Integración Pinterest Feed: configuración y ayuda

En versiones anteriores de PrestaShop, usa la página equivalente de instalación de módulos. Abre este módulo mediante "Configure" cuando quieras volver a sus ajustes.

El enlace de perfil/canal del encabezado está anidado dentro del bloque del título de sección. Define Título de sección si quieres que aparezca ese enlace en el encabezado. El botón independiente de seguir/suscribirse tiene su propio interruptor.

La cuadrícula y el slider usan tres columnas de 768px a 991px y el ajuste móvil por debajo de 768px. El modo de lista siempre usa una columna.

Los ajustes de columnas y separación se aplican a la cuadrícula y al carrusel. El carrusel también usa las columnas móviles y el redondeo de las esquinas configurados. Después de cambiar los ajustes, comprueba su navegación en los anchos de escritorio, tableta y móvil de tu tienda.

No necesitas un token de la API de Pinterest para mostrar un feed. Tu servidor debe poder obtener la respuesta RSS pública de Pinterest o la respuesta oEmbed. El análisis de RSS requiere PHP SimpleXML.

El módulo elige la URL RSS directa si existe. En caso contrario, crea una URL RSS a partir de URL del tablero. Si la solicitud RSS elegida no devuelve publicaciones, prueba URLs de pines mediante https://www.pinterest.com/oembed.json?url=.... No combina todas las fuentes ni pasa de una URL RSS directa fallida a URL del tablero. Se omiten las entradas RSS sin imagen en su descripción.

El feed aparece solo en el hook seleccionado. Cada tarjeta abre la URL original de su pin en una pestaña nueva. El título, el enlace al perfil, la leyenda y el botón de seguir dependen de tus ajustes y de los metadatos devueltos. Se trata de un único feed configurado.

El módulo guarda los elementos obtenidos en:

modules/mprpinterestintegration/mprpinterest_feed_cache.json

El proceso del servidor web debe poder escribir este archivo en el directorio del módulo. Mantén los permisos normales de propietario/grupo de tu alojamiento. No necesitas una tarea cron para mostrar el feed. Una solicitud a la tienda obtiene los datos después de que caduque la caché. Guardar el formulario principal del feed vacía la caché. El archivo se comparte entre los contextos de tienda de este módulo, en lugar de tener un archivo separado por tienda.

No hay un botón "Refresh Pinterest Cache" en esta versión. Guarda los ajustes del feed para vaciar la caché o pide a tu administrador que elimine solo el archivo de caché. La siguiente solicitud válida a la tienda obtendrá los datos. Si falla una URL RSS directa introducida, el módulo utiliza los pines manuales; no intenta después la URL del tablero.

Solo se guardan los resultados de obtención no vacíos. Una obtención vacía o fallida oculta el feed y puede reintentarse en solicitudes posteriores a la tienda. Si los elementos parecen antiguos, vacía la caché después de comprobar la fuente. Los títulos y las URL de las imágenes proceden de la respuesta en caché, no de una suscripción en directo en el navegador.

La pantalla incluye Activar publicación automática, con valor predeterminado No, y Plantilla de leyenda, con este valor predeterminado:

{title}

{excerpt}

Read more: {url}

Los marcadores disponibles incluyen {title}, {excerpt}, {url} y {shop_name}. El panel asociado Artículos del blog requiere datos de MPR Blog Revolution. La publicación usa la API de Pinterest v5 y requiere un token de acceso OAuth, un ID de tablero y una imagen.

En Conexión con Pinterest, introduce Token de acceso para publicación (ACCESS_TOKEN) e ID del tablero para publicación (BOARD_ID) y guarda. Ambos están vacíos de forma predeterminada y solo se requieren para publicar. Usa un token con permiso para crear pines y el ID numérico del tablero de destino. En esta versión, guardar el formulario principal del feed sigue restableciendo el interruptor independiente de publicación automática y la plantilla de leyenda. Guarda de nuevo el formulario de publicación después de cambiar los ajustes del feed.

Una vez configurado, el sistema de publicación gestiona los objetos de entradas de blog publicadas que cumplan los requisitos mediante hooks de adición/actualización. Usa la imagen destacada y la plantilla de leyenda. No publica productos ni páginas CMS. Los registros compartidos de cola/historial hacen seguimiento de la publicación. El módulo suprime su publicación cuando está activo el indicador guardado de toma de control de Pinterest por Social Revolution. La política de escritura saliente puede bloquear los hosts de desarrollo/pruebas o los hosts de tienda sin resolver; el panel de publicación muestra el motivo.

Los siguientes ejemplos describen valores que debes introducir en los formularios del back office. No son comandos de shell. Sustituye los nombres de cuenta, los ID de pines/vídeos y las credenciales por valores reales. El hook del tema debe coincidir con Hook de visualización.

Fuente de pines manual:

MPRPINTEREST_PIN_URLS =
https://www.pinterest.com/pin/1234567890
https://www.pinterest.com/pin/9876543210

Fuente de tablero:

MPRPINTEREST_BOARD_URL = https://www.pinterest.com/yourusername/summer-products/

El módulo solicita este feed:

https://www.pinterest.com/yourusername/summer-products.rss

Fuente RSS directa:

MPRPINTEREST_RSS_URL = https://www.pinterest.com/yourusername/summer-products.rss

Cuadrícula de la página de inicio con seis pines:

MPRPINTEREST_DISPLAY_HOOK = displayHome
MPRPINTEREST_LAYOUT = grid
MPRPINTEREST_POST_COUNT = 6
MPRPINTEREST_COLUMNS = 3
MPRPINTEREST_MOBILE_COLUMNS = 1
MPRPINTEREST_GAP = 16
MPRPINTEREST_BORDER_RADIUS = 8

Slider del pie de página con desplazamiento automático:

MPRPINTEREST_DISPLAY_HOOK = displayFooterBefore
MPRPINTEREST_LAYOUT = slider
MPRPINTEREST_AUTO_SCROLL = 1
MPRPINTEREST_SCROLL_SPEED = 5000

Plantilla de leyenda para publicar en Pinterest:

{title}

{excerpt}

Read more: {url}

{shop_name}

Marcadores disponibles para la publicación:

{title}
{excerpt}
{url}
{shop_name}

Rutas de sobrescritura del tema para el marcado de la tienda:

themes/your_theme/modules/mprpinterestintegration/views/templates/hook/feed.tpl
themes/your_theme/modules/mprpinterestintegration/views/templates/hook/post_item.tpl

Selectores CSS para custom.css del tema:

.mprfeed-pinterest .mprfeed-title {
  font-size: 20px;
}

.mprfeed-pinterest .mprfeed-item {
  box-shadow: 0 2px 10px rgba(0, 0, 0, 0.08);
}

.mprfeed-pinterest .mprfeed-caption {
  font-size: 14px;
}

Ajustes opcionales del tema para los efectos hover integrados:

.mprfeed-pinterest[data-hover="elevate"] .mprfeed-item:hover {
  transform: translateY(-3px);
}

.mprfeed-pinterest[data-hover="glow"] .mprfeed-item:hover {
  box-shadow: 0 0 0 2px rgba(230, 0, 35, 0.18);
}

.mprfeed-pinterest[data-hover="border"] .mprfeed-item:hover {
  outline: 2px solid #e60023;
}

Para un carrusel, prueba la navegación después de cambiar las columnas y el espacio. Mantén los cambios de CSS y plantillas en tu tema.

• Si falta la sección, comprueba Activar módulo, los campos de fuente, Mostrar en móvil y el hook seleccionado. El módulo no devuelve ninguna sección cuando no hay elementos disponibles.
• Comprueba que tu tema llama a displayHeader para cargar la hoja de estilos y JavaScript, y que renderiza el hook de visualización seleccionado.
• Si las imágenes siguen en blanco, inspecciona los errores de red del navegador. Prueba a desactivar la carga diferida y comprueba las URL de las imágenes.
• Si el diseño es incorrecto, prueba primero la cuadrícula y después verifica el carrusel en anchuras de escritorio y móvil.
• Si MPR Social Revolution tiene activado su ajuste PINTEREST_ACTIVE, se suprime este feed independiente. Esta comprobación lee el indicador guardado; no requiere que Social Revolution esté activado actualmente como módulo.

Abre la página "Integrity" del módulo para comprobar la configuración y los hooks. Licencia, Soporte y Actualizar son páginas de mantenimiento. Prueba los destinos reales después de cambiar identificadores de cuenta o fuentes del feed.

Establece Activar módulo en No y guarda para ocultar el feed y conservar su configuración. Guardar este formulario principal también restablece el interruptor independiente de publicación automática y la plantilla de leyenda. Para mantener la publicación desactivada, confirma que Activar publicación automática está en No en su formulario independiente. Desinstala desde el gestor de módulos para eliminar la configuración de este módulo, la caché local y las entradas del menú de administración. Las tablas compartidas mpr_social_publish y mpr_social_queue están marcadas como compartidas y se conservan al desinstalar. La desinstalación no elimina publicaciones ya enviadas a la plataforma.