Instalación de una extensión

El código que amplía o personaliza el comportamiento de Adobe Commerce y de los Magento Open Source 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 y Magento Open Source)
• Temas (cambia la apariencia de tu tienda y administrador)
• Paquetes de idioma (localice la tienda y el administrador)

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:

   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:

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

   

3. Clic Mis compras.

   

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

   

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.

   composer require <component-name>:<version>
   

   Por ejemplo,

   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:

   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:

   bin/magento module:enable J2t_Payplug --clear-static-content
   

   Debería ver el siguiente resultado:

   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:

   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.

   bin/magento setup:di:compile
   

4. Compruebe que la extensión esté habilitada:

   bin/magento module:status J2t_Payplug
   

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

   Module is enabled
   

5. Limpie la caché:

   bin/magento cache:clean
   

6. Configure la extensión en Administración según sea necesario.

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:

   composer update vendor/module-name
   

   Actualización por versión:

   composer require vendor/module-name ^x.x.x
   

4. Ejecute los siguientes comandos para actualizar, implementar y limpiar la caché.

   bin/magento setup:upgrade --keep-generated
   

   bin/magento setup:static-content:deploy
   

   bin/magento cache:clean
   

Recursos de Business.Adobe.com