Línguas: Inglês – Français – 日本語 (Adicione a sua língua)
Desde a Versão 2.5, o WordPress suporta os chamados Shortcodes. Foram introduzidos para a criação de macros a serem utilizados no conteúdo de um post. Para exemplos de atalhos e de como utilizá-los, ver Atalhos do WordPress.com, embora alguns atalhos aí apresentados sejam exclusivos do WordPress.com.
Um atalho trivial para uma galeria parece-se com isto:
Códigos de atalho também podem ser usados com atributos adicionais como mostra o seguinte exemplo:
Bambos exemplos exibirão uma galeria de imagens, o que seria difícil de manter quando se escreve a marcação HTML para ela e a mantém em sincronia com as imagens carregadas. Utilizando um atalho, a marcação para a galeria será criada dinamicamente e automaticamente.
Built-In e Atalhos Adicionais
WordPress oferece alguns dos atalhos por defeito (por exemplo o da galeria) e os plugins podem também adicionar os seus próprios através da API de Atalhos.
Os seguintes códigos de atalho estão incluídos com WordPress:
Escaping Shortcodes
Por vezes pode desejar utilizar o texto que normalmente representa um atalho nos seus posts. Para o fazer, é necessário escapar ao atalho utilizando dois conjuntos de parênteses em vez de apenas um. Assim, para exibir isto no seu post:
Escreve isto:
]
Para os atalhos que têm uma etiqueta de início e fim, só precisa de escapar ao primeiro e último parênteses:
... ]
Nota que apenas os atalhos que estão actualmente disponíveis podem ser escapados desta forma. A utilização de parênteses duplos em torno de texto que não está actualmente registado como um atalho resultará na exibição de ambos os conjuntos de parênteses no seu post, e não apenas de um como quando escapa aos atalhos registados.
Códigos de atalho em Widgets
Por defeito, o WordPress não suporta atalhos dentro dos Sidebar Widgets até 4.9. Apenas expande os atalhos dentro do conteúdo de um post, página, ou tipo de post personalizado. Para adicionar suporte de atalhos aos widgets da barra lateral, pode instalar um plugin, usar o código abaixo, ou rever as melhorias do Widget em 4.9:
add_filter( 'widget_text', 'shortcode_unautop' );add_filter( 'widget_text', 'do_shortcode' );
É importante que estas linhas sejam adicionadas nesta ordem. A primeira linha impede que o WordPress transforme as quebras de linha em etiquetas de parágrafo, uma vez que isto impede que os atalhos funcionem. A segunda linha é a que faz funcionar os atalhos.
Códigos de Horticultura para Plugins em Falta (Nomes Não Registados)
Fora dos atalhos incorporados, todos os outros são adicionados através de plugins. Se o plugin que fornece um determinado código de atalho estiver em falta ou desactivado, o WordPress tratará todo o código de atalho, os seus atributos e o conteúdo dentro dele como texto normal e preservará os caracteres especiais no HTML de saída.
| Input |
Yay! |
|
| com plugin | <> | <> — Viva! | <<<Y> |
| sem plugin |
Yay! |
Yay! |