Qual é a maneira ideal de registrar / enfileirar scripts e / ou estilos para uso em plugins?
Recentemente, criei um plugin simples para adicionar o usuário avatar / gravatar com um código curto. Eu tenho diferentes opções de estilo para exibir o avatar (quadrado, redondo, etc.) e decidi colocar o css diretamente no próprio código de acesso.
No entanto, agora percebo que essa não é uma boa abordagem, pois repetirá o css toda vez que o código curto for usado em uma página. Eu já vi várias outras abordagens neste site e o wp codex ainda tem dois exemplos, por isso é difícil saber qual abordagem é mais consistente e mais rápida.
Aqui estão os métodos que eu conheço atualmente:
Método 1: Incluir diretamente no shortcode - É o que estou fazendo atualmente no plug-in, mas não parece bom, pois repete o código.
class My_Shortcode {
function handle_shortcode( $atts, $content="" ) {
/* simply enqueue or print the scripts/styles in the shortcode itself */
?>
<style type="text/css">
</style>
<?php
return "$content";
}
}
add_shortcode( 'myshortcode', array( 'My_Shortcode', 'handle_shortcode' ) );Método 2: Usar classe para enfileirar scripts ou estilos condicionalmente
class My_Shortcode {
static $add_script;
static function init() {
add_shortcode('myshortcode', array(__CLASS__, 'handle_shortcode'));
add_action('init', array(__CLASS__, 'register_script'));
add_action('wp_footer', array(__CLASS__, 'print_script'));
}
static function handle_shortcode($atts) {
self::$add_script = true;
// shortcode handling here
}
static function register_script() {
wp_register_script('my-script', plugins_url('my-script.js', __FILE__), array('jquery'), '1.0', true);
}
static function print_script() {
if ( ! self::$add_script )
return;
wp_print_scripts('my-script');
}
}
My_Shortcode::init();Método 3: usando get_shortcode_regex();
function your_prefix_detect_shortcode() {
global $wp_query;
$posts = $wp_query->posts;
$pattern = get_shortcode_regex();
foreach ($posts as $post){
if ( preg_match_all( '/'. $pattern .'/s', $post->post_content, $matches )
&& array_key_exists( 2, $matches )
&& in_array( 'myshortcode', $matches[2] ) )
{
// css/js
break;
}
}
}
add_action( 'wp', 'your_prefix_detect_shortcode' );Método 4: usando has_shortcode();
function custom_shortcode_scripts() {
global $post;
if( is_a( $post, 'WP_Post' ) && has_shortcode( $post->post_content, 'myshortcode') ) {
wp_enqueue_script( 'my-script');
}
}
add_action( 'wp_enqueue_scripts', 'custom_shortcode_scripts');
Method 4: Using has_shortcode();é melhor, porque garantirá que os scripts e estilos sejam carregados uma vez se o conteúdo da postagem tiver um código curto, independentemente de vários usos do código curto. Embora possa não funcionar para o uso de códigos curtos em widgets ou na barra lateral, não tenho certeza. Se for para um plug-in, não recomendo que você amarre scripts com shortcode, porque alguns podem chamar sua função em vez de shortcode para obter a saída desejada.