Instalar paquetes con Composer

Antes de empezar

• Tu cuenta necesita acceso al repositorio: un plan, o ser miembro de una organización que tenga uno. Configuración → Cuenta indica si está activo.
• Crea un token de Composer.
• El composer.json de tu proyecto necesita composer/installers para que los plugins y los temas vayan a las carpetas correctas.

1. Guarda tu token para Composer

Una vez por ordenador, guarda el token en el auth.json global de Composer:

composer config --global http-basic.composer.meteorgpl.com token <your-token>

El nombre de usuario es siempre token; la contraseña es el propio token. El menú Instalar de cada paquete tiene el comando en Autenticar (1).

En CI, pasa el token mediante la variable de entorno COMPOSER_AUTH (Composer en CI).

2. Añade el repositorio al proyecto

Una vez por proyecto:

composer config repositories.meteorgpl composer https://composer.meteorgpl.com

3. Requiere un paquete

1. En la página del paquete, abre Instalar (1).
2. La pestaña Composer (2) tiene el comando composer require; cópialo y ejecútalo en tu proyecto.
3. La pestaña Autenticar (3) tiene el comando del token del paso 1.
4. Descargar ZIP (4) descarga en su lugar la última versión como archivo ZIP.

La pestaña composer.json da la línea que hay que añadir a mano a require, con una restricción de acento circunflejo sobre la última versión.

Un composer.json completo

{
    "repositories": [
        { "type": "composer", "url": "https://composer.meteorgpl.com" }
    ],
    "require": {
        "composer/installers": "^2.0",
        "meteorgpl-plugin/elementor-pro": "^3.21"
    },
    "extra": {
        "installer-paths": {
            "wp-content/plugins/{$name}/": ["type:wordpress-plugin"],
            "wp-content/themes/{$name}/": ["type:wordpress-theme"]
        }
    }
}

Los plugins se llaman meteorgpl-plugin/<slug> y los temas meteorgpl-theme/<slug>.

En Bedrock, las rutas son web/app/plugins/{$name}/ y web/app/themes/{$name}/ (el propio composer.json de Bedrock ya las incluye).

Versiones

Todas las versiones publicadas siguen disponibles, así que las instalaciones desde composer.lock son reproducibles. Usa restricciones con acento circunflejo (^3.21) para recibir las actualizaciones menores con composer update, o requiere una versión exacta: composer require meteorgpl-plugin/elementor-pro:3.21.2. La pestaña Versiones las enumera todas, con el SHA-256 de cada ZIP (Leer la página de un paquete).

Un tema hijo necesita también instalado su tema padre: la página del paquete indica el tema padre y enlaza a él cuando está en el repositorio.

Descargas ZIP

Sin Composer, descarga una versión desde el sitio web: Descargar ZIP en el menú Instalar para la última, o zip junto a cualquier versión en la pestaña Versiones. Sube el ZIP en WordPress en Plugins → Añadir nuevo → Subir plugin (o Apariencia → Temas → Añadir nuevo → Subir tema). Las descargas cuentan en tu historial de descargas igual que las de Composer.

Solución de problemas

401 Unauthorized: el token es incorrecto, está revocado o ha caducado. Compruébalo en Configuración → Tokens de Composer y vuelve a guardarlo.

403 Forbidden: el token es válido, pero tu cuenta no tiene acceso al repositorio (no tiene plan), o el token está limitado a redes que no incluyen la máquina que ejecuta Composer.

Paquete no encontrado: comprueba el nombre de Composer en la página del paquete y que la entrada del repositorio está en el composer.json del proyecto. Un token limitado a ciertos paquetes tampoco ve los demás.

Demasiados intentos de autenticación fallidos (429): espera unos minutos y vuelve a intentarlo con el token correcto.