DocumentaciónCommerceGuía de instalación

Administración de extensiones de terceros

Last update: Fri Jun 07 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Experimentado
  • Administrador
  • Desarrollador

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 interfaz de línea de comandos para administrar las extensiones de terceros que compra al 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".

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 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 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 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 dependencias del Compositor

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 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>; 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".

Activar

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.

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 primero y realice pruebas exhaustivas antes de su implementación en el entorno de producción de.

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, elimine la extensión de su Adobe Commerce composer.json archivo.

      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 la variable config.php está bajo control de código fuente en el repositorio del proyecto de Adobe Commerce, elimine la extensión de la config.php archivo.

  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