# Documentação de Estrutura do Tema CCST / Gov.br V2.5

Esta documentação detalha a finalidade dos principais arquivos encontrados na raiz deste tema WordPress.

## Arquivos Principais

- **`style.css`**: Define os metadados do tema para o WordPress reconhecê-lo (Nome, Versão, Autor) e traz estilos principais/globais.
- **`functions.php`**: Arquivo base para adicionar suporte a features do tema, carregar scripts e estilos, definir menus, sidebars e hooks personalizados.
- **`index.php`**: O fallback principal do WordPress para exibir listas de posts caso não exista `home.php` ou `archive.php`.
- **`header.php`**: Contém a tag `<head>`, abertura do `<body>` e o cabeçalho padrão com logos e menu de navegação do Governo Federal.
- **`footer.php`**: Contém o rodapé padrão com links importantes, encerramento do layout estrutural e a inclusão de scripts de rastreamento (`template-parts/footer/footer-scripts.php`).
- **`sidebar.php`**: Define a estrutura da barra lateral onde os widgets cadastrados via painel são exibidos.

## Templates de Página e Conteúdo

- **`page.php`**: Template padrão para exibir o conteúdo de Páginas estáticas.
- **`single.php`**: Template padrão para exibir um Post individual do blog/notícias.
- **`archive.php`**: Template para exibição de categorias, tags, taxonomias personalizadas, ou arquivos baseados em data.
- **`search.php`**: Template para exibir os resultados das pesquisas feitas no site.
- **`404.php`**: A página de "Erro 404 - Não Encontrado", exibida quando uma URL requisitada não existe.
- **`content-none.php`**: Um template part utilizado quando um loop não retorna nenhum resultado.

## Páginas Específicas / Custom Templates

- **`tema_home.php`**: Possivelmente o template atribuído à página inicial do portal (Front Page). Traz os widgets ou áreas específicas de destaque.
- **`tema_contato.php`**: Template designado para a página de contato, estruturado para suportar formulários (geralmente integrados com Contact Form 7).

## Componentes do Sistema de Busca

- **`searchform.php`**: O formulário de busca genérico do site.
- **`searchform-publicacao.php`**: Um formulário de busca alternativo, muito provável customizado para buscar o CPT (Custom Post Type) de "Publicações".

## Recomendações de Uso

Para manter a modularidade do código:
- **Evite poluir o `functions.php`**: Se for adicionar um novo Custom Post Type, Shortcode ou Configuração extensa, crie um arquivo dentro da pasta `/inc/` e use `require_once` no `functions.php`.
- **Reutilize código com `get_template_part()`**: Partes de layout como banners, grids de notícias e pedaços do rodapé devem estar em `/template-parts/`.
