Desde a versão 2.5 do WordPress (de preferência 2.5.1) fornece os chamados códigos de acesso , um procedimento que permite a criação de callback, ou melhor do que o gancho, quando o texto de nosso post é encontrada uma string formatada com suportes como [id_shortcode] . Antes da versão 2.5 do WordPress shortcodes foram implementadas manualmente (ver Napolux ), agora você pode explorar com mais simplicidade e para diferentes usos.
Sintaxe
Para utilizar códigos de acesso é suficiente para criar uma função de gancho, com os parâmetros padrão e definir os códigos de acesso através add_shortcode() :
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | / ** * Este é o protótipo da função de gancho * / $attrs , $content = null ) { mio_shortcode_hook função ($ attrs, $ content = null) { / / Código aqui ; retornar "Saída no post"; } / ** * Add_shortcode () aceita dois parâmetros: * * @ Param tag string $ Shortcode tag a ser pesquisado no conteúdo do post. * @ Param Gancho $ exigível função para executar quando shortcode é encontrado. * / , "mio_shortcodes_hook" ) ; add_shortcode ("mio_shortcode", "mio_shortcodes_hook"); |
Este código pode ser colocado no arquivo functions.php . . Ao escrever o seu post, incluindo mio_shortcode colchetes será executado como código de gancho (função) mio_shortcode_hook() .
A função de gancho, e nosso shortcode, pode ser usado de várias maneiras, dependendo das necessidades:
1 2 3 4 5 6 | <- Apenas shortcode -> [Mio_shortcode] <- Com atributos -> [Color = Mio_shortcode '# 000000'] <- Com o conteúdo incluído -> [Color = Mio_shortcode '# 000000'] Eu estou contente [mio_shortcode /] |
Nota: o código acima tive para inserir um espaço entre o shortcode fechando a abertura do suporte e uma barra. Este espaço vai ser eliminado em seu código. Tudo isso devido a um conflito com o plugin que eu uso para ver o código, como anc'esso utiliza uma sintaxe semelhante ao shortcode
Atributos de gestão
Os atributos incluídos em um shortcode são fáceis de manusear e você pode definir o valor padrão. Veja como criar tal shortcode um para lidar com um título formatado de uma maneira especial:
1 2 3 4 5 6 7 8 | $attrs , $content = null ) { mio_shortcode_hook função ($ attrs, $ content = null) { shortcode_atts ( array ( extrair (shortcode_atts ( matriz ( 'attributo 1 default' , "Attr_1 '=' atributo padrão 1">, 'attributo 2 default' , "Attr_2 'atributo padrão 2" => / / ... Etc $attrs ) ) ; ), $ Attrs)); / / ... } |
Da mesma forma que como vimos no WordPress: wp_parse_args () , a gestão de atributos é muito simples e permite que você defina valores padrão na ausência dos mesmos atributos. (cugina della wp_parse_args() ), rendendo disponibile nello scope della funzione (vedi extract() ) gli attributi come variabili. O código acima "derrete" a matriz $attrs com que as dinâmicas de funções remotas shortcode_atts() (primo de wp_parse_args() ), tornando disponível no âmbito da função (ver extract() ) atributos como variáveis. Os atributos devem estar todos em letras minúsculas!
Gestão de Conteúdos
A forma como o conteúdo é mais versátil, em certos casos, aqui está um exemplo ilustrativo:
1 2 3 4 | $attrs , $content = null ) { make_title_shortcode função ($ attrs, $ content = null) { . $content . '"><span>' . $content . '</span></h1>' ; return '<h1 title="'. $content.'"> <span>' $ conteudo '</ span> </ h1>'..; } , 'make_title_shortcode' ) ; add_shortcode ('my-title', 'make_title_shortcode'); |
Usando o shortcode em nosso post:
1 | [My-título] Este é um título [/ meu-título] |
Teremos como saída:
1 |
Podemos melhorar os nossos atributos exemplo introducento ainda mais personalizáveis para tornar a nossa shortcode:
1 2 3 4 5 6 7 | $attrs , $content = null ) { make_title_shortcode função ($ attrs, $ content = null) { shortcode_atts ( array ( extrair (shortcode_atts ( matriz ( 'my-title' , 'Classe' => 'my-title', $attrs ) ) ; ), $ Attrs)); . $class . '" title="' . $content . '"><span>' . $content . '</span></h1>' ; return '<h1 class="'. $class.'" title="'. $content.'"> <span>' $ conteudo '</ span> </ h1>'..; } |
1 | [My-título class = "cor vermelha"] Este é um título [/ meu-título] |
1 |
Como já foi mencionado, você pode encontrar muitas informações sobre a documentação oficial do WordPress . Aqui estão alguns shortcode útil.
Mostrar Adsense no post
Digite o código abaixo em seu arquivo functions.php . Altere o código com o Google AdSense.
1 2 3 4 5 6 7 8 9 10 11 12 | show_adsense function () { return '<script type="text/javascript"> <! - google_ad_client = "pub-9877654123213210"; google_ad_slot = "9876543210"; google_ad_width = 468; google_ad_height = 60; / / -> </ Script> <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> </ script> '; } , 'adsense' ) ; add_shortcode ('myadsense', 'adsense'); |
Basta colocar no lugar:
1 | [Myadsense] |
Adicionar notas a um post visível apenas pelo administrador
Este shortcode permite adicionar notas a um post visível apenas a um administrador.
1 2 3 4 5 6 | $attrs , $content = null ) { admin_note função ($ attrs, $ content = null) { current_user_can ( 'publish_posts' ) ) if (current_user_can ('publish_posts')) . $content . '</div>' ; return '<div class="admin-note">' $ conteudo '</ div>'..; ; voltar''; } , 'admin_note' ) ; add_shortcode ("admin-notas ',' admin_note '); |
1 | [Notes] Esta nota só é visível para os administradores do blog [nota /] |
Publicará no futuro outros shortcode útil ...
Como dizem aqui na América ... Awesome! Eu sabia que essa coisa de códigos curtos em wordpress, eu sempre fiz "na mão" com o método antigo. Obrigado.
@ Camu: glishortcodes querida ... na verdade tem uma ferramenta muito poderosa e útil em muitas ocasiões. A propósito ... Eu sei que este ano não vai ser capaz de chegar e te dar uma saudação, mas com cuidado valorizar suas ótimas dicas e vou tentar segui-los, pelo menos, o próximo ano ...
Absolutamente! Quando você quiser, você é bem-vinda
[...] Além disso consultar o artigo original: Undolog.com »WordPress: uso shortcodes Artigos relacionados: IT FeedBurner - WordPress: usar [...]
Excelente
ou então eu escrevi um pequeno plugin bbcode 