Añade un agente de voz con IA a ProcessWire

Cómo añadir AnveVoice a un sitio ProcessWire

ProcessWire no tiene un ajuste global de scripts porque el marcado es tuyo. Pon la etiqueta de AnveVoice en el único archivo que imprime la estructura de la página, normalmente site/templates/_main.php, y vacía cualquier caché de plantillas para que los visitantes reciban el nuevo marcado. Pasos comprobados con la documentación oficial el 2026-10-14.

En resumen

• Dónde va el código: site/templates/_main.php (el archivo de layout añadido), encima de </body>
• Programación necesaria: Pegar una línea en un archivo PHP/HTML; no se necesita lógica PHP
• Límites del plan: Ninguno. ProcessWire es de código abierto y autoalojado
• Tiempo: Unos 3 minutos

Localiza el archivo que imprime tus páginas

Los archivos de plantilla de ProcessWire están en /site/templates/. La forma en que se ensambla el HTML final depende de la estrategia de salida del sitio. La documentación describe la salida directa, la salida diferida y las regiones de marcado. En el patrón diferido, un archivo _init.php establece los valores por defecto, los archivos de plantilla individuales cambian lo que es distinto, y _main.php contiene todo el documento HTML, de modo que el head y el pie se imprimen allí. ProcessWire los carga automáticamente cuando site/config.php define prependTemplateFile y appendTemplateFile. Tu sitio podría estar configurado de otra forma, por ejemplo con archivos de inclusión separados para el head y el pie, o con un perfil como el perfil de sitio por defecto. El objetivo es el mismo: encontrar el único archivo cuya salida termina con la etiqueta de cierre body. Abre Setup (Configuración) > Templates (Plantillas), elige una plantilla y mira su pestaña Files para ver si los archivos de prepend o append están activos; la página de regiones de marcado indica que el ajuste de append puede desactivarse por plantilla.

• 1. Obtén tu ID de incrustación — Inicia sesión en app.anvevoice.app con el plan Free, crea un bot de voz para tu sitio y copia su ID de incrustación en la etiqueta. Los parámetros opcionales establecen la esquina y el esquema de colores. <script src="https://anvevoice.app/embed.js?embedId=YOUR_EMBED_ID" async></script>

Método 1: editar _main.php

Si tu _main.php usa regiones de marcado, la misma línea funciona sin cambios, ya que las regiones solo transforman elementos que llevan ids o atributos pw-. La documentación también muestra cómo definir una región opcional vacía antes de </body> a la que las plantillas individuales pueden añadir contenido, lo cual resulta útil si solo algunas plantillas deben cargar el agente de voz.

• 1. Abre el archivo — Edita site/templates/_main.php por SFTP o en tu editor. Localiza la línea de cierre </body> cerca del final.
• 2. Pega la etiqueta — Añade la línea de AnveVoice en su propia línea justo encima de </body>. Va fuera de cualquier etiqueta PHP, así que se imprime como HTML normal.
• 3. Guarda y recarga — Sube el archivo si lo editaste en local, y después recarga una página con la sesión cerrada en el panel de administración.

Método 2: solo en determinadas plantillas

Para limitar el agente, envuelve la línea en una condición PHP dentro de _main.php. Por ejemplo, compara $page->template->name con las plantillas que quieras e imprime la etiqueta solo para ellas. Con regiones de marcado, una región vacía más un atributo pw-append en el archivo de plantilla elegido logra el mismo resultado sin PHP en el layout. La documentación indica que debe usarse la forma con valor del atributo para conservar el src del script.

Caché de plantillas y actualizaciones

ProcessWire puede guardar en caché la salida renderizada de cada página por plantilla. La referencia de la API describe cacheTime en segundos, donde 0 desactiva la caché, y useCacheForUsers, donde el valor por defecto 0 sirve la caché solo a los visitantes invitados. Eso significa que puedes estar conectado, ver la nueva etiqueta y preguntarte por qué los visitantes no la ven, o al revés. Después de editar _main.php, vacía la caché de las plantillas afectadas o establece cacheTime en 0 mientras pruebas. La configuración cacheExpire controla qué se caduca al guardar una página, pero cambiar un archivo de plantilla no es guardar una página, así que tendrás que vaciarla tú.

Comprueba que funciona

• 1. Usa una ventana privada — Como la caché se aplica a los invitados, una ventana privada muestra lo que reciben los visitantes.
• 2. Busca el botón — El micrófono redondo aparece abajo a la derecha por defecto. Haz clic, permite el acceso al micrófono y haz una pregunta.
• 3. Verifica el marcado — Mira el código fuente y busca anvevoice.app. Una coincidencia significa una sola copia; ProcessWire no la duplicará por sí mismo.

Problemas comunes

• Ningún cambio en el sitio en vivo: la salida está en caché. Vacía la caché de plantillas o espera a que transcurra el tiempo de caché.
• La etiqueta aparece solo en algunas páginas: esas plantillas no usan el _main.php con append, o lo evitan con su propio HTML completo.
• Error de sintaxis tras editar: colocaste la etiqueta dentro de un bloque PHP abierto. Cierra primero PHP con su etiqueta de cierre, o mueve la línea fuera del bloque.
• Micrófono bloqueado: el sitio necesita HTTPS; revisa el nombre de host con el que estás probando.

Fuentes

• Documentación de ProcessWire: salida diferida (_init.php, _main.php, archivos de plantilla append y prepend) (https://processwire.com/docs/front-end/output/delayed/) — consultado el 2026-10-14
• Documentación de ProcessWire: regiones de marcado (appendTemplateFile, regiones, pw-optional) (https://processwire.com/docs/front-end/output/markup-regions/) — consultado el 2026-10-14
• Referencia de la API de ProcessWire: Template (cacheTime, useCacheForUsers, cacheExpire) (https://processwire.com/api/ref/template/) — consultado el 2026-10-14

Relacionado

• Cómo añadir AnveVoice a un sitio Grav
• Cómo añadir AnveVoice a un sitio de ExpressionEngine
• Cómo añadir AnveVoice a un sitio de DNN
• Cómo añadir AnveVoice a un sitio web HTML sencillo

Prueba AnveVoice en tu sitio

Plan gratuito: 0 US$, 50.000 tokens al mes, sin tarjeta. Obtén tu ID de inserción en el panel y pega una etiqueta.