Como “escapar” um shortcode no WordPress

Houve quem me perguntasse como consegui “escapar” (escape) um shortcode no WordPress no artigo em que falei sobre o plugin “WM jqMath” – “Como usar o jqMath no WordPress“. Por isso, decidi escrever este pequeno artigo sobre este assunto.

Já nas linguagens de programação, existem os chamados “escape characters” para introduzir símbolos que são reservados. Por exemplo, na linguagem JAVA as aspas (“”) são delimitadoras de “strings” (cadeias de caracteres). Para poder introduzir uma “aspa” dentro de uma string é necessário usar o um “escape character“. Por exemplo:

String a = "Como introduzir um \"escape character\" numa string";

O símbolo “\” é um “escape character” e permite, neste exemplo, colocar aspas dentro de uma string.

E no WordPress com shortcodes?

A forma oficial de o fazer é colocando dois parêntesis rectos de cada lado. Por exemplo: [[shortcode]] irá exibir [shortcode].

Neste caso nada acontece ao colocar apenas “[shortcode]” pois não temos nenhum plugin que renderize um “shortcode” chamado “shortcode“…

Para fazer a demonstração de como introduzir um shortcode válido vou usar 3 parêntesis rectos em cada lado no editor do artigo (o leitor verá 2):

[[jqmath expr="\$\$y={-b±√{b^2-4ac}}/{2a}\$\$" style="color: navy; font-size: 14pt"]]

Mas o que o leitor vê acima é o que introduzi no artigo para mostrar o shortcode em si, com o resultado:

[jqmath expr="\$\$y={-b±√{b^2-4ac}}/{2a}\$\$" style="color: navy; font-size: 14pt"]

Existem também sugestões para colocar os códigos HTML que renderizam estes parêntesis:

• [ para [
• ] para ]

Porém, estes códigos só funcionam no modo de edição em “Text”, ou seja, em HTML. Não aconselho esta prática pois, se comutar o modo de edição para “Visual” o WordPress irá trocar estes símbolos respectivos [ e ] e o artigo irá renderizar o shortcode.

Este artigo foi escrito de acordo com a antiga grafia.