Instalar en WordPress
Instalar en WordPress
Requisitos
| Requisito | Mínimo | Recomendado |
|---|---|---|
| WordPress | 6.4 | 6.x última |
| PHP | 8.2 | 8.3 |
| MySQL / MariaDB | 8.0 / 10.6 | 8.0+ / 10.11+ |
| Extensiones PHP | openssl, json, mbstring, curl | — |
| HTTPS | Obligatorio | — |
| Memoria PHP | 128M | 256M |
Descarga
Tras la compra recibes un enlace de descarga:
wp-ai-assistant-1.0.0.zip (~91 KB)
Instalación
Método 1 — Desde el admin de WordPress (recomendado)
- Accede al dashboard WP.
- Ve a Plugins → Añadir nuevo.
- Pulsa Subir plugin arriba.
- Arrastra
wp-ai-assistant-1.0.0.zipo pulsa Examinar. - Pulsa Instalar ahora.
- Cuando termine, pulsa Activar plugin.
Método 2 — Carga vía FTP
- Extrae el zip localmente.
- Sube la carpeta
wp-ai-assistant/a/wp-content/plugins/por FTP/SFTP. - En el admin WP, Plugins → Plugins instalados, busca JoomlaAI for WordPress y pulsa Activar.
Primer setup
1. Abre los ajustes
Tras la activación aparece una nueva entrada de menú: JoomlaAI → Dashboard.
2. Añade una clave API
- JoomlaAI → Ajustes → Providers.
- Pega tu clave API para al menos un proveedor.
- Elige Default Provider y Default Model.
- Guardar cambios.
3. Configura el cron
WordPress incluye WP-Cron, pero solo se ejecuta cuando alguien visita el sitio. Para programaciones fiables, usa un cron real del sistema:
* * * * * wp --path=/path/to/wordpress cron event run --due-now >/dev/null 2>&1
O vía PHP:
* * * * * php /path/to/wordpress/wp-cron.php >/dev/null 2>&1
Opcionalmente desactiva el trigger por tráfico añadiendo a wp-config.php:
define('DISABLE_WP_CRON', true);
4. Verifica los eventos programados
wp cron event list
Deberías ver:
wpai_run_due_jobs— ejecuta los jobs de AI Schedulerwpai_provider_health— ping a todos los proveedoreswpai_cleanup_old_data— limpieza de datos antiguos
REST API
El plugin expone endpoints REST en /wp-json/wpai/v1/*. Están protegidos por nonce y por la capability wpai_use_chatbot (o equivalente).
| Endpoint | Método | Capability |
|---|---|---|
/wpai/v1/chat | POST | wpai_use_chatbot |
/wpai/v1/jobs | GET/POST | wpai_manage_jobs |
/wpai/v1/content | GET/POST | wpai_review_content |
/wpai/v1/health | GET | wpai_dashboard |
Checklist primer setup
- Plugin instalado y activado
- Al menos una clave API de proveedor introducida
- Proveedor y modelo por defecto elegidos
- Cron real del sistema configurado
- WP-Cron por tráfico desactivado (opcional pero recomendado)
- Dashboard carga sin errores
- Health Check no muestra problemas críticos
Actualizaciones
- Descarga el nuevo
wp-ai-assistant-X.Y.Z.zip. - Plugins → Añadir nuevo → Subir plugin → sube el nuevo zip.
- WordPress detecta el plugin existente y propone Sustituirlo. Confirma.
- Las migraciones de la base de datos se ejecutan automáticamente al activar.
Desinstalación
Las opciones de desinstalación están en Ajustes → Desinstalación:
- Preserve data on uninstall (default: ON) — mantiene las 15 tablas BD.
- Create SQL backup before uninstall — ejecuta un dump en
wp-content/uploads/wpai-backups/antes de la eliminación.
Para desinstalar: Plugins → Plugins instalados → Desactivar → Eliminar.
Troubleshooting
| Problema | Causa | Solución |
|---|---|---|
| Widget chatbot no aparece | Pantalla en lista de exclusiones | Ver Ajustes → Widget → Excluded screens |
| Jobs programados no se ejecutan | WP-Cron desactivado o sin trigger | Configura un cron real del sistema |
| Error 401 del proveedor | Clave API errónea | Regenera la clave desde el dashboard del proveedor |
Troubleshooting completo → Guía de troubleshooting.
_Última actualización: 2026-05-19 · v1.0.0_


