0
Antes de abrir un tema de soporte consulta esta guía. La mayoría de problemas tienen solución rápida. Si no encuentras tu problema crea un tema en soporte.
INSTALACIÓN
¿Cuáles son los requisitos mínimos del servidor?
PHP 8.0+ (recomendado 8.2), MySQL 5.7+ o MariaDB 10.3+, Apache con mod_rewrite activado, allow_url_fopen activo y extensión GD. Consulta la Guía de requisitos y hostings compatibles de este foro.
¿Puedo instalar Risus Nova en un hosting gratuito?
No. Los hostings gratuitos (InfinityFree, 000webhost, AwardSpace...) tienen restricciones que impiden el funcionamiento correcto: mod_rewrite desactivado, file_get_contents bloqueado, timeouts muy cortos y sin SSL. Usa un hosting de pago desde 1,5€/mes.
El instalador da error al crear las tablas
Comprueba que el usuario de la base de datos tiene permisos de CREATE TABLE. En cPanel ve a MySQL → usuarios y asigna todos los privilegios al usuario de la BD.
El instalador se queda a medias o en blanco
El tiempo de ejecución de PHP es muy corto. Contacta con tu hosting para que aumenten el max_execution_time a 60 segundos o más.
¿Cómo sé si la instalación se completó correctamente?
Abre tudominio.com en el navegador. Si carga la home de Risus Nova la instalación fue correcta.
Después elimina la carpeta /install/ del servidor.
ERRORES FRECUENTES
Error 404 en todas las páginas
El módulo mod_rewrite de Apache no está activo.
Soluciones:
Error 500 — Internal Server Error
Es un error en el código o en la configuración.
Para ver el error exacto abre header.php y cambia temporalmente:
Por:
Recarga la página y verás el error exacto. Recuerda volver a ponerlo en FALSE cuando lo soluciones.
Página en blanco (sin error visible)
Igual que el error 500 — activa display_errors para ver qué falla.
Suele ser incompatibilidad de versión de PHP o un archivo corrupto.
Error: Unknown column 'X' in 'SET' o 'field list'
Falta ejecutar el SQL de instalación de algún complemento.
Ve a phpMyAdmin y ejecuta las consultas ALTER TABLE correspondientes al complemento que instalaste.
Error: Call to undefined function result_array()
El archivo functions.php no se está cargando correctamente. Comprueba que todos los archivos se subieron correctamente y que la carpeta inc/ext/ existe.
Fatal error: Class 'tsXXXX' not found
Falta subir algún archivo de clase. Comprueba que el archivo c.XXXX.php correspondiente está en inc/class/.
URLS Y NAVEGACIÓN
Las URLs amigables no funcionan
mod_rewrite no está activo o el .htaccess tiene un problema. Ver respuesta de Error 404 más arriba.
Al hacer clic en un enlace redirige a la home
El .htaccess tiene alguna regla mal escrita o conflictiva. Revisa que las rutas personalizadas que hayas añadido tienen la letra L al final: [QSA,L]
Las páginas /login/ y /registro/ dan error 404
Falta añadir las reglas en el .htaccess y los casos en el index.php. Consulta la guía de instalación del script.
CORREOS Y REGISTRO
Los correos de activación no llegan
La función mail() de PHP no funciona en muchos hostings.
Soluciones:
El registro da error en la verificación de seguridad
El Cloudflare Turnstile no puede verificarse porque allow_url_fopen está desactivado en tu hosting.
Soluciones:
CACHÉ Y PLANTILLAS
Hice cambios en un .tpl pero no se ven
Smarty cachea las plantillas compiladas.
Borra todos los archivos de:
Los cambios en CSS no se ven en el navegador
El navegador tiene el CSS antiguo en caché. Prueba con Ctrl+F5 o abre el sitio en modo incógnito.
El sitio muestra plantillas sin estilos o con errores de Smarty
Borra la carpeta /templates_c/ completa. Si persiste comprueba que los permisos de esa carpeta son 755 o 777.
IMÁGENES Y ARCHIVOS
No se pueden subir avatares o imágenes
Las carpetas de archivos no tienen permisos de escritura.
Pon permisos 777 en estas carpetas:
Las imágenes de los posts no se muestran
Comprueba que la carpeta /files/ y sus subcarpetas tienen permisos de lectura (777).
El editor CKEditor no carga
Comprueba que hay conexión a internet desde el servidor (el script de CKEditor se carga desde CDN).
Si el servidor tiene restricciones de salida puede que no pueda cargar scripts externos.
COMPLEMENTOS Y MODS
Instalé un complemento y el sitio da error 500
Suele ser porque falta ejecutar el SQL del complemento.
Ejecuta el archivo .sql incluido en el complemento desde phpMyAdmin.
Si sigue fallando activa display_errors en header.php para ver el error exacto.
El widget de donaciones no aparece en la home
El widget solo aparece si tienes al menos un método de pago configurado en Admin → Configuración → Donaciones.
Configura tu PayPal, Ko-fi o cualquier otro método y guarda.
Las notificaciones push no llegan
Comprueba que:
RENDIMIENTO
El sitio carga muy lento
Posibles causas y soluciones:
La home tarda mucho en cargar con muchos posts
Activa la caché de estadísticas en el admin.
Si tienes el modo "Home por categorías" activo con muchas categorías reduce el número de posts por categoría en Admin → Configuración.
SEO
Mi sitio no aparece en Google
Google tarda entre 1 y 4 semanas en indexar un sitio nuevo. Acelera el proceso registrando el sitemap en Google Search Console.
Consulta la Guía de Search Console de este foro.
El sitemap.xml da error 404
mod_rewrite no está activo o el .htaccess tiene algún problema.
Sin mod_rewrite las URLs dinámicas como /sitemap.xml no funcionan.
Los posts no tienen meta description
Risus Nova 2.x genera la meta description automáticamente — usa el slogan en la home y el extracto del post en las páginas individuales.
Si no aparece borra la caché de templates.
PREGUNTAS GENERALES
¿Cómo actualizo a una versión nueva?
Sube los archivos nuevos al servidor, ejecuta el upgrade desde /upgrade/ y ejecuta las consultas SQL indicadas en el CHANGELOG.
Borra las carpetas /cache/ y /templates_c/ después.
¿Puedo usar Risus Nova en localhost para hacer pruebas?
Sí. Instala XAMPP o Laragon en Windows, o LAMP en Linux. El proceso de instalación es el mismo.
Para el Turnstile en local usa las claves de prueba indicadas en la guía de Turnstile de este foro.
¿Dónde están los archivos de log de errores?
En hosting compartido busca Errores en la sección Métricas de cPanel.
En VPS están en /var/log/apache2/error.log.
También puedes activar display_errors en header.php para ver los errores directamente en pantalla.
¿Cómo hago una copia de seguridad?
Tienes que guardar dos cosas:
¿Puedo cambiar el dominio de mi instalación?
Sí. Ve a Admin → Configuración y cambia el campo URL del sitio.
También comprueba el archivo config.inc/config.php si la URL está hardcodeada ahí.
¿Tu problema no está en esta lista?
Abre un tema:
INSTALACIÓN
¿Cuáles son los requisitos mínimos del servidor?
PHP 8.0+ (recomendado 8.2), MySQL 5.7+ o MariaDB 10.3+, Apache con mod_rewrite activado, allow_url_fopen activo y extensión GD. Consulta la Guía de requisitos y hostings compatibles de este foro.
¿Puedo instalar Risus Nova en un hosting gratuito?
No. Los hostings gratuitos (InfinityFree, 000webhost, AwardSpace...) tienen restricciones que impiden el funcionamiento correcto: mod_rewrite desactivado, file_get_contents bloqueado, timeouts muy cortos y sin SSL. Usa un hosting de pago desde 1,5€/mes.
El instalador da error al crear las tablas
Comprueba que el usuario de la base de datos tiene permisos de CREATE TABLE. En cPanel ve a MySQL → usuarios y asigna todos los privilegios al usuario de la BD.
El instalador se queda a medias o en blanco
El tiempo de ejecución de PHP es muy corto. Contacta con tu hosting para que aumenten el max_execution_time a 60 segundos o más.
¿Cómo sé si la instalación se completó correctamente?
Abre tudominio.com en el navegador. Si carga la home de Risus Nova la instalación fue correcta.
Después elimina la carpeta /install/ del servidor.
ERRORES FRECUENTES
Error 404 en todas las páginas
El módulo mod_rewrite de Apache no está activo.
Soluciones:
- En cPanel busca Apache Handlers o mod_rewrite y actívalo
- En VPS ejecuta: a2enmod rewrite && systemctl restart apache2
- Comprueba que el archivo .htaccess existe en la raíz del sitio — algunos FTP ocultan los archivos que empiezan por punto
Error 500 — Internal Server Error
Es un error en el código o en la configuración.
Para ver el error exacto abre header.php y cambia temporalmente:
Código: ( Seleccionar Todo )
ini_set('display_errors', FALSE);Por:
Código: ( Seleccionar Todo )
ini_set('display_errors', TRUE);Recarga la página y verás el error exacto. Recuerda volver a ponerlo en FALSE cuando lo soluciones.
Página en blanco (sin error visible)
Igual que el error 500 — activa display_errors para ver qué falla.
Suele ser incompatibilidad de versión de PHP o un archivo corrupto.
Error: Unknown column 'X' in 'SET' o 'field list'
Falta ejecutar el SQL de instalación de algún complemento.
Ve a phpMyAdmin y ejecuta las consultas ALTER TABLE correspondientes al complemento que instalaste.
Error: Call to undefined function result_array()
El archivo functions.php no se está cargando correctamente. Comprueba que todos los archivos se subieron correctamente y que la carpeta inc/ext/ existe.
Fatal error: Class 'tsXXXX' not found
Falta subir algún archivo de clase. Comprueba que el archivo c.XXXX.php correspondiente está en inc/class/.
URLS Y NAVEGACIÓN
Las URLs amigables no funcionan
mod_rewrite no está activo o el .htaccess tiene un problema. Ver respuesta de Error 404 más arriba.
Al hacer clic en un enlace redirige a la home
El .htaccess tiene alguna regla mal escrita o conflictiva. Revisa que las rutas personalizadas que hayas añadido tienen la letra L al final: [QSA,L]
Las páginas /login/ y /registro/ dan error 404
Falta añadir las reglas en el .htaccess y los casos en el index.php. Consulta la guía de instalación del script.
CORREOS Y REGISTRO
Los correos de activación no llegan
La función mail() de PHP no funciona en muchos hostings.
Soluciones:
- Configura el SMTP desde Admin → Configuración → Email SMTP con Gmail, Outlook o el email de tu hosting
- Consulta la Guía de configuración SMTP de este foro
- Los correos pueden ir a la carpeta de spam — avisa a los usuarios que lo revisen
El registro da error en la verificación de seguridad
El Cloudflare Turnstile no puede verificarse porque allow_url_fopen está desactivado en tu hosting.
Soluciones:
- Contacta con tu hosting para que activen allow_url_fopen
- Configura una Pregunta de seguridad en Admin → Configuración como alternativa al Turnstile
CACHÉ Y PLANTILLAS
Hice cambios en un .tpl pero no se ven
Smarty cachea las plantillas compiladas.
Borra todos los archivos de:
- /cache/ — caché de páginas
- /templates_c/ — plantillas compiladas
Los cambios en CSS no se ven en el navegador
El navegador tiene el CSS antiguo en caché. Prueba con Ctrl+F5 o abre el sitio en modo incógnito.
El sitio muestra plantillas sin estilos o con errores de Smarty
Borra la carpeta /templates_c/ completa. Si persiste comprueba que los permisos de esa carpeta son 755 o 777.
IMÁGENES Y ARCHIVOS
No se pueden subir avatares o imágenes
Las carpetas de archivos no tienen permisos de escritura.
Pon permisos 777 en estas carpetas:
Código: ( Seleccionar Todo )
/cache/
/templates_c/
/files/avatar/
/files/images/
/files/uploads/
/files/posts/Las imágenes de los posts no se muestran
Comprueba que la carpeta /files/ y sus subcarpetas tienen permisos de lectura (777).
El editor CKEditor no carga
Comprueba que hay conexión a internet desde el servidor (el script de CKEditor se carga desde CDN).
Si el servidor tiene restricciones de salida puede que no pueda cargar scripts externos.
COMPLEMENTOS Y MODS
Instalé un complemento y el sitio da error 500
Suele ser porque falta ejecutar el SQL del complemento.
Ejecuta el archivo .sql incluido en el complemento desde phpMyAdmin.
Si sigue fallando activa display_errors en header.php para ver el error exacto.
El widget de donaciones no aparece en la home
El widget solo aparece si tienes al menos un método de pago configurado en Admin → Configuración → Donaciones.
Configura tu PayPal, Ko-fi o cualquier otro método y guarda.
Las notificaciones push no llegan
Comprueba que:
- El sitio tiene HTTPS activo — sin SSL las push no funcionan
- Las claves VAPID están configuradas en el admin
- El archivo sw.js está en la raíz del sitio
- El usuario ha dado permiso en el navegador
- No funciona en Safari de iOS (iPhone/iPad) — es una limitación del navegador
RENDIMIENTO
El sitio carga muy lento
Posibles causas y soluciones:
- Activa la caché de estadísticas en Admin → Configuración
- Activa Gzip/Brotli en tu hosting
- Si usas Cloudflare activa la caché automática
- Comprueba si tienes consultas lentas con el log de MySQL lento
- Un hosting barato o saturado también puede ser la causa — prueba con otro
La home tarda mucho en cargar con muchos posts
Activa la caché de estadísticas en el admin.
Si tienes el modo "Home por categorías" activo con muchas categorías reduce el número de posts por categoría en Admin → Configuración.
SEO
Mi sitio no aparece en Google
Google tarda entre 1 y 4 semanas en indexar un sitio nuevo. Acelera el proceso registrando el sitemap en Google Search Console.
Consulta la Guía de Search Console de este foro.
El sitemap.xml da error 404
mod_rewrite no está activo o el .htaccess tiene algún problema.
Sin mod_rewrite las URLs dinámicas como /sitemap.xml no funcionan.
Los posts no tienen meta description
Risus Nova 2.x genera la meta description automáticamente — usa el slogan en la home y el extracto del post en las páginas individuales.
Si no aparece borra la caché de templates.
PREGUNTAS GENERALES
¿Cómo actualizo a una versión nueva?
Sube los archivos nuevos al servidor, ejecuta el upgrade desde /upgrade/ y ejecuta las consultas SQL indicadas en el CHANGELOG.
Borra las carpetas /cache/ y /templates_c/ después.
¿Puedo usar Risus Nova en localhost para hacer pruebas?
Sí. Instala XAMPP o Laragon en Windows, o LAMP en Linux. El proceso de instalación es el mismo.
Para el Turnstile en local usa las claves de prueba indicadas en la guía de Turnstile de este foro.
¿Dónde están los archivos de log de errores?
En hosting compartido busca Errores en la sección Métricas de cPanel.
En VPS están en /var/log/apache2/error.log.
También puedes activar display_errors en header.php para ver los errores directamente en pantalla.
¿Cómo hago una copia de seguridad?
Tienes que guardar dos cosas:
- Archivos: Descarga todos los archivos del sitio por FTP o desde el gestor de archivos del hosting
- Base de datos: Exporta la BD desde phpMyAdmin en formato SQL
¿Puedo cambiar el dominio de mi instalación?
Sí. Ve a Admin → Configuración y cambia el campo URL del sitio.
También comprueba el archivo config.inc/config.php si la URL está hardcodeada ahí.
¿Tu problema no está en esta lista?
Abre un tema:
- Tu hosting y versión de PHP
- El error exacto que aparece
- Qué hiciste antes de que apareciera el error
Facebook
Twitter
Reddit
Digg
del.icio.us
Tumblr
Pinterest
Blogger
Fark
LinkedIn
Mix
Google