Saltar al contenido principal

Problemas frecuentes del sitio público

Los problemas del sitio público casi siempre son uno de estos.

Antes de nada, mira el estado del sistema

Si lo que falla tiene que ver con subir, generar o guardar archivos, abre Configuración → Estado del Sistema: diagnostica los permisos de carpetas y en la mayoría de los casos los repara con un botón, sin terminal. Ver Revisar el estado del sistema.

La página pública muestra datos viejos​

Por qué pasa: el sitio público guarda una copia en caché para ir rápido.

Qué hacer: Configuración → Apariencia → Purgar caché. El sitio vuelve a leer los datos frescos.

La página pública no muestra ningún dato​

Por qué pasa: falta el archivo de configuración del sitio (web/config.php).

Qué hacer: entra una vez a Configuración → Páginas Web. El sistema lo crea solo. También puedes ejecutar sudo ./setup.sh en el servidor.

El sitio se ve sin diseño según cómo se escriba la dirección​

El síntoma: escribes tudominio.cl y la página sale desarmada —letras de máquina de escribir, menú en una columna, botones sin color—, pero escribes www.tudominio.cl y se ve perfecta. O al revés.

Por qué pasa: para el navegador, tudominio.cl y www.tudominio.cl son dos sitios distintos, aunque muestren lo mismo. El sistema tiene una regla de seguridad que impide cargar archivos de otro sitio —es lo que frena a quien intente inyectar código en tus páginas—, y esa regla también frenaba los archivos de diseño del propio sitio cuando la dirección estaba escrita con el otro nombre.

Qué hacer: actualiza el sistema. Desde la versión que trae este arreglo, los archivos de diseño salen sin nombre de dominio adentro, así que los carga el nombre por el que entró el visitante, sea cual sea. Ver Actualizar el sistema.

Si acabas de actualizar y todavía lo ves mal, es la copia guardada de la página: Configuración → Apariencia → Purgar caché.

Además, elige un nombre y quédate con él

Aunque el sitio ya funcione por los dos, conviene que uno redirija al otro: los buscadores tratan los dos nombres como dos sitios con el mismo contenido y reparten entre ambos lo que deberías ganar con uno. Es un ajuste del servidor, de una línea; pídeselo a quien te lo administra, o a soporte. Y en Configuración → SEO, deja escrita la «dirección canónica» con el nombre que elegiste.

Ícono de imagen rota​

Por qué pasa: la URL apunta a un archivo que no existe.

Click derecho sobre la imagen rota → "Copiar dirección de imagen" y verifica:

  • Si la URL usa un dominio viejo (después de migrar) → hay que reescribir. Ver Cambiar de dominio.
  • Si la imagen no está en el servidor → vuelve al registro y súbela de nuevo.
  • Si la carpeta de archivos no tiene permisos → Configuración → Estado del Sistema → Intentar reparar. Ver Revisar el estado del sistema.

Todo el sitio con imágenes rotas después de migrar​

Las URLs siguen apuntando al servidor viejo. Restaura el paquete con el sistema de empaquetado — reescribe todos los dominios automáticamente. Ver Empaquetar y desplegar.

Las fotos de un módulo salen rotas y el archivo sí está en el servidor​

Es el caso más desconcertante: copias la dirección de la imagen rota, la abres y da 404; pero el archivo está donde debería, y en el CMS se ve bien.

Por qué pasa: la dirección guardada arrastra la carpeta desde la que se servía la instalación anterior. Si el sitio se armó en midominio.cl/pruebas/sistema/ y se publicó en la raíz de restobar.cl, la base sigue pidiendo /pruebas/sistema/cms/views/assets/files/foto.jpg cuando el archivo vive en /cms/views/assets/files/foto.jpg.

Se nota sobre todo en las fotos que suben los módulos: platos de la carta, fichas de propiedades, ítems de inventario, logos de sucursal, avatares.

Qué hacer: abre Configuración → Estado del Sistema. Abajo, la tarjeta Direcciones de las fotos lo averigua sola: mira desde dónde se sirve este sitio, junta todas las carpetas desde las que se están pidiendo fotos y abre cada archivo en el servidor para saber cuál es la correcta. Después te muestra qué encontró, fila por fila, y Arreglar las direcciones las corrige todas de una vez. Los archivos no se tocan y la caché del sitio público se purga sola. Recarga con Ctrl+F5.

El botón está siempre; queda apagado sólo cuando no hay nada que corregir. Si una fila dice que falta el archivo, ahí no hay ruta que arreglar: esa foto hay que volver a subirla.

Y si además cambió el dominio

Si el sitio también cambió de dominio, el aviso amarillo del panel («La configuración apunta a otro dominio») corrige las dos cosas de una vez. Ver Cambiar de dominio.

Imágenes rotas después de traer contenido de otra instalación​

Si copiaste fotos o fichas a mano —por FTP, o pegando filas en la base— las direcciones que viajaron son las del servidor de origen y por eso no se ven.

Hazlo con Llevar contenido de un lado a otro: ese paquete anota de dónde salió y, al importarlo, reescribe las direcciones a las de este servidor, incluidas las de los campos de varias imágenes.

Solo algunas imágenes fallan​

  • Diferencias de mayúsculas/minúsculas (Linux es case-sensitive, Windows no). Si migraste de Windows a Linux, MiFoto.jpg puede no ser lo mismo que mifoto.jpg.
  • Nombres con caracteres raros (espacios, tildes, símbolos). Suele pasar al importar de otro sistema.
  • Formato no soportado. El framework soporta JPG, PNG, WebP, GIF. Otros (BMP, TIFF, HEIC) pueden fallar.

Imágenes se ven en el CMS pero no en el sitio público​

Puede ser tema de rutas:

  • El CMS carga con URLs internas.
  • El sitio público carga con URLs completas.
  • Si web/config.php tiene mal la URL base, las imágenes se buscan en el lugar equivocado.

Verifica web/config.php.

Imágenes muy grandes que no cargan​

Si un archivo es mayor a 8 MB (default de PHP), la subida puede fallar silenciosamente. Ajusta upload_max_filesize y post_max_size en php.ini y reinicia Apache/PHP-FPM.

Imágenes borrosas o rotadas​

  • Rotación EXIF: fotos de móviles vienen con metadatos de orientación. Si aparecen giradas, tu técnico puede rotar al subir.
  • Compresión demasiado agresiva: el framework las optimiza; si quieres desactivarlo, hay un ajuste.

Todo en HTTPS pero imágenes en HTTP​

Los navegadores bloquean contenido mixto (HTTPS + HTTP). Si tu sitio es HTTPS y las imágenes tienen URL http://..., no se cargan. Reescribe las URLs para que todo sea HTTPS.

Cache del navegador​

A veces "no se ve la imagen" es solo que el navegador tiene una versión cacheada rota. Recarga con Ctrl+F5 (o Cmd+Shift+R en Mac).

Un desplegable de relación sale vacío​

Por qué pasa: la tabla relacionada no tiene registros, o el "Parámetro del tipo" está mal escrito.

Qué hacer: carga primero los registros de la tabla destino y revisa el nombre exacto en el parámetro.

Un usuario no ve una sección​

Por qué pasa: su rol no tiene permiso de Leer sobre esa página.

Qué hacer: Roles y Permisos → marca Leer en esa fila. Ver RBAC Manager.

El POS dice que no está configurado​

Por qué pasa: falta mapear alguna tabla o columna obligatoria.

Qué hacer: Punto de Venta → Configuración. El mensaje indica qué campo falta.

No aparece el ícono que busco​

Por qué pasa: la palabra es muy específica.

Qué hacer: prueba un término más general (limpieza en vez de sanitización; sueldo o dinero en vez de liquidación).

Los nombres internos de columna salen raros​

Por qué pasa: el sufijo del módulo quedó mal (produccione en vez de produccion).

Qué hacer: revísalo al crear el módulo. Después conviene rehacer la tabla — cambiarlo en producción es molesto. Ver Crear una tabla.

¿Qué sigue?​