add_action referencia a una clase

¿Es posible hacer referencia a una clase en lugar de una función en 'add_action'? Parece que no puedo entenderlo. Aquí hay un ejemplo básico de la función en cuestión.

add_action( 'admin_init', 'MyClass' );
class MyClass {
     function __construct() {
          .. This is where stuff gets done ..
     }
}

Entonces sí, eso no funciona. También he intentado:

$var = new MyClass();
add_action( 'admin_init', array( &$var ) );

Y:

$var = new MyClass();
add_action( 'admin_init', array( &$var, '__construct' ) );

Y también:

add_action( 'admin_init', 'MyClass::__construct' );

¿Hay alguna forma de que pueda hacer esto sin tener que crear una función separada que cargue la clase? Me gustaría poder ejecutar el constructor de clases a través de add_action. Eso es todo lo que hay que cargar para que la pelota ruede.

No, no puede 'inicializar' o instanciar la clase a través de un gancho, no directamente. Siempre se requiere algún código adicional (y no es deseable poder hacerlo, ya que está abriendo una lata de gusanos para usted).

Aquí hay una mejor manera de hacerlo:

class MyClass {
     function __construct() {
          add_action( 'admin_init',array( $this, 'getStuffDone' ) );
     }
     function getStuffDone() {
          // .. This is where stuff gets done ..
     }
}
$var = new MyClass();

Por supuesto, uno podría crear una clase de interfaz para simplificarla aún más para el caso general:

class IGetStuffDone {
    function IGetStuffDone(){
        add_action( 'admin_init',array( $this, 'getStuffDone' ) );
    }
    public abstract function getStuffDone();
}

Tenga en cuenta que, como interfaz, no puede crear un objeto de este tipo directamente, pero puede crear una subclase, que le permite decir:

class CDoingThings extends IGetStuffDone {
    function getStuffDone(){
        // doing things
    }
}
$var = new CDoingThings();

Lo que luego agregaría automáticamente todos los ganchos, ¡solo necesita definir qué se está haciendo exactamente en una subclase y luego crearlo!

En constructores

No agregaría un constructor como una función de enlace, es una mala práctica y puede provocar muchos eventos inusuales. Además, en la mayoría de los idiomas, un constructor devuelve el objeto que se está instanciando, por lo que si su gancho necesita devolver algo como en un filtro, no devolverá la variable filtrada que desee, sino que devolverá el objeto de clase.

Llamar a un constructor o un destructor es una muy, muy, muy mala práctica de programación, sin importar en qué idioma se encuentre, y nunca se debe hacer.

Los constructores también deben construir objetos, para inicializarlos listos para usar, no para el trabajo real. El trabajo a realizar por el objeto debe estar en una función separada.

Métodos de clase estática y sin necesidad de instanciar / inicializar en absoluto

Si su método de clase es un método de clase estático, puede pasar el nombre de la clase entre comillas en lugar de $thiscomo se muestra a continuación:

class MyClass {
     public static function getStuffDone() {
          // .. This is where stuff gets done ..
     }
}
add_action( 'admin_init', array('MyClass','getStuffDone' ) );

Closures y PHP 5.3

Lamentablemente, no puede evitar la línea que crea la nueva clase. La única otra solución para omitirlo sería el código de placa de caldera que todavía tiene esa línea, y requeriría PHP 5.3+, por ejemplo:

add_action('admin_init',function(){
    $var = new MyClass();
    $var->getStuffDone();
});

En ese momento, también puede saltear la clase y simplemente usar una función:

add_action('admin_init',function(){
    // do stuff
});

Pero tenga en cuenta que ahora ha introducido el espectro de funciones anónimas. No hay forma de eliminar la acción anterior utilizando remove_action, y esto puede causar un gran dolor a los desarrolladores que tienen que trabajar con el código de otras personas.

En los símbolos

Puede ver acciones utilizadas de esta manera:

array( &$this, 'getStuffDone' );

Esto es malo . &se agregó nuevamente en PHP 4 cuando los objetos se pasaron como valores, no como referencias. PHP 4 tiene más de una década y no ha sido compatible con WordPress en mucho tiempo.

No hay ninguna razón para usar &thisal agregar ganchos y filtros, y eliminar la referencia no causará problemas e incluso puede mejorar la compatibilidad con futuras versiones de PHP

Use esto en su lugar:

array( $this, 'getStuffDone' );

Clase de ejemplo

Notas:

• Inicia la clase solo una vez
  • Llame a la prioridad 0, para que pueda usar el mismo enlace con la prioridad predeterminada más adelante
  • Envuélvala en una ! class_existspara evitar llamarla dos veces y coloque la llamada de inicio dentro
• Hacer la initfunción y la clase varstatic
• Llame al constructor desde dentro de su init, cuando llame a la clase new self.

Aquí hay un ejemplo

if ( ! class_exists( 'WPSESampleClass' ) )
{
    // Init the class on priority 0 to avoid adding priority inside the class as default = 10
    add_action( 'init', array ( 'WPSESampleClass', 'init' ), 0 );

class WPSESampleClass
{
    /**
     * The Class Object
     */
    static private $class = null;

    public static function init()
    {
        if ( null === self::$class ) 
            self :: $class = new self;

        return self :: $class;
    }

    public function __construct()
    {
        // do stuff like add action calls:
        add_action( 'init', array( $this, 'cb_fn_name' ) );
    }

    public function cb_fn_name()
    {
        // do stuff 
    }
} // END Class WPSESampleClass

} // endif;

Php 5+

Por favor , deja &afuera. Ya estamos más allá de php4. :)

if (!class_exists("AllInOneWoo")){
    class AllInOneWoo {
        function __construct(){
            add_action('admin_menu', array($this, 'all_in_one_woo') );
        }
        function all_in_one_woo(){
            $page_title = 'All In One Woo';
            $menu_title = 'All In One Woo';
            $capability = 'manage_options';
            $menu_slug  = 'all-in-one-woo-menu';
            $function   = array($this, 'all_in_one_woo_menu');
            $icon_url   = 'dashicons-media-code';
            $position   = 59;

            add_menu_page($page_title, $menu_title, $capability, $menu_slug, $function, $icon_url, $position);
        }
        function all_in_one_woo_menu(){?>
            <div class="wrap">
                <h1><?php _e('All In One Woo', 'all_in_one_woo'); ?></h1>
            </div>
        <?php }
    }// end class
}// end if

if (class_exists("AllInOneWoo")){       
    $all_in_one_woo = new AllInOneWoo();
}

Puede activar eventos en su clase sin la necesidad de cargarlo inicialmente . Esto es útil si no desea cargar toda la clase por adelantado, pero necesita acceder a los filtros y acciones de WordPress.

Aquí hay un ejemplo muy simple

<?php
class MyClass
{
    public static function init()
    {
        add_filter( 'the_content', array('MyClass', 'myMethod') );
    }

    public static function myMethod($content)
    {
        $content = $content . 'Working without loading the object';
    }
}

MyClass::init();

Esta es una versión muy simplificada de la respuesta de Kaiser, pero muestra en términos simples el comportamiento. Puede ser útil para aquellos que buscan este estilo por primera vez.

Otros métodos aún pueden iniciar el objeto si es necesario. Personalmente estoy usando este método para permitir que partes opcionales de mi complemento pongan en cola los scripts, pero solo desencadenar el objeto en una solicitud AJAX.

Esto funciona para mi:

class foo
{
    public static function bar()
    {
        echo 'it works!';
    }
}

add_action('foo_bar', array('foo', 'bar'));

En términos generales, no agregaría una clase completa a un gancho. Los add_action()/ add_filter()hooks esperan funciones de devolución de llamada , a las que se puede hacer referencia desde dentro de una clase .

Digamos que tiene una init()función dentro de su clase, que desea conectar al gancho de WordPress init.

Ponga su add_action()llamada dentro de su clase, y luego identifique la devolución de llamada de esta manera:

add_action( 'init', array( $this, 'init' ) );

(Nota: supongo que su clase tiene un espacio de nombres adecuado; de lo contrario, asegúrese de asignar un espacio de nombres a sus funciones de devolución de llamada).

Debería poder hacerlo pasando el nombre de la clase en lugar del objeto instanciado:

add_action( 'init', array( 'MyClass', '__construct' ) );

(En teoría, su otra solución también debería funcionar

$var = new MyClass();
add_action( 'admin_init', array( $var, '__construct' ) );

No estoy seguro de por qué no lo hace. ¿Tal vez si no llama por referencia?)