🚀 Auto Shortcode Inserter

Auto Shortcode Inserter é um plugin WordPress moderno, leve e seguro projetado para automatizar a injeção de shortcodes no início (topo), no meio (após N parágrafos) ou no fim (rodapé) das suas postagens e páginas.

---

🌐 Idiomas / Languages / Idiomas

• 🇧🇷 Português (PT-BR)
• 🇺🇸 English (EN)
• 🇪🇸 Español (ES)

---

🇧🇷 Português (PT-BR)

💡 Por que usar o Auto Shortcode Inserter?

Muitas vezes precisamos exibir elementos repetitivos em centenas de posts (como um leitor de texto em áudio para acessibilidade, banners promocionais do Google AdSense no meio do texto, ou um mapa e formulário de contato no rodapé). Inserir esses shortcodes manualmente em cada post é trabalhoso e inviável.

O Auto Shortcode Inserter resolve isso de forma centralizada e sem tocar no banco de dados original dos posts.

✨ Principais Recursos (v1.3.0)

• 3 Posições de Inserção Flexíveis:
  • Topo (Início): Antes do primeiro parágrafo (ideal para Leitores de Voz/Áudio, avisos, disclaimer).
  • Meio do Conteúdo: Após o N-ésimo parágrafo configurado (ideal para Banners de Afiliados, Google AdSense, Newsletters).
  • Rodapé (Final): Após o último parágrafo (ideal para Google Maps, Bio do autor, formulários de contato).
• Múltiplos Shortcodes: Suporte a múltiplos shortcodes por posição (um por linha).
• Suporte a Custom Post Types: Selecione facilmente quais tipos de conteúdo recebem os shortcodes (Posts, Páginas, Produtos WooCommerce, etc.).
• Exclusão de Posts por ID: Defina IDs de posts específicos que não devem receber shortcodes automáticos.
• Estilização e Alinhamento: Defina classes CSS customizadas para o wrapper e escolha o alinhamento (center, left, right, none).
• Segurança & Performance:
  • Proteção nativa contra recursão infinita no filtro the_content.
  • Sanitização rigorosa de inputs respeitando atributos e aspas de shortcodes.
  • Ignora feeds RSS para evitar quebra de validadores XML.
• 100% Coberto por Testes Automatizados (TDD-First).

📦 Instalação

1. Baixe o repositório como arquivo .zip ou clone para a pasta de plugins:

   git clone https://github.com/mailsonm/auto-shortcode-inserter.git wp-content/plugins/auto-shortcode-inserter

2. No painel do WordPress, acesse Plugins > Plugins Instalados e clique em Ativar.
3. Acesse o menu lateral Auto Shortcode para configurar seus shortcodes.

---

🇺🇸 English (EN)

💡 Why use Auto Shortcode Inserter?

Inserting repetitive elements across hundreds of blog posts (such as accessibility audio players, middle-content AdSense banners, or footer Google Maps) is tedious and hard to maintain.

Auto Shortcode Inserter provides a centralized, non-destructive way to automatically inject shortcodes dynamically into your content without modifying post content in the database.

✨ Key Features (v1.3.0)

• 3 Dynamic Placement Areas:
  • Top (Beginning): Injected before the post content (perfect for Text-to-Speech audio players, alerts).
  • Middle Content: Injected after paragraph N (ideal for Google AdSense, promotional banners, CTAs).
  • Bottom (End): Injected after the post content (ideal for Google Maps, contact forms, affiliate disclosures).
• Multiple Shortcodes: Enter multiple shortcodes per section (one per line).
• Custom Post Type Support: Granular control over which post types receive shortcodes (Posts, Pages, WooCommerce products, etc.).
• Post Exclusion: Exclude specific post IDs with a comma-separated list.
• Styling & Alignment: Custom container CSS wrapper and alignment settings (center, left, right, none).
• Security & Reliability:
  • Native recursion / loop protection on the_content filter.
  • Robust input sanitization preserving shortcode syntax and quotes.
  • Automatically bypassed on RSS feeds.
• 100% Automated Test Coverage (TDD-First).

📦 Installation

1. Download the repository as .zip or clone into your plugins directory:

   git clone https://github.com/mailsonm/auto-shortcode-inserter.git wp-content/plugins/auto-shortcode-inserter

2. In WordPress Admin, navigate to Plugins > Installed Plugins and click Activate.
3. Click on the Auto Shortcode menu in the sidebar to configure your settings.

---

🇪🇸 Español (ES)

💡 ¿Por qué usar Auto Shortcode Inserter?

Insertar elementos repetitivos en cientos de entradas (como reproductores de audio para accesibilidad, banners de anuncios en el medio del texto o mapas y formularios al final) de forma manual es ineficiente.

Auto Shortcode Inserter automatiza la inyección dinámica de shortcodes de forma segura y centralizada.

✨ Características Principales (v1.3.0)

• 3 Posiciones de Inserción:
  • Inicio (Encabezado): Antes del contenido (ideal para lectores de texto/audio).
  • Medio del Contenido: Después del párrafo número N (ideal para banners, AdSense y llamadas a la acción).
  • Final (Pie de página): Después del contenido (ideal para Google Maps, formularios de contacto).
• Múltiples Shortcodes: Añada varios shortcodes por posición (uno por línea).
• Soporte para Tipos de Publicación (CPT): Elija qué tipos de contenido recibirán los shortcodes.
• Exclusión de Publicaciones: Excluya IDs específicos fácilmente.
• Estilos y Alineación: Clase CSS personalizada y selector de alineación.
• Seguridad: Protección contra bucles infinitos y sanitización completa.

---

🧪 Testes Automatizados / Automated Testing (TDD)

Este projeto segue rigorosamente a metodologia TDD-First (Akita Way).

Para rodar os testes unitários em ambiente isolado via Docker:

docker run --rm -v "${PWD}:/app" -w /app php:8.3-cli php tests/test_auto_shortcode_inserter.php

---

👤 Autor

Mailson Maia Alves

• GitHub: @mailsonm

📄 Licença

Distribuído sob a licença MIT.