Instalar extensiones de Magento: guía completa

Las extensiones de Magento amplían las funciones de tu tienda online. En esta guía aprenderás a instalar y gestionar extensiones de forma segura.

Encontrar extensiones

Magento Marketplace

La fuente oficial de extensiones de Magento:

1. Ve a marketplace.magento.com
2. Filtra por versión de Magento y por categoría
3. Consulta las valoraciones y la compatibilidad
4. Fíjate en la fecha de la última actualización

Otras fuentes

Además del Marketplace, encontrarás extensiones en GitHub (código abierto) y en proveedores externos como Amasty y Mageworx. Aplica los criterios de calidad que verás a continuación también a las extensiones de estas fuentes.

Criterios de calidad

Al elegir extensiones, fíjate en lo siguiente:

• Compatibilidad: admite tu versión de Magento
• Valoraciones: un mínimo de 4 estrellas, con varias valoraciones
• Actualizaciones: actualizada recientemente (en los últimos 6 meses)
• Soporte: desarrollador activo que ofrece soporte
• Documentación: buena documentación de instalación y configuración

Riesgo de las extensiones malas

Las extensiones malas pueden provocar:

• Vulnerabilidades de seguridad
• Problemas de rendimiento
• Conflictos con otras extensiones
• Problemas de actualización al subir de versión Magento

Instalación con Composer (recomendada)

Composer es el método estándar para las extensiones de Magento 2.

Paso 1: Configurar el acceso al Marketplace

1. Inicia sesión en marketplace.magento.com
2. Ve a My Profile > Access Keys
3. Crea un nuevo par de claves
4. Copia la clave pública y la clave privada

Paso 2: Configurar la autenticación

Añade las claves a auth.json de esta forma:

{
    "http-basic": {
        "repo.magento.com": {
            "username": "public_key_hier",
            "password": "private_key_hier"
        }
    }
}

Paso 3: Instalar la extensión

# Ve a la raíz de Magento
cd /pad/naar/magento

# Instala la extensión
composer require vendor/module-name

# Registra el módulo
bin/magento setup:upgrade

# Compila la inyección de dependencias
bin/magento setup:di:compile

# Despliega el contenido estático
bin/magento setup:static-content:deploy nl_NL

# Vacía la caché
bin/magento cache:clean

Atención: si tu tienda está en modo developer o default, setup:static-content:deploy solo se ejecuta con la opción -f (force): bin/magento setup:static-content:deploy -f nl_NL. En el modo de producción, -f no hace falta.

Instalación manual

Para las extensiones que no están disponibles con Composer:

Paso 1: Descarga y subida

1. Descarga la extensión (archivo ZIP)
2. Descomprímela en tu ordenador
3. Súbela a app/code/Vendor/ModuleName/

Paso 2: Registrar el módulo

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

Comprobar la estructura

Un módulo con la estructura correcta tiene:

app/code/Vendor/ModuleName/
├── registration.php
├── etc/
│   └── module.xml
├── Block/
├── Controller/
├── Model/
└── view/

Gestionar extensiones

Resumen de los módulos instalados

bin/magento module:status

Muestra todos los módulos activados y desactivados.

Desactivar un módulo

bin/magento module:disable Vendor_ModuleName
bin/magento setup:upgrade
bin/magento cache:clean

Activar un módulo

bin/magento module:enable Vendor_ModuleName
bin/magento setup:upgrade
bin/magento cache:clean

Eliminar un módulo

# Con Composer (recomendado)
composer remove vendor/module-name
bin/magento setup:upgrade
bin/magento cache:clean

# Módulos manuales
bin/magento module:disable Vendor_ModuleName
# Elimina la carpeta de app/code/
bin/magento setup:upgrade

Configurar la extensión

Después de instalarlas, la mayoría de las extensiones deben configurarse:

1. Ve a Stores > Configuration
2. Busca la sección de la extensión (suele estar bajo su propio nombre)
3. Configura los ajustes
4. Haz clic en Save Config
5. Vacía la caché si hace falta

Extensiones muy utilizadas por categoría

Pagos

• Mollie Payments: iDEAL, tarjeta de crédito, Bancontact
• MultiSafepay: varios métodos de pago
• Adyen: pagos para grandes empresas

SEO

• Mageplaza SEO: paquete completo de SEO
• Amasty SEO Toolkit: SEO avanzado
• MageWorx SEO Suite: optimización SEO

Rendimiento

• LiteSpeed Cache: caché LiteMage
• Amasty Full Page Cache Warmer: precalentamiento de caché
• MageWorx Image Optimizer: optimización de imágenes

Marketing

• Mailchimp: integración de marketing por correo electrónico
• Klaviyo: automatización de marketing
• Google Shopping: gestión de feeds

Resolución de problemas

Comprobar los registros

Si una extensión no funciona como esperas, mira primero los archivos de registro en var/log/, sobre todo exception.log y system.log, de esta forma:

tail -100 var/log/exception.log
tail -100 var/log/system.log

El mensaje de error suele señalar directamente la extensión y el archivo que causan el problema.

"Class not found" después de la instalación

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

"Cannot save" o error de permisos

Comprueba los permisos de los archivos:

find var generated vendor pub/static pub/media app/etc -type f -exec chmod 644 {} \;
find var generated vendor pub/static pub/media app/etc -type d -exec chmod 755 {} \;

Conflictos entre extensiones

1. Desactiva las extensiones una por una
2. Identifica la extensión que causa el conflicto
3. Ponte en contacto con el desarrollador de la extensión
4. Plantéate usar una extensión alternativa

El sitio web no funciona después de la instalación

# Desactiva el módulo
bin/magento module:disable Vendor_ModuleName

# Si eso no funciona, hazlo desde la base de datos
# Busca el módulo en la tabla setup_module

Buenas prácticas

1. Prueba primero en staging: nunca instales directamente en producción
2. Haz una copia de seguridad: siempre antes de instalar
3. Una cada vez: instala las extensiones de una en una
4. Documenta: lleva un registro de las extensiones que tienes
5. Actualiza con regularidad: mantén las extensiones al día por seguridad
6. Reduce las extensiones al mínimo: instala solo lo que de verdad necesitas. Cada extensión es código adicional que requiere mantenimiento y puede afectar a la velocidad de tu tienda