Documentación Commerce Guía de Commerce en la infraestructura en la nube

Administración de extensiones

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:
Nube
Extensiones

Creado para:

Administrador
Desarrollador

Puede ampliar las funcionalidades de la aplicación de Adobe Commerce agregando una extensión desde el Commerce Marketplace. Por ejemplo, puede agregar una temática para cambiar la apariencia de su tienda, o puede agregar un paquete de idioma para localizar su tienda y administrador.

NOTE

Para evitar problemas de instalación, todas las compras de Marketplace deben completarse con la misma cuenta (MAGEID) que posee el proyecto en la nube.

Nombre del compositor de una extensión

Aunque en esta sección se explica cómo obtener el nombre y la versión del Compositor de una extensión del Commerce Marketplace, puede encontrar el nombre y la versión de cualquier módulo en el archivo Compositor del módulo. Abra el archivo composer.json en un editor de texto y anote los valores "name" y "version".

Para obtener el nombre del Compositor de un módulo del Commerce Marketplace:

Inicie sesión en Commerce Marketplace con el nombre de usuario y la contraseña que utilizó para adquirir el componente.
En la esquina superior derecha, haz clic en tu nombre de usuario y selecciona Mi perfil.
En la página Mi cuenta, haga clic en Mis compras.
En la página Mis compras, seleccione un módulo que haya adquirido y haga clic en Detalles técnicos.
Haga clic en Copiar para copiar Component name en el portapapeles.
Abra un editor de texto, pegue el nombre del componente y agregue dos puntos (:).
En Detalles técnicos, haga clic en Copiar para copiar Component version en el portapapeles.

En el editor de texto, anexe el número de versión al nombre del componente después de dos puntos. Por ejemplo:

code language-text
`extension-name/magento2:1.0.1`

Instalación de una extensión

Adobe recomienda trabajar en una rama de desarrollo al añadir una extensión a la implementación. Al instalar una extensión, el nombre de la extensión (<VendorName>_<ComponentName>) se inserta automáticamente en el archivo app/etc/config.php. No es necesario editar el archivo directamente.

Para instalar una extensión:

En la estación de trabajo local, cambie al directorio del proyecto.
Cree o desproteja una rama de desarrollo. Consulte ramificación.

Usando el nombre y la versión del Compositor, agregue la extensión a la sección require del archivo composer.json.

code language-bash
`composer require <extension-name>:<version> --no-update`

Actualice las dependencias del proyecto.

code language-bash
`composer update`

Agregar, confirmar y enviar cambios de código.

code language-bash
`git add -A`

code language-bash
`git commit -m "Install <extension-name>"`

code language-bash
`git push origin <branch-name>`

note warning
WARNING
Al instalar una extensión, debe incluir el archivo `composer.lock` cuando inserte cambios de código en el entorno remoto. El comando `composer install` lee el archivo `composer.lock` para habilitar las dependencias definidas en el entorno remoto.

Una vez finalizada la generación y la implementación, utilice un SSH para iniciar sesión en el entorno remoto y comprobar la extensión instalada.

code language-bash
`bin/magento module:status <extension-name>`

Un nombre de extensión usa el formato: <VendorName>_<ComponentName>.

Respuesta de ejemplo:

code language-none
`Module is enabled`

Si encuentra errores de implementación, consulte error de implementación de extensión.

Administración de extensiones

Al añadir una extensión mediante Composer, el proceso de implementación habilita automáticamente la extensión. Si ya tiene la extensión instalada, puede habilitarla o deshabilitarla mediante la CLI. Al administrar las extensiones, use el formato: <VendorName>_<ComponentName>

Nunca habilite ni deshabilite una extensión mientras esté conectado a entornos remotos.

Para habilitar o deshabilitar una extensión:

En la estación de trabajo local, cambie al directorio del proyecto.

Habilite o deshabilite un módulo. El comando module actualiza el archivo config.php con el estado solicitado del módulo.

Habilite un módulo.

code language-bash
`bin/magento module:enable <module-name>`

Deshabilite un módulo.

code language-bash
`bin/magento module:disable <module-name>`

Si habilitó un módulo, use ece-tools para actualizar la configuración.

code language-bash
`./vendor/bin/ece-tools module:refresh`

Compruebe el estado de un módulo.

code language-bash
`bin/magento module:status <module-name>`

Agregar, confirmar y enviar cambios de código.

code language-bash
`git add -A`

code language-bash
`git commit -m "Disable <extension-name>"`

code language-bash
`git push origin <branch-names>`

Actualización de una extensión

Antes de continuar, necesita el nombre y la versión del compositor para la extensión de. Además, confirme que la extensión es compatible con el proyecto y la versión de Adobe Commerce. En particular, compruebe la versión de PHP necesaria antes de comenzar.

Para actualizar una extensión:

En la estación de trabajo local, cambie al directorio del proyecto.
Cree o desproteja una rama de desarrollo. Consulte ramificación.
Abra el archivo composer.json en un editor de texto.
Busque la extensión y actualice la versión.
Guarde los cambios y salga del editor de texto.

Actualice las dependencias del proyecto.

code language-bash
`composer update`

Agregue, confirme e inserte los cambios de código.

code language-bash
`git add -A`

code language-bash
`git commit -m "Update <extension-name>"`

code language-bash
`git push origin <branch-names>`

Si encuentra errores, consulte Error al recuperar del componente. Para obtener más información acerca del uso de extensiones con Adobe Commerce, consulte Extensiones en la Guía de administración.

recommendation-more-help

05f2f56e-ac5d-4931-8cdb-764e60e16f26