Instalar plugins premium do WordPress com o Composer

Plugins premium costumam chegar como arquivos zip: você os baixa da página de conta do fornecedor e os envia à mão, em cada site, a cada atualização. O MeteorGPL os oferece como pacotes do Composer, para que sejam versionados, fixados e instalados como o resto das suas dependências. Este guia leva um projeto do zero ao seu primeiro composer require.

Passo 1 — Crie um token do Composer#

O Composer se autentica no repositório com um token. Entre no MeteorGPL, abra Configurações → Tokens do Composer e crie um. Copie-o imediatamente: ele é exibido uma única vez.

Um token pode ser restringido ao ser criado: a certos pacotes, a faixas de IP ou até uma data. Para a sua própria máquina, um token pessoal sem restrições serve; para servidores e pipelines, leia Tokens do Composer no CI.

Passo 2 — Guarde o token para o Composer#

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

O nome de usuário é literalmente a palavra token; a senha é o próprio token. O Composer guarda o par no seu auth.json global (~/.composer/auth.json, ou $COMPOSER_HOME/auth.json), nunca no projeto, então ele não pode ser commitado por acidente.

Passo 3 — Adicione o repositório ao projeto#

Na pasta que contém o composer.json do seu projeto:

composer config repositories.meteorgpl composer https://composer.meteorgpl.ddev.site

Passo 4 — Diga ao Composer para onde vão os pacotes do WordPress#

Os plugins são publicados com o tipo wordpress-plugin, os temas com wordpress-theme. O pacote composer/installers lê esses tipos e coloca cada pacote onde o WordPress procura por ele. Para uma instalação clássica do WordPress, o composer.json fica assim:

{
    "repositories": [
        { "type": "composer", "url": "https://composer.meteorgpl.ddev.site" }
    ],
    "require": {
        "composer/installers": "^2.0"
    },
    "extra": {
        "installer-paths": {
            "wp-content/plugins/{$name}/": ["type:wordpress-plugin"],
            "wp-content/themes/{$name}/": ["type:wordpress-theme"]
        }
    },
    "config": {
        "allow-plugins": { "composer/installers": true }
    }
}

O próprio composer/installers é um plugin do Composer, e o Composer pergunta antes de executar um; allow-plugins responde a essa pergunta de antemão.

Passo 5 — Encontre o nome do pacote#

Cada página de pacote mostra o comando de instalação. Os nomes seguem uma única regra:

O slug é o nome da própria pasta do plugin ou do tema, em minúsculas, então o pacote vai para o diretório que o fornecedor distribui e o WordPress não vê nenhuma diferença.

Passo 6 — Faça o require do plugin#

composer require meteorgpl-plugin/elementor-pro:^3.21

O Composer baixa a versão, coloca-a em wp-content/plugins/elementor-pro/ e registra no composer.lock a versão exata e o checksum do zip dela. Faça commit do composer.json e do composer.lock: todos os outros ambientes passam então a instalar os mesmos bytes com composer install.

A restrição com circunflexo (^3.21) permite que composer update traga novas versões minor e patch, nunca a próxima major. Toda versão publicada continua disponível, então voltar atrás é um único comando:

composer require meteorgpl-plugin/elementor-pro:3.20.0

Passo 7 — Ative-o com a sua chave de licença#

Nada em um pacote é modificado: o código de licença, ativação e atualização do fornecedor é distribuído como está. Ative o plugin no WordPress com a chave de licença que você comprou do fornecedor; o suporte e o canal de atualização do próprio fornecedor vêm com essa chave.

Guarde suas chaves no cofre de chaves de licença (Configurações → Chaves de licença): elas são armazenadas criptografadas, exibidas na página de cada pacote, e você recebe um lembrete 30 e 7 dias antes de uma delas expirar.

Se algo der errado#

• 401 Unauthorized — o Composer não enviou nenhum token, ou enviou um desconhecido, expirado ou revogado. Repita o passo 2 com um novo token.
• 403 Forbidden — o token é válido, mas a conta não tem acesso ao repositório. Verifique Configurações → Cobrança e planos, ou fale com o proprietário da sua organização.
• O plugin foi parar em vendor/ — o composer/installers está faltando, ou o Composer não teve permissão para executá-lo. Verifique require e allow-plugins do passo 4.

Próximos passos#

• Trabalha com Bedrock? Leia Usar o MeteorGPL em um projeto Bedrock.
• Instala a partir de um pipeline? Leia Tokens do Composer no CI.
• Quer ficar sabendo de novas versões e correções de segurança? Leia Manter plugins atualizados e acompanhar vulnerabilidades.
• A documentação cobre nomes, versões e a API JSON em uma única página.