Black Friday: 30% OFF em todos os planos, já aplicado no carrinho Ver planos
1.217 sites com atualizações automáticas Ver planos
Entrar Carrinho

O complemento não ativa: quase sempre é o plugin principal/core

O add-on instala, aparece na lista e a opção fica indisponível. Resolver o principal costuma resolver os dois.

Atualizado em 2 set 20262 min de leitura
Licenças e ativação

Um add-on (complemento, extensão, módulo) depende do plugin principal para existir. Quando ele instala, aparece na lista e a opção dele permanece indisponível, o problema quase nunca está no complemento: está no principal, que não foi reconhecido como licenciado.

É por isso que insistir no complemento não leva a lugar nenhum: ele está esperando uma resposta que o principal não está dando.

A ordem certa de checar

  • O plugin principal está instalado e ativo? Parece óbvio e não é: complementos costumam instalar sem reclamar mesmo sem o principal presente.
  • O principal está funcionando de verdade? Não basta estar ativo. Abra o painel de opções dele e use um recurso premium. Se o principal está limitado, o complemento vai continuar limitado.
  • As versões conversam? Complemento novo com principal antigo é uma causa comum e silenciosa. Atualize o principal primeiro.
  • Falta o Ativador do fabricante? Quando existe, ele é quem libera a linha inteira. Veja o que é o Ativador.

Resolvido o principal, o complemento normalmente passa a funcionar sozinho, sem nenhuma ação extra.

A ordem de instalação importa

Instale e ative o principal antes do complemento. Feito ao contrário, o complemento às vezes registra que o principal não existe e não refaz essa checagem sozinho. Se foi o seu caso, desative e reative o complemento: isso costuma bastar.

Exemplos que aparecem com frequência

O padrão é sempre o mesmo: o complemento é a peça visível, o principal é a peça que decide. Três formas em que isso chega ao suporte:

1. O complemento instala e a opção não liga. É o caso mais direto. Multi-Tier Commissions instalado, AffiliateWP na versão mais nova, e a comissão em níveis continua indisponível. Antes de mexer no complemento, confira o principal pelos quatro pontos da lista acima: é lá que a resposta costuma estar.

2. O complemento depende de dois principais, não de um. Affiliate Forms For Gravity Forms precisa do AffiliateWP e do Gravity Forms ativos. Falta um dos dois e ele fica na lista sem fazer nada, sem erro nenhum. Vale igual para o YayMail Addon for WooCommerce Subscriptions, que quer o YayMail Pro e o WooCommerce Subscriptions. Regra prática: quando o nome do complemento cita dois produtos, ele precisa dos dois.

3. O complemento não vem dentro do pacote do principal. Essa é a dúvida que mais chega, e não é bem um defeito: cada complemento é um item próprio no catálogo, com página e download separados. Baixar o principal não traz os complementos junto. Se você não achou, procure pelo nome exato do complemento na busca do site antes de concluir que ele não existe aqui.

Se o principal está impecável e o complemento continua parado

Aí vale um chamado. Abra descrevendo os dois: nome e versão do principal, nome e versão do complemento, e o que exatamente aparece (ou não aparece) no menu. Com esses quatro dados dá para dizer se é incompatibilidade de versão ou outra coisa.