ALT Image Manager

Plugin WordPress para gerenciar e editar os atributos ALT de todas as imagens da biblioteca de mídia.

📋 Descrição

O ALT Image Manager é um plugin WordPress completo que permite:

• ✅ Escanear todas as imagens da biblioteca de mídia
• ✅ Visualizar thumbnails, nomes de arquivo e caminhos
• ✅ Ver o texto ALT atual de cada imagem
• ✅ Editar o ALT de cada imagem diretamente na lista
• ✅ 🤖 Gerar ALT automaticamente com IA (GRÁTIS) usando Hugging Face
• ✅ Salvar alterações via AJAX sem recarregar a página
• ✅ Interface moderna, limpa e responsiva
• ✅ Estatísticas de imagens com e sem ALT

🚀 Instalação

Método 1: Upload Manual

1. Faça upload da pasta alt-editor para /wp-content/plugins/
2. Ative o plugin através do menu 'Plugins' no WordPress
3. Acesse Ferramentas > ALT Image Manager no admin

Método 2: Via WordPress Admin

1. Vá em Plugins > Adicionar Novo
2. Clique em Fazer Upload do Plugin
3. Selecione o arquivo ZIP do plugin
4. Clique em Instalar Agora e depois Ativar

📁 Estrutura de Arquivos

alt-editor/
├── alt-editor.php                          # Arquivo principal do plugin
├── admin/
│   └── class-alt-editor-admin.php         # Classe admin com lógica backend
├── assets/
│   ├── css/
│   │   └── admin.css                      # Estilos da interface
│   └── js/
│       └── admin.js                       # JavaScript para AJAX e interação
└── README.md                              # Este arquivo

🎯 Como Usar

1. Ativar o Plugin

   • Vá em Plugins no WordPress Admin
   • Encontre "ALT Image Manager" e clique em Ativar

2. Acessar a Interface

   • No menu lateral, vá em Ferramentas > ALT Image Manager

3. Carregar Imagens

   • Clique no botão Carregar Imagens
   • O plugin irá escanear toda a biblioteca de mídia

4. Editar ALT

   • Cada imagem aparecerá em um card com:
     • Thumbnail da imagem
     • Nome do arquivo
     • Data de upload
     • Campo de texto para editar o ALT
     • Botão "Salvar ALT"
     • Botão "Ver" para abrir a imagem em nova aba

5. Salvar Alterações

   • Digite o novo texto ALT no campo
   • Clique em Salvar ALT
   • A alteração é salva via AJAX instantaneamente
   • Uma mensagem de sucesso aparecerá

🔧 Recursos Técnicos

Backend (PHP)

• Classe Modular: ALT_Editor_Admin organiza toda a lógica
• Hooks WordPress: admin_menu, admin_enqueue_scripts, wp_ajax_*
• Segurança: Verificação de nonce e current_user_can('manage_options')
• AJAX Handlers:
  • alt_editor_get_images: Retorna todas as imagens da biblioteca
  • alt_editor_update_alt: Atualiza o ALT de uma imagem

Frontend (JavaScript)

• jQuery: Para manipulação DOM e AJAX
• Fetch/AJAX: Comunicação assíncrona com o backend
• Renderização Dinâmica: Grid de cards gerado via JavaScript
• Feedback Visual: Loading states, mensagens de sucesso, estatísticas

Estilos (CSS)

• Design Moderno: Interface limpa seguindo padrões do WordPress
• Responsivo: Grid adaptável para mobile, tablet e desktop
• Animações: Transições suaves e feedback visual
• Acessibilidade: Cores contrastantes e elementos focáveis

🔐 Segurança

• ✅ Verificação de nonce em todas as requisições AJAX
• ✅ Verificação de permissões (manage_options)
• ✅ Sanitização de inputs (sanitize_text_field, absint)
• ✅ Escape de outputs (esc_html, esc_attr)
• ✅ Proteção contra acesso direto aos arquivos

📊 Estatísticas

O plugin exibe:

• Total de Imagens: Quantidade total na biblioteca
• Com ALT: Imagens que possuem texto ALT
• Sem ALT: Imagens sem texto ALT (precisam de atenção)

🎨 Interface

A interface foi desenvolvida com foco em:

• Simplicidade: Fácil de usar, sem complexidade
• Clareza: Informações organizadas e visíveis
• Eficiência: AJAX para salvar sem recarregar
• Feedback: Mensagens claras de sucesso/erro

🛠️ Requisitos

• WordPress 5.0 ou superior
• PHP 7.0 ou superior
• Permissões de administrador (manage_options)

📝 Changelog

Versão 1.0.0

• Lançamento inicial
• Listagem de todas as imagens da biblioteca
• Edição inline de texto ALT
• Salvamento via AJAX
• Interface responsiva e moderna
• Estatísticas de imagens

👨‍💻 Desenvolvedor

Giovanni Pajeu Lima

🔗 LinkedIn

📄 Licença

Este plugin é software livre; você pode redistribuí-lo e/ou modificá-lo sob os termos da GNU General Public License versão 2 ou posterior, conforme publicada pela Free Software Foundation.

Este programa é distribuído na esperança de que seja útil, mas SEM QUALQUER GARANTIA; sem mesmo a garantia implícita de COMERCIALIZAÇÃO ou ADEQUAÇÃO A UM PROPÓSITO ESPECÍFICO. Veja a GNU General Public License para mais detalhes.

License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

🆘 Suporte

Para suporte ou dúvidas sobre o plugin, entre em contato com o desenvolvedor.

---

Desenvolvido com ❤️ para facilitar a gestão de acessibilidade de imagens no WordPress