Instalación de una extensión

El código que amplía o personaliza el comportamiento de Adobe Commerce se denomina extensión. Si lo desea, puede empaquetar y distribuir extensiones en Commerce Marketplace u otro sistema de distribución de extensiones.

Las extensiones incluyen:

  • Módulos (ampliación de las funciones de Adobe Commerce)
  • Temas (cambia la apariencia de tu tienda y administrador)
  • Paquetes de idioma (localice la tienda y el administrador)
TIP
En este tema se explica cómo utilizar la línea de comandos para instalar extensiones que adquiere del Commerce Marketplace. Puede utilizar el mismo procedimiento para instalar cualquiera Extensión; todo lo que necesita es el nombre y la versión Compositor de la extensión. Para encontrarlo, abra el de la extensión de composer.json y anote los valores de "name" y "version".

Antes de la instalación, es posible que desee:

  1. Haga una copia de seguridad de la base de datos.

  2. Activar modo de mantenimiento:

    code language-bash
    bin/magento maintenance:enable
    

Para instalar una extensión, debe:

  1. Obtenga una extensión del Commerce Marketplace u otro desarrollador de extensiones.

  2. Si instala una extensión desde el Commerce Marketplace, asegúrese de que la variable repo.magento.com el repositorio existe en su composer.json archivo:

    code language-bash
    "repositories": [
        {
            "type": "composer",
            "url": "https://repo.magento.com/"
        }
    ]
    
  3. Obtenga el nombre y la versión del compositor de la extensión.

  4. Actualice el composer.json en el proyecto con el nombre y la versión de la extensión.

  5. Compruebe que la extensión de está instalada correctamente.

  6. Habilite y configure la extensión de.

Obtener el nombre y la versión de la extensión Compositor

Si ya conoce el nombre y la versión del compositor de la extensión, omita este paso y continúe con Actualice su composer.json archivo.

Para obtener el nombre y la versión del compositor de la extensión desde el Commerce Marketplace:

  1. Iniciar sesión en Commerce Marketplace con el nombre de usuario y la contraseña que utilizó para adquirir la extensión de.

  2. En la esquina superior derecha, haga clic en Su nombre > Mi perfil.

    Acceder a su cuenta de Marketplace

  3. Clic Mis compras.

    Historial de compras de Marketplace

  4. Busque la extensión que desea instalar y haga clic en Detalles técnicos.

    Los detalles técnicos muestran el nombre de Compositor de la extensión.

TIP
También puede encontrar el nombre del compositor y la versión de cualquiera extensión (tanto si la compró en Commerce Marketplace como en otro sitio) en el composer.json archivo.

Actualizar el archivo de composición

Añada el nombre y la versión de la extensión a su composer.json archivo:

  1. Vaya al directorio del proyecto y actualice el composer.json archivo.

    code language-bash
    composer require <component-name>:<version>
    

    Por ejemplo,

    code language-bash
    composer require j2t/module-payplug:2.0.2
    
  2. Introduzca su claves de autenticación. Su clave pública es su nombre de usuario; su clave privada es su contraseña.

  3. Espere a que Composer termine de actualizar las dependencias del proyecto y asegúrese de que no hay errores:

    code language-terminal
    Updating dependencies (including require-dev)
    Package operations: 1 install, 0 updates, 0 removals
      - Installing j2t/module-payplug (2.0.2): Downloading (100%)
    Writing lock file
    Generating autoload files
    

Verificar la extensión

Para comprobar que la extensión de está instalada correctamente, ejecute el siguiente comando:

bin/magento module:status J2t_Payplug

De forma predeterminada, la extensión está probablemente deshabilitada:

Module is disabled

El nombre de la extensión tiene el formato <VendorName>_<ComponentName>; este es un formato diferente del nombre del Compositor. Utilice este formato para activar la extensión de. Si no está seguro del nombre de la extensión, ejecute:

bin/magento module:status

Y busque la extensión en "Lista de módulos desactivados".

Habilitar la extensión

Algunas extensiones no funcionan correctamente a menos que borre primero los archivos de vista estática generados. Utilice el --clear-static-content para borrar los archivos de vista estática al activar una extensión.

  1. Habilite la extensión y borre los archivos de vista estática:

    code language-bash
    bin/magento module:enable J2t_Payplug --clear-static-content
    

    Debería ver el siguiente resultado:

    code language-terminal
    The following modules have been enabled:
    - J2t_Payplug
    
    To make sure that the enabled modules are properly registered, run 'setup:upgrade'.
    Cache cleared successfully.
    Generated classes cleared successfully. Please run the 'setup:di:compile' command to generate classes.
    Generated static view files cleared successfully.
    
  2. Registre la extensión:

    code language-bash
    bin/magento setup:upgrade
    
  3. Vuelva a compilar el proyecto: en el modo de producción, puede recibir un mensaje que indique "Vuelva a ejecutar el comando de compilación del Magento". La aplicación no le pide que ejecute el comando de compilación en modo de desarrollador.

    code language-bash
    bin/magento setup:di:compile
    
  4. Compruebe que la extensión esté habilitada:

    code language-bash
    bin/magento module:status J2t_Payplug
    

    Debería ver la salida que verifica que la extensión ya no está deshabilitada:

    code language-terminal
    Module is enabled
    
  5. Limpie la caché:

    code language-bash
    bin/magento cache:clean
    
  6. Configure la extensión en Administración según sea necesario.

TIP
Si se producen errores al cargar la tienda en un explorador, utilice el siguiente comando para borrar la caché: bin/magento cache:flush.

Actualización de una extensión

Para actualizar o actualizar un módulo o una extensión:

  1. Descargue el archivo actualizado desde Marketplace u otro desarrollador de extensiones. Tome nota del nombre y la versión del módulo.

  2. Exporte el contenido al directorio raíz de la aplicación.

  3. Si existe un paquete Composer para el módulo, ejecute una de las siguientes acciones.

    Actualización por nombre de módulo:

    code language-bash
    composer update vendor/module-name
    

    Actualización por versión:

    code language-bash
    composer require vendor/module-name ^x.x.x
    
  4. Ejecute los siguientes comandos para actualizar, implementar y limpiar la caché.

    code language-bash
    bin/magento setup:upgrade --keep-generated
    
    code language-bash
    bin/magento setup:static-content:deploy
    
    code language-bash
    bin/magento cache:clean
    
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995