Использование класса плагина внутри шаблона

9

Я пишу плагин для отправки приглашения другу, который открывает форму при нажатии на ссылку. Я инкапсулировал все функции в классе, следуя коду, указанному в плагине Report Broken Video @toscho. Соответствующий код ниже:

/*
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 = 'navanitachora@gamil.com';
            $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 */
?>

Я в растерянности относительно того, как использовать этот класс в моем шаблоне, чтобы я мог отобразить форму. Я знаю, что мне нужно создать экземпляр класса, но я не уверен, куда поместить код и как получить доступ к объекту, чтобы я мог использовать его в своем шаблоне. У меня есть знания о ООП, но я не использовал их в этом контексте раньше, и мне нужно немного пошаговых инструкций.

Огромное спасибо.

navanitachora
источник

Ответы:

9

Лучший способ использовать ваш класс без знания объекта - это действие . Вы регистрируете действие до загрузки файлов темы для презентации, WordPress будет обрабатывать все остальное.

Образец кода:

<?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 );
    }
}

Теперь вы можете позвонить do_action( 'plugin_action_demo', 50 );куда-нибудь в своей теме или в другом плагине, и вам больше не нужно заботиться о внутренней работе класса.

Если вы деактивируете плагин, вы все еще в безопасности: WordPress просто игнорирует неизвестные действия и do_action()не причинит вреда. Кроме того, другие плагины могут удалять или заменять действие, поэтому вы можете создать красивый мини-API с одним из них add_action().

Вы также можете построить синглтон:

<?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 );
    }
}

Теперь print_foo()доступно по:

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

Я не рекомендую шаблон Singleton. У него есть серьезные недостатки .

Фуксия
источник
1
Из любопытства, какова цель plugin_action_demoв add_action()? Как do_action( 'print_foo', 50 );узнать, что действие plugin_action_demoили это имя не имеет значения?
Джаред
Хорошо, был немного смущен. :) Спасибо за разъяснение.
Джаред
Для записи: declare()требуется php 5.3+ :)
kaiser
Спасибо, что работы просто нужно добавить некоторую проверку, и я должен быть сделан. Спасибо @toscho, ты многому меня научил. :-)
navanitachora
@tosco Нашёл ответ, ища статьи о синглетонах для плагинов WordPress. Вы понимаете , что вы являетесь , используя Singleton в вашем рекомендуемом ответе, вы просто не укрепляете его? Вообразите, что Themer называет new Plugin_Action_Demo?? Любой, кто использует do_action('plugin_action_demo'), вызовет два (2) вызова Plugin_Action_Demo->print_foo(), а не то, что вы хотите. Фурор над синглетонами игнорирует наличие соответствующих прецедентов. Как FYI, @ericmann и я сейчас ведем блог, чтобы отстаивать синглтоны для пространства имен плагинов WordPress, он на eamann.com, а я на hardcorewp.com.
MikeSchinkel