✅ IW Banner Manager

📦 Pacote

Arquivos Disponíveis:

1. iw-banner-manager.zip (16KB)
   • Plugin completo pronto para instalação
   • Contém todos os arquivos necessários
   • Pronto para envio ao repositório WordPress.org
2. INSTRUCOES-INSTALACAO.md
   • Guia completo de instalação
   • Exemplos de código
   • Troubleshooting
   • Configurações
3. GUIA-RAPIDO.md
   • Referência rápida
   • Comandos principais
   • Exemplos básicos

---

📋 Conteúdo do Plugin

Estrutura Completa:

iw-banner-manager/
├── iw-banner-manager.php       # Arquivo principal (15.9KB)
├── uninstall.php               # Script de desinstalação
├── readme.txt                  # Documentação WordPress.org
├── README.md                   # Documentação GitHub
├── LICENSE                     # Licença GPL v2
├── .gitignore                  # Git ignore
│
├── assets/
│   ├── css/
│   │   ├── admin.css          # Estilos admin (1.6KB)
│   │   └── frontend.css       # Estilos frontend (1.9KB)
│   └── js/
│       └── frontend.js        # JavaScript (1.9KB)
│
├── templates/
│   ├── admin-meta-box.php     # Template metabox (4.9KB)
│   └── banner-display.php     # Template exibição (1KB)
│
└── languages/
    └── iw-banner-manager.pot  # Arquivo traduções (855B)

TOTAL: 17 arquivos | ~38KB descompactado | 16KB compactado

---

✨ Características Implementadas

Funcionalidades Principais:

✅ Custom Post Type “iw_banner”

• Gerenciamento completo de banners
• Interface intuitiva no admin

✅ Taxonomy “iw_banner_position”

• 3 posições: Topo, Meio, Inferior
• Criadas automaticamente na ativação

✅ Metabox de Configurações

• URL personalizada
• Ordem de exibição
• Ocultar em mobile
• Classes CSS customizadas

✅ Função PHP: iw_display_banners()

• Para uso em temas
• Parâmetros: posição e limite

✅ Shortcode:

• Para uso em posts/páginas
• Atributos: position e limit

✅ Recursos Avançados:

• Target automático para links externos
• Botão de fechar banner
• Design responsivo
• Acessibilidade (ARIA labels)
• Internacionalização (i18n)

---

🔒 Segurança

✅ Sanitização e Validação

• Todos os inputs sanitizados
• URLs validadas
• Nonces em formulários

✅ Proteções

• Escape de outputs (XSS)
• Prepared statements (SQL Injection)
• Verificação de permissões
• Proteção contra acesso direto

---

🎯 Padrões WordPress

✅ Coding Standards

• Segue WordPress Coding Standards
• Documentação PHPDoc completa
• Código limpo e organizado

✅ Estrutura

• Custom Post Type
• Taxonomy
• Meta Boxes
• Hooks e Filters
• Template System

✅ Performance

• Carregamento condicional de assets
• Queries otimizadas
• Código enxuto

---

📝 Como Usar

1. Instalação

bash

WordPress → Plugins → Adicionar Novo → Enviar Plugin
Selecionar: iw-banner-manager.zip
Instalar e Ativar

2. Criar Banner

Banners → Adicionar Novo
- Título: "Nome do Banner"
- Imagem Destacada: [Selecionar imagem]
- Posição: Banner Topo / Meio / Inferior
- URL: https://exemplo.com
- Publicar

3. Exibir no Tema

php

<?php
// Adicionar no header.php, index.php ou onde desejar

// Banner Topo
if ( function_exists( 'iw_display_banners' ) ) {
    iw_display_banners( 'banner-topo', 2 );
}

// Banner Meio (opcional)
if ( function_exists( 'iw_display_banners' ) ) {
    iw_display_banners( 'banner-meio', 2 );
}

// Banner Inferior
if ( function_exists( 'iw_display_banners' ) ) {
    iw_display_banners( 'banner-inferior', 2 );
}
?>

---