Integración X (Twitter) 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 necesites volver a su configuración.

El menú Hook de visualización también ofrece Widget personalizado (usa {widget} en las plantillas), pero esta versión no implementa esa forma de mostrar el feed. Selecciona un hook estándar, también al colocar el feed en una plantilla del tema.

Los controles de columnas se aplican a la cuadrícula y al carrusel. Con anchuras de 768px a 991px, el carrusel y las cuadrículas con al menos dos publicaciones usan dos columnas; una cuadrícula con una sola publicación mantiene una columna. Por debajo de 768px, usan Columnas móviles. Las cuadrículas que solo contienen una o dos publicaciones usan respectivamente una o dos columnas en escritorio y una columna en móvil. El espaciado y el radio de borde se aplican a todos los diseños, incluido el carrusel.

El servidor resuelve un ID de usuario X vacío mediante https://api.x.com/2/users/by/username/{username}. Obtiene la cronología mediante https://api.x.com/2/users/{user_id}/tweets, incluidas fechas de creación, métricas públicas, adjuntos multimedia y datos del autor. Tu cuenta configurada y acceso a la API deben permitir esas solicitudes. El módulo no obtiene un muro de hashtags ni combina varias cuentas.

La lógica de obtención limita a 20 la cantidad solicitada para mostrar. Solicita hasta tres veces esa cantidad antes de conservar el número de resultados necesario. Mantén una cantidad positiva. El texto se acorta a Longitud máx. del texto durante la obtención; usa 0 para el texto completo. Los interruptores de metadatos controlan las tarjetas, mientras que los de exclusión cambian la solicitud a la API.

El hook estándar seleccionado renderiza una cuadrícula, carrusel o lista. El botón para seguir de la cabecera abre https://x.com/{username}. Cada tarjeta abre https://x.com/{author_handle}/status/{post_id} en una pestaña nueva. Los vídeos siguen siendo vistas previas, sin reproductor insertado.

Si cambias de cuenta, modifica Nombre de usuario X y vacía manualmente ID de usuario X antes de guardar. Un ID no vacío se reutiliza incluso después de cambiar el nombre de usuario. Después usa Sincronizar ahora.

La caché del feed usa este archivo JSON local:

modules/mprxintegration/mprx_feed_cache.json

La configuración del feed y este archivo se comparten entre las tiendas que usan la misma instalación del módulo. Las solicitudes a la tienda lo reutilizan mientras es válido y obtienen publicaciones de X si falta o ha caducado. Guardar el formulario principal lo elimina; esta versión no tiene una tarea programada para actualizar el feed.

Sincronizar ahora requiere un Bearer Token y un ID de usuario X resuelto, después borra la caché y obtiene las publicaciones al momento. Vaciar caché solo elimina el archivo; la siguiente solicitud a la tienda obtiene datos nuevos. Si la solicitud posterior a la API falla o no devuelve publicaciones, no queda ninguna publicación en caché. Revisa la cronología, las credenciales y el acceso a la API y vuelve a intentarlo.

Solo se guardan en caché los resultados no vacíos de la API. Si falla la obtención, no se usa un archivo caducado como respaldo; el feed puede desaparecer hasta que una solicitud posterior tenga éxito. Los recuentos de la API y las fechas relativas reflejan la respuesta en caché.

Configura los cuatro campos de credenciales OAuth 1.0a en Conexión X (Twitter) si necesitas publicar desde el blog. Un Bearer Token de solo lectura no configura por sí solo esta vía de publicación. Después usa el formulario independiente "Auto-Publish to X":

El panel Artículos del blog requiere MPR Blog Revolution y ofrece una acción de publicación manual cuando el publicador está configurado. Usa título, extracto, URL e imagen destacada del blog cuando están disponibles. El publicador admite texto e imágenes/GIF. La publicación pasa por una cola y registros de historial compartidos que evitan el procesamiento duplicado. Si el panel indica un error de cola o conciliación, comprueba el resultado existente antes de reintentar.

La visualización del feed y la publicación tienen interruptores independientes, pero guardar el formulario principal restablece el interruptor y el texto de publicación porque esos campos no están en él. Después de cada guardado del formulario principal, vuelve a guardar Activar publicación automática y su texto en el formulario de publicación independiente.

La publicación se impide cuando está activa la bandera de control de X de Social Revolution. La política de escritura saliente también puede bloquearla en un host de desarrollo/pruebas o sin resolver. La interfaz indica el motivo. Otro módulo social instalado que cargue un paquete publicador compartido antiguo puede bloquear el envío; actualiza juntos los módulos sociales instalados si aparece ese error.

Los ejemplos siguientes describen valores para los formularios del back office. No son comandos de shell. Sustituye los nombres de cuenta y credenciales por valores reales. El hook del tema debe coincidir con Hook de visualización.

Muestra una cuadrícula en la página de inicio con seis publicaciones, tres columnas en escritorio, una en móvil y solo publicaciones originales:

MPRX_DISPLAY_HOOK=displayHome
MPRX_LAYOUT=grid
MPRX_POST_COUNT=6
MPRX_COLUMNS=3
MPRX_MOBILE_COLUMNS=1
MPRX_EXCLUDE_REPLIES=1
MPRX_EXCLUDE_RETWEETS=1

Usa una lista compacta en la columna derecha sin medios ni contadores de interacción:

MPRX_DISPLAY_HOOK=displayRightColumn
MPRX_LAYOUT=list
MPRX_POST_COUNT=3
MPRX_SHOW_MEDIA=0
MPRX_SHOW_LIKES=0
MPRX_SHOW_RETWEETS=0
MPRX_SHOW_REPLIES=0
MPRX_TEXT_LENGTH=140

Usa el slider con desplazamiento automático cada ocho segundos:

MPRX_LAYOUT=slider
MPRX_COLUMNS=3
MPRX_AUTO_SCROLL=1
MPRX_SCROLL_SPEED=8000

Personaliza el texto de Blog Revolution enviado a X:

{title}

{excerpt}

Read more: {url}

Los marcadores de texto disponibles son:

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

Renderiza el módulo mediante un hook estándar de PrestaShop en una plantilla del tema, con el módulo configurado para ese mismo hook:

{hook h='displayHome' mod='mprxintegration'}

Los desarrolladores de temas pueden sobrescribir las plantillas de la tienda aquí:

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

Selectores CSS útiles para aplicar estilos desde el tema:

.mprx-section { margin-top: 32px; }
.mprx-title { font-size: 1.25rem; }
.mprx-item { border-radius: 8px; }
[data-theme="dark"] .mprx-item { background: #16181c; }
.mprx-follow-btn { text-transform: none; }

La caché del feed usa este archivo JSON local:

modules/mprxintegration/mprx_feed_cache.json

Para un carrusel, comprueba las columnas y el espaciado configurados con anchuras de escritorio, tableta y móvil. Mantén los cambios de CSS y plantillas en tu tema.

• Si falta la sección, comprueba Activar módulo, los campos de origen, 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 llame a displayHeader para cargar la hoja de estilos y JavaScript, y renderice el hook de visualización seleccionado.
• Si las imágenes siguen vacías, revisa 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 con anchuras de escritorio y móvil.
• Si MPR Social Revolution tiene activado el ajuste X_ACTIVE, este feed independiente se oculta. La comprobación lee la bandera guardada; no requiere que Social Revolution esté actualmente activado 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 tras cambiar los identificadores de cuenta o las fuentes del feed.

Establece Activar módulo en No y guarda para ocultar el feed conservando la configuración de fuente y visualización. Guardar el formulario principal restablece el interruptor y el texto de publicación; revisa y guarda después el formulario de publicación independiente si quieres que continúe. Desinstala desde el gestor de módulos para eliminar la configuración, caché local y entradas del menú de administración de este módulo. 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.