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 para Magento 2 destinado a 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 realizados,
- base de case studies,
- sección que muestra aplicaciones de productos,
- herramienta para reforzar el enlazado interno de la tienda.
Tras la ampliación más reciente, 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 configurado un token GitHub si el repositorio es privado,
- permite ejecutar comandos
bin/magento, - cuenta con una copia de seguridad 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:
composer config repositories.kowal.trusted.us vcs https://github.com/kowalco/trusted-us
2. Añadir el token de acceso
Si el repositorio es privado, añade el token GitHub:
composer config --global --auth github-oauth.github.com
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 estándar de implementación 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 tiene su propio pipeline CI/CD, los pasos anteriores deben adaptarse al proceso de implementación 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
Según la configuración del menú, la entrada también puede estar disponible en la sección:
Trusted Us -> Firmy
Añadir una empresa o 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 del sitio (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 case study descriptivo.
- Breve descripción 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.
- Products - productos relacionados con la entrada.
Configuración de agrupación y enlaces internos
El campo Grupo de case study / slug URL sirve para unir varias entradas de la misma empresa en una 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 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 determinado.
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 una cuadrícula similar a la de las categorías de producto.
En la edición de una página CMS, página de inicio, landing page o 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 nombre del proyecto - si el nombre del proyecto debe ser visible debajo del logo.
Si la entrada tiene completado el campo group_slug, al hacer clic en el logo se dirige a la página interna:
/trusted-us/{slug}
Si group_slug está vacío, la entrada permanece sin enlace.
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 solo entradas activas que tienen marcada la opción:
Pokaż w widgecie wyróżnionych firm
Igual que el widget estándar, puede enlazar con 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,
- breve descripción 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,
- cuadrícula de productos similar a la cuadrícula de categorías.
Estas páginas aumentan el número de enlaces internos y crean una ruta adicional:
widget -> case study -> produkt
Compatibilidad con varios store view
El módulo admite contenidos dependientes del store view para los campos:
- nombre del proyecto,
- breve descripción del proyecto.
Los campos globales, como el nombre de la empresa, logo, estado de actividad, ordenación, 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 sincroniza correctamente entre entornos si la tienda funciona con una arquitectura multiservidor.
Checklist de implementación
Antes de la implementación:
- realiza una copia de seguridad de la base de datos,
- realiza una copia de seguridad del código o asegúrate de que la implementación puede reproducirse desde el repositorio,
- comprueba el acceso al repositorio Composer,
- comprueba el token GitHub si es necesario,
- planifica una ventana de implementación si la tienda está 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 de static content,
- comprueba si 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 si la cuadrícula de productos muestra los productos asignados al case study,
- comprueba la ficha de producto con 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
Recompilación DI:
php bin/magento setup:di:compile
Problemas más frecuentes
Comprueba si la entrada tiene completado el campo:
Grupa case study / slug URL
Un elemento sin group_slug no se enlaza con la página interna.
La página /trusted-us/{slug} no funciona
Comprueba:
- si existe una entrada activa con el
group_slug indicado, - 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, debe comprobarse si la tienda utiliza widgets, bloques CMS o contenidos dependientes del módulo.