Capa do guia: Blocos Modulares, addon SEOX Publishers para encaixar Parts, Shortcodes e HTML em hooks do tema com seis páginas dedicadas

O portal SEOX Publishers possui diversos pontos estratégicos de inserção espalhados pelo tema, chamados de hooks. Esses pontos funcionam como áreas reservadas onde é possível adicionar conteúdos e componentes extras sem precisar alterar templates ou solicitar mudanças técnicas no tema. Com isso, o portal consegue inserir facilmente elementos como blocos de Mais Lidas, newsletters, vitrines de colunas, embeds, banners, shortcodes personalizados e diversos outros conteúdos em posições específicas do site, como antes do header, dentro de páginas de editoria, no single das matérias ou no rodapé.

A funcionalidade responsável por essa composição é o addon Inserir Elementos (seox-publishers-addon-parts-inserter). No menu lateral do WordPress, ele cria a seção Inserir Elementos, dividida em páginas específicas para diferentes áreas do portal: Home, Geral, Archive, Single, Search e 404. Dentro de cada área, o sistema permite adicionar conteúdos através de três tipos de blocos: Parts, com componentes prontos do tema; Shortcodes, para reutilizar qualquer shortcode válido do WordPress; e HTML, para inserir códigos personalizados, scripts externos e embeds.

Neste tutorial, você aprenderá como acessar a funcionalidade, configurar os componentes disponíveis e organizar os elementos dentro dos hooks do portal. Cada bloco possui opções de posicionamento, prioridade e ordem de exibição, permitindo controlar exatamente onde cada conteúdo será exibido no frontend. Além das configurações comuns, cada componente possui campos específicos relacionados à sua funcionalidade, como período de exibição em blocos de Mais Lidas ou seleção de colunas em vitrines de colunistas.

Como configurar

1 Abra Inserir Elementos e escolha a página
No menu lateral do wp-admin, clique em Inserir Elementos (ícone de página com edit). O sub-menu expande mostrando seis páginas: Home para a página inicial, Geral para header/footer (que aparecem em todo o site), Archive para páginas de editoria e tag, Single para matérias individuais, Search para a página de resultados de busca e 404 para a página de erro. Clique na página onde você quer inserir o bloco. A tela Configurações abre com três abas: Parts, Shortcodes e HTML.

Tela Inicial do Inserir Elementos no wp-admin com submenu lateral expandido mostrando Home, Geral, Archive, Single, Search e 404, e a tela de Configurações com três abas Parts, Shortcodes e HTML, painel Controle de Parts vazio com botão Adicionar Linha

2 Configure uma Linha de Mais Lidas
Na aba Parts, clique em + Adicionar Linha e escolha Mais Lidas no popup. A Linha expande mostrando os campos. Em Part Class, deixe Mais Lidas (default). Em Template, escolha a variação visual: Sidebar Destaque e Lista (formato compacto com um destaque grande e lista numerada), Lista Horizontal ou Cards Compactos. Em Local, escolha Antes (Before) ou Depois (After) do hook que aparecerá no template; Posição define a ordem horizontal dentro do hook e Prioridade controla qual Linha aparece primeiro quando há mais de uma no mesmo lugar (números menores = mais cedo). O grupo Mostrar Hoje / Semana / Mês / Ano define quais janelas temporais o bloco oferece como filtro: deixe os quatro ativados pra dar a opção completa ao leitor, ou desligue períodos que não fazem sentido pro seu portal.

Linha Mais Lidas expandida no Controle de Parts com Part Class Mais Lidas, Template Sidebar Destaque e Lista, Configuração manual desligada, Posição 0, Prioridade 9, Local Antes Before, e os quatro toggles Mostrar Hoje, Mostrar Semana, Mostrar Mês e Mostrar Ano todos ligados em Sim

3 Configure uma Linha de Newsletter
Clique em + Adicionar Linha novamente e escolha Addon Newsletter no popup. A Linha expande com os campos do formulário de captação. Em Part Class, deixe FormDefault (formulário padrão de email). Em Template, escolha o estilo visual: 1. Template Boxed [Background][White] (caixa com fundo branco e borda destacada, ideal pra rodapé de single ou sidebar), e há outras variações como Inline Compacto, Banner Largo. Os campos Configuração manual, Posição, Prioridade e Local funcionam igual ao bloco anterior; ajuste pra colocar o bloco antes ou depois do hook escolhido na sub-página atual.

Linha Addon Newsletter expandida no Controle de Parts com Part Class FormDefault, Template 1 Template Boxed Background White, Configuração manual desligada, Posição 0, Prioridade 9 e Local Antes Before

4 Configure uma Linha de TV
Clique em + Adicionar Linha e escolha Addon TV no popup. A Linha expande com os campos do bloco de vídeos. Em Part Class, deixe SectionSchedulesTemplate (carrossel de programação do canal vinculado ao addon TV). Em Template, escolha parts/grids/section-schedules ou outras variações de grid de vídeos disponíveis. Os campos Posição, Prioridade e Local funcionam igual; Configuração manual permite, se ligado, sobrescrever quais vídeos aparecem em vez de seguir a programação automática do addon TV. Útil pra destacar uma cobertura específica em vez do feed cronológico.

Linha Addon TV expandida no Controle de Parts com Part Class SectionSchedulesTemplate, Template parts grids section-schedules, Configuração manual desligada, Posição 0, Prioridade 9 e Local Antes Before

5 Configure uma Linha de Colunas
Clique em + Adicionar Linha e escolha Addon Columns no popup. A Linha expande mostrando o vínculo com o addon Colunistas. Em Part Class, deixe Grid Colunistas. Em Template, escolha o formato do grid: Grid XS V1 | Mobile Horizontal (grid pequeno otimizado pra mobile, com scroll horizontal), ou variações como Grid Vertical Largo e Lista Compacta. Os campos comuns (Configuração manual, Posição, Prioridade, Local) seguem o padrão. O campo extra Posição da seção de colunas define qual Grid de Colunistas (configurado em Posts > Colunas > Home) este bloco vai espelhar; selecione uma seção de colunas já criada lá pra reaproveitar a fixação manual feita anteriormente.

Linha Addon Columns expandida no Controle de Parts com Part Class Grid Colunistas, Template Grid XS V1 Mobile Horizontal, Configuração manual desligada, Posição 0, Prioridade 9, Local Antes Before e dropdown Posição da seção de colunas com texto Selecione uma seção de colunas

6 Aba Shortcodes: insira shortcodes em qualquer hook
Abra a aba Shortcodes. Em Controle de Shortcodes, clique em + Adicionar Linha e escolha o tipo Shortcode no popup. A Linha expande com dois campos principais: o shortcode em si (cole o código completo, ex: o shortcode gerado pelo addon Gerador de Shortcodes ou qualquer shortcode WordPress válido) e o Hook (a posição no template). Útil pra blocos custom que você criou no Gerador de Shortcodes mas quer que apareçam automaticamente em todas as matérias, em vez de colar manualmente um por um. O toggle Disabled está disponível aqui também.

Aba Shortcodes da tela Configurações com popup Adicionar Linha aberto exibindo a opção Shortcode como única alternativa para inserção de shortcode WordPress em hook do template

7 Aba HTML: insira HTML ou Script personalizado
Abra a aba HTML. Em Controle de HTML, clique em + Adicionar Linha de HTML e escolha HTML ou Script no popup. A Linha expande com um campo de texto livre onde você cola HTML, marcação custom, embed de terceiros (Twitter, Instagram, YouTube), tags script, ou qualquer marcação raw. Esse é o slot mais aberto: serve pra integrar pixels de tracking, banners de campanha externa, widgets de redes sociais, ou qualquer bloco que não cabe nos outros dois tipos. O Hook define onde a marcação é injetada, e o toggle Disabled permite ligar/desligar sem perder o conteúdo.

Aba HTML da tela Configurações com popup Adicionar Linha de HTML aberto exibindo a opção HTML ou Script como tipo de bloco modular para marcação livre customizada

Hooks disponíveis em cada página

Cada sub-página do Inserir Elementos expõe um conjunto diferente de hooks. A escolha do hook é o que determina onde o bloco modular aparece visualmente no frontend.

PáginaHooks principaisQuando usar
HomeHooks dinâmicos definidos por outros addons da homeBanner antes da grid principal, vitrine entre seções
Geralpublisher_before_header, publisher_after_header, publisher_footer_left, publisher_footer_rightBloco que aparece em todo site (alerta sazonal, banner institucional)
Archivepublisher_before_archive, publisher_start_archive, publisher_archive_after_heading, publisher_end_archive, publisher_after_archive, publisher_archive_before_paginationBloco no topo, depois do título da editoria, antes da paginação
Singlepublisher_before_single, publisher_after_singleAntes da matéria (chamada complementar) ou depois (CTA, newsletter, related)
Searchpublisher_archive_before_heading_search, publisher_archive_after_heading_search, publisher_end_archive, publisher_archive_before_paginationAnúncio na página de busca, dica antes dos resultados
404publisher_before_404, publisher_end_404, publisher_after_404Sugestão de matérias relacionadas, busca alternativa

A coluna direita não é prescritiva, é só ilustração: você decide pelo objetivo editorial. O mesmo addon Newsletter pode aparecer no rodapé do Single (captação após leitura), no fim do Archive (captação no scroll), ou no header da Geral (presença máxima); são três Linhas distintas, em três páginas distintas, escolhendo três hooks distintos.

Boas práticas de composição

Use Disabled em vez de deletar. Quando uma campanha sazonal acaba, desative pelo toggle Disabled em vez de remover a Linha. Mantém a configuração arquivada, e reativar pra próxima campanha é um clique. Deletar perde a configuração de hook, parâmetros, tudo.

Ordem importa. Dentro de uma mesma aba, as Linhas são processadas na ordem em que aparecem. Se três Linhas mapeiam pro mesmo hook, a primeira aparece em cima, a última embaixo. Use o handle de drag-and-drop pra reordenar.

Hooks distintos por tipo de página. Não force um Bloco de TV no hook de Single se ele foi desenhado pra Home. O catálogo de hooks por página é editorialmente coerente; respeite a separação. Bloco da página Single = só Single.

Cuidado com peso de página. Cada Linha custa render. Cinco blocos de TV no header da Geral significa cinco vídeos lazy-load em todo o portal. Use moderação, especialmente com vídeo, embed externo e script de terceiros.

Documente a intenção. Não há campo de notas no addon, mas ajuda manter um doc interno listando “qual Linha está em qual página com qual propósito”. Em portais com 30+ Linhas espalhadas, sem catálogo vira floresta de mistérios.

Perguntas frequentes

Onde fica o Inserir Elementos no menu?

No menu lateral principal do wp-admin, com ícone de página e lápis (Dashicons edit-page). Se não aparece, confirme no Seox Store que o addon Parts Inserter está ativo. Sem ele, o sub-menu inteiro some.

Por que existem seis páginas separadas em vez de uma única?

Cada tipo de tela do portal tem hooks próprios. A página Single expõe hooks de matéria; a página Archive expõe hooks de listagem; a Search expõe hooks específicos de resultado de busca. A separação evita confusão (você não tem como inserir um bloco na 404 a partir da página Home, por exemplo) e mantém o catálogo de cada uma enxuto e coerente.

Posso inserir o mesmo bloco em duas páginas?

Sim. Você cria duas Linhas separadas, uma em cada página, escolhendo o hook correspondente. Não há reuso direto entre páginas; cada Linha é independente. Isso é proposital: o mesmo bloco pode pedir Template visual diferente quando aparece em Single versus Archive.

O que acontece se o hook escolhido não existe no template?

A Linha é configurada normalmente, mas no frontend nada renderiza, porque o tema nunca dispara aquele hook nessa página. Cheque a coluna “Hooks principais” da tabela acima ou pergunte ao desenvolvedor do tema se o hook foi customizado.

Posso usar shortcodes do Gerador de Shortcodes aqui?

Sim, esse é um caso de uso clássico. Você cria o shortcode reutilizável no addon Gerador de Shortcodes, copia o código gerado, cola na aba Shortcodes do Inserir Elementos com o hook desejado. O bloco passa a aparecer automaticamente em todas as páginas onde aquele hook existe.

Qual a diferença entre as opções Mais Lidas, Newsletter, TV e Colunas na aba Parts?

Cada uma vem de um addon SEOX específico. Mais Lidas mostra as matérias mais clicadas no portal, com filtros por janela temporal (Hoje, Semana, Mês, Ano). Addon Newsletter vem do addon Newsletters e renderiza o formulário de captação de email. Addon TV vem do addon TV e renderiza um carrossel de vídeos do canal. Addon Columns vem do addon Colunistas e renderiza um grid dos colunistas, espelhando a configuração feita em Posts > Colunas > Home. Se você desativar o addon correspondente, a opção some do popup.

O Disabled apaga ou só esconde?

Só esconde no frontend. A configuração permanece salva no banco. Reativar é um toggle: a Linha volta a renderizar exatamente como estava antes.

Posso aninhar HTML com shortcode dentro?

Sim. O campo HTML aceita marcação raw com shortcodes embutidos; o WordPress processa o shortcode na renderização. Útil pra wrappear um shortcode num div com classe CSS específica, ou condicionar visibilidade via CSS responsive.

Qual a ordem de renderização entre as três abas?

As três abas são processadas independentemente, mas a injeção no hook acontece na ordem: Parts → Shortcodes → HTML. Se você tem três Linhas mapeando pro mesmo hook, todas aparecem no frontend, na ordem das abas.

Tem como agendar uma Linha pra ativar/desativar em data específica?

Não nativamente. O Disabled é manual. Pra agendamento automático, considere usar campos custom no tema com lógica condicional ou um cron com WP-CLI. Pra campanhas com janela definida, use cuidado pra não esquecer o toggle ligado.

Onde testar antes de publicar pra todo o site?

Não há sandbox dentro do addon. A boa prática é configurar primeiro num staging, validar no frontend (lembrando de limpar cache de página WP Rocket e CDN), e só depois replicar em produção. Use Disabled ligado durante testes em produção pra evitar exposição prematura.

Assuntos