Instrucciones de instalación, configuración e implementación del módulo Kowal TrustedUs

Objetivo del módulo

Kowal TrustedUs es un módulo universal de Magento 2 para presentar empresas, clientes, partners, proveedores, marcas y case studies en la tienda.

El módulo puede utilizarse como:

• sección 'Han confiado en nosotros',
• lista de partners o proveedores,
• portfolio de proyectos,
• base de case studies,
• sección que muestra aplicaciones de productos,
• herramienta para reforzar el enlazado interno en la tienda.

Tras la última ampliación, los widgets pueden dirigir a páginas internas de case study, por ejemplo:

/trusted-us/vitcas

En dicha página se muestran entradas del mismo grupo y los productos asignados a ellas.

Requisitos

Antes de la instalación, asegúrate de que la tienda cumple los requisitos:

• funciona con Magento 2,
• tiene acceso a Composer,
• tiene acceso al repositorio del módulo,
• tiene configurados los datos de acceso al repositorio Composer de Kowal,
• permite ejecutar comandos bin/magento,
• se ha realizado un backup del código y de la base de datos antes de la implementación en producción.

Instalación mediante Composer

1. Añadir el repositorio Composer

En el directorio raíz de Magento, ejecuta:

Recibirás por correo electrónico los datos de acceso al repositorio Composer, es decir, el correo electrónico del cliente y el token de licencia, después de la compra. También están disponibles en el panel de cliente tras iniciar sesión en kowal.store. Sustituye TWOJ_EMAIL_KLIENTA por la dirección de correo electrónico de tu cuenta y TWOJ_TOKEN por el token recibido. Ejecuta los comandos en el directorio raíz de Magento.

composer config repositories.kowal composer https://repo.kowal.store

2. Añadir el token de acceso

Configura los datos de acceso al repositorio Composer de Kowal:

composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'

3. Instalación del módulo

composer require kowal/module-trustedus

4. Activación del módulo

Nombre del módulo Magento:

Kowal_TrustedUs

Activa el módulo:

php bin/magento module:enable Kowal_TrustedUs

5. Actualización del esquema de la base de datos

php bin/magento setup:upgrade

Este comando creará o actualizará las tablas del módulo, incluido el campo group_slug utilizado para las páginas internas de case study.

6. Limpieza de la caché

php bin/magento cache:flush

Instalación en modo producción

En el entorno de producción se recomienda seguir el proceso de despliegue estándar de Magento.

Secuencia de ejemplo:

composer require kowal/module-trustedusphp bin/magento module:enable Kowal_TrustedUsphp bin/magento setup:upgrade --keep-generatedphp bin/magento setup:di:compilephp bin/magento setup:static-content:deploy -fphp bin/magento cache:flush

Si la tienda cuenta con su propio pipeline CI/CD, los pasos anteriores deben adaptarse al proceso de despliegue de la tienda.

Actualización de una instalación existente

Si el módulo ya está instalado, actualízalo mediante Composer:

composer update kowal/module-trustedus

A continuación, ejecuta:

php bin/magento setup:upgradephp bin/magento cache:flush

En modo producción:

php bin/magento setup:upgrade --keep-generatedphp bin/magento setup:di:compilephp bin/magento setup:static-content:deploy -fphp bin/magento cache:flush

Configuración en el panel de administración

Acceso a la lista de empresas

Después de la instalación, ve en el panel de Magento a:

Content -> Zaufali nam -> Firmy

En función de la configuración del menú, la entrada también puede estar disponible en la sección:

Trusted Us -> Firmy

Añadir una empresa o un case study

Al añadir una nueva entrada, completa los datos básicos:

• Nombre de la empresa - nombre del cliente, partner, proveedor, marca o proyecto.
• Dirección de la página (URL) - dirección externa opcional; actualmente los widgets enlazan internamente si la entrada tiene configurado el slug de grupo.
• Grupo de case study / slug URL - slug global utilizado para agrupar entradas y crear el enlace interno.
• Nombre del proyecto - título del proyecto realizado o del case study descriptivo.
• Descripción breve del proyecto - contenido presentado junto a la entrada.
• Icono - logo de la empresa o marca.
• Activa - determina si la entrada es visible en el frontend.
• Mostrar en el widget de empresas destacadas - determina si la entrada se incluirá en el widget destacado.
• Orden - ordenación de las entradas.
• Productos - productos relacionados con la entrada.

Configuración de agrupación y enlaces internos

El campo Grupo de case study / slug URL sirve para conectar varias entradas de la misma empresa en una única página interna.

Ejemplo:

vitcas

Todas las entradas activas con el mismo slug serán visibles en la página:

/trusted-us/vitcas

Si introduces un valor con espacios o letras mayúsculas, el módulo lo guardará como un slug seguro.

Ejemplo:

Tandem Baits

se guardará como:

tandem-baits

Configuración de productos relacionados

En la sección Productos / módulos relacionados, selecciona los productos que deben asignarse a una empresa, proyecto realizado o case study concreto.

Estas relaciones se utilizan en dos lugares:

• en la ficha de producto, donde el módulo puede mostrar empresas o proyectos relacionados,
• en la página de case study /trusted-us/{slug}, donde los productos se presentan en un grid similar al de una categoría de productos.

Configuración del widget estándar

Al editar una página CMS, la página de inicio, una landing page o un bloque CMS, añade el widget:

Kowal: Zaufali nam

Parámetros disponibles:

• Título - encabezado de la sección.
• Límite - número máximo de entradas mostradas.
• Mostrar el nombre del proyecto - determina si el nombre del proyecto debe mostrarse debajo del logo.

Si la entrada tiene completado el campo group_slug, al hacer clic en el logo se accede a la página interna:

/trusted-us/{slug}

Si group_slug está vacío, la entrada permanece sin enlace.

Configuración del widget de empresas destacadas

En la edición CMS, añade el widget:

Kowal: Zaufali nam - wyróżnione firmy

Parámetros disponibles:

• Encabezado - texto principal de la sección.
• Límite - número máximo de entradas mostradas.

El widget muestra únicamente las entradas activas que tienen marcada la opción:

Pokaż w widgecie wyróżnionych firm

Al igual que el widget estándar, puede enlazar a páginas internas de case study en función del campo group_slug.

Sección en la ficha de producto

Si el producto tiene empresas o case studies asignados, el módulo puede mostrar automáticamente una sección en la ficha de producto.

La sección presenta:

• logo de la empresa,
• nombre de la empresa,
• nombre del proyecto,
• descripción breve del proyecto.

Esto permite mostrar el uso real del producto y reforzar la credibilidad de la oferta.

Páginas de case study

Las páginas de case study están disponibles en la dirección:

/trusted-us/{slug}

Ejemplo:

/trusted-us/vitcas

En la página se muestran:

• todas las entradas activas con el mismo group_slug,
• descripciones de case studies,
• logo de la empresa,
• productos asignados a cada entrada,
• grid de productos similar al grid de categoría.

Estas páginas aumentan el número de enlaces internos y crean una ruta adicional:

widget -> case study -> produkt

Compatibilidad con múltiples store view

El módulo admite contenidos dependientes del store view para los campos:

• nombre del proyecto,
• descripción breve del proyecto.

Los campos globales, como el nombre de la empresa, el logo, el estado de actividad, la ordenación, los productos relacionados y group_slug, son comunes para toda la entrada.

Directorio de medios

Los logos se guardan en el directorio:

pub/media/kowal/trustedus/

Antes de la implementación, asegúrate de que el directorio pub/media se comparte o se sincroniza correctamente entre entornos si la tienda funciona con una arquitectura multiservidor.

Checklist de implementación

Antes de la implementación:

• realiza un backup de la base de datos,
• realiza un backup del código o asegúrate de que el despliegue es reproducible desde el repositorio,
• comprueba el acceso al repositorio Composer,
• comprueba el correo electrónico del cliente y el token de licencia para el repositorio Composer de Kowal,
• planifica una ventana de despliegue si la tienda funciona en producción.

Después de la implementación:

• ejecuta setup:upgrade,
• limpia la caché,
• en modo producción, ejecuta la compilación DI y el deployment static content,
• comprueba que el módulo esté activo,
• añade o edita una empresa de prueba,
• configura group_slug,
• asigna un producto,
• añade el widget en una página CMS de prueba,
• haz clic en el logo y comprueba la página /trusted-us/{slug},
• comprueba que el grid de productos muestre los productos asignados al case study,
• comprueba la ficha de producto con las entradas asignadas.

Comandos de diagnóstico

Comprobar el estado del módulo:

php bin/magento module:status Kowal_TrustedUs

Comprobar la lista de módulos Kowal:

php bin/magento module:status | grep Kowal

Limpiar la caché:

php bin/magento cache:flush

Recompilar DI:

php bin/magento setup:di:compile

Problemas frecuentes

El widget no enlaza a la página de case study

Comprueba si la entrada tiene completado el campo:

Grupa case study / slug URL

Un elemento sin group_slug no se enlaza a una página interna.

La página /trusted-us/{slug} no funciona

Comprueba:

• si existe una entrada activa con el group_slug correspondiente,
• si se ha ejecutado setup:upgrade,
• si se ha limpiado la caché,
• si el módulo Kowal_TrustedUs está activo.

Los productos no aparecen en la página de case study

Comprueba:

• si los productos están asignados a la entrada de la empresa,
• si los productos están activos,
• si los productos son visibles en el catálogo o en el buscador,
• si los productos están disponibles en el store view actual.

Los cambios no son visibles después de la implementación

Limpia la caché de Magento:

php bin/magento cache:flush

En modo producción, ejecuta también:

php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy -f

Desinstalación

Desactivar el módulo:

php bin/magento module:disable Kowal_TrustedUsphp bin/magento setup:upgradephp bin/magento cache:flush

Eliminar el paquete Composer:

composer remove kowal/module-trustedus

Antes de eliminar el módulo de producción, debes comprobar si la tienda utiliza widgets, bloques CMS o contenidos dependientes del módulo.