Como criar códigos de acesso para WordPress e trabalhar com eles

Os atalhos do WordPress são pequenas tags usadas como atalhos para executar recursos específicos em postagens e páginas. Você pode reconhecer códigos de acesso por colchetes que circundam uma palavra ou frase simples. Eles foram introduzidos na versão 2.5 com a missão de ajudar as pessoas a executar funções de maneira fácil.

Como você já deve saber, o WordPress usa a linguagem de programação PHP para se potencializar. Portanto, quando você quiser adicionar um recurso específico diretamente a postagens e páginas, terá que escrever o código no editor de texto. Em vez disso, os códigos de acesso permitem que os usuários substituam todo o bloco de código por um termo simples e o executem apenas publicando uma postagem. Incrível, não é?

Como usar os códigos de acesso do WordPress

Para usar códigos de acesso, não é necessário saber como codificar ou entender como eles funcionam no back-end. O próprio WordPress, assim como a maioria dos temas e plug-ins do WordPress, usa diferentes códigos de acesso para permitir o uso de muitos recursos avançados.

Por exemplo, para exibir toda a galeria de imagens, basta usar o shortcode [galeria] que vem instalado com o WordPress. A maioria dos códigos de acesso podem ser usados ​​em sua forma básica, como no exemplo anterior.

Parâmetros de shortcode

Na maioria das vezes, os códigos de acesso podem ter parâmetros adicionais . Ao adicionar informações extras a eles, você pode personalizar e alterar a saída. Por exemplo, embora o shortcode trivial [galeria] exiba todas as imagens que estão anexadas à postagem, é possível mudar isso. O shortcode da galeria permite que você especifique imagens por seu ID para que você possa mostrar apenas as imagens específicas ou até mesmo incluir imagens que não fazem parte daquela postagem específica.

Além disso, é possível definir o tamanho da galeria e muitas outras coisas, fornecendo parâmetros adicionais. Aqui está um exemplo:

A galeria deste exemplo mostraria apenas imagens com números de identificação especificados. Nesse caso, o tamanho seria alterado automaticamente para médio. E você consegue tudo isso com um simples código de acesso. Agora imagine como seria a coisa toda se você fosse adicionar manualmente o código PHP, que teria dezenas, senão centenas de linhas. Obrigado, códigos de acesso!

Tags de início e fim

Por exemplo, um plugin do Google Maps pode permitir que você exiba uma localização nos mapas por meio do código de acesso. A maioria desses plug-ins terá tags de início e fim, enquanto o endereço deve ser escrito no meio. Aqui está um exemplo:

[[maps]] Nova York, EUA [[/ maps]]

Como você pode ver no exemplo, a tag de finalização sempre começa com um sinal de barra “/”. Por ter ambas as tags, o WordPress pode identificar as partes dos códigos de acesso mais facilmente.

Trabalhe no editor de texto

Embora sejam apenas atalhos para funções, os códigos de atalho são, na verdade, criptogramas específicos do WordPress por conta própria. Portanto, se você tentar escrever um shortcode no editor visual, o WordPress mostrará imediatamente a saída (ou apenas o espaço reservado) desse shortcode. Se você seguir o exemplo da galeria e escrever o shortcode no editor Visual, verá que o WordPress imediatamente exibiu seu conteúdo (veja a primeira imagem neste post para ver como isso funciona).

Códigos de acesso padrão do WordPress

Os shortcodes geralmente são gerenciados por temas e plug-ins. Cada desenvolvedor pode registrar códigos de acesso por conta própria, então cada um é diferente. O que um shortcode faz, quais são seus parâmetros e funções, depende exclusivamente do plugin e tema específicos que você está usando.

Por exemplo, um plugin que ajuda a exibir uma localização no Google Maps pode ter [[maps]] shortcode, um que exibe formulários de inscrição usará [[form]] e assim por diante.

Porém, o WordPress vem com um conjunto de códigos de acesso padrão que você pode usar sem instalar extensões adicionais. Por padrão, estes são códigos de acesso com os quais você pode trabalhar:

Códigos de acesso de escape (exibir o texto dos códigos de atalho sem executá-lo)

Às vezes, você pode desejar exibir um texto que representa um código de acesso em vez de executá-lo. Se você tentou adicionar um shortcode tanto para os editores de texto quanto para os editores visuais, percebeu que ele foi executado nas duas ocasiões.

Se você quiser exibir um shortcode com tags de início e fim, use apenas o primeiro e o último colchetes duplos: [[maps] New York, USA [/ maps]]

Ao trabalhar no editor de texto, você também pode substituir os colchetes por seus códigos. Portanto, em vez de “[” você pode usar “& # 91;”, e em vez de “]” usar “& # 93;”. Por exemplo: & # 91; shortcode & # 93 ; irá exibir o shortcode também sem executá-lo.

Como criar um shortcode simples

Quando você escreve artigos no WordPress diariamente, há momentos em que você se repete e precisa digitar algo continuamente. Não importa se é um URL de site, uma frase longa ou talvez um pedaço de código HTML que você constantemente escreve do zero, você deve considerar escrever um código curto para ele.

E com esta função simples, você não precisa ser um programador ou nem mesmo contratará um para simplificar as coisas para você. Siga as próximas etapas e crie um código de acesso personalizado:

1. Abra o arquivo function.php no menu Aparência -> Editor
2. Coloque o seguinte código no final do arquivo:

 function fsg_shortURL () {
 return 'http://www.firstsiteguide.com';
 }
 add_shortcode ('fsg', 'fsg_shortURL');

3. Vá para o Editor de Texto e digite [fsg] para obter o URL em vez do código curto

Não foi tão difícil, certo?

Exemplo mais avançado: Adicionar código curto de imagem

Colocando o seguinte código no functions.php, você pode criar o shortcode para colocar uma imagem com atributos personalizados de largura e altura:

1. Vá para o arquivo functions.php
2. Cole o seguinte código:

 function img_shortcode ($ atts, $ content = null) {

	extrair (shortcode_atts (
		variedade(
			'largura' => '',
			'altura' => '',
		), $ atts)
	);
Retorna '';
}
add_shortcode ('img', 'img_shortcode');

3. Abra o Editor de Texto:

Aqui você pode usar [img width = 'x' height = 'y'] http: //… [/ img] shortcode onde “x” e “y” são números que representam largura e altura em pixels.

Você pode adicionar facilmente outros atributos de imagem, se precisar; confira a lista de todos os atributos de imagem no W3 Schools.

Como usar códigos de acesso no widget de texto

Os códigos curtos podem conter diferentes funcionalidades que você pode adicionar ao seu site WordPress. Independentemente de você ter criado um para você mesmo ou vir com um tema ou plugin que acabou de instalar, provavelmente usará códigos de acesso o tempo todo. Como você pode realmente economizar tempo e se beneficiar deles, não há razão para não usar códigos de acesso.

Se você acabou de começar a construir seu site WordPress, pode ter usado códigos de acesso apenas no editor de postagem. Mas, a verdade é que você pode usar códigos de acesso em praticamente qualquer lugar .

Por exemplo, se você estiver usando o plug-in 5sec do Google Maps PRO, que permite criar mapas sem esforço com inúmeros pinos nele, você pode inserir o mapa por meio de um código de acesso diretamente em seu widget de texto e mostrar sua localização na barra lateral em vez de um único publicar. Mas se o seu tema não suportar códigos de acesso em widgets, você precisará habilitar a função sozinho e é isso que mostraremos neste artigo.

Se você precisa usar um shortcode em seus arquivos PHP (por exemplo, se você deseja executar o código em seu arquivo header.php e executar o shortcode onde quer que o cabeçalho esteja presente), você pode fazer isso facilmente envolvendo o código em torno dele . Mas se você tentou usar um shortcode em seu widget de texto como no exemplo que mencionamos acima, você acabou decepcionado porque isso simplesmente não funciona e o widget exibiu o shortcode em vez de seu conteúdo. A menos que seu tema já tenha o recurso registrado, você precisará habilitá-lo por conta própria.

Portanto, se você deseja inserir um código de acesso em um widget de texto e executá-lo, não se preocupe; você pode fazer isso acontecer em questão de segundos:

1. Abra functions.php
2. Copie e cole as duas linhas a seguir:

 add_filter ('widget_text', 'shortcode_unautop');
 add_filter ('widget_text', 'do_shortcode');

3. Salvar alterações

Embora seja suficiente usar apenas a segunda linha que faz o shortcode funcionar, você vai querer a primeira linha para evitar a inserção automática de parágrafos e tags de quebra do WordPress, onde você inconscientemente cria quebras de linha formatando o texto em um widget . Apenas no caso de você colocar um shortcode em uma linha separada, o unautop removerá as tags de parágrafo e o shortcode funcionará perfeitamente .

Agora você pode navegar até Aparência -> Widgets e arrastar o Widget de Texto para onde quiser. Depois de tudo isso, quando você escreve um shortcode diretamente em seu widget de texto (que está registrado em seu site, é claro), ele será executado exatamente como foi digitado no editor de postagem.

Da mesma forma, você pode executar o código PHP de seu widget de texto. Foi muito fácil, não foi? Aproveite seus códigos de acesso.

Os códigos curtos estão em toda parte

Se você está apenas começando um blog WordPress, os códigos de acesso podem parecer redundantes e difíceis de entender. Na maioria das vezes, será possível evitar códigos de acesso usando uma interface amigável fornecida por um plug-in. Mas quando você se envolver mais com o blog e começar a usar mais plug-ins, entenderá o verdadeiro poder dos códigos de acesso.

Usá-los se tornará uma rotina e você rapidamente se acostumará a escrever colchetes em cada nova postagem que criar. Portanto, dedique alguns minutos e use este artigo para aprender o básico.