# Tema DaggerRO - Documentação

## 📋 Visão Geral

O **Tema DaggerRO** é um tema moderno e responsivo para FluxCP com design medieval, desenvolvido especificamente para servidores de Ragnarok Online. Ele combina estética medieval com funcionalidades modernas e design responsivo.

## 🎨 Características

### Design
- ✅ **Estilo Medieval** - Visual inspirado em jogos medievais
- ✅ **Totalmente Responsivo** - Funciona perfeitamente em desktop, tablet e mobile
- ✅ **Paleta de Cores Customizada** - Branco, Laranja, Azul e Dourado
- ✅ **Animações Suaves** - Transições e efeitos modernos em CSS3
- ✅ **Google Fonts** - Tipografia profissional (Cinzel + Lato)

### Funcionalidades
- ✅ **Login Visível** - Formulário de login sempre visível na página inicial
- ✅ **Menu Responsivo** - Navegação mobile-friendly com hamburger menu
- ✅ **Dropdown Animados** - Menus dropdown com animações suaves
- ✅ **Estatísticas em Tempo Real** - Exibição de contas, personagens, guilds e jogadores online
- ✅ **Sistema de Notícias** - Integração com o CMS de notícias do FluxCP
- ✅ **Compatibilidade Total** - Mantém todas as funcionalidades do FluxCP

## 🎨 Paleta de Cores

```css
--color-primary: #1e3a8a      /* Deep Blue */
--color-secondary: #f97316    /* Orange */
--color-gold: #fbbf24         /* Gold */
--color-white: #ffffff        /* White */
--color-light: #f8fafc        /* Light Gray */
--color-dark: #1e293b         /* Dark Gray */
```

## 📁 Estrutura de Arquivos

```
themes/daggerro/
├── css/
│   ├── daggerro.css          # CSS principal do tema
│   └── flux/                 # CSS de compatibilidade
│       ├── unitip.css
│       ├── recaptcha.css
│       └── ie.css
├── img/
│   └── logo.png              # Logo do servidor
├── main/
│   ├── navbar.php            # Barra de navegação
│   ├── loginbox.php          # Caixa de login
│   ├── userinfo.php          # Informações do usuário logado
│   ├── submenu.php           # Sub-menu
│   ├── pagemenu.php          # Breadcrumb
│   ├── balance.php           # Saldo de créditos
│   └── index.php             # Página principal
├── header.php                # Cabeçalho global
├── footer.php                # Rodapé global
└── manifest.php              # Informações do tema
```

## 🚀 Instalação

### 1. Arquivos já estão instalados
Os arquivos do tema já foram criados em `themes/daggerro/`

### 2. Configuração
O tema já foi configurado como padrão em `config/application.php`:
```php
'SiteTitle' => 'DaggerRO',
'ThemeName' => array('daggerro', 'default', 'bootstrap'),
```

### 3. Ativar o Tema
1. Acesse o FluxCP
2. No rodapé da página, selecione "daggerro" no seletor de temas
3. O tema será aplicado automaticamente

## 🎯 Componentes Principais

### Header (header.php)
- Logo do servidor
- Menu de navegação responsivo
- Scripts jQuery e funções JavaScript

### Navbar (main/navbar.php)
- Menu principal com dropdowns
- Menu administrativo (quando logado como GM)
- Responsivo com menu mobile

### Login Box (main/loginbox.php)
- Formulário de login visível
- Suporte a CAPTCHA/reCAPTCHA
- Seletor de servidor (se múltiplos)
- Links para criar conta e recuperar senha

### User Info (main/userinfo.php)
- Informações do usuário logado
- Seletor de servidor preferido
- Links rápidos (Minha Conta, Personagens, Sair)

### Página Principal (main/index.php)
- Hero section com call-to-action
- Cards de features
- Estatísticas do servidor em tempo real
- Integração com sistema de notícias
- Links para redes sociais

### Footer (footer.php)
- Links rápidos
- Configurações (tema e idioma)
- Informações de copyright
- Detalhes de renderização (se habilitado)

## 🎨 Customização

### Alterar Cores
Edite as variáveis CSS em `css/daggerro.css`:
```css
:root {
    --color-primary: #1e3a8a;
    --color-secondary: #f97316;
    --color-gold: #fbbf24;
    /* ... */
}
```

### Alterar Logo
Substitua o arquivo `img/logo.png` pela sua logo

### Alterar Fontes
Modifique as importações no início do `css/daggerro.css`:
```css
@import url('https://fonts.googleapis.com/css2?family=SuaFonte&display=swap');
```

### Personalizar Página Inicial
Edite `main/index.php` para alterar:
- Texto do hero
- Features exibidas
- Estatísticas
- Links de redes sociais

## 📱 Responsividade

O tema é totalmente responsivo com breakpoints em:
- **Desktop**: > 1024px
- **Tablet**: 768px - 1024px
- **Mobile**: < 768px

### Menu Mobile
- Ativa automaticamente em telas < 768px
- Botão hamburger para abrir/fechar
- Dropdowns funcionam com clique

## 🔧 Compatibilidade

### Navegadores Suportados
- ✅ Chrome/Edge (últimas versões)
- ✅ Firefox (últimas versões)
- ✅ Safari (últimas versões)
- ⚠️ Internet Explorer 11 (suporte limitado)

### FluxCP
- ✅ Compatível com FluxCP 1.0+
- ✅ Mantém todas as funcionalidades do sistema
- ✅ Suporta todos os módulos padrão

## 🎯 Funcionalidades Mantidas

Todas as funcionalidades do FluxCP são mantidas:
- ✅ Sistema de login/logout
- ✅ Criação de contas
- ✅ Gerenciamento de personagens
- ✅ Item shop
- ✅ Doações
- ✅ Rankings
- ✅ Service desk
- ✅ Logs
- ✅ Administração
- ✅ E muito mais...

## 🐛 Troubleshooting

### Logo não aparece
- Verifique se o arquivo `img/logo.png` existe
- Verifique as permissões do arquivo

### Estilos não carregam
- Limpe o cache do navegador (Ctrl+F5)
- Verifique se o arquivo `css/daggerro.css` existe

### Menu mobile não funciona
- Verifique se o jQuery está carregando
- Abra o console do navegador (F12) para ver erros

### Tema não aparece no seletor
- Verifique se está em `config/application.php`
- Limpe o cache do FluxCP

## 📝 Notas Importantes

### Segurança
- ✅ Mantém todas as proteções de segurança do FluxCP
- ✅ Sanitização de inputs
- ✅ Proteção contra XSS
- ✅ Validação de formulários

### Performance
- ✅ CSS otimizado
- ✅ Fontes carregadas de forma assíncrona
- ✅ Imagens otimizadas
- ✅ Código minificado quando possível

### SEO
- ✅ Meta tags apropriadas
- ✅ Estrutura semântica HTML5
- ✅ Títulos e descrições customizáveis

## 🎨 Exemplos de Uso

### Adicionar Nova Feature na Home
Edite `main/index.php` e adicione um novo card:
```html
<div class="dagger-feature-card">
    <span class="dagger-feature-icon">🎯</span>
    <h3>Sua Feature</h3>
    <p>Descrição da sua feature aqui!</p>
</div>
```

### Alterar Links de Redes Sociais
Edite `main/index.php` na seção de comunidade:
```html
<a href="https://facebook.com/seu-servidor" class="dagger-btn dagger-btn-secondary">
    📘 Facebook
</a>
```

### Adicionar Estatística Customizada
Edite `main/index.php` e adicione um novo card de estatística:
```html
<div class="dagger-stat-card">
    <span class="dagger-stat-number">999</span>
    <span class="dagger-stat-label">Sua Estatística</span>
</div>
```

## 📞 Suporte

Para suporte ou dúvidas sobre o tema:
1. Verifique esta documentação
2. Consulte a documentação do FluxCP
3. Entre em contato com o suporte do servidor

## 📄 Licença

Este tema foi desenvolvido para uso com FluxCP e segue as mesmas diretrizes de licença.

---

**Desenvolvido para DaggerRO** ⚔️  
**Versão:** 1.0.0  
**Data:** Janeiro 2026
