Capa do guia: Programação TV, addon SEOX Publishers para cadastrar grade semanal de TV ou rádio com sete abas de dias e repeater de Programas

Portais de TV, rádio e entretenimento costumam perder uma importante oportunidade de audiência quando não disponibilizam sua programação dentro do próprio site. Muitos usuários pesquisam horários de telejornais, programas esportivos, filmes, séries ou atrações ao vivo diretamente no Google e, quando não encontram essas informações no portal, acabam buscando em outras páginas. O recurso Programações foi criado justamente para transformar a grade de programação em uma área estruturada de conteúdo dentro do portal, ampliando pageviews, retenção e recorrência de audiência.

O recurso Programação TV cria um custom post type chamado Programações no painel do WordPress, permitindo cadastrar diferentes grades para canais, emissoras ou categorias específicas de programação. Cada programação possui um workspace dividido por dias da semana, onde é possível adicionar programas com informações como imagem, nome, descrição, horário de início e horário de término. O sistema organiza automaticamente os conteúdos em ordem cronológica e o tema renderiza tanto páginas completas de programação quanto blocos modulares exibindo programas atuais e destaques em diferentes áreas do portal.

Neste tutorial, você aprenderá como acessar o menu Programações, criar grades independentes, configurar programas para cada dia da semana e gerenciar a whitelist de domínios autorizados para importação de imagens externas. O fluxo foi pensado para facilitar a atualização contínua da programação sem necessidade de ajustes técnicos ou conhecimento em código.

1 Acesse Programações no menu lateral
No menu lateral do wp-admin, clique em Programações (ícone de calendário). A tabela mostra todas as Programações cadastradas com colunas Título, Autor, Colunas, Categorias, Tags, Data e Shortcode (o código pronto pra colar em qualquer post ou página, no formato [tv id="N"]). O sub-menu lateral expande mostrando três itens: Programações (a listagem que você está vendo), Adicionar programação (criar nova grade) e Configurações (whitelist de domínios e padrões globais). Clique em + Adicionar programação no topo da tabela ou no link Adicionar programação do sub-menu pra começar uma grade nova.

Tela Programações no wp-admin com botão Adicionar programação no topo, sub-menu lateral mostrando Programações, Adicionar programação e Configurações, e tabela listando Programação Principal com colunas Título, Autor, Colunas, Categorias, Tags, Data e Shortcode contendo o código tv id 6422

2 Navegue entre as sete abas de dias da semana
Após criar a Programação e dar um título descritivo no campo do topo (ex: “Programação Principal”, “Grade do Domingo Especial”), o workspace Configurar Programação aparece logo abaixo com sete abas: Segunda-feira, Terça-feira, Quarta-feira, Quinta-feira, Sexta-feira, Sábado e Domingo. Cada aba é uma grade independente do dia correspondente. Clique nas abas pra alternar; o que você preenche numa aba não copia automaticamente pras outras (porque a grade real costuma variar entre dias úteis e fim de semana). Comece pelo dia que tem a grade mais completa, copie depois manualmente pros outros dias se a programação for similar.

Tela de edição da Programação Principal mostrando o workspace Configurar Programação com sete abas no topo (Segunda-feira, Terça-feira, Quarta-feira, Quinta-feira, Sexta-feira, Sábado, Domingo) e a aba Segunda-feira selecionada com tabela de programas e botão Adicionar Programa

3 Adicione um Programa com Imagem, Nome, Descrição e Horários
Na aba do dia escolhido, clique em + Adicionar Programa. Uma nova linha aparece na tabela com cinco campos editáveis. Em Imagem do programa, faça upload do logo ou capa quadrada do programa (tamanho recomendado 640x640px, formatos .SVG ou .PNG). Em Nome do programa, escreva o título oficial (ex: “Bom Dia Brasil”, “Jornal Nacional”). Em Descrição do programa, escreva uma frase curta explicando o conteúdo (ex: “Telejornal matinal com as principais notícias do dia”). Em Horário de início e Horário de término, use os pickers de hora pra definir o intervalo (ex: 07:00 e 08:30). Repita pra cada programa do dia. Ao salvar, o addon ordena automaticamente os Programas pelo horário de início, então pode adicionar fora de ordem que ele acerta sozinho.

Aba Segunda-feira do Configurar Programação com a tabela de programas mostrando uma linha preenchida com Imagem do programa, Nome Bom Dia Brasil, Descrição Telejornal matinal com as principais notícias do dia, Horário de início 07:00 e Horário de término 08:30, mais o botão Adicionar Programa abaixo

4 Configure a Whitelist de Domínios em Configurações
No sub-menu lateral, clique em Configurações. A tela Configurações do addon programações mostra três campos globais. Em Lista de domínios habilitados para importar imagens, clique em + Adicionar linha e cole a URL base de cada domínio externo permitido (ex: https://cdn.canal.com.br); útil quando você integra com um catálogo de programação fora do WordPress que serve as imagens dos programas. Sem o domínio na whitelist, a importação automática rejeita as URLs externas como medida de segurança. Em Imagem padrão para a listagem de programas, defina uma imagem fallback (placeholder) para Programas que não tenham capa própria. Em Página de programas, informe a URL pública da página de grade no portal (ex: /programacao/); blocos do tema usarão esse link quando precisarem direcionar o leitor à grade completa. Salve clicando em Atualizar no canto direito.

Tela Configurações do addon programações mostrando os três campos globais Lista de domínios habilitados para importar imagens com whitelist e botão Adicionar linha, Imagem padrão para listagem de programas com botão Adicionar imagem, e Página de programas com campo de URL

A Programação salva no admin alimenta tanto uma página própria quanto blocos modulares espalhados pelo portal. O tema processa os horários em tempo real e destaca o que está no ar agora.

Lugar onde apareceO que mostraComo ativar
Página de grade (URL definida em Configurações > Página de programas)Tabela completa dos sete dias com todos os ProgramasColoque o shortcode [tv id="N"] (visível na coluna Shortcode da listagem) no editor da página
Sidebar de TV (bloco do addon)Programa atual + próximos 2-3 da gradeUse o bloco modular Addon TV no Inserir Elementos, hook escolhido (ex: sidebar do Single)
Bloco “Está no ar”Apenas o Programa que está acontecendo no horário atualComponente do tema, geralmente no header ou rodapé
Carrossel de programaçãoLista horizontal scrollável dos Programas do diaBloco custom do tema vinculado ao CPT tv

A vantagem do CPT separado por Programação é que você pode ter várias grades coexistindo (canal aberto vs canal pago, grade normal vs grade especial de copa) e escolher qual exibir em qual contexto via shortcode [tv id="N"] ou via configuração do bloco modular.

Imagens quadradas e padronizadas. O addon recomenda 640x640px por um motivo: a maioria dos blocos do frontend renderiza o programa em formato quadrado ou círculo. Imagens retangulares cortam de jeito imprevisível. Padronize todas as capas de programa no mesmo tamanho.

Descrição curta com gatilho. Os 100-120 primeiros caracteres aparecem em listagens. Use uma frase com verbo forte (“Cobertura ao vivo de…”, “Análise diária de…”), não descrição genérica (“Programa de variedades”).

Horários no formato 24h. Sempre use HH:MM 24h (07:00, 19:30, 23:45), nunca AM/PM. O picker do addon retorna nesse formato e o tema espera assim. Misturar formato quebra a ordenação automática.

Atenção ao fim de semana. Sábado e domingo costumam ter grade muito diferente da semana. Não copie cega: revise a grade pra esses dois dias com cuidado. É onde os portais erram mais.

Use múltiplas Programações pra canais distintos. Se o publisher tem mais de um canal (TV aberta, TV paga, rádio AM, rádio FM), crie uma Programação separada pra cada. Não tente espremer tudo numa única grade: você perde a clareza visual e dificulta ter shortcodes específicos pra cada contexto.

Onde fica o menu Programações no admin?

No menu lateral principal do wp-admin, com ícone de calendário (Dashicons calendar). Posição 99 (perto do final da lista). Se não aparece, confirme no Seox Store que o addon TV está ativo. Sem ele, o CPT inteiro some.

Posso ter mais de uma Programação cadastrada?

Sim. Cada item da listagem é uma Programação independente, com sua própria grade semanal. Use isso pra separar canais (canal aberto vs pago), faixas (programação normal vs especial de fim de ano), ou contextos (grade geral vs grade do streaming). O shortcode [tv id="N"] direciona qual delas renderizar no frontend.

O que acontece com o programa que termina depois da meia-noite?

Cadastre-o no dia em que ele começa, com horário de término no formato 24h normal (ex: começa 23:00 e termina 01:00 do dia seguinte, registre como 23:00 a 01:00). O tema interpreta corretamente que é virada de dia. Não duplique o programa nos dois dias.

Por que a ordem dos programas mudou depois que salvei?

Por design. O addon ordena automaticamente todos os Programas de cada dia pelo Horário de início sempre que você salva. Isso garante que a grade no frontend sempre saia cronológica, mesmo se você adicionou os programas fora de ordem. Se a ordem mudou de jeito inesperado, cheque se algum horário de início está digitado errado.

Onde aparece a grade no frontend?

Em três lugares principais: na página própria da grade (URL configurada em Configurações > Página de programas, alimentada pelo shortcode [tv id="N"]), no bloco modular Addon TV do Inserir Elementos (sidebar, carrossel, header), e em componentes do tema que usam o CPT tv diretamente. A grade no frontend mostra o programa atual destacado e os próximos em sequência.

Pra que serve a Whitelist de Domínios?

Quando você integra a programação com um sistema externo (catálogo de canal, planilha automatizada, scraper) que serve as imagens de cada programa via URL externa, o WordPress por padrão rejeita imagens de domínios não autorizados como medida de segurança. A whitelist em Configurações libera apenas os domínios que você confia. Se você sempre faz upload manual das imagens, esse campo pode ficar vazio.

Posso reutilizar a mesma Imagem em vários Programas?

Sim. O campo Imagem do programa usa a Media Library do WordPress, então você pode escolher imagens já existentes. Útil pra programas em série (mesma capa pra Bom Dia Brasil de segunda a sexta, mesma capa pra Tela Quente de toda terça, etc).

O que vai no campo Imagem padrão das Configurações?

É o fallback. Se algum Programa não tiver imagem cadastrada (ou se a imagem externa falhou ao importar), o tema renderiza essa imagem padrão no lugar. Use uma capa neutra do canal ou do logo da emissora pra não ficar com placeholder cinza no frontend.

Posso cadastrar exceções para datas específicas (feriados, edições especiais)?

Sim. A tela de edição da Programação tem uma seção Exceções (toggle “Habilitar Exceções”) onde você define grades alternativas pra datas específicas. Útil pra véspera de Natal, Carnaval, finais de copa. A exceção sobrescreve a grade padrão do dia da semana correspondente apenas naquela data.

Como deletar uma Programação sem quebrar páginas que usam o shortcode?

Antes de deletar, faça uma busca no banco pelos posts e páginas que contém [tv id="N"] com o ID que vai sumir, e remova ou substitua a chamada. Quando você deleta a Programação, o shortcode passa a apontar pro nada e renderiza vazio (ou texto literal [tv id="N"] em alguns temas).

Tem como agendar a substituição de uma grade pra entrar em data futura?

Não nativamente. A solução é manter duas Programações (a atual e a próxima) e na data certa trocar manualmente o shortcode no destino, ou trocar a Programação configurada no bloco modular. Pra grade especial pontual, a melhor prática é usar a seção Exceções dentro da Programação existente, em vez de criar uma Programação separada.