WP Manifestindependent plugin directory
manifest / media / narrador-de-post

Narrador de Post

Widget de conversão de texto em fala para posts do WordPress usando o Read Aloud Widget.

by Mailson Maia Alves · github.com/mailsonm/narrador-de-post · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/mailsonm/narrador-de-post/archive/refs/heads/master.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/mailsonm/narrador-de-post ↗

🎙️ Narrador de Post (v2.0.0 Híbrido)

Narrador de Post é um plugin para WordPress moderno, leve e híbrido que adiciona um leitor de áudio em seus artigos para conversão de texto em fala (TTS). Possui modo 100% gratuito e suporte a IA Neural de alta fidelidade (OpenAI TTS).

🌐 Idiomas / Languages / Idiomas

🇧🇷 Português (PT-BR)

💡 Por que usar o Narrador de Post?

Oferecer uma versão em áudio dos seus artigos aumenta drasticamente o tempo de permanência no site, melhora o SEO e garante acessibilidade para pessoas com deficiência visual ou usuários que preferem ouvir conteúdos enquanto realizam outras tarefas.

🌟 Modos de Operação (Arquitetura Híbrida)

1. Modo Gratuito (Vozes Neurais do Navegador)

  • Zero Custo: Não exige nenhuma chave de API e não consome créditos.
  • Vozes Naturais: Detecta automaticamente as melhores vozes neurais instaladas no dispositivo do visitante (ex: Microsoft Francisca/Antonio Online (Natural) no Edge/Windows, vozes de alta qualidade do Google no Chrome e Siri no Safari/iOS).
  • Anti-Congelamento de 15s: Algoritmo que divide o texto em blocos por pontuação, contornando o limite de 15 segundos da Web Speech API nos navegadores Chromium.
  • Player Completo: Botão Ouvir, Pausar, Continuar, Parar, Seletor de Velocidade (0.75x, 1x, 1.25x, 1.5x, 2x) e Barra de Progresso em tempo real.

2. Modo IA de Alta Fidelidade (OpenAI TTS - BYOK)

  • Qualidade de Podcast: Narração humana ultrarrealista com vozes de estúdio (Alloy, Echo, Fable, Onyx, Nova, Shimmer).
  • Bring Your Own Key (BYOK): O administrador utiliza sua própria chave da OpenAI sem depender de intermediários.
  • Cache Inteligente em MP3: O áudio é sintetizado uma única vez por post e salvo como .mp3 no seu WordPress (wp-content/uploads/narrador-de-post/), garantindo carregamento instantâneo e zero custo de API por visualização de página.

💰 Comparativo de APIs & Custo-Benefício

Como o plugin salva o arquivo .mp3 em cache local no WordPress, o áudio é sintetizado uma única vez por post (e não a cada visita do usuário), garantindo custo baixíssimo:

Provedor / API Camada Gratuita (Free Tier) Custo Estimado Qualidade (PT-BR) Onde Obter a Chave
🥇 Modo Gratuito (Navegador) Ilimitado (100% Grátis) R$ 0,00 ⭐⭐⭐⭐⭐ (Vozes Naturais) Nativa no plugin (Sem API)
🥈 Google Cloud TTS 1.000.000 caracteres/mês GRÁTIS ~$0,016 / 1k chars ⭐⭐⭐⭐⭐ (Neural2 / WaveNet) Google Cloud Console
🥉 Microsoft Azure Speech 500.000 caracteres/mês GRÁTIS (Plano F0) ~$0,016 / 1k chars ⭐⭐⭐⭐⭐ (Francisca / Antonio) Azure Portal
🔹 OpenAI Audio TTS Créditos iniciais ~$0,015 / 1k chars (~$0,05/post) ⭐⭐⭐⭐⭐ (Nova / Alloy / Echo) OpenAI Platform
👑 ElevenLabs 10.000 caracteres/mês GRÁTIS Planos a partir de $5/mês ⭐⭐⭐⭐⭐ (Estúdio / Cinema) ElevenLabs.io

🔑 Manual: Como Obter sua Chave de API OpenAI (Opcional)

Se você optar pelo Modo IA, siga o passo a passo para gerar sua chave:

  1. Acesse o painel de desenvolvedor da OpenAI: platform.openai.com/api-keys.
  2. Crie uma conta ou faça login.
  3. No menu lateral, clique em API keys e depois no botão "+ Create new secret key".
  4. Dê um nome à chave (ex: WordPress Narrador) e copie o código exibido (iniciado por sk-proj-...).
  5. No painel do seu WordPress, vá em Narrador de Post, cole a chave no campo OpenAI API Key, selecione a voz desejada e clique em Salvar Configurações.

🧩 Integração com o Auto Shortcode Inserter

O Narrador de Post disponibiliza o shortcode:

[narrador_de_post]

Você pode utilizar o plugin Auto Shortcode Inserter para injetar automaticamente o leitor de áudio no topo de todos os seus posts de forma centralizada!

🇺🇸 English (EN)

💡 Why use Post Narrator?

Providing an audio version of your blog posts increases reader engagement, boosts SEO, and ensures accessibility for visually impaired readers or multitaskers.

🌟 Key Features (Hybrid Architecture)

1. Free Mode (Browser Neural Voices)

  • 100% Free: Zero API keys required, zero running costs.
  • Natural Voice Engine: Automatically selects the best neural/natural voices on the visitor's device.
  • Anti-Freeze Chunking: Sentence-based chunking that prevents Chromium's 15-second speech synthesis timeout.
  • Complete Audio Player: Play, Pause, Resume, Stop, Speed selector (0.75x to 2x), and progress bar.

2. Studio AI Mode (OpenAI TTS - BYOK)

  • Human-like Audio: Realistic studio voices (Nova, Alloy, Echo, Onyx, Shimmer).
  • Local MP3 Caching: Synthesized once and cached in wp-content/uploads/narrador-de-post/, ensuring instant playback and zero recurring API costs per pageview.

🇪🇸 Español (ES)

💡 ¿Por qué usar Narrador de Post?

Ofrecer una versión en audio de tus artículos mejora la accesibilidad, aumenta el tiempo de permanencia en tu sitio web y optimiza el SEO.

🌟 Características Principales (Arquitectura Híbrida)

  • Modo Gratuito (Voces Neuronales): Sin costes de API. Utiliza sintetizadores nativos de alta calidad.
  • Modo IA de Estudio (OpenAI TTS): Voces humanas hiperrealistas con caché persistente en MP3.
  • Reproductor Moderno: Controles de reproducción, velocidad (0.75x - 2x) y barra de progreso.

🧪 Testes Automatizados / Automated Tests (TDD)

Execução dos testes unitários em PHP 8.3 via Docker:

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

👤 Autor

Mailson Maia Alves

📄 Licença

Distribuído sob a licença MIT.