Kowal Custom Tab - instalación y configuración
Requisitos
- Magento 2.4 o posterior.
- Acceso a la CLI de Magento.
- Composer configurado para descargar paquetes privados de Kowal.
- Módulo base
kowal/base instalado. - Permisos de administrador para el panel de Magento.
Instalación mediante Composer
Añade el repositorio del paquete:
Recibirás los datos de acceso al repositorio de Composer, es decir, la dirección de correo electrónico del cliente y el token de licencia, por correo electrónico 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
Configura los datos de acceso al repositorio de Composer de Kowal:
composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'
Instala el módulo:
composer require kowal/module-customtab
Ejecuta la actualización de Magento:
php bin/magento setup:upgrade
En el entorno de producción, ejecuta la compilación DI y el despliegue de recursos estáticos de acuerdo con el proceso del proyecto:
php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy
Limpia la caché:
php bin/magento cache:flush
Verificación de la instalación
Comprueba si el módulo está activo:
php bin/magento module:status Kowal_CustomTab
Si el módulo está inactivo, actívalo:
php bin/magento module:enable Kowal_CustomTabphp bin/magento setup:upgradephp bin/magento cache:flush
Configuración del módulo
En el panel de Magento, ve a:
Stores > Configuration > Kowal > Custom Tab
Establece la opción Enable module en Yes, guarda la configuración y limpia la caché si Magento lo solicita.
Gestión de pestañas
En el panel de administración, ve a:
Kowal > Custom Tabs > Custom Tab
Haz clic en Add new CustomTab para crear una nueva pestaña.
Completa los campos:
Name - nombre de la pestaña visible en el frontend.Field type - tipo de fuente de contenido.Attribute code - atributo del producto del que se debe obtener el contenido de la pestaña.Status - actividad de la pestaña.Sort Order - orden de visualización de la pestaña.
Guarda la pestaña.
Traducción del nombre de la pestaña
El nombre predeterminado de la pestaña se guarda para store_id = 0.
Para añadir una traducción para un Store View concreto:
- Abre la pestaña existente en modo de edición.
- Utiliza el selector Store View en la zona superior derecha del formulario.
- Selecciona el Store View para el que quieres cambiar el nombre.
- Desmarca
Use Default Value junto al campo Name. - Introduce el nombre de la pestaña para la versión lingüística seleccionada.
- Guarda el formulario.
Si Use Default Value permanece marcado, el módulo utilizará el valor predeterminado de store_id = 0.
Funcionamiento en el frontend
El módulo añade pestañas a la sección de detalles del producto. La pestaña solo aparece cuando el producto tiene un valor completado en el atributo indicado en la configuración de la pestaña.
Para el nombre de la pestaña, el módulo aplica el siguiente fallback:
- Nombre para el Store View actual.
- Nombre predeterminado de
store_id = 0. - Valor de la tabla principal de pestañas, conservado por compatibilidad.
El contenido de la pestaña se filtra mediante el mecanismo CMS de Magento, por lo que puede contener etiquetas HTML y widgets compatibles con Magento.
Actualización de una instalación existente
Después de actualizar el módulo a una versión con soporte multilingüe, ejecuta:
php bin/magento setup:upgradephp bin/magento cache:flush
La nueva tabla de valores por Store View se añadirá mediante el esquema declarativo de Magento. Tras guardar por primera vez una pestaña existente, su nombre predeterminado también quedará guardado como registro store_id = 0.
Resolución de problemas
Si la pestaña no aparece en el frontend:
- Comprueba si el módulo está activado en la configuración.
- Comprueba si la pestaña tiene
Status establecido en Yes. - Comprueba si el producto tiene un valor completado en el atributo indicado en el campo
Attribute code. - Limpia la caché de Magento.
- Asegúrate de que el layout del tema sigue renderizando el bloque
product.info.details.
Si la traducción del nombre no aparece en el frontend:
- Comprueba si estás editando el Store View correcto.
- Comprueba si
Use Default Value está desmarcado para el campo Name. - Guarda la pestaña y limpia la caché.
