Administración de extensiones de terceros

El código que amplía o personaliza el comportamiento de Adobe Commerce se denomina extensión. Opcionalmente, puede empaquetar y distribuir extensiones en el 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 interfaz de línea de comandos para administrar las extensiones de terceros que compra al Commerce Marketplace. Puede usar el mismo procedimiento para instalar la extensión any; todo lo que necesita es el nombre y la versión del Compositor de la extensión. Para encontrarlo, abra el archivo composer.json de la extensión y anote los valores de "name" y "version".

Instalar

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 el repositorio repo.magento.com existe en el archivo composer.json:

    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 archivo composer.json del 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 información de extensión

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

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

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

  2. En la esquina superior derecha, haz clic en Tu nombre > Mi perfil.

    Acceda a su cuenta de Marketplace

  3. Haga clic en Mis compras.

    Historial de compras en el mercado

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

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

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

Actualizar dependencias del Compositor

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

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

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

    Por ejemplo,

    code language-bash
    composer require j2t/module-payplug:2.0.2
    
  2. Escriba sus 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-none
    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 instalació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>; 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".

Activar

Algunas extensiones no funcionan correctamente a menos que borre primero los archivos de vista estática generados. Utilice la opción --clear-static-content para borrar los archivos de vista estática cuando habilite 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-none
    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-none
    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 encuentra errores al cargar la tienda en un explorador, use el siguiente comando para borrar la caché: bin/magento cache:flush.

Actualizar

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
    

Desinstalar

Debe ponerse en contacto con el proveedor de la extensión para obtener instrucciones sobre cómo quitar una extensión de terceros. Las instrucciones deben proporcionar la siguiente información:

  • Cómo revertir los cambios de la tabla de base de datos
  • Cómo revertir los cambios de datos de la base de datos
  • Qué archivos se deben eliminar o revertir
CAUTION
Realice los pasos de desinstalación en un entorno que no sea de producción first y realice pruebas exhaustivas antes de implementar en el entorno de producción.

Las siguientes instrucciones proporcionan información general para desinstalar extensiones de terceros:

  1. Elimine la extensión del repositorio del proyecto de Adobe Commerce.

    • Para las extensiones basadas en Compositor, quite la extensión del archivo de Adobe Commerce composer.json.

      code language-bash
      composer remove <package-name>
      
    • Para las extensiones no basadas en Compositor, elimine los archivos físicos del repositorio del proyecto de Adobe Commerce.

      code language-bash
      rm -rf app/code/<vendor-name>/<module-name>
      
  2. Si el archivo config.php está bajo control de código fuente en el repositorio del proyecto de Adobe Commerce, quite la extensión del archivo config.php.

  3. Pruebe la base de datos local para asegurarse de que las instrucciones proporcionadas por el proveedor funcionan según lo esperado.

  4. Compruebe que la extensión de está correctamente deshabilitada y que el sitio web funciona según lo esperado en el entorno de ensayo.

  5. Implemente los cambios en el entorno de producción.

recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995