Como criar seus próprios códigos de acesso do WordPress
Na versão 2.5, o WordPress introduziu códigos de acesso, e todos nós provavelmente os usamos em um momento ou outro. Eles geralmente vêm acompanhados de plugins, ou até mesmo de temas, e o que eles fazem é observar quando você insere algo entre colchetes e substituí-lo por algum outro conteúdo; Poderia ser uma sentença simples ou poderia ser uma função maciça do PHP, tudo depende do que você instruiu o WordPress a fazer.
Shortcodes empacotados são ótimos e agilizam bastante as coisas, mas não seria ótimo saber como criar códigos de acesso?
Neste artigo, conduzirei você criando alguns códigos de acesso simples do WordPress para ajudá-lo a criar qualquer funcionalidade que desejar.
Um shortcode simples
A API shortcode funciona de forma muito simples: primeiro você precisa criar uma função de retorno de chamada que será executada sempre que o shortcode for usado; então você precisa amarrar essa função a um shortcode específico, tornando-a pronta para uso. O código é freqüentemente colocado no arquivo functions.php, mas se você planeja ter muitos códigos de acesso, faz sentido criar um arquivo separado e incluí-lo em seu arquivo functions.php.
Em nosso primeiro exemplo, queremos criar um shortcode que criará algum lorem ipsum toda vez que digitarmos [lorem] no editor. Primeiro precisamos criar a função de retorno de chamada que retornará o lorem ipsum (em códigos de acesso não fazemos eco de nada, tudo é retornado):
function lorem_function() {return 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec nec nulla vitae lacus mattis volutpat eu at sapien. Nunc interdum congue libero, quis laoreet elit sagittis ut. Pellentesque lacus erat, dictum condimentum pharetra vel, malesuada volutpat risus. Nunc sit amet risus dolor. Etiam posuere tellus nisl. Integer lorem ligula, tempor eu laoreet ac, eleifend quis diam. Proin cursus, nibh eu vehicula varius, lacus elit eleifend elit, eget commodo ante felis at neque. Integer sit amet justo sed elit porta convallis a at metus. Suspendisse molestie turpis pulvinar nisl tincidunt quis fringilla enim lobortis. Curabitur placerat quam ac sem venenatis blandit. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nullam sed ligula nisl. Nam ullamcorper elit id magna hendrerit sit amet dignissim elit sodales. Aenean accumsan consectetur rutrum.';}Em seguida, precisamos adicionar este shortcode ao WordPress usando a função add_shortcode em nosso arquivo functions.php ou um arquivo que está sendo incluído nele, essa função adiciona o shortcode e também o liga à função que acabamos de criar. add_shortcode leva apenas dois argumentos, o primeiro sendo o nome que queremos que este shortcode tenha (o que vamos digitar entre os colchetes) e o segundo sendo a função que queremos anexar a esse shortcode:
add_shortcode('lorem', 'lorem_function');Isso é tudo o que é necessário para criar um shortcode simples no WordPress.
Adicionando parâmetros
Continuando com essa ideia de conteúdo fictício, muitas vezes precisamos de imagens em nosso conteúdo quando preparamos nossos mockups e essas imagens precisam ter tamanhos diferentes, então agora criaremos um shortcode para inserir uma imagem como esta:
[picture width="500" height="500"]Quando o WordPress encontra isso, queremos uma função que irá inserir uma imagem. Ele precisa ler os atributos de largura e altura, mas apenas no caso de também fornecermos valores padrão para que possam ser usados sem os atributos. Porque podemos não ter uma imagem disponível, vamos usar o lorempixel.com serviço para nos fornecer uma imagem aleatória.
Primeiro precisamos criar a função:
function random_picture($atts) {extract(shortcode_atts(array('width' => 400,'height' => 200,), $atts));return '
';}Nós nomeamos essa função random_picture e, como esse shortcode poderá receber argumentos, atribuímos o parâmetro $ atts . Para usar os atributos, precisamos de duas funções: o shortcode_atts, que é uma função do WordPress que combina nossos atributos com atributos conhecidos e preenche os padrões quando necessário; e a função PHP de extração que, como o nome sugere, extrai os atributos que definimos para o nosso shortcode. Finalmente, a função retorna o valor que queremos, neste caso, o código HTML para a nossa imagem, combinado com as variáveis width e height.
A única coisa que resta a fazer é registrar este shortcode:
add_shortcode('picture', 'random_picture');Nosso shortcode está completo, quando digitamos [picture] ele nos dará uma imagem aleatória de 400 por 200, e se usarmos os atributos podemos criar uma imagem de qualquer tamanho que nos agrade.
Conclusão
Criar pequenos códigos de acesso para coisas que usamos com freqüência definitivamente nos ajuda a escrever posts, porque você pode fazer o que quiser com shortcodes, pode ser tão simples quanto retornar uma frase ou tão complexo quanto adicionar um formulário ou as últimas mensagens classificadas por mês.
Você criou códigos de acesso úteis para o WordPress? Que códigos de acesso você desejava que existissem? Deixe-nos saber nos comentários.
Imagem em destaque / miniatura, imagem de código via Marjan Krebelj.