Ações e Filtros
A melhor maneira de imho é usar uma ação para incluir funções de plug-in em temas.
Exemplo 1
Aqui está um pequeno plugin para testar isso.
<?php
/** Plugin Name: (#68117) Print Hello! */
function wpse68117_print_hello()
{
echo "Hello World!";
}
add_action( 'wpse68117_say', 'wpse68117_print_hello' );
Dentro do tema:
<?php
/** Template Name: Test »Print Hello!« Plugin */
get_header();
// Now we call the plugins hook
do_action( 'wpse68117_say' );
O que acontece agora / O garoto kool
Dessa forma, não precisamos verificar a existência de uma função, um arquivo, uma classe, um método ou talvez até um (não faça isso!) Global $variable. O estagiário global do WP já aceita isso: verifica se o nome do gancho é o filtro atual e o anexa. Se não existe, nada acontece.
Exemplo 2
Com o nosso próximo plug-in, estamos anexando uma função de retorno de chamada que requer um argumento.
<?php
/** Plugin Name: (#68117) Print Thing! */
function wpse68117_print_thing_cb( $thing )
{
return "Hello {$thing}!";
}
add_filter( 'wpse68117_say_thing', 'wpse68117_print_thing_cb' );
Dentro do tema:
<?php
/** Template Name: Test »Print Thing!« Plugin */
get_header();
// Now we call the plugins hook
echo apply_filter( 'wpse68117_say_thing', 'World' );
Desta vez, oferecemos ao usuário / desenvolvedor a possibilidade de adicionar um argumento. Ele pode echo/printproduzir a saída ou até processá-la ainda mais (caso você tenha uma matriz em troca).
Exemplo 3
Com o terceiro plug-in, estamos anexando uma função de retorno de chamada que recebe dois argumentos.
<?php
/** Plugin Name: (#68117) Print Alot! */
function wpse68117_alot_cb( $thing, $belongs = 'is mine' )
{
return "Hello! The {$thing} {$belongs}";
}
add_filter( 'wpse68117_grab_it', 'wpse68117_alot_cb' );
Dentro do tema:
<?php
/** Template Name: Test »Print Alot!« Plugin */
get_header();
// Now we call the plugins hook
$string_arr = implode(
" "
,apply_filter( 'wpse68117_grab_it', 'World', 'is yours' )
);
foreach ( $string_arr as $part )
{
// Highlight the $thing
if ( strstr( 'World', $part )
{
echo "<mark>{$part} </mark>";
continue;
}
echo "{$part} ";
}
Este plugin agora nos permite inserir dois argumentos. Podemos salvá-lo em um $variablee mais processá-lo.
Conclusão
Com o uso de filtros e ações, você obtém melhor desempenho, evitando verificações desnecessárias (compare a velocidade function_*/class_*/method_*/file_existsou a pesquisa de um global com in_array()~ 1k (?) Pesquisas de filtro). Você também evita receber todos os avisos desnecessários para não definir variáveis, etc., pois o plug-in se preocupa com isso.
