Criar shortcode com arquivo de estrutura externa

Com este código é possível trazer o conteúdo de um arquivo PHP dentro do seu tema, como um template, para estruturar seu shortcode.

1° Editar arquivo functions.php

Abra o arquivo functions.php do seu tema, e adicione o código abaixo para poder manipular arquivos dentro do seu shortcode.

// RETORNAR ARQUIVOS PARA SHORTCODE
function brnn_theme_return_file($file, $attrs="") {
	ob_start();
	$html;
	$html .= include($file.".php");
	$html = ob_get_clean();
	return $html;
}

2° Criar um shortcode

Ainda dentro do arquivo functions.php, vamos adicionar o código abaixo para criar um shortcode, e vamos usar nossa função customizada, criada no passo anterior.

function brnn_theme_shortcode_teste($attrs) {
	return brnn_theme_return_file("custom_shortcode/arquivo_teste", $attrs);
}
add_shortcode("brnn_theme_shortcode_teste", "brnn_theme_shortcode_teste");

3° Criando arquivo

No exemplo acima, eu criei a função brnn_theme_shortcode_teste e dentro dela estou retornando a função brnn_theme_return_file, onde passo um parâmetro personalizado chamado “custom_shortcode/arquivo_teste” que vai ser o caminho do meu arquivo.

Vou criar dentro da raiz do meu tema wordpress, a pasta “custom_shortcode“, e dentro dela um arquivo chamado “arquivo_teste.php“.

Note que na função, não preciso digitar “.php” no caminho do arquivo.

Outra informação relevante é que passo uma variável chamada $attrs, ela pode ser usada para passar informações dentro do shortcode para nosso arquivo.

4° Editando arquivo arquivo_teste.php

Dentro deste arquivo, posso colocar qualquer código HTML, PHP, CSS, JS que eu quiser.

Assim que editar, salve.

5° obtendo os resultados

Agora que esta tudo feito, você pode chamar o shortcode deste exemplo dentro de qualquer pagina wordpress.

Para chamar é só usar o trecho [brnn_theme_shortcode_teste], ou caso queira passar algum parâmetro, faça [brnn_theme_shortcode_teste cor="azul" numero="99"].

DICA:

Para que seu arquivo consiga usar esses parâmetros, dentro do arquivo que criamos ( arquivo_teste.php ) você pode adicionar o código:

<p>A cor obtida é: <?= $attrs['cor'] ?>, e o numero é <?= $attrs['numero'] ?></p>