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

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

Complementos de plugins de afiliados, de formulários e de e-commerce são os que mais chegam como chamado. O padrão é sempre o mesmo: o complemento é a peça visível, o principal é a peça que decide.

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.