Panel de control — Vista rápida
La Vista rápida del panel de control te ofrece un resumen del estado de tu feed cada vez que abres el módulo: cuándo se generó por última vez, cuántos productos exportó y con qué rapidez se generó.
Disponible desde la v2.5.0
Descripción general
Una vez que hayas generado tu feed al menos una vez, el panel de Vista rápida (#fcp) aparece en la parte superior de la página de configuración del módulo, antes que el resto de ajustes. Hasta que ejecutes la primera generación, se muestra primero la guía paso a paso y el panel permanece oculto.
El panel tiene tres secciones:
- Tarjetas de estado — tres tarjetas compactas que muestran la antigüedad de la última generación, el recuento de productos y el tiempo de rendimiento.
- URLs del feed — las URLs del feed XML que pegas en Meta Business Manager, cada una con un botón copiar de un solo clic y un enlace abrir para previsualizar el archivo en tu navegador.
- Tabla de estadísticas de generación — un desglose por feed de cada feed generado (tienda, tipo, idioma, tiempo y recuento de errores).
Qué muestra el panel
Tarjeta de última generación
Muestra hace cuánto tiempo se completó la generación del feed más reciente, expresado de forma legible: "Ahora mismo", "Hace 3 minutos", "Hace 2 h 14 m", "Hace 3 días", etc. Debajo del tiempo transcurrido, la tarjeta muestra la fecha y hora completa y formateada de esa ejecución.
Un distintivo de estado con código de color te indica si tu feed está actualizado:
| Color del distintivo | Condición | Significado |
|---|---|---|
| Verde — Actualizado | Menos de 24 horas | El feed está al día; Facebook tiene datos actuales |
| Amarillo — Actualización recomendada | De 24 a 48 horas | Tu feed está envejeciendo; genera uno nuevo pronto |
| Rojo — Desactualizado | Más de 48 horas | Facebook puede estar mostrando precios obsoletos o productos sin stock |
La marca de tiempo se almacena como timestamp Unix en la clave de configuración global FPF_LAST_UPDATED. Se actualiza cada vez que se completa una generación de feed, independientemente de qué tienda o idioma se haya exportado.
Tarjeta de productos
Muestra el número total de productos procesados durante la última generación. El número grande en la parte superior es el Total — el recuento de filas de productos que el módulo intentó exportar en todos los feeds. Por debajo, métricas más pequeñas desglosan el resultado:
| Métrica | Qué cuenta |
|---|---|
| Éxito | Productos escritos correctamente en el XML del feed |
| Combinaciones | Filas de combinaciones añadidas (solo se muestra cuando las combinaciones están activadas y se exportó al menos una) |
| Errores | Productos que no se pudieron procesar; al hacer clic en el número se salta al informe de errores |
| Omitidos | Productos excluidos por tus filtros (sin stock, ocultos, etc.); al hacer clic en el número se salta al informe de omitidos |
Estos recuentos se leen de stats.txt dentro del directorio feeds/ del módulo, que el generador de feeds escribe al final de cada ciclo de generación.
Tarjeta de rendimiento
Muestra el tiempo total de reloj (en segundos, con dos decimales) que tardó la última generación completa, obtenido de la clave de configuración global FPF_FEED_GENERATION_TIME. Cuando se exportó al menos un producto, la tarjeta también muestra el tiempo medio por producto, útil para estimar cuánto tardará una generación después de añadir más productos o activar combinaciones.
URLs del feed
Debajo de las tarjetas de estado, el panel lista todas las URLs del feed XML que tu tienda ha generado, agrupadas por tienda. Cada URL se muestra completa y tiene dos acciones:
- copiar — copia la URL al portapapeles con un solo clic; el texto del botón cambia brevemente para confirmar que la copia se realizó correctamente.
- abrir — abre la URL en una nueva pestaña del navegador para que puedas verificar el contenido del feed antes de pegarlo en Meta Business Manager.
Pueden aparecer tres tipos de feed por tienda, según tu configuración:
| Tipo de feed | Etiqueta | Cuándo aparece |
|---|---|---|
| Feed principal | Main Feed | Siempre, tras la primera generación |
| Feed de idiomas | Languages Feed | Cuando tienes al menos un idioma adicional activado |
| Feed de países | Countries Feed | Cuando tienes al menos una configuración de país activada |
Si no aparece ningún feed, el panel muestra una advertencia: "Feed URLs Not Available — You need to generate the Feeds at least once." Genera el feed usando la sección Manual Feed Generation y vuelve aquí.
Tabla de estadísticas de generación
Debajo de las URLs del feed, el panel muestra una tabla — una fila por tipo de feed por tienda — con las siguientes columnas:
| Columna | Descripción |
|---|---|
| Shop ID | El ID interno de la tienda en PrestaShop |
| Name | El nombre de la tienda |
| Type | Tipo de feed: Main Feed, Language o Country |
| Locale | Identificador de idioma o país para esa fila del feed |
| Time | Tiempo de generación de ese feed específico, en segundos |
| Total | Total de productos intentados |
| Success | Productos exportados correctamente |
| Combis | Filas de combinaciones añadidas |
| Skip | Productos omitidos (se puede hacer clic en las filas del Main Feed con elementos omitidos) |
| Errors | Productos con error (se puede hacer clic; enlaza al informe de detalle de errores) |
Las estadísticas se leen de feeds/stats.txt en el directorio del módulo. Este archivo se actualiza cada vez que finaliza un ciclo de generación.
Cómo se calculan los valores
Marca de tiempo de la última generación (FPF_LAST_UPDATED): Se escribe como timestamp Unix cuando finaliza cualquier generación de feed. El panel lo convierte en una cadena legible de "tiempo transcurrido" usando un formateador por intervalos: minutos cuando es menos de una hora, horas y minutos hasta 24 horas, días y horas hasta 7 días, y días totales a partir de ahí.
Indicador de primera generación (FPF_FIRST_GENERATED): Se establece en 1 la primera vez que cualquier generación de feed se completa con éxito. El módulo usa este indicador para decidir si mostrar el panel antes o después de la guía paso a paso.
Tiempo de generación (FPF_FEED_GENERATION_TIME): Almacenado como número de coma flotante. La tarjeta de rendimiento lo muestra con dos decimales y lo divide entre el recuento total de productos para calcular la media por producto.
Recuentos de productos: Agregados desde feeds/stats.txt al cargar la página. El panel suma los campos totalp, current, errors, skipped y added_combi de todas las filas del feed en ese archivo.
Notas
- El panel es de solo lectura. Ninguno de los valores mostrados puede editarse; reflejan el resultado de la generación más reciente.
- Todas las marcas de tiempo y tiempos de generación mostrados en el panel son globales — reflejan la última generación en todas las tiendas, no valores por tienda. El desglose por tienda está en la tabla de estadísticas.
- Si ejecutas el módulo en modo multi-tienda, la tabla de estadísticas tendrá una fila por tienda y por tipo de feed. Las tarjetas de estado siguen agregando datos de todas las tiendas.
- Las URLs del feed incluyen un hash derivado de
_COOKIE_KEY_. Si cambias la clave secreta de PrestaShop, las URLs del feed existentes cambiarán y deberás actualizarlas en Meta Business Manager. - La sección de URL de Checkout de la tienda (que aparece entre las URLs del feed y la tabla de estadísticas cuando la función de checkout está configurada) también tiene un botón copiar y un botón Test; estos se explican en la guía de URL de Checkout de la tienda.
Solución de problemas
| Problema | Solución |
|---|---|
| El panel no aparece en la parte superior de la página | El feed no se ha generado todavía. Usa Manual Feed Generation para ejecutar la primera generación y recarga la página. |
| El distintivo de última generación muestra Desactualizado | Tu cron no está ejecutándose o se ha detenido. Comprueba la sección Automatic Generation (Cron Jobs) y verifica la entrada del cron en tu servidor. |
| La sección de URLs del feed está vacía | Debe completarse al menos una generación correctamente antes de que aparezcan las URLs. Si la generación falla a mitad, la sección de URLs puede seguir en blanco. |
| La tabla de estadísticas no aparece | feeds/stats.txt no se escribió durante la generación. Comprueba que el directorio feeds/ tenga permisos de escritura para el servidor web. |
| La tarjeta de productos muestra 0 en todas las métricas | Una generación anterior puede haber sido interrumpida. Ejecuta una nueva generación completa para reconstruir stats.txt. |
Preguntas frecuentes
¿Con qué frecuencia debo regenerar mi feed para que el panel se mantenga en verde?
Genera tu feed al menos una vez cada 24 horas para que el distintivo de estado se mantenga verde. Para tiendas con cambios frecuentes de stock o actualizaciones de precios, se recomienda cada 1–6 horas. Configura un cron para automatizarlo.
¿Qué significa que el panel muestre un distintivo rojo de Desactualizado?
Tu feed no se ha regenerado en más de 48 horas. La copia del catálogo de Facebook puede mostrar precios desactualizados, productos no disponibles o novedades que faltan. Ejecuta una nueva generación lo antes posible.
¿Por qué el Total de la tarjeta de productos no coincide con el número de productos de mi tienda?
El Total cuenta solo los productos que el módulo intentó incluir según tu configuración actual de filtros — los productos excluidos por categoría, disponibilidad u otras reglas se cuentan por separado como Omitidos. Los productos que encontraron un error durante el procesamiento se cuentan en Errores.
¿Puedo tener más de tres URLs de feed por tienda?
No. Cada tienda puede tener como máximo un Main Feed, un Languages Feed y un Countries Feed. El Languages Feed consolida todos los idiomas activados en un único archivo; el Countries Feed consolida todos los ajustes de país activados en un único archivo.
La URL del feed cambió tras una migración de servidor — ¿por qué?
Las URLs del feed contienen un hash derivado de tu _COOKIE_KEY_ de PrestaShop. Si esa clave cambió durante la migración (por ejemplo, una instalación nueva de PrestaShop), las URLs serán diferentes. Copia las nuevas URLs desde el panel y actualiza tu fuente de datos del catálogo en Meta Business Manager.
¿Qué es el indicador de primera generación y cuándo se restablece?
El indicador (FPF_FIRST_GENERATED) se establece en 1 la primera vez que cualquier generación de feed se completa con éxito. Controla si se muestra primero la guía paso a paso o el panel. Nunca se restablece automáticamente — si necesitas restablecerlo (por ejemplo, tras reinstalar el módulo), puedes hacerlo reinstalando el módulo o borrando la configuración de la base de datos.