--- title: "Como usar shortcodes no WordPress em 5 passos" description: "Um shortcode é uma macro entre colchetes que o WordPress troca por conteúdo dinâmico quando a página carrega, e saber como usar shortcodes no WordPress." url: https://full.services/usar-shortcodes-wordpress/ date: 2026-06-27 author: "Clayton Margiotti" --- # Como usar shortcodes no WordPress em 5 passos Saber **como usar shortcodes no WordPress** é colar um código entre colchetes que vira conteúdo dinâmico. Segundo o [W3Techs](https://w3techs.com/technologies/details/cm-wordpress) (2026), o WordPress roda 41,5% dos sites da web. O callback precisa usar return, nunca echo. Use os nativos, plugins ou crie o seu. Um shortcode é uma macro entre colchetes que o WordPress troca por conteúdo dinâmico quando a página carrega, e saber como usar shortcodes no WordPress economiza HTML repetido em cada post. Ele serve para inserir uma galeria, um formulário ou um vídeo com uma linha de texto. Neste guia você vai entender o que é o recurso, ver os shortcodes nativos, aprender a inserir em posts e widgets, criar o seu próprio com `add_shortcode` no `functions.php` e usar tudo dentro do bloco do Gutenberg. Para uma visão dos plugins que ampliam esse recurso, o hub de [plugins úteis para WordPress](https://full.services/plugins-wordpress/) reúne as opções testadas pela FULL. O caminho é didático e vale tanto para quem usa o editor clássico quanto para quem já migrou para os blocos. --- ## Primeiros passos: O que é um shortcode e onde ele funciona Um shortcode é um marcador entre colchetes que o WordPress processa por um filtro antes de exibir a página, devolvendo HTML no lugar do código. O recurso é nativo desde a versão 2.5, de , e funciona em qualquer tema, sem depender de plugin externo. A tabela abaixo resume os três cenários de uso que este tutorial cobre, do mais simples ao que exige código. Cada linha responde uma dúvida prática de quem está começando.
Como usar shortcodes no WordPress: cenários, onde aplicar e nível
Cenário Onde se aplica Nível exigido
Shortcode nativo Posts, páginas e widgets, sem instalar nada Iniciante
Plugin de shortcode Biblioteca pronta de botões, abas e colunas Iniciante
Shortcode próprio functions.php do tema ou plugin de snippets Intermediário
Os três funcionam no mesmo lugar: onde o WordPress aceita conteúdo, o shortcode é interpretado. A diferença está em quem fornece o código por trás do colchete. --- ## Os shortcodes nativos do WordPress e como inseri-los O WordPress traz seis shortcodes nativos prontos para uso, sem plugin nenhum: `[gallery]`, `[caption]`, `[audio]`, `[video]`, `[playlist]` e `[embed]`. Para inserir, você abre um post, digita o marcador entre colchetes no corpo do conteúdo e publica; o site troca o código pelo resultado quando a página carrega. No editor clássico, basta colar o texto; no Gutenberg, o ideal é usar o bloco Shortcode dedicado, que você adiciona pelo menu de blocos. O `[gallery]` é o mais conhecido e aceita atributos como `ids="12,34,56"` para escolher imagens específicas e `columns="3"` para definir a grade. Esses atributos sempre chegam em minúsculas ao processador, então `[gallery IDS="12"]` é lido como `ids`. Se você ainda organiza barras laterais, vale revisar [como adicionar e usar widgets no WordPress](https://full.services/como-adicionar-e-usar-widgets-no-wordpress/), porque widgets e shortcodes se cruzam o tempo todo. --- ## Como inserir um shortcode em posts, páginas e widgets Inserir um shortcode leva menos de 1 minuto e o processo muda conforme o local. Em posts e páginas, o caminho é digitar o código entre colchetes no editor e salvar; o WordPress troca o marcador pelo conteúdo quando alguém abre a URL. Em widgets, desde a versão 4.9, de , a área de widgets processa shortcodes automaticamente, então você cola o código num widget de texto ou HTML e ele renderiza igual a um post. Em menus e títulos o recurso não roda por padrão, o que evita brechas de segurança. Esse comportamento é o mesmo que o WordPress aplica aos antigos [códigos de acesso no WordPress](https://full.services/dicas-para-usar-codigos-de-acesso-no-wordpress/), o termo em português para shortcode que você ainda encontra em conteúdos mais antigos.

Legenda: o bloco Shortcode dedicado evita que o código seja escapado como texto comum.

--- ## Plugins de shortcode: Bibliotecas prontas para quem não escreve código Plugins de shortcode entregam dezenas de marcadores prontos para quem não escreve código, e o Shortcodes Ultimate lidera a categoria com mais de 600 mil instalações ativas no repositório oficial. Ele adiciona botões, abas, colunas responsivas, contadores e caixas de destaque, todos acionados por um shortcode visual. Outros nomes fortes são o Woody Code Snippets, voltado a quem cria os próprios marcadores, e o Shortcoder, que transforma blocos de HTML em shortcodes reutilizáveis. A vantagem é velocidade: você instala, escolhe o componente e cola o código. A desvantagem aparece quando o plugin some, porque os shortcodes deixam de funcionar e o texto bruto fica exposto no post. Por isso a FULL recomenda registrar no [editor de CSS direto do painel WordPress](https://full.services/como-editar-o-css-direto-do-painel-wordpress/) só o que for visual, e reservar shortcodes para conteúdo que precisa de lógica. --- ## Passo a passo: Criar seu próprio shortcode com add_shortcode Criar um shortcode próprio exige apenas 1 função em PHP e a chamada `add_shortcode`, que tem a assinatura oficial `add_shortcode( string $tag, callable $callback )`. Segundo a documentação para desenvolvedores do [WordPress](https://developer.wordpress.org/reference/functions/add_shortcode/) (2026), o callback recebe 3 argumentos e deve sempre retornar o texto, nunca usar echo para imprimir. O callback recebe `$atts`, `$content` e o nome da tag, e o motivo do return é simples: o shortcode age como um filtro, então imprimir direto joga a saída para fora do lugar. Os três passos abaixo cobrem o registro mínimo seguro. Cada passo é um bloco de código que você cola no `functions.php` do tema filho ou em um plugin de snippets como o Code Snippets. ### Passo 1: Escreva a função de callback em PHP Crie uma função que monte o HTML e o devolva com return. O nome da tag não pode ter espaços nem os caracteres reservados `< > & / [ ] =`, e o ideal é prefixar para evitar colisão com outro plugin. Um exemplo simples que devolve o ano atual fica assim: `function full_ano_atual() { return date('Y'); }`. Repare que a função termina com return, não com echo, porque imprimir direto jogaria o valor para o topo da página, fora do parágrafo onde o código aparece. ### Passo 2: Registre a função com add_shortcode Conecte a função a uma tag com `add_shortcode('ano', 'full_ano_atual');`. A partir daí, escrever `[ano]` em qualquer post exibe o ano corrente. Como existe apenas um gancho por shortcode, se outro plugin registrar a mesma tag `ano`, o último registro vence e sobrescreve o seu. Por isso o prefixo no nome da função e numa tag mais específica, como `[full_ano]`, reduz o risco de conflito em sites com muitos plugins. ### Passo 3: Use atributos com shortcode_atts Para aceitar parâmetros, leia o array `$atts` e defina padrões com `shortcode_atts`. Assim `[saudacao nome="Ana"]` passa a chave `nome` para sua função, sempre em minúsculas. A função `shortcode_atts` mescla os atributos enviados com os padrões que você definir, evitando erro quando o usuário esquece um parâmetro. Quem prefere uma interface visual em vez de PHP pode gerar marcadores parecidos com o [criar shortcodes customizados com o JetEngine](https://full.services/criar-shortcodes-customizados-com-jetengine/), que monta a lógica sem escrever a função na mão.

Legenda: a chamada add_shortcode liga a tag à função de callback que retorna o conteúdo.

--- ## Como usar shortcodes no bloco do Gutenberg sem quebrar a renderização No Gutenberg, o jeito certo de usar shortcodes é por 1 bloco específico, o bloco Shortcode, e não pelo bloco de código, porque os dois tratam os colchetes de forma oposta. O bloco Shortcode processa o marcador e devolve o HTML final; o bloco Código exibe os colchetes como texto literal na tela. Para adicionar, clique no ícone de mais, busque por Shortcode e cole o marcador dentro. Um sintoma comum no suporte da FULL é o shortcode que some depois da migração do editor clássico para o Gutenberg: na maioria dos casos o texto caiu dentro de um bloco Parágrafo que escapou os colchetes, e mover o conteúdo para o bloco Shortcode restaura a saída sem tocar no código. Quem quer entender melhor a lógica de blocos pode ler [o editor de blocos Gutenberg do WordPress](https://full.services/wordpress-block-editor-gutenberg/) antes de seguir. --- ## Por que usar a plataforma FULL para gerenciar plugins de shortcode Manter plugins de shortcode atualizados em vários sites consome tempo, e a plataforma FULL entra como alternativa de gestão no plano PRO, por R$849 ao ano, com ativação em 1 clique dos plugins premium da curadoria em até 10 sites. Diluído pela base, isso dá R$85 por site. A gente vê no suporte que boa parte dos sites que perdem um shortcode na tela estava com plugin desatualizado ou desativado por engano, e a ativação central reduz esse risco. Conheça os planos em [FULL.services/planos](https://full.services/planos) e compare com o custo de licenciar cada plugin de forma avulsa. --- --- ## Perguntas frequentes sobre shortcodes no WordPress
O que é um shortcode no WordPress e para que serve?

Um shortcode é uma macro entre colchetes, como `[gallery]`, que o WordPress troca por conteúdo dinâmico quando a página carrega. Ele serve para inserir galerias, vídeos, formulários ou botões sem repetir HTML em cada post. O recurso é nativo desde a versão 2.5 de 2008 e funciona em qualquer tema, em posts, páginas e widgets de texto.

Por que um shortcode aparece como texto puro em vez de renderizar?

O shortcode vira texto puro quando o plugin que o criou foi desativado ou quando o marcador caiu num bloco de código no Gutenberg. Sem o plugin registrado, o WordPress não reconhece a tag e exibe os colchetes literais. A correção é reativar o plugin responsável ou mover o conteúdo para o bloco Shortcode dedicado, que processa o marcador corretamente.

É possível criar um shortcode próprio sem instalar nenhum plugin?

Sim, é possível criar um shortcode próprio só com PHP, usando a função `add_shortcode` no arquivo `functions.php` do tema filho. Você escreve uma função que retorna o HTML com return, nunca echo, e registra a tag com `add_shortcode('ano', 'sua_funcao')`. Nenhum plugin é necessário, mas um tema filho evita perder o código numa atualização do tema.

Qual a diferença entre o bloco Shortcode e o bloco de código no Gutenberg?

A diferença é que o bloco Shortcode processa o marcador e devolve o HTML final, enquanto o bloco Código exibe os colchetes como texto literal na tela. Para ver o resultado de um `[gallery]`, use o bloco Shortcode; o bloco Código serve só para mostrar o código-fonte ao leitor. Trocar um pelo outro é a causa mais comum de shortcode que não renderiza.

Quanto custa usar shortcodes em um site WordPress?

Usar shortcodes nativos e criar os seus com `add_shortcode` é gratuito, porque o recurso faz parte do núcleo do WordPress. O custo só aparece se você optar por plugins premium de shortcode. No bundle da FULL, o plano PRO sai por R$849 ao ano para até dez sites, o que equivale a R$85 por site, ante o licenciamento avulso de cada plugin.

--- ## Próximos passos para dominar shortcodes no WordPress Dominar shortcodes no WordPress significa saber escolher entre os três caminhos conforme a necessidade: o nativo resolve galerias e mídia, o plugin entrega uma biblioteca pronta de componentes visuais e o `add_shortcode` no `functions.php` dá controle total quando você precisa de lógica própria. Comece pelos nativos, avance para um plugin como o Shortcodes Ultimate e, quando o site exigir algo sob medida, escreva a função em um tema filho ou plugin de snippets para não perder o código numa atualização. Para continuar aprendendo, o guia [os melhores plugins para WordPress](https://full.services/guias/os-melhores-plugins-para-wordpress) reúne tutoriais e reviews num só lugar, e o [FULL Academy](https://full.services/academy/) organiza o conteúdo por trilha. Com o bloco Shortcode do Gutenberg e o cuidado de sempre retornar do callback, você evita os dois erros que mais geram chamado: o marcador escapado e a saída fora do lugar. --- ## Metadados Estruturados (Schema.org) ```json-ld { "@context": "https://schema.org", "@graph": [ { "@type": "TechArticle", "@id": "https://full.services/usar-shortcodes-wordpress/#article", "headline": "Como usar shortcodes no WordPress em 5 passos", "description": "Um shortcode é uma macro entre colchetes que o WordPress troca por conteúdo dinâmico quando a página carrega, e saber como usar shortcodes no WordPress economiza HTML repetido em cada post.", "url": "https://full.services/usar-shortcodes-wordpress/", "datePublished": "2026-06-27T09:00:00-03:00", "dateModified": "2026-06-27T09:00:00-03:00", "inLanguage": "pt-BR", "articleSection": "Plugins WordPress", "keywords": [ "como usar shortcodes no wordpress", "WordPress Plugins", "WordPress Tools", "Plugin Development" ], "author": { "@id": "https://full.services/#person-clayton" }, "publisher": { "@id": "https://full.services/#org" }, "about": [ { "@type": "Thing", "name": "WordPress Plugins" }, { "@type": "Thing", "name": "WordPress Tools" }, { "@type": "Thing", "name": "Plugin Development" } ], "mentions": [ { "@type": "Organization", "name": "WordPress", "url": "https://wordpress.org/", "@id": "https://www.wikidata.org/wiki/Q13166", "sameAs": "https://www.wikidata.org/wiki/Q13166" } ], "mainEntityOfPage": { "@type": "WebPage", "@id": "https://full.services/usar-shortcodes-wordpress/" }, "wordCount": 2178, "citation": [ { "@type": "CreativeWork", "name": "W3Techs", "url": "https://w3techs.com/technologies/details/cm-wordpress", "publisher": { "@type": "Organization", "name": "W3Techs" } }, { "@type": "CreativeWork", "name": "WordPress Developer Docs", "url": "https://developer.wordpress.org/reference/functions/add_shortcode/", "publisher": { "@type": "Organization", "name": "WordPress Developer Docs" } } ] }, { "@type": "FAQPage", "@id": "https://full.services/usar-shortcodes-wordpress/#faq", "isPartOf": { "@id": "https://full.services/usar-shortcodes-wordpress/#article" }, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/usar-shortcodes-wordpress/#faq-q1", "name": "O que é um shortcode no WordPress e para que serve?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Um shortcode é uma macro entre colchetes, como `[gallery]`, que o WordPress troca por conteúdo dinâmico quando a página carrega. Ele serve para inserir galerias, vídeos, formulários ou botões sem repetir HTML em cada post. O recurso é nativo desde a versão 2.5 de 2008 e funciona em qualquer tema, em posts, páginas e widgets de texto.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/usar-shortcodes-wordpress/#faq-q2", "name": "Por que um shortcode aparece como texto puro em vez de renderizar?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "O shortcode vira texto puro quando o plugin que o criou foi desativado ou quando o marcador caiu num bloco de código no Gutenberg. Sem o plugin registrado, o WordPress não reconhece a tag e exibe os colchetes literais. A correção é reativar o plugin responsável ou mover o conteúdo para o bloco Shortcode dedicado, que processa o marcador corretamente.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/usar-shortcodes-wordpress/#faq-q3", "name": "É possível criar um shortcode próprio sem instalar nenhum plugin?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Sim, é possível criar um shortcode próprio só com PHP, usando a função `add_shortcode` no arquivo `functions.php` do tema filho. Você escreve uma função que retorna o HTML com return, nunca echo, e registra a tag com `add_shortcode('ano', 'sua_funcao')`. Nenhum plugin é necessário, mas um tema filho evita perder o código numa atualização do tema.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/usar-shortcodes-wordpress/#faq-q4", "name": "Qual a diferença entre o bloco Shortcode e o bloco de código no Gutenberg?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "A diferença é que o bloco Shortcode processa o marcador e devolve o HTML final, enquanto o bloco Código exibe os colchetes como texto literal na tela. Para ver o resultado de um `[gallery]`, use o bloco Shortcode; o bloco Código serve só para mostrar o código-fonte ao leitor. Trocar um pelo outro é a causa mais comum de shortcode que não renderiza.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/usar-shortcodes-wordpress/#faq-q5", "name": "Quanto custa usar shortcodes em um site WordPress?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Usar shortcodes nativos e criar os seus com `add_shortcode` é gratuito, porque o recurso faz parte do núcleo do WordPress. O custo só aparece se você optar por plugins premium de shortcode. No bundle da FULL, o plano PRO sai por R$849 ao ano para até dez sites, o que equivale a R$85 por site, ante o licenciamento avulso de cada plugin.", "author": { "@id": "https://full.services/#org" } } } ] }, { "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://full.services/" }, { "@type": "ListItem", "position": 2, "name": "Plugins WordPress", "item": "https://full.services/plugins-wordpress/" }, { "@type": "ListItem", "position": 3, "name": "Como usar shortcodes no WordPress em 5 passos", "item": "https://full.services/usar-shortcodes-wordpress/" } ] }, { "@type": "Organization", "@id": "https://full.services/#org", "name": "FULL Services", "url": "https://full.services", "logo": { "@type": "ImageObject", "url": "https://full.services/wp-content/uploads/full-services-logo.png", "width": 200, "height": 60 }, "sameAs": [ "https://www.instagram.com/fullservicesbr", "https://www.facebook.com/fullservices.br", "https://www.linkedin.com/company/fullservicesbr/" ], "knowsAbout": [ "WordPress", "WordPress Hosting", "Web Development", "Performance Optimization", "WordPress Security", "SEO para WordPress" ], "award": [ "Gold Medal - The WP Weekly Awards 2023 (https://thewpweekly.com/awards-2023/)", "Gold Medal - The WP Weekly Awards 2024 (https://thewpweekly.com/awards-2024/)" ], "hasCredential": { "@type": "EducationalOccupationalCredential", "credentialCategory": "certification", "name": "CVE Numbering Authority (CNA)", "description": "Autoridade de numeração de vulnerabilidades (CVE) para o ecossistema WordPress, autorizada a atribuir IDs CVE. Certificação válida desde 2022-05-03, com abrangência global.", "url": "https://www.cve.org/PartnerInformation/ListofPartners/partner/FULL", "recognizedBy": { "@type": "Organization", "name": "CISA — Cybersecurity and Infrastructure Security Agency", "url": "https://www.cisa.gov/", "sameAs": "https://www.cisa.gov/" } } }, { "@type": "Person", "@id": "https://full.services/#person-clayton", "name": "Clayton Margiotti", "givenName": "Clayton", "familyName": "Margiotti", "jobTitle": "Fundador e CEO da FULL Services", "description": "Fundador e CEO da FULL Services, plataforma WordPress SaaS com 50 mil clientes e 150 mil sites conectados, e anchor do ecossistema Elevor Global. Em 2024 conduziu a FULL a se tornar a primeira e unica empresa brasileira aprovada como CVE Numbering Authority sob a CISA (DHS/EUA). Mais de 20 anos construindo empresas digitais, com 13+ reconhecimentos internacionais (Facebook, GPTW, ONU, RD Summit).", "url": "https://full.services/sobre-nos/", "image": "https://full.services/wp-content/uploads/2026/05/clayton-margiotti.jpg", "sameAs": [ "https://www.linkedin.com/in/cmargiotti/" ], "knowsAbout": [ "Artificial Intelligence", "Cybersecurity", "CVE Program", "WordPress Enterprise", "SaaS Platforms", "Digital Infrastructure", "Technology Entrepreneurship", "Company Building", "Business Leadership", "Digital Growth" ], "hasOccupation": { "@type": "Occupation", "name": "Fundador e CEO", "occupationalCategory": "11-1011.00" }, "knowsLanguage": [ { "@type": "Language", "name": "Portuguese", "alternateName": "pt-BR" }, { "@type": "Language", "name": "English", "alternateName": "en" } ], "memberOf": { "@type": "Organization", "name": "CVE Numbering Authorities", "url": "https://www.cve.org/", "sameAs": "https://www.cve.org/" }, "alumniOf": [ { "@type": "EducationalOrganization", "name": "Global Scaling Academy (Blitzscaling Program)", "url": "https://www.blitzscalingacademy.com" }, { "@type": "EducationalOrganization", "name": "Esade", "url": "https://www.esade.edu" }, { "@type": "EducationalOrganization", "name": "Business School Sao Paulo (BSP)", "url": "https://bsp.edu.br/" }, { "@type": "EducationalOrganization", "name": "Tera", "url": "https://somostera.com" }, { "@type": "EducationalOrganization", "name": "Le Wagon", "url": "https://www.lewagon.com" }, { "@type": "EducationalOrganization", "name": "FIAP", "url": "https://www.fiap.com.br" }, { "@type": "EducationalOrganization", "name": "PUCRS", "url": "https://online.pucrs.br/" } ], "award": [ "Digital Disruptor – Engaging Experiences Master (Globant, 2021)", "Maior ROI do e-commerce brasileiro – Letrissimas (Facebook, 2019)", "1º lugar – Melhores Empresas para Trabalhar no Brasil – Eleva Digital (Great Place to Work, 2018)", "Case global de educacao no Facebook – Metodo SUPERA (Facebook, 2017)", "Maquina de Geracao de Leads, Agencia do Ano (RD Summit / RD Station, 2015)", "Monthly Recurring Revenue, top performance (RD Summit / RD Station, 2015)", "Quality/Efficiency – Entrepreneurship Training (UNCTAD / PNUD-ONU, 2010)" ], "subjectOf": [ { "@type": "NewsArticle", "url": "https://www.globant.com/news/globant-reveals-inaugural-digital-disruptors-award-winners", "publisher": { "@type": "Organization", "name": "Globant" } }, { "@type": "NewsArticle", "url": "https://www.prnewswire.com/news-releases/letrissimas-com-e-destaque-do-e-commerce-brasileiro-com-maior-roi-de-2018-877517801.html", "publisher": { "@type": "Organization", "name": "PR Newswire" } }, { "@type": "NewsArticle", "url": "https://www.segs.com.br/seguros/102599-gestao-de-pessoas-garante-mais-lucro-as-empresas", "publisher": { "@type": "Organization", "name": "Segs" } }, { "@type": "NewsArticle", "url": "https://franquiaeducacional.com/negocios-inovadores-facebook-elege-supera-case-mundial-de-educacao", "publisher": { "@type": "Organization", "name": "Franquia Educacional" } }, { "@type": "NewsArticle", "url": "https://acontecendoaqui.com.br/marketing/resultados-digitais-divulga-vencedores-do-premio-agencias-de-resultados-2015-durante-o-rd", "publisher": { "@type": "Organization", "name": "Acontecendo Aqui" } } ], "worksFor": { "@type": "Organization", "@id": "https://full.services/#org" } }, { "@type": "HowTo", "@id": "https://full.services/usar-shortcodes-wordpress/#howto", "isPartOf": { "@id": "https://full.services/usar-shortcodes-wordpress/#article" }, "name": "Passo a passo: como usar shortcodes no wordpress", "description": "Guia passo a passo sobre como usar shortcodes no wordpress para WordPress.", "url": "https://full.services/usar-shortcodes-wordpress/", "totalTime": "PT18M", "author": { "@type": "Organization", "@id": "https://full.services/#org" }, "step": [ { "@type": "HowToStep", "position": 1, "name": "Passo 1: Escreva a função de callback em PHP", "text": "Crie uma função que monte o HTML e o devolva com return. O nome da tag não pode ter espaços nem os caracteres reservados `< > & / [ ] =`, e o ideal é prefixar para evitar colisão com outro plugin. Um exemplo simples que devolve o ano atual fica assim: `function full_ano_atual() { return date('Y'); }`. Repare que a função termina com return, não com echo, porque imprimir direto jogaria o valor para o topo da página, fora do parágrafo onde o código aparece." }, { "@type": "HowToStep", "position": 2, "name": "Passo 2: Registre a função com add_shortcode", "text": "Conecte a função a uma tag com `add_shortcode('ano', 'full_ano_atual');`. A partir daí, escrever `[ano]` em qualquer post exibe o ano corrente. Como existe apenas um gancho por shortcode, se outro plugin registrar a mesma tag `ano`, o último registro vence e sobrescreve o seu. Por isso o prefixo no nome da função e numa tag mais específica, como `[full_ano]`, reduz o risco de conflito em sites com muitos plugins." }, { "@type": "HowToStep", "position": 3, "name": "Passo 3: Use atributos com shortcode_atts", "text": "Para aceitar parâmetros, leia o array `$atts` e defina padrões com `shortcode_atts`. Assim `[saudacao nome="Ana"]` passa a chave `nome` para sua função, sempre em minúsculas. A função `shortcode_atts` mescla os atributos enviados com os padrões que você definir, evitando erro quando o usuário esquece um parâmetro. Quem prefere uma interface visual em vez de PHP pode gerar marcadores parecidos com o criar shortcodes customizados com o JetEngine, que monta a lógica sem escrever a função na mão.

Legenda: a chamada add_shortcode liga a tag à função de callback que retorna o conteúdo.

--- No Gutenberg, o jeito certo de usar shortcodes é por 1 bloco específico, o bloco Shortcode, e não pelo bloco de código, porque os dois tratam os colchetes de forma oposta. O bloco Shortcode processa o marcador e devolve o HTML final; o bloco Código exibe os colchetes como texto literal na tela. Para adicionar, clique no ícone de mais, busque por Shortcode e cole o marcador dentro. Um sintoma comum no suporte da FULL é o shortcode que some depois da migração do editor clássico para o" } ] } ] } ```