Korzystanie z klasy wtyczek w szablonie

9

Piszę wtyczkę, aby wysłać zaproszenie do znajomego, który otwiera formularz po kliknięciu linku. Hermetyzowałem wszystkie funkcje w klasie, postępując zgodnie z kodem podanym we wtyczce Report Broken Video autorstwa @toscho. Odpowiedni kod znajduje się poniżej:

/*
Plugin Name: Send Invitation
Plugin URI: http://w3boutique.net
Description: Emails a the link of the current page to a friend
Author: Nandakumar Chandrasekhar
Version: 0.1
Author URI: http://w3boutique.net/about-nanda.html
License: GPL2
*/

// include() or require() any necessary files here

// Settings and/or Configuration Details go here
define('SEND_INVITATION_MIN_WORDPRESS_VERSION', '3.1.1');

define('SEND_INVITATION_PLUGIN_URL', plugins_url('', __FILE__));

add_action( 'init', array( 'SendInvitation', 'nc_sendinvitation_init' ) );

class SendInvitation {

    protected $nonce_name = 'nc_sendinvitation';
    protected $post_url = '';

    public static function nc_sendinvitation_init() {
        new self;
    }

    public function __construct() {
        add_action( 'init', array(&$this, 'nc_sendinvitation_head' ));
        add_action( 'init', array(&$this,  'nc_sendinvitation_check_wordpress_version' ));
       add_action( 'init', array(&$this, 'nc_sendinvitation_form_action' ));
       //$this->post_url = $this->nc_sendinvitation_get_post_url();
   }

   public function nc_sendinvitation_head() {
       wp_enqueue_script( 'jquery' );
       wp_enqueue_script( 'send_invitation_js',
        plugins_url( 'js/send-invitation.js', __FILE__ ),
        array( 'jquery' ) );

       wp_enqueue_style( 'send_invitation_css',
        plugins_url( 'css/send-invitation.css', __FILE__ ) );
   }

   public function nc_sendinvitation_check_wordpress_version() {
       global $wp_version;

       $exit_msg = 'Send Invitation requires version '
    . SEND_INVITATION_MIN_WORDPRESS_VERSION
    . 'or newer <a href="http://codex.wordpress.org/Upgrading_WordPress">Please
update!</a>';

       if ( version_compare( $wp_version, SEND_INVITATION_MIN_WORDPRESS_VERSION, '<') )
       {
            exit( $exit_msg );
       }
   }

   public function nc_sendinvitation_form_action() {

        $action = '';
        if ( $_SERVER['REQUEST_METHOD'] != 'POST' )
        {
             $action = $this->nc_sendinvitation_get_form();
        }
        else if ( $_SERVER['REQUEST_METHOD'] == 'POST' ) {
            $action = $this->nc_sendinvitation_handle_submit();
        }
        return $action;
   }

   public function nc_sendinvitation_get_form() {
       // Start the output buffer, prevents content being output directly into
       // script, instead it is stored in a buffer which can then be flushed
       // to allow the include file to be stored in a variable
       // See http://www.codingforums.com/showthread.php?t=124537
       ob_start();
       include('send-invitation-form.php');
       $send_invitation_link = ob_get_clean();

       return $send_invitation_link;
   }

   public function nc_sendinvitation_handle_submit() {
         if ( isset( $_POST['form_type'] ) && ( $_POST['form_type'] == 'nc_sendinvitation' ) ) {
            $to = '[email protected]';
            $subject = 'Invitation to SwanLotus';
            $message = 'Navanitachora invites you to take a look at this link';
            wp_mail($to, $subject, $message);
            $result = 'Email was sent successfully';
    }
    else {
        $result = $this->nc_sendinvitation_get_form();
    }
    return $result;
}

public function nc_sendinvitation_get_post_url() {
    global $post;
    $blog_id = get_option('page_for_posts');
    $post_id = '';
    if (is_home($blog_id)) {
        $post_id = $blog_id;
    } else {
        $post_id = $post->ID;
    }

    return get_permalink($post_id);
}
}
/* End of File */
?>

Nie wiem, jak użyć tej klasy w moim szablonie, aby wyświetlić formularz. Wiem, że muszę utworzyć instancję klasy, ale nie jestem pewien, gdzie umieścić kod i jak uzyskać dostęp do obiektu, aby móc go użyć w moim szablonie. Mam wiedzę na temat OOP, ale nie korzystałem z niej wcześniej w tym kontekście i potrzebuję trochę instrukcji krok po kroku.

Wielkie dzięki.

navanitachora
źródło

Odpowiedzi:

9

Najlepszym sposobem na użycie klasy bez znajomości obiektu jest akcja . Rejestrujesz akcję przed załadowaniem plików motywu do prezentacji, a WordPress zajmie się resztą.

Przykładowy kod:

<?php # -*- coding: utf-8 -*-
/**
 * Plugin Name: Plugin Action Demo
 */
add_action( 'init', array ( 'Plugin_Action_Demo', 'init' ) );

class Plugin_Action_Demo
{
    /**
     * Creates a new instance.
     *
     * @wp-hook init
     * @see    __construct()
     * @return void
     */
    public static function init()
    {
        new self;
    }

    /**
     * Register the action. May do more magic things.
     */
    public function __construct()
    {
        add_action( 'plugin_action_demo', array ( $this, 'print_foo' ), 10, 1 );
    }

    /**
     * Prints 'foo' multiple $times.
     *
     * Usage:
     *    <code>do_action( 'plugin_action_demo', 50 );</code>
     *
     * @wp-hook plugin_action_demo
     * @param int $times
     * @return void
     */
    public function print_foo( $times = 1 )
    {
        print str_repeat( ' foo ', (int) $times );
    }
}

Teraz możesz zadzwonić do_action( 'plugin_action_demo', 50 );gdzieś w swoim motywie lub w innej wtyczce i nie musisz już przejmować się wewnętrznym funkcjonowaniem klasy.

Jeśli dezaktywujesz wtyczkę, nadal jesteś bezpieczny: WordPress po prostu ignoruje nieznane działania i do_action()nie wyrządzi szkody. Ponadto inne wtyczki są w stanie usunąć lub zastąpić akcję, więc zbudowałeś fajny mini API z jednym add_action().

Możesz także zbudować singletona:

<?php # -*- coding: utf-8 -*-
/**
 * Plugin Name: Plugin Singleton Demo
 */
class Plugin_Singleton_Demo
{
    protected static $instance = NULL;

    /**
     * Creates a new instance if there isn't one.
     *
     * @wp-hook init
     * @return object
     */
    public static function get_instance()
    {

        NULL === self::$instance and self::$instance = new self;
        return self::$instance;
    }

    /**
     * Not accessible from the outside.
     */
    protected function __construct() {}

    /**
     * Prints 'foo' multiple $times.
     *
     * @param int $times
     * @return void
     */
    public function print_foo( $times = 1 )
    {
        echo str_repeat( ' foo ', (int) $times );
    }
}

Teraz print_foo()jest dostępny dla:

Plugin_Singleton_Demo::get_instance()->print_foo();

Nie polecam wzoru Singleton. Ma kilka poważnych wad .

fuxia
źródło
1
Z ciekawości, co jest celem plugin_action_demow add_action()? Skąd do_action( 'print_foo', 50 );wiadomo, że akcja jest plugin_action_demolub jest nieistotna?
Jared
Ok, był trochę zdezorientowany. :) Dzięki za wyjaśnienie.
Jared,
Dla declare()przypomnienia : wymaga php 5.3+ :)
Kaiser
Dzięki, że działa, muszę tylko dodać trochę sprawdzania poprawności i powinienem to zrobić. Dzięki @ toscho wiele mnie nauczyłeś. :-)
navanitachora
@tosco Znalazłeś odpowiedź, szukając artykułów o singletonach dla wtyczek WordPress. Zdajesz sobie sprawę, że przy użyciu Singleton w zalecanej odpowiedź, jesteś nie tylko jej wykonywania? Wyobraź sobie ich połączenia new Plugin_Action_Demo? Każdy, kto użyje do_action('plugin_action_demo'), uruchomi dwa (2) połączenia Plugin_Action_Demo->print_foo(), a nie to, czego chcesz. Wściekłość nad singletonami ignoruje odpowiednie przypadki użycia. Jako FYI zarówno @ericmann, jak i ja blogujemy teraz, aby promować singletony w przestrzeni nazw wtyczek WordPress, on na eamann.com i ja na hardcorewp.com.
MikeSchinkel