Використання класу плагінів всередині шаблону


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 */
?>

Я в занепокоєнні, як використовувати цей клас у своєму шаблоні, щоб я міг відобразити форму. Я знаю, що мені потрібно інстанціювати клас, але я не впевнений, куди поставити код і як отримати доступ до об'єкта, щоб я міг його використовувати у своєму шаблоні. Я знаю про ООП, але раніше не використовував його в цьому контексті і потребую покрокової інструкції.

Дуже дякую.

Відповіді:


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+ :)
кайзер

Дякую, що роботи просто повинні додати деяку перевірку, і мені це слід зробити. Дякую @toscho, ти мене багато чому навчив. :-)
navanitachora

@tosco Знайшов свою відповідь, шукаючи статті про одиночні кнопки для плагінів WordPress. Ви розумієте , що використовуєте Сінглтон у своїй рекомендованій відповіді, ви просто не застосовуєте його? Уявіть тематичні дзвінки new Plugin_Action_Demo?? Усі, хто використовує do_action('plugin_action_demo'), викликали б два (2) дзвінки Plugin_Action_Demo->print_foo(), а не те, що ви хочете. Фурор над одиночними ігнорує, що є відповідні випадки використання. Як FYI, і @ericmann і я веду блог зараз, щоб захищати одиночні кнопки для розширення імен плагінів WordPress, він на eamann.com і мене на hardcorewp.com.
MikeSchinkel
Використовуючи наш веб-сайт, ви визнаєте, що прочитали та зрозуміли наші Політику щодо файлів cookie та Політику конфіденційності.
Licensed under cc by-sa 3.0 with attribution required.