> For the complete documentation index, see [llms.txt](https://academy.gopersonal.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.gopersonal.ai/developers/plataforma-ecommerce/magento.md).

# Magento

## Magento

### Crear credenciales de API <a href="#create-api-credentials" id="create-api-credentials"></a>

Para crear credenciales de API en el Admin de Magento y darle acceso a "gopersonal", seguí estos pasos:

1. Ingresá al panel de administración de Magento con tus credenciales de administrador.
2. **Navegar a Integraciones**: una vez dentro, andá al menú "System" y seleccioná "Extensions" > "Integrations".
3. **Agregar una nueva integración**: hacé clic en el botón "Add New Integration".
4. Configurar los permisos de la API: andá a la pestaña API en la misma página.

   Definí los permisos de acceso a recursos que requiere tu integración. Para acceso total, seleccioná All. En caso contrario, seleccioná permisos personalizados según tus necesidades.

   Como mínimo seleccioná:

<figure><img src="https://academy.gopersonal.ai/~gitbook/image?url=https%3A%2F%2Flh7-us.googleusercontent.com%2FkyjOt6tlqxVUT8IXRMPHQLxjsZO6V1vNw-qXSmfhKg_I18dAp6zko8vka52ExsM3DXvC2LyxqUpwyGUBbolvVQ0wt_mH3ynSDLMt3dIpCE5z67RqVXbeHFVmUHd8L5r1J5-qAL7_clwSfcX6QjYaqAY&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=f8b5e89b&#x26;sv=1" alt=""><figcaption></figcaption></figure>

5- **Guardar y activar:** hacé clic en Save para guardar la configuración.

Después de guardar, aparece una nueva sección en la parte superior de la página con el Consumer Key, Consumer Secret, Access Token y Access Token Secret.

Hacé clic en Activate y luego permití los permisos en el popup para habilitar la integración. Si el proceso fue exitoso, vas a ver una pantalla con las credenciales de API.

### Instalar el plugin de gopersonal <a href="#install-gopersonal-plugin" id="install-gopersonal-plugin"></a>

#### Descarga / Actualización <a href="#download-update" id="download-update"></a>

Si la instalación del proyecto de Magento está, por ejemplo, en Sites/magento, navegá a la carpeta del proyecto / src/app/code y ejecutá el siguiente comando (asegurate de tener unzip instalado)

Copiar

```
#!/bin/bash

# Specify the directory
DIR="Gopersonal/Magento"

echo "Checking if directory exists: $DIR"
# Check if the directory exists
if [ -d "$DIR" ]; then
    echo "Directory exists. Deleting directory and its contents..."
    # Delete the directory and its contents
    rm -rf "$DIR"
    echo "Directory deleted."
else
    echo "Directory does not exist."
fi

echo "Creating directory: $DIR"
# Create the directory
mkdir -p "$DIR"
echo "Directory created."

echo "Navigating to directory: $DIR"
# Navigate to the directory
cd "$DIR"

echo "Downloading the latest zip file..."
# Download the file
curl -O https://public-assets.goshops.ai/magento2/modules/latest.zip
echo "Download complete."

echo "Unzipping the file..."
# Unzip the file
unzip -o latest.zip
echo "Unzip complete."

echo "Cleaning up the downloaded zip file..."
# Clean up the downloaded zip file
rm latest.zip
echo "Clean up complete."
```

En caso de una instalación manual, por ejemplo para un servidor SFTP, descargá los plugins directamente desde <https://public-assets.goshops.ai/magento2/modules/releases.html>

#### Reinicio <a href="#restart" id="restart"></a>

Normalmente, refrescá la caché y reiniciá Magento.

Copiar

```
bin/magento cache:clean &&
composer dump-autoload &&
bin/magento setup:upgrade &&
bin/magento setup:di:compile bin/magento setup:static-content:deploy
```

### Instalación con Composer <a href="#install-with-composer" id="install-with-composer"></a>

Podés instalar este módulo mediante Composer. Seguí estos pasos:

1. Asegurate de tener Composer instalado y configurado con tu proyecto Magento 2.
2. Ejecutá el siguiente comando en el directorio raíz de Magento para instalar la última versión de la rama main:

Copiar

```
composer require gopersonal/magento-plugin:dev-main
```

Si preferís instalar una versión específica, podés indicar el número de versión:

Copiar

```
composer require gopersonal/magento-plugin:1.0.16
```

Reemplazá `1.0.16` por el número de versión deseado.

1. Una vez completada la instalación, habilitá el módulo ejecutando:

Copiar

```
bin/magento module:enable Gopersonal_Magento
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
```

1. Limpiá la caché:

Copiar

```
bin/magento cache:clean
```

#### Actualización <a href="#upgrading" id="upgrading"></a>

Para actualizar el plugin de gopersonal para Magento a la última versión, seguí estos pasos:

1. Desde el directorio raíz de Magento, ejecutá el siguiente comando:

Copiar

```
composer require gopersonal/magento-plugin:dev-main --update-with-dependencies
```

Este comando actualiza el módulo a la última versión de la rama main.

1. Una vez finalizada la actualización con composer, ejecutá los siguientes comandos de Magento:

Copiar

```
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:clean
```

1. Si estás actualizando desde una versión considerablemente anterior, revisá el changelog o las release notes para identificar breaking changes o pasos de actualización adicionales.

Nota: si preferís actualizar a una versión específica en lugar de la última, reemplazá `dev-main` por el número de versión deseado en el comando de composer.

#### Configurar <a href="#configure" id="configure"></a>

Agregá el clientId en la configuración. Hay 1 clientId por ambiente; solicitá el valor correcto al equipo de soporte.

<figure><img src="https://academy.gopersonal.ai/~gitbook/image?url=https%3A%2F%2Flh7-us.googleusercontent.com%2F5_uRzEKqv12o0drDptnSGSWUmjBgrsxuC1bJolM0MezR0Eb0Da45IZRmqooCcMgXokGJ9Na8ZTB8E3AxiQSneA8a0dD7CLS5OX1pC7ec7qBMxqHhwpE5w4Z4Z9OpUJXAfzy3PP9X94o0JtKqc8amfFU&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=d3c4e339&#x26;sv=1" alt=""><figcaption></figcaption></figure>