Saltar al contenido principal

Problemas frecuentes del sitio público

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

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.

Í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 → ejecuta sudo ./setup.sh.

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.

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?​