# Primeiro plugin (5min)

Este guia leva você de "mpm recém-instalado" a "plugin rodando no Mautic". Pressupõe Docker e um container Mautic ativo.

# 1. Registre a instância

Um "instance" é um apelido pra um container Docker do Mautic.

mpm instance discover
mpm instance add prod --container mautic_app --mautic-version 6
mpm instance list

Use --mautic-version correto (4, 5, 6, 7). Ele define defaults de console e plugins. O mpm detecta o layout docroot sozinho — ver Layout do Mautic.

# 2. Veja o que você tem direito

O catálogo mostra só os plugins cobertos pela sua licença.

mpm catalog refresh
mpm catalog search report
mpm catalog info queryreport

# 3. Instale

mpm install queryreport -i prod

Você vai ver o pipeline de 14 etapas. No fim:

OK Query Report v6.3.4 installed successfully in 'prod'

# 4. Confirme que o Mautic registrou

mpm list -i prod
mpm console -i prod -- mautic:plugins:reload

O plugin deve aparecer no painel do Mautic em Settings → Plugins.

# 5. Mantenha atualizado

mpm check -i prod          # há updates?
mpm update queryreport -i prod
mpm update all -i prod     # tudo de uma vez

# Se algo der errado

• 426 fingerprint_required → mpm desatualizado: mpm self-update.
• 403 key_revoked → a key foi usada em outro ambiente; ver API key e fingerprint.
• Instala mas não aparece no Mautic → quase sempre é layout docroot; ver Layout do Mautic.
• Mais casos em Troubleshooting.

# Diagnóstico seguro (não muda nada)

mpm validate ./algum-plugin.zip --mautic-version 6   # valida um ZIP local
mpm status queryreport -i prod                        # estado detalhado
mpm console -i prod -- cache:clear                     # console arbitrário