39 lines
1.7 KiB
Markdown
Executable File
39 lines
1.7 KiB
Markdown
Executable File
# Regras de Layouts e Templates Twig
|
|
|
|
## 1. Layouts Disponíveis
|
|
O sistema SysCMS utiliza uma estrutura específica de templates Twig. NÃO invente nomes de layouts. Utilize apenas os existentes.
|
|
|
|
### Layouts Principais
|
|
- **Painel Administrativo (Backend):** `layouts/dashboard.twig`
|
|
- Use este layout para todas as páginas internas do painel de controle, módulos administrativos, e páginas de erro do admin.
|
|
- **Caminho:** `app/templates/layouts/dashboard.twig`
|
|
- **Exemplo de uso:** `{% extends "layouts/dashboard.twig" %}`
|
|
|
|
- **Layout Base (Genérico):** `layouts/base.twig`
|
|
- Use apenas se precisar de uma estrutura HTML mínima sem a barra de navegação e sidebar do dashboard.
|
|
- **Caminho:** `app/templates/layouts/base.twig`
|
|
|
|
- **Frontend/Público:**
|
|
- O frontend geralmente utiliza temas dinâmicos localizados em `public/themes/`.
|
|
- Para páginas de erro ou sistema genéricas, verifique `app/templates/default.twig`.
|
|
|
|
## 2. Erros Comuns a Evitar
|
|
- **NUNCA** use `{% extends "layout.twig" %}`. Este arquivo NÃO existe.
|
|
- **NUNCA** use `{% extends "admin.twig" %}`.
|
|
- Sempre verifique a pasta `app/templates/layouts/` para confirmar o nome correto do arquivo antes de estender.
|
|
|
|
## 3. Estrutura de Pastas de Templates
|
|
```
|
|
app/templates/
|
|
├── layouts/
|
|
│ ├── dashboard.twig (O MAIS IMPORTANTE)
|
|
│ └── base.twig
|
|
├── errors/ (Páginas de erro devem estender layouts/dashboard.twig)
|
|
├── components/ (Componentes reutilizáveis)
|
|
└── modules/ (Templates específicos de instalação de módulos)
|
|
```
|
|
|
|
## 4. Injeção de CSS/JS
|
|
- Utilize `{% block head %}` para adicionar CSS específico da página.
|
|
- Utilize `{% block scripts %}` (se disponível no layout) ou adicione scripts no final do `{% block content %}` se necessário.
|