Kowal Custom Tab - instalación y configuración
Requisitos
- Magento 2.4 o superior.
- Acceso a CLI de Magento.
- Composer configurado para descargar paquetes privados de Kowal.
- Módulo base
kowal/base.
- Permisos de administrador para el panel de Magento.
Instalación mediante Composer
Añade el repositorio del paquete:
Recibirás por correo electrónico los datos de acceso al repositorio Composer (dirección de e-mail del cliente y 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 e-mail 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 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 un entorno de producción, ejecuta la compilación DI y el despliegue de recursos estáticos según el proceso del proyecto:
php bin/magento setup:di:compile
php 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_CustomTab
php bin/magento setup:upgrade
php bin/magento cache:flush
Configuración del módulo
En el panel de Magento, ve a:
Stores > Configuration > Kowal > Custom Tab
Configura la opciónEnable moduleenYes, 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 enAdd new CustomTabpara 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 de producto desde el que se obtendrá 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 parastore_id = 0.
Para añadir una traducción para un Store View concreto:
- Abre una pestaña existente en modo edición.
- Utiliza el conmutador Store View en la zona superior derecha del formulario.
- Selecciona el Store View para el que quieres cambiar el nombre.
- Desmarca
Use Default Valuejunto al campoName.
- Introduce el nombre de la pestaña para la versión lingüística seleccionada.
- Guarda el formulario.
SiUse Default Valuepermanece marcado, el módulo utilizará el valor predeterminado destore_id = 0.
Funcionamiento en el frontend
El módulo añade pestañas a la sección de detalles del producto. La pestaña aparece solo 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 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 incluir 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 compatibilidad multilingüe, ejecuta:
php bin/magento setup:upgrade
php bin/magento cache:flush
La nueva tabla de valores por Store View se añadirá mediante el esquema declarativo de Magento. Tras el primer guardado de una pestaña existente, su nombre predeterminado también se persistirá como registrostore_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
Statusconfigurado enYes.
- 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 Valueestá desmarcado para el campoName.
- Guarda la pestaña y limpia la caché.
