Pular para a documentaçãoSkip to the documentation

Documentação oficialOfficial documentation

Tema WP Definitivo

Um tema de blocos acessível para sites modernos e lojas WooCommerce, feito com blocos nativos, padrões e o Editor do Site.An accessible block theme for modern sites and WooCommerce stores, built with native blocks, patterns and the Site Editor.

Versão documentadaDocumented version
1.0.0
WordPress
6.6 ou superior6.6 or later
PHP
7.4 ou superior7.4 or later
LicençaLicense
GPL v2 ou posteriorGPL v2 or later
Índice da documentaçãoDocumentation contents
Introdução

Visão geral

O WP Definitivo é um tema de blocos para sites modernos e lojas WooCommerce. Todo o layout é feito com blocos nativos do WordPress, padrões (patterns) e o Editor do Site, sem construtor de páginas, painel de opções próprio ou código que prenda o seu conteúdo ao tema.

A acessibilidade faz parte da base. Regiões semânticas, foco visível, navegação por teclado, links sublinhados e cores com contraste calculado já vêm prontos, e as escolhas de design no editor ficam limitadas a combinações testadas.

Blocos nativos

Modelos, partes e padrões editáveis no Editor do Site. O que você cria continua sendo conteúdo do WordPress, mesmo que um dia troque de tema.

Acessível desde a base

Link para pular ao conteúdo, regiões identificadas, foco em duas cores, controles com 44 pixels de altura e suporte a movimento reduzido.

Loja opcional

Com o WooCommerce ativo, o tema apresenta catálogo, produto, carrinho, finalização da compra, confirmação do pedido e Minha conta com os blocos do próprio WooCommerce.

Sem rastreamento

Nenhuma requisição externa, CDN, telemetria ou fonte baixada de outro servidor. Tudo o que o tema usa está no próprio pacote.

Compatibilidade

Requisitos do sistema

ComponenteRequisitoObservação
WordPress6.6 ou superiorTestado até a versão 7.1.
PHP7.4 ou superiorUse uma versão ainda suportada pelo seu provedor.
EditorEditor do SiteO tema não usa o Personalizador. A aparência é ajustada em Aparência → Editor.
WooCommerceOpcionalOs modelos da loja só entram em uso quando o plugin está ativo.
Outros pluginsNenhum obrigatórioO tema funciona sozinho para páginas, posts e blog.
Primeiros passos

Instalação e atualização

Instalar pelo painel

  1. Acesse Aparência → Temas → Adicionar novo tema.
  2. Clique em Enviar tema e selecione o arquivo ZIP do WP Definitivo.
  3. Clique em Instalar agora e depois em Ativar.
  4. Abra Aparência → Editor para revisar modelos, partes e estilos.

Atualizar uma instalação existente

Antes de atualizar, faça backup do banco de dados e da pasta wp-content/themes/wp-definitivo. Envie a nova versão pelo painel e, em seguida, limpe o cache do WordPress, do servidor e do navegador. Confirme a versão em Aparência → Temas.

Configuração

Configuração inicial recomendada

  1. Em Configurações → Geral, defina o título e a descrição do site. O cabeçalho e o rodapé exibem os dois.
  2. Para mostrar um logotipo, edite a parte Cabeçalho no Editor do Site e escolha a imagem no bloco Logo do site.
  3. Crie a página inicial: em Páginas → Adicionar nova, escolha o padrão Página inicial institucional ou, com o WooCommerce ativo, Página inicial da loja. Nas configurações da página, escolha o modelo Página Largura Total e publique.
  4. Em Configurações → Leitura, escolha essa página como página inicial e outra página, por exemplo Blog, como página de posts.
  5. Crie os menus em Aparência → Editor → Navegação e escolha cada um no bloco Navegação das partes Cabeçalho e Rodapé. Até você escolher um menu, o cabeçalho e o rodapé listam as páginas publicadas.
  6. Com o WooCommerce ativo, confira as páginas da loja, do carrinho, da finalização da compra e de Minha conta em WooCommerce → Configurações → Avançado. O tema aplica os modelos certos a essas páginas.
Estrutura

Editor do Site

Toda a aparência do WP Definitivo é editada em Aparência → Editor. Não há opções no Personalizador nem painel próprio: o que existe no tema aparece no editor como modelo, parte do modelo, padrão ou estilo.

ÁreaO que você ajusta
NavegaçãoMenus do cabeçalho e do rodapé.
EstilosCores, tipografia, espaçamentos e estilos dos blocos, a partir das predefinições do tema.
PáginasConteúdo das páginas, incluindo a página inicial.
ModelosEstrutura de cada tipo de página, como blog, post, arquivo, busca, erro 404 e loja.
PadrõesAs partes Cabeçalho, Rodapé e Carrinho lateral e os padrões reutilizáveis.
Design

Cores, tipografia e espaçamento

O tema define uma paleta de 14 cores. Cores personalizadas, gradientes, duotone e a paleta padrão do WordPress ficam desativados de propósito, para que toda combinação escolhida no editor venha de pares com contraste verificado.

CorSlugValorUso principal
Fundobackground#f6f8fcFundo da página
Brancowhite#ffffffCartões e superfícies
Texto principalforeground#0f172aTexto e fundo do rodapé
Texto secundáriomuted#475569Textos de apoio e metadados
Destaqueaccent#0f3d73Links e botões
Destaque ao passar o cursorsecondary#14599fBotões ao passar o cursor
Link visitadovisited#5b2a86Links já visitados
Fundo suavesoft#f0f3f9Áreas de conteúdo do blog e dos posts
Borda do conteúdocontent-border#0f305724Bordas de cartões
Bordaborder#64748bBordas de campos e controles
Borda sutilborder-subtle#d7dde5Linhas divisórias
Sucessosuccess#146c43Mensagens de sucesso
Erroerror#a51d2dErros e campos inválidos
Avaliaçãorating#a16207Estrelas de avaliação

Contraste das combinações padrão

CombinaçãoContraste
Texto principal sobre o fundo16,79:1
Texto secundário sobre o fundo7,13:1
Links sobre o fundo10,21:1
Texto branco em botões10,85:1
Texto branco em botões, ao passar o cursor7,10:1
Links visitados sobre o fundo9,32:1
Texto de sucesso sobre o fundo6,07:1
Texto de erro sobre o fundo7,02:1
Estrelas de avaliação sobre cartões brancos4,92:1
Bordas de controles sobre o branco4,76:1

Tipografia

O texto usa a pilha de fontes sem serifa do sistema, com altura de linha 1,65. Também estão disponíveis a pilha com serifa e a monoespaçada do sistema. Nenhum arquivo de fonte é baixado. Tamanhos personalizados e letra capitular ficam desativados.

TamanhoSlugValor
Pequenosmall15 px
MédiomediumFluido, de 16 a 18 px. É o tamanho do texto corrido.
GrandelargeFluido, de 24 a 32 px
Muito grandex-largeFluido, de 32 a 56 px
Extragrandexx-largeFluido, de 40 a 72 px

Larguras e espaçamento

O conteúdo tem largura de 720 px, e a largura ampla chega a 1280 px. A escala de espaçamento tem oito passos, de 8 px, em Mínimo, até um valor fluido de 48 a 96 px, em Máximo.

Estrutura

Modelos e partes

ModeloQuando é usado
ÍndiceModelo de reserva para listas de posts sem modelo próprio.
Página de postsPágina do blog: título, grade de publicações em duas colunas e barra lateral com busca e posts recentes.
Post individualTítulo, resumo, categorias, data, autor, imagem destacada, conteúdo, categorias e tags, navegação entre posts, comentários e barra lateral.
Página PadrãoDestaque com o título da página, o conteúdo num cartão e os comentários, quando estão ativados.
Página Largura TotalDestaque com o título da página, conteúdo em largura total e os comentários, quando estão ativados.
Página Sem TítuloConteúdo em largura total, sem o título da página, e os comentários, quando estão ativados. O conteúdo precisa começar com o título principal (H1) da página.
ArquivoCategorias, tags, autores e datas, com o título e a descrição do termo.
Resultados da buscaCabeçalho dos resultados e lista de posts.
Página não encontradaMensagem de erro 404, campo de busca e link para a página inicial.
Loja (WooCommerce)Catálogo de produtos; Produtos por categoria, por tag, por atributo e por marca; Resultados da pesquisa de produtos; Produto simples; Carrinho; Check-out; Confirmação do pedido e Minha Conta. Veja Loja com WooCommerce.

As partes Cabeçalho e Rodapé aparecem em todos os modelos. A parte Carrinho lateral define o conteúdo do minicarrinho do WooCommerce.

Navegação

Cabeçalho, menus e busca

O cabeçalho reúne logotipo, título e descrição do site, menu principal e uma busca expansível. Os submenus abrem por clique ou pelo teclado, não pela passagem do ponteiro. Em telas estreitas, o menu vira um botão que abre a navegação em tela cheia.

A busca do cabeçalho abre pelo botão com o ícone de lupa, tem um rótulo para leitores de tela e um botão para fechar.

Com o WooCommerce ativo, ele acrescenta ao cabeçalho os botões da conta e do carrinho. No bloco Conta de cliente, você escolhe mostrar só o ícone, só o texto ou os dois, e se a conta abre um menu suspenso. Os botões crescem com o conteúdo, sem cobrir a busca nem o carrinho, e usam a cor do texto do cabeçalho.

O rodapé mostra o título e a descrição do site, o menu do rodapé, a linha de direitos autorais com o ano e o nome do seu site e os créditos do WordPress e do tema. Tudo pode ser editado na parte Rodapé.

Conteúdo

Padrões

No insersor de blocos, os padrões do tema ficam nas categorias que começam com Definitivo. Todos usam blocos nativos e começam os títulos no nível 2, para ficarem abaixo do título da página. Depois de inserir, troque os textos de exemplo pelos seus.

PadrãoCategoriaUso
Destaque da página inicialDefinitivo – DestaquesAbertura da página inicial com o título do site como título de nível 2 e um cartão de destaques da semana.
Destaque acessívelDefinitivo – DestaquesAbertura com alto contraste, título claro e texto de apoio curto.
Sobre em duas colunasDefinitivo – GeralApresentação da empresa ou do projeto.
Destaques da comunidadeDefinitivo – GeralDuas colunas com projetos e atividades.
Dados de contatoDefinitivo – GeralContato com rótulos claros, sem depender de plugin de formulário.
DepoimentoDefinitivo – GeralCitação com título e atribuição visível.
Seção de buscaDefinitivo – BuscaCampo de busca com rótulo visível e botão de texto.
Grade de publicaçõesDefinitivo – PublicaçõesTrês posts recentes com título, data e resumo.
Três serviçosDefinitivo – ServiçosTrês cartões de serviço em ordem de leitura lógica.
Cartões de serviçosDefinitivo – ServiçosSeis cartões com ícone decorativo e link próprio, numa grade que se adapta à largura.
Grade de produtosDefinitivo – WooCommerceGrade paginada de produtos, com o mesmo cartão usado na loja. Aparece só com o WooCommerce ativo.
Página inicial institucionalDefinitivo – GeralPágina inicial completa: abertura, propósito, serviços, depoimento, últimas notícias e dados de contato. Use com o modelo Página Largura Total.
Página inicial da lojaDefinitivo – WooCommercePágina inicial completa da loja: abertura, categorias, produtos em destaque, ofertas e novidades. Use com o modelo Página Largura Total. Aparece só com o WooCommerce ativo e o WordPress 6.7 ou superior.

As duas páginas iniciais também aparecem na janela de padrões que abre ao criar uma página nova. Uma seção de produtos sem nada para mostrar, como as ofertas quando nenhum produto está em promoção, fica oculta no site.

Os padrões do núcleo do WordPress ficam ocultos, e os padrões internos do tema, como cabeçalho, rodapé e conteúdo da loja, não aparecem no insersor.

Publicação

Blog, arquivos e posts

  • A página de posts mostra os artigos numa grade de duas colunas, com barra lateral de busca e posts recentes.
  • O título de cada post é o link para ele. Os resumos não usam links ambíguos como “Leia mais”.
  • Posts fixos ganham borda e elevação, sem depender só de cor.
  • O post individual abre com o título e o resumo. Em seguida vêm categorias, data, autor, imagem destacada, conteúdo, categorias e tags, navegação entre posts e comentários.
  • Comentários aninhados mantêm a estrutura em telas estreitas, e a paginação de comentários é a nativa do WordPress.
  • Posts divididos com a marcação <!--nextpage--> recebem links numerados para as páginas.
  • Um post sem título aparece como “Publicação sem título”, para que a página não fique sem título principal.
Comércio eletrônico

Loja com WooCommerce

O WooCommerce é opcional. Quando ele está ativo, o tema declara suporte ao plugin e apresenta as páginas públicas da loja com os blocos nativos do WooCommerce. Preços, estoque, frete, impostos, pagamentos e e-mails continuam configurados no próprio WooCommerce.

PáginaO que o tema apresenta
Loja e categoriasTrilha de navegação, faixa com título e descrição, atalhos de categoria com a categoria atual marcada, filtros nativos de preço, categorias e marcas, ordenação nativa do WooCommerce, contagem de resultados e paginação.
Cartão de produtoImagem, categoria, nome com link para o produto, preço, selo de oferta e, na loja e nos resultados, botão de compra.
ProdutoTrilha de navegação, galeria quadrada com miniaturas, setas e ampliação, detalhes com categoria, marca, SKU e tags, avaliação, preço, resumo, painéis de compra com as variações e a quantidade com botões de menos e mais, descrição e avaliações, as seções Você também pode gostar (vendas casadas) e Produtos relacionados.
CarrinhoItens, cupons nativos, resumo do pedido com subtotal, descontos e frete, a seção Complete seu pedido com as vendas cruzadas e um estado vazio com atalho para a loja.
Finalização da compraEtapas da compra e o checkout nativo do WooCommerce.
Confirmação do pedidoResumo, downloads, endereços e próximos passos, para produtos físicos e digitais.
Minha contaBoas-vindas, navegação nativa numa barra lateral, atalhos no painel e tabela de downloads.
Carrinho lateralMinicarrinho com os itens, o resumo dos valores e as ações nativas de compra.

Para editar a loja, abra Aparência → Editor → Modelos. A loja usa o modelo Catálogo de produtos, e categorias, tags, atributos e marcas de produtos têm modelos próprios. Textos e links podem ser trocados e salvos no editor. Para filtrar por um atributo, adicione o filtro de atributo ao bloco de filtros. Para voltar à versão do tema, use Redefinir nas opções do modelo.

Inclusão

Acessibilidade

O desenvolvimento segue as diretrizes accessibility-ready do WordPress.org. Em 15 de outubro de 2026, o autor do tema concluiu uma auditoria interna com base na WCAG 2.2 nível AA, com testes manuais de teclado, zoom, zoom só de texto, cores forçadas e o leitor de tela NVDA no Firefox e no Chrome, incluindo a loja. Não é uma auditoria independente, e a etiqueta accessibility-ready só vale depois da revisão do WordPress.org. O arquivo accessibility.txt, na pasta do tema, traz a declaração de acessibilidade, a metodologia de testes e os recursos.

  • Link “Pular para o conteúdo”, gerado pelo WordPress a partir da região principal de cada modelo.
  • Regiões identificadas, com nomes distintos para a navegação principal e a do rodapé.
  • Um único título principal (H1) por página e hierarquia de títulos coerente.
  • Foco visível em duas cores, legível em fundos claros e escuros.
  • Links sublinhados no conteúdo e cor própria para links visitados.
  • Botões, campos e controles de navegação com pelo menos 44 pixels de altura.
  • Submenus que abrem por clique e funcionam com o teclado. A tecla Esc fecha o submenu aberto e devolve o foco ao botão dele.
  • Suporte a movimento reduzido e foco visível no modo de cores forçadas.
  • Links com o mesmo texto e destinos diferentes ganham nomes próprios, como os comentários recentes, os nomes de quem comenta e as categorias com o mesmo nome de uma tag.
  • Na loja, preço, estoque e quantidade escolhidos são anunciados aos leitores de tela, e a ordenação avisa que a lista de produtos é atualizada ao escolher uma opção.
  • Classe screen-reader-text para textos destinados só a leitores de tela.

Boas práticas para quem publica

  • Escreva texto alternativo para imagens que informam algo e deixe vazio o das imagens decorativas.
  • Use os títulos em ordem, sem pular níveis.
  • Prefira textos de link que façam sentido fora do contexto.
  • Não transmita informação apenas por cor.

Para relatar um problema de acessibilidade, escreva para contato@wpdefinitivo.com com a página afetada, o navegador e, se for o caso, a tecnologia assistiva usada.

Internacionalização

Idiomas e traduções

O idioma de origem do tema é o inglês. A tradução para o português do Brasil acompanha o pacote, então um site configurado em Português do Brasil exibe o tema em português sem nenhum download extra.

Para outro idioma, use o arquivo languages/wp-definitivo.pot como base e salve as traduções como languages/LOCALE.po e languages/LOCALE.mo, trocando LOCALE pelo código do idioma. As mensagens de JavaScript precisam também dos arquivos JSON do domínio wp-definitivo. As instruções estão em languages/README.md.

Os textos salvos no banco de dados, como páginas, produtos, menus e padrões já inseridos, não mudam quando o idioma do tema muda.

Dados

Privacidade e recursos externos

O WP Definitivo não rastreia visitantes nem administradores, não grava cookies próprios e não faz requisições a serviços externos. Não há telemetria, CDN, fontes remotas, importador de demonstração ou sistema próprio de atualização.

Plugins como o WooCommerce têm as suas próprias regras de dados, como os cookies da sessão do carrinho. Consulte a documentação de cada plugin e mantenha a política de privacidade do site atualizada.

Carregamento

Desempenho

  • Os estilos globais saem do theme.json. Além da folha principal, as folhas de produto, finalização da compra, confirmação do pedido e Minha conta só carregam nas páginas que as usam.
  • Os scripts são pequenos, não dependem de jQuery e carregam apenas onde são necessários.
  • A folha do carrinho lateral só carrega quando o minicarrinho aparece na página.
  • Cada arquivo recebe uma versão baseada na data de modificação, o que faz o navegador buscar a cópia nova depois de uma atualização.
Ajuda

Solução de problemas

Atualizei o tema e o cabeçalho não mudou.

A parte Cabeçalho foi personalizada no Editor do Site, e a versão salva no banco de dados tem prioridade sobre o arquivo do tema. Use Redefinir nessa parte para voltar à versão do tema. As mudanças que você fez nela serão descartadas.

O menu que criei não aparece no cabeçalho.

Criar um menu não o coloca no cabeçalho. Selecione o bloco Navegação na parte Cabeçalho, escolha o menu desejado e salve. Até essa escolha, o cabeçalho lista as páginas publicadas.

Não encontro a opção de cor personalizada.

É uma escolha do tema: o editor oferece apenas a paleta com contraste verificado. Se precisar de outras cores, crie um tema filho e confira o contraste de cada combinação.

As páginas da loja não usam o layout do tema.

Confirme que o WooCommerce está ativo e que as páginas estão definidas em WooCommerce → Configurações → Avançado. Se uma página tiver outro modelo escolhido nas configurações dela, esse modelo tem prioridade.

Minhas mudanças não aparecem no site.

Limpe o cache do plugin de cache, do servidor e do navegador e recarregue a página.

O tema aparece em inglês.

Confira o idioma em Configurações → Geral. O pacote inclui o português do Brasil. Outros idiomas precisam de uma tradução, como explica a seção Idiomas e traduções.

Escopo

O que o tema não inclui

Por design, o WP Definitivo cuida da apresentação. Recursos que mudam dados ou que pertencem a plugins ficam fora do tema:

  • construtor de páginas e blocos próprios;
  • tipos de conteúdo, taxonomias e shortcodes personalizados;
  • formulários de contato;
  • SEO, analytics e pixels de rastreamento;
  • importador de conteúdo de demonstração;
  • sliders com rotação automática;
  • plugins embutidos ou instalados automaticamente.

Para essas necessidades, escolha plugins do diretório do WordPress.org.

Projeto

Suporte, licença e créditos

Para dúvidas, problemas de acessibilidade ou relatos de erro, use a página de contato ou escreva para contato@wpdefinitivo.com.

O WP Definitivo é distribuído sob a GNU General Public License v2 ou posterior. Os ícones e a captura de tela foram criados para o tema e seguem a mesma licença. O tema usa as fontes do sistema e não inclui fontes nem imagens de terceiros.

O histórico de versões está no arquivo readme.txt do tema.

O WP Definitivo é um projeto independente, sem vínculo com a WordPress Foundation, a Automattic ou o WooCommerce.

Introduction

Overview

WP Definitivo is a block theme for modern sites and WooCommerce stores. The whole layout is built with native WordPress blocks, patterns and the Site Editor, with no page builder, no custom options panel and no code that ties your content to the theme.

Accessibility is part of the foundation. Semantic regions, visible focus, keyboard navigation, underlined links and colors with calculated contrast come ready, and the design choices in the editor are limited to tested combinations.

Native blocks

Templates, template parts and patterns you can edit in the Site Editor. What you build stays WordPress content, even if you switch themes one day.

Accessible by design

A skip link, labelled regions, a two-color focus indicator, controls at least 44 pixels tall and reduced motion support.

Optional store

With WooCommerce active, the theme presents the catalog, product, cart, checkout, order confirmation and My account pages with WooCommerce’s own blocks.

No tracking

No external requests, CDN, telemetry or fonts loaded from another server. Everything the theme uses ships in its own package.

Compatibility

System requirements

ComponentRequirementNotes
WordPress6.6 or laterTested up to 7.1.
PHP7.4 or laterUse a version your host still supports.
EditorSite EditorThe theme does not use the Customizer. Its appearance is managed in Appearance → Editor.
WooCommerceOptionalThe store templates are only used when the plugin is active.
Other pluginsNone requiredThe theme works on its own for pages, posts and a blog.
Getting started

Installation and updates

Install from the dashboard

  1. Go to Appearance → Themes → Add New Theme.
  2. Click Upload Theme and choose the WP Definitivo ZIP file.
  3. Click Install Now, then Activate.
  4. Open Appearance → Editor to review the templates, template parts and styles.

Update an existing installation

Before updating, back up the database and the wp-content/themes/wp-definitivo folder. Upload the new version from the dashboard, then clear the WordPress, server and browser caches. Confirm the version in Appearance → Themes.

Configuration

Recommended initial setup

  1. In Settings → General, set the site title and tagline. The header and the footer display both.
  2. To show a logo, edit the Header template part in the Site Editor and choose the image in the Site Logo block.
  3. Build the front page: under Pages → Add New, choose the Institutional front page pattern or, with WooCommerce active, Store front page. In the page settings, choose the Full-width page template and publish.
  4. In Settings → Reading, choose that page as the homepage and another page, such as Blog, as the posts page.
  5. Create the menus in Appearance → Editor → Navigation and choose each one in the Navigation block of the Header and Footer template parts. Until you choose a menu, the header and footer list the published pages.
  6. With WooCommerce active, check the shop, cart, checkout and My account pages in WooCommerce → Settings → Advanced. The theme applies the right templates to those pages.
Structure

Site Editor

Everything about WP Definitivo’s appearance is edited in Appearance → Editor. There are no Customizer options and no custom panel: whatever the theme provides shows up in the editor as a template, template part, pattern or style.

AreaWhat you adjust
NavigationThe header and footer menus.
StylesColors, typography, spacing and block styles, based on the theme presets.
PagesPage content, including the front page.
TemplatesThe structure of each kind of page, such as the blog, posts, archives, search, the 404 error and the store.
PatternsThe Header, Footer and Side cart template parts and the reusable patterns.
Design

Colors, typography and spacing

The theme defines a palette of 14 colors. Custom colors, gradients, duotone and the default WordPress palette are turned off on purpose, so every combination picked in the editor comes from pairs with verified contrast.

SlugValueMain use
background#f6f8fcPage background
white#ffffffCards and surfaces
foreground#0f172aText and footer background
muted#475569Supporting text and metadata
accent#0f3d73Links and buttons
secondary#14599fButtons on hover
visited#5b2a86Visited links
soft#f0f3f9Blog and post content areas
content-border#0f305724Card borders
border#64748bField and control borders
border-subtle#d7dde5Dividers
success#146c43Success messages
error#a51d2dErrors and invalid fields
rating#a16207Rating stars

Default contrast ratios

CombinationContrast
Main text on the page background16.79:1
Secondary text on the page background7.13:1
Links on the page background10.21:1
White text on buttons10.85:1
White text on buttons, on hover7.10:1
Visited links on the page background9.32:1
Success text on the page background6.07:1
Error text on the page background7.02:1
Rating stars on white cards4.92:1
Control borders on white4.76:1

Typography

Text uses the system sans-serif font stack with a 1.65 line height. The system serif and monospace stacks are also available. No font files are downloaded. Custom font sizes and drop caps are turned off.

SizeSlugValue
Smallsmall15 px
MediummediumFluid, from 16 to 18 px. This is the body text size.
LargelargeFluid, from 24 to 32 px
Extra largex-largeFluid, from 32 to 56 px
Hugexx-largeFluid, from 40 to 72 px

Widths and spacing

Content is 720 px wide, and the wide width reaches 1280 px. The spacing scale has eight steps, from 8 px to a fluid value between 48 and 96 px.

Structure

Templates and template parts

TemplateWhen it is used
IndexFallback template for post lists without a template of their own.
Blog homeThe posts page: heading, a two-column post grid and a sidebar with search and recent posts.
Single postTitle, excerpt, categories, date, author, featured image, content, categories and tags, post navigation, comments and a sidebar.
Default pageA hero with the page title, the content inside a card and the comments, when they are enabled.
Full-width pageA hero with the page title, full width content and the comments, when they are enabled.
Page without titleFull width content without the page title, and the comments, when they are enabled. The content must start with the page’s main heading (H1).
ArchiveCategories, tags, authors and dates, with the term title and description.
Search resultsA results header and the list of posts.
Page not foundA 404 message, a search field and a link to the front page.
Store (WooCommerce)Product Catalog; Products by Category, by Tag, by Attribute and by Brand; Product Search Results; Single Product; Cart; Checkout; Order Confirmation and My account. See WooCommerce store.

The Header and Footer template parts appear in every template. The Side cart template part defines the content of the WooCommerce mini cart.

Navigation

Header, menus and search

The header holds the logo, the site title and tagline, the primary menu and an expandable search. Submenus open on click or with the keyboard, not on pointer hover. On narrow screens the menu becomes a button that opens the navigation full screen.

The header search opens from the magnifying glass button, has a label for screen readers and a close button.

With WooCommerce active, it adds the account and cart buttons to the header. In the Customer account block, you choose to show the icon, the text or both, and whether the account opens a dropdown menu. The buttons grow with their content, never covering the search or the cart, and use the header’s text color.

The footer shows the site title and tagline, the footer menu, a copyright line with the year and your site name, and the WordPress and theme credits. All of it can be edited in the Footer template part.

Content

Patterns

In the block inserter, the theme patterns are in the categories that start with Definitivo. They all use native blocks and start their headings at level 2, so they sit below the page title. After inserting one, replace the sample text with your own.

PatternCategoryUse
Front page heroDefinitivo – HighlightsFront page opening with the site title as a level 2 heading and a card of weekly highlights.
Accessible heroDefinitivo – HighlightsHigh contrast opening with a clear heading and short supporting text.
Two-column aboutDefinitivo – GeneralIntroduction to a company or project.
Community highlightsDefinitivo – GeneralTwo columns with projects and activities.
Contact detailsDefinitivo – GeneralContact details with clear labels, no form plugin needed.
TestimonialDefinitivo – GeneralA quote with a heading and a visible attribution.
Search sectionDefinitivo – SearchSearch field with a visible label and a text button.
Post gridDefinitivo – PostsThree recent posts with title, date and excerpt.
Three servicesDefinitivo – ServicesThree service cards in a logical reading order.
Service cardsDefinitivo – ServicesSix cards with a decorative icon and their own link, in a grid that adapts to the width.
Product gridDefinitivo – WooCommercePaginated product grid with the same card used in the store. Available only when WooCommerce is active.
Institutional front pageDefinitivo – GeneralA complete front page: opening, purpose, services, testimonial, latest news and contact details. Use it with the Full-width page template.
Store front pageDefinitivo – WooCommerceA complete store front page: opening, categories, featured products, offers and new arrivals. Use it with the Full-width page template. Available only with WooCommerce active and WordPress 6.7 or later.

Both front pages also appear in the pattern window that opens when you create a new page. A product section with nothing to show, such as the offers when nothing is on sale, stays hidden on the site.

The WordPress core patterns are hidden, and the theme’s internal patterns, such as the header, the footer and the store content, do not appear in the inserter.

Publishing

Blog, archives and posts

  • The posts page shows articles in a two-column grid, with a sidebar for search and recent posts.
  • Each post title links to the post. Excerpts do not use ambiguous links such as “Read more”.
  • Sticky posts get a border and elevation, not just a different color.
  • A single post opens with its title and excerpt, followed by categories, date, author, featured image, content, categories and tags, post navigation and comments.
  • Nested comments keep their structure on narrow screens, and comment pagination is the native WordPress one.
  • Posts split with the <!--nextpage--> marker get numbered page links.
  • A post without a title is shown as “Untitled post”, so the page never lacks a main heading.
E-commerce

WooCommerce store

WooCommerce is optional. When it is active, the theme declares support for the plugin and presents the public store pages with WooCommerce’s native blocks. Prices, stock, shipping, taxes, payments and emails are still configured in WooCommerce itself.

PageWhat the theme presents
Shop and categoriesBreadcrumbs, a banner with the title and description, category shortcuts with the current category marked, native price, category and brand filters, WooCommerce’s native sorting, result count and pagination.
Product cardImage, category, name linked to the product, price, sale badge and, in the shop and search results, a purchase button.
ProductBreadcrumbs, a square gallery with thumbnails, arrows and lightbox, details with category, brand, SKU and tags, rating, price, summary, purchase panels with the variations and the quantity with minus and plus buttons, description and reviews, and the You may also like (upsells) and Related products sections.
CartItems, native coupons, an order summary with subtotal, discounts and shipping, a Complete your order section with cross-sells and an empty state with a link back to the store.
CheckoutPurchase steps and WooCommerce’s native checkout.
Order confirmationSummary, downloads, addresses and next steps, for physical and digital products.
My accountA welcome banner, the native account navigation in a sidebar, dashboard shortcuts and the downloads table.
Side cartA mini cart with the items, a summary of the totals and the native purchase actions.

To edit the store, open Appearance → Editor → Templates. The shop uses the Product Catalog template, and product categories, tags, attributes and brands each have their own. Texts and links can be changed and saved in the editor. To filter by an attribute, add the attribute filter to the filters block. To return to the theme’s version, use Reset in the template options.

Inclusion

Accessibility

Development follows the WordPress.org accessibility-ready guidelines. On October 15, 2026, the theme author completed an internal audit against WCAG 2.2 Level AA, with manual testing using the keyboard, zoom, text-only zoom, forced colors and the NVDA screen reader in Firefox and Chrome, including the store. It is not an independent audit, and the accessibility-ready tag only applies after the WordPress.org review. The accessibility.txt file in the theme folder holds the accessibility statement, the testing methodology and the features.

  • A “Skip to content” link, generated by WordPress from the main region of every template.
  • Labelled regions, with distinct names for the primary and footer navigation.
  • A single main heading (H1) per page and a consistent heading hierarchy.
  • A two-color focus indicator, visible on light and dark backgrounds.
  • Underlined links in content and a distinct color for visited links.
  • Buttons, fields and navigation controls at least 44 pixels tall.
  • Submenus that open on click and work with the keyboard. The Escape key closes the open submenu and returns focus to its button.
  • Reduced motion support and visible focus in forced colors mode.
  • Links with the same text and different destinations get names of their own, such as the latest comments, comment author names and categories that share a name with a tag.
  • In the store, the chosen price, stock and quantity are announced to screen readers, and the sorting list says that the product list updates when an option is chosen.
  • A screen-reader-text class for text meant only for screen readers.

Good practices for editors

  • Write alternative text for informative images, and leave it empty for decorative ones.
  • Use headings in order, without skipping levels.
  • Prefer link text that makes sense out of context.
  • Do not convey information through color alone.

To report an accessibility issue, email contato@wpdefinitivo.com with the affected page, the browser and, where applicable, the assistive technology you used.

Internationalization

Languages and translations

The theme’s source language is English. A Brazilian Portuguese translation ships with the package, so a site set to Português do Brasil shows the theme in Portuguese with no extra download.

For another language, use languages/wp-definitivo.pot as the base and save the translations as languages/LOCALE.po and languages/LOCALE.mo, replacing LOCALE with the language code. JavaScript messages also need the JSON files for the wp-definitivo domain. The instructions are in languages/README.md.

Text saved in the database, such as pages, products, menus and patterns you already inserted, does not change when the theme language changes.

Data

Privacy and external resources

WP Definitivo does not track visitors or administrators, sets no cookies of its own and makes no requests to external services. There is no telemetry, CDN, remote font, demo importer or custom update system.

Plugins such as WooCommerce have their own data practices, like the cart session cookies. Check each plugin’s documentation and keep your site’s privacy policy up to date.

Loading

Performance

  • Global styles come from theme.json. Besides the main stylesheet, the product, checkout, order confirmation and My account stylesheets only load on the pages that use them.
  • The scripts are small, do not depend on jQuery and only load where they are needed.
  • The side cart stylesheet only loads when the mini cart is on the page.
  • Every file gets a version based on its modification date, so browsers fetch the new copy after an update.
Help

Troubleshooting

I updated the theme and the header did not change.

The Header template part was customized in the Site Editor, and the version saved in the database takes precedence over the theme file. Use Reset on that template part to return to the theme version. Your changes to it will be discarded.

The menu I created does not appear in the header.

Creating a menu does not add it to the header. Select the Navigation block in the Header template part, choose the menu you want and save. Until you do, the header lists the published pages.

I cannot find the custom color option.

It is a theme decision: the editor only offers the palette with verified contrast. If you need other colors, create a child theme and check the contrast of every combination.

The store pages do not use the theme layout.

Make sure WooCommerce is active and the pages are set in WooCommerce → Settings → Advanced. If a page has another template selected in its own settings, that template takes precedence.

My changes do not show up on the site.

Clear the caching plugin, server and browser caches, then reload the page.

The theme appears in English.

Check the site language in Settings → General. The package includes Brazilian Portuguese. Other languages need a translation, as described in Languages and translations.

Scope

What the theme does not include

By design, WP Definitivo takes care of presentation. Features that change data or belong to plugins stay out of the theme:

  • a page builder or custom blocks;
  • custom post types, taxonomies and shortcodes;
  • contact forms;
  • SEO, analytics and tracking pixels;
  • a demo content importer;
  • auto-rotating sliders;
  • bundled or automatically installed plugins.

For those needs, choose plugins from the WordPress.org directory.

Project

Support, license and credits

For questions, accessibility issues or bug reports, use the contact page or email contato@wpdefinitivo.com.

WP Definitivo is distributed under the GNU General Public License v2 or later. The icons and the screenshot were created for the theme and use the same license. The theme uses system fonts and bundles no third-party fonts or images.

The version history is in the theme’s readme.txt file.

WP Definitivo is an independent project and is not affiliated with the WordPress Foundation, Automattic or WooCommerce.