WP Definitivo

Visão geral

O WP Definitivo combina a hierarquia clássica de templates PHP do WordPress com theme.json. O resultado é um tema leve, previsível e compatível com o editor moderno, sem transformar recursos que pertencem a plugins em funcionalidades proprietárias do tema.

Ele pode ser usado sem plugins para publicação de páginas e posts. WooCommerce, Elementor e Elementor Pro são integrações opcionais: quando não estão ativos, o tema mantém seus layouts nativos.

Requisitos do sistema

Instalação e atualização

Instalar pelo painel

1. Acesse Aparência → Temas → Adicionar novo tema.
2. Escolha Enviar tema e selecione o arquivo ZIP do WP Definitivo.
3. Instale, ative o tema e abra Aparência → Personalizar → Opções do tema.
4. Atribua os menus Principal e Rodapé e adicione widgets somente às sidebars que deseja exibir.

Atualizar uma instalação existente

Antes de atualizar, salve um backup do banco de dados e da pasta do tema. Envie a nova versão pelo painel ou substitua a pasta wp-content/themes/wp-definitivo. As opções do Personalizador ficam armazenadas no banco de dados e não são removidas pela atualização dos arquivos.

Após atualizar, limpe o cache do WordPress, do servidor e do navegador. Confirme a versão em Aparência → Temas.

Configuração inicial recomendada

1. Em Configurações → Leitura, escolha a página inicial e, se necessário, a página de posts.
2. Em Aparência → Menus, atribua um menu à localização Menu principal e outro à localização Menu do rodapé.
3. Em Aparência → Personalizar → Identidade do site, configure título, descrição e logotipo.
4. Em Opções do tema, escolha o esquema de cores, tipografia, largura e sidebar de cada contexto.
5. Edite o resumo das páginas e produtos quando quiser exibir uma descrição abaixo do título.

Layouts e modelos de página

As páginas padrão aceitam resumo. Quando preenchido, ele aparece como descrição abaixo do título. O conteúdo principal suporta blocos alinhados à largura normal, ampla e total.

Personalizador

As configurações estão em Aparência → Personalizar → Opções do tema. Os grupos são organizados por contexto para evitar que uma alteração da loja afete o blog ou uma página comum.

Cores e tipografia

Esquemas de cores

O tema inclui quatro esquemas: Branco e azul-marinho, Marfim e vinho, Areia e verde e Noite e vinho. A cor de destaque personalizada só é aceita quando mantém contraste mínimo de 4,5:1 nos fundos, superfícies e textos de botões controlados pelo tema.

Fontes

As fontes disponíveis no Personalizador são Inter, Interface do sistema, Arial e Trebuchet MS. Inter e JetBrains Mono acompanham o tema localmente; nenhuma fonte é carregada de serviços externos.

Escalas

Texto base e títulos podem usar escala compacta, padrão ou grande. A loja possui controles separados para textos e títulos do WooCommerce, permitindo ajustar formulários e interfaces comerciais sem alterar o restante do site.

Cabeçalho e rodapé

Cabeçalho

• Identidade do site com título ou logotipo personalizado.
• Menu principal com suporte a segundo nível.
• Pesquisa expansível com gerenciamento de foco e tecla Escape.
• Link do carrinho e contador atualizado por Ajax quando WooCommerce está ativo.
• Opção de manter o cabeçalho visível durante a rolagem.
• No celular, o nome do site ocupa a primeira linha e pesquisa, carrinho e botão “Menu” ficam na segunda.

Rodapé

O rodapé suporta menu próprio e texto editável. Use [current_year] para o ano atual e [site_title] para o título do site. Links e ênfase básica são permitidos. O crédito do tema pode ser editado ou removido diretamente nesse campo.

Blog, arquivos e posts

Arquivos

• Layout em lista ou grade.
• Grade com duas ou três colunas.
• Três colunas ficam indisponíveis quando uma sidebar é selecionada.
• Exibição do resumo ou conteúdo completo nos arquivos.
• Configuração compartilhada pela página de posts, categorias, tags, datas e pesquisa.

Posts individuais

Posts exibem título, categoria, data de publicação ou atualização, autor, imagem destacada opcional, conteúdo, taxonomias, navegação entre posts e comentários. Imagem destacada e metadados podem ser ativados ou desativados no Personalizador.

Sidebars

O WP Definitivo registra três áreas de widgets:

• Blog e arquivos: posts individuais, página de posts, arquivos e pesquisa.
• Páginas: páginas comuns quando a sidebar está habilitada.
• Loja: catálogo, produtos, carrinho, checkout e Minha Conta conforme a configuração de cada contexto.

Página, post, blog, catálogo, produto, carrinho, checkout e Minha Conta possuem controles independentes para sidebar à esquerda, à direita ou ausente. Sidebars genéricas vazias permanecem ocultas.

Editor de blocos

O arquivo theme.json versão 3 integra paleta, espaçamentos, tipografia fluida, larguras de conteúdo e estilos básicos ao editor. O tema suporta alinhamentos amplo e total, embeds responsivos e estilos do WordPress.

Estilos adicionais de blocos

• Contorno Definitivo: variação de botão com contorno.
• Citação orgânica: apresentação editorial para citações.
• Emoldurada: acabamento para blocos de imagem.
• Painel suave: superfície destacada para grupos.

Os estilos do editor carregam as mesmas famílias tipográficas do front-end para reduzir diferenças entre edição e publicação.

Compatibilidade com WooCommerce

WooCommerce não é obrigatório. Quando o plugin é ativado, o tema declara suporte oficial e adapta catálogo, produto, carrinho, finalização de compra e Minha Conta sem copiar templates internos do plugin. A integração usa hooks, o que reduz o risco de arquivos sobrescritos ficarem desatualizados.

Catálogo e arquivos de produtos

• Grade configurável com duas, três ou quatro colunas no desktop.
• Miniaturas quadradas ou verticais na proporção 4:5.
• Descrição curta opcional nos cartões, limitada para manter o alinhamento.
• Contagem de resultados e ordenação agrupadas em uma barra responsiva.
• Título e descrição do catálogo obtidos da página da loja; categorias e tags usam a descrição do termo.
• Sidebar opcional com pesquisa de produtos e categorias como conteúdo inicial quando não há widgets.

Produto individual

• Galeria com zoom, lightbox e slider.
• Imagem principal de até 720 px e miniaturas de catálogo de 480 px como referências declaradas ao WooCommerce.
• Título e descrição curta integrados à apresentação editorial.
• Estilos responsivos para resumo, preço, variações, abas, avaliações e produtos relacionados.
• Sidebar independente e opcional.

Carrinho, checkout e Minha Conta

As páginas transacionais usam título compacto no lugar da hero completa. O tema estiliza tanto estruturas clássicas quanto blocos atuais do WooCommerce, com cartões, formulários, totais, campos de país e estado, resumo do pedido e navegação da conta.

No celular, itens do carrinho e do resumo do pedido reorganizam imagem, nome, quantidade e preço para evitar sobreposição. No tablet, o resumo compacto duplicado do checkout é ocultado e o resumo completo permanece próximo da etapa final.

Opções independentes

Catálogo, produto, carrinho, checkout e Minha Conta possuem largura de contêiner e posição de sidebar próprias. A tipografia do WooCommerce também tem controles separados de texto e títulos.

Compatibilidade com Elementor

Elementor é opcional. Uma página identificada como construída com Elementor recebe uma área de conteúdo sem as restrições do cartão e da largura de leitura nativos do tema. Isso permite que containers e seções do construtor controlem a composição da página.

• Compatibilidade com páginas criadas no Elementor Free.
• Respeito à opção Ocultar título nas configurações da página.
• Compatibilidade com os modelos Tela do Elementor e Elementor largura total fornecidos pelo plugin.
• O conteúdo do Elementor não herda os seletores de cartões e layouts nativos do tema.
• Quando Elementor está inativo, as páginas continuam usando a renderização nativa do WordPress.

Substituições com Elementor Pro

Quando Elementor Pro está ativo, o WP Definitivo registra todas as localizações principais do Theme Builder. Templates publicados com condições correspondentes podem substituir a apresentação nativa do tema.

Fluxo recomendado

1. Acesse Elementor → Construtor de temas.
2. Crie o template para a localização desejada.
3. Publique e configure as condições de exibição.
4. Limpe caches e verifique uma URL que corresponda à condição.

Se nenhuma condição corresponder ou o Elementor Pro estiver inativo, o WP Definitivo usa automaticamente seu template nativo. Conteúdos substituídos são envolvidos por um landmark principal compatível com o link “Pular para o conteúdo”.

Responsividade

O tema usa tipografia fluida, grades flexíveis e pontos de quebra orientados pelo espaço disponível. Os principais ajustes ocorrem em aproximadamente 960 px para tablets e 700 px para celulares.

• Sidebars migram para depois do conteúdo em tablet e celular.
• Grades de posts passam para uma coluna; produtos usam duas colunas no tablet e uma no celular.
• O cabeçalho móvel usa duas linhas centralizadas e botão textual “Menu”.
• Títulos e paddings são reduzidos em telas estreitas.
• Carrinho e checkout reorganizam itens, quantidades, valores e formulários.
• Imagens, vídeos, tabelas e embeds respeitam a largura disponível.

Acessibilidade

O WP Definitivo foi desenvolvido para atender aos requisitos accessibility-ready do diretório de temas do WordPress. O arquivo accessibility.txt acompanha o pacote com metodologia, classe para leitores de tela e canais de suporte.

• Link “Pular para o conteúdo” visível ao receber foco.
• Landmarks semânticos e regiões de navegação nomeadas.
• Menus, busca e controles operáveis por teclado.
• Estados expostos por atributos ARIA quando necessário.
• Indicadores de foco visíveis.
• Links em textos, comentários, resumos, widgets textuais e rodapé sempre sublinhados.
• Esquemas de cores e cor personalizada com validação de contraste.
• Suporte a redimensionamento de texto, reflow e preferência por movimento reduzido.
• Classe .screen-reader-text disponível para conteúdo apenas para leitores de tela.

Traduções e idiomas RTL

Todos os textos de interface do tema usam o domínio wp-definitivo. O pacote inclui o catálogo-fonte languages/wp-definitivo.pot e uma tradução brasileira completa em pt_BR.po e pt_BR.mo.

Novas traduções podem ser feitas por ferramentas como Poedit ou pela plataforma de traduções do WordPress.org. O tema declara Domain Path: /languages e inclui rtl.css para idiomas escritos da direita para a esquerda.

Privacidade e recursos externos

O tema não rastreia visitantes ou administradores, não envia configurações para serviços externos e não carrega recursos por CDN. Fontes, CSS e JavaScript são servidos pela própria instalação.

WordPress, WooCommerce, formulários e outros plugins podem processar dados de forma independente. A política de privacidade do site deve descrever esses serviços conforme a configuração utilizada.

O que não acompanha o tema

Para respeitar o território de plugins e manter o site portátil, o WP Definitivo não inclui:

• Formulários de contato, newsletters ou automações.
• SEO, analytics, pixels ou rastreamento.
• Tipos de post personalizados, shortcodes ou blocos proprietários.
• Compartilhamento social, favicons ou sistema de consentimento.
• Importador de demonstração, instalação automática de plugins ou upsell no painel.
• Sistema proprietário de licenciamento ou atualização.

Esses recursos devem ser adicionados por plugins adequados ao projeto.

Suporte, licença e créditos

Suporte

Para dúvidas, problemas de acessibilidade ou relato de falhas, utilize a página de contato ou escreva para contato@wpdefinitivo.com. Informe a versão do WordPress, PHP, tema e plugins relacionados, além dos passos para reproduzir o problema.

Licença

O código e o design do WP Definitivo são distribuídos sob a GNU General Public License v2 ou posterior. Inter e JetBrains Mono usam a SIL Open Font License 1.1. Os arquivos de licença acompanham o pacote.

Independência

WP Definitivo é um projeto independente e não é afiliado, endossado ou patrocinado pela WordPress Foundation, Automattic, WooCommerce ou Elementor.

Versão 1.0.53

• Carregamento modular dos estilos conforme o contexto da página.
• Recursos visuais da loja restritos às páginas que realmente usam WooCommerce.
• Integrações opcionais carregadas somente quando necessárias.
• Fontes locais reutilizadas sem declarações ou downloads duplicados.