MevvCode Documentation

Para que serve o MevvCode

O MevvCode é uma casa para pequenos pedaços de comportamento específico do site: uma regra de frete do WooCommerce, um campo do checkout, uma tag de verificação, uma pequena ferramenta administrativa, um ajuste visual em CSS ou HTML/texto reutilizável. Ele dá ao código um dono, um local, condições, histórico e um caminho protegido até a produção.

Use quando: A mudança é menor que um plugin completo, mas importante o suficiente para não desaparecer dentro de um arquivo do tema.
Não use quando: O requisito é um produto de domínio completo, com seu próprio modelo de dados, telas e ciclo de vida de releases; nesse caso, construa um plugin convencional.
Propriedade do código: Escreva o código você mesmo ou traga código revisado de um desenvolvedor ou fonte em que confie. O MevvCode gerencia e protege código; ele não torna confiável um snippet desconhecido.

Comece todo snippet emprestado como inativo. Leia-o, remova segredos e identificadores específicos do site e valide-o antes de ativar.

Instalação

Instale e ative primeiro o plugin gratuito MevvCode. Ele exige WordPress 6.6 ou superior e PHP 8.1 ou superior. O Pro é um plugin complementar separado e nunca substitui o runtime gratuito.

Envie mevvcode-1.1.0.zip e ative-o.
Abra MevvCode → Trechos de código. O diretório de armazenamento e seus arquivos de proteção do servidor web são criados automaticamente.
Crie um snippet inativo, escolha o tipo e o local, e salve.
Use a prévia e o resultado de sintaxe antes de ativá-lo.
Instale mevvcode-pro-1.1.0.zip apenas se precisar das telas do Pro e ative depois a sua licença MEVD em MevvCode → Licença.

Mantenha o plugin gratuito ativo quando o Pro estiver instalado. O runtime executável pertence ao Free, de modo que uma licença vencida nunca faz desaparecer um comportamento já publicado.

Seu primeiro snippet

Crie o primeiro registro inativo. Dê a ele um nome que descreva o propósito, selecione PHP e o local global apenas se o próprio código se conectar a um hook específico do WordPress ou do WooCommerce, e salve.

add_filter( 'woocommerce_package_rates', function ( $rates ) {
    if ( ! WC()->cart || WC()->cart->get_subtotal() < 1000 ) {
        return $rates;
    }
    return array_filter( $rates, function ( $rate ) {
        return 'free_shipping' === $rate->method_id;
    } );
} );

Leia o resultado da validação; um erro de análise deve deixar o registro inativo.
Confirme que a sua loja já tem um método de frete grátis configurado.
Ative o snippet no ambiente de homologação e teste carrinhos abaixo e acima do limite.
Exporte uma cópia em JSON antes de levar o registro para produção.
Publique e depois verifique o carrinho público e o endpoint de saúde do MevvCode.

O exemplo demonstra o fluxo de trabalho, não uma política de frete universal. Impostos, cupons, moedas e zonas de entrega podem mudar qual subtotal a sua regra de negócio deve usar.

Painel em turco e linha do plugin

Free e Pro 1.1.0 trazem catálogos PO editáveis, MO compilados e POT. Quando o idioma do site WordPress é Türkçe (tr_TR), o painel, os estados da migração, os erros de validação e a tela de licença carregam em turco automaticamente.

A tela de Plugins mostra a descrição traduzida.
Configurações abre diretamente a aba de configurações do MevvCode.
Documentação abre esta página e Suporte abre a página de contato.
O tratamento de dependências do WordPress impede que o Free seja removido enquanto o MevvCode Pro precisar dele.

Se o painel em turco não carregar, verifique Configurações → Geral → Idioma do site e depois atualize Free e Pro para a mesma versão. Não renomeie arquivos dentro do diretório de idiomas.

O modelo de runtime

Os registros editáveis ficam em wp-content/mevvcode-snippets/records. Salvar uma alteração ativa constrói uma nova geração em um diretório temporário, valida cada arquivo PHP, escreve um manifesto e só então troca o ponteiro atual.

Registros: A origem editável, os metadados, as condições e o histórico.
Geração: Arquivos compilados imutáveis para um estado comprovadamente bom.
Manifesto: O pequeno mapa que o caminho da requisição lê para encontrar a geração atual.

Uma falha de compilação não atualiza o site pela metade. O manifesto antigo continua sendo o atual, a origem que falhou permanece editável e o painel mostra o erro. Não há consulta por requisição para o código dos snippets.

Não edite à mão os arquivos gerados. Eles são saída de build descartável e serão substituídos pela próxima compilação bem-sucedida.

Tipos, locais e condições

O PHP roda através dos hooks do WordPress. JavaScript, CSS, HTML e texto são impressos apenas no local explícito que você selecionar: head, abertura do body, rodapé, antes ou depois do conteúdo, shortcode, manual ou uma única vez.

Dentro de um grupo de condições aplica-se E; os grupos são unidos com OU.
É possível combinar contexto de administração, front-end, URL, usuário, função e requisição.
Tags e grupos organizam os registros; um bloqueio evita edições acidentais e ações em massa.
Um snippet manual nunca entra em um hook de requisição até que o seu próprio código o chame.

Use o local e a condição mais restritos que descrevam o requisito. Um hook PHP global deve ser uma escolha deliberada, não o lar padrão de código copiado de um chamado de suporte.

Migrando do Code Snippets

Abra MevvCode → Migração. O importador lê a tabela de snippets com o prefixo do site, preserva cada id de origem e os bytes exatos do código, e cria registros do MevvCode preparados sem mudar qual plugin está ativo.

Execute a detecção e verifique a contagem de registros.
Importe para o conjunto preparado e inativo.
Analise cada snippet que esteja ativo no Code Snippets.
Crie um instantâneo de reversão da lista de plugins ativos e do manifesto atual do MevvCode.
Compile uma geração completa.
Inicie a transição. O Code Snippets só é desligado depois que o manifesto existe.
Uma requisição de loopback assinada verifica o site público. Sucesso confirma; falha restaura a lista de plugins e o manifesto automaticamente.

As tabelas de origem não são apagadas. A reversão manual continua disponível depois de uma transição bem-sucedida e reativa exatamente a lista anterior de plugins ativos. No mevvshop.com, em 1 de setembro de 2026, a transição medida em produção preservou 9 registros e 6 estados ativos e produziu 0 divergências em nome, bytes exatos do código, prioridade e status. Isso é evidência para aquela loja, não um parâmetro universal.

Se um snippet importado falhar na análise, corrija a cópia preparada no MevvCode ou deixe-a inativa. Não desative o Code Snippets à mão antes de a transição relatar uma geração saudável.

Modo seguro e recuperação

É possível entrar no modo seguro com a constante documentada ou com uma URL assinada de curta duração gerada para um administrador. No modo seguro, a execução de snippets para enquanto o painel continua disponível para reparo.

Um erro de análise de PHP nunca se torna a geração atual.
Uma exceção em runtime desativa o registro responsável e deixa os demais snippets disponíveis.
A proteção contra erros fatais registra apenas a identidade e o estado do registro necessários para a recuperação — nunca o código-fonte nem os segredos da requisição.
A geração anterior comprovadamente boa é mantida até que a substituta passe em todas as verificações.

define( 'MEVVCODE_SAFE_MODE', true );

Remova a constante depois que o registro quebrado for corrigido ou desativado. Deixá-la no lugar mantém, de propósito, todos os snippets desligados.

Portabilidade e backups

Exporte os registros selecionados como MevvCode JSON v1 para uma ida e volta sem perdas, ou como PHP legível quando o destino não deva depender do MevvCode. As importações do Code Snippets e do WPCode são adaptadores para esse mesmo formato canônico de registro.

Uma exportação em JSON inclui metadados, condições e status.
Uma exportação em PHP é feita para revisão e propriedade manual, não para reimportar metadados ocultos.
O carregador must-use pode carregar o comportamento compilado quando o plugin normal precisar ser removido.
O Pro pode empacotar snippets selecionados como um ZIP de plugin de funcionalidades convencional depois de validar nomes, caminhos e PHP.

Guarde uma cópia das exportações fora do servidor antes de uma importação grande, uma ativação em massa ou uma migração. As revisões são um histórico de edição, não um backup de recuperação de desastres.

Free e Pro

O Free é o gerenciador local seguro de snippets, completo. Ele inclui os cinco tipos, o runtime atômico, os locais e as condições básicas, a proteção contra erros fatais, o modo seguro, a migração do Code Snippets, a importação/exportação, os geradores, as revisões, as capacidades por função, o REST somente leitura e o carregador must-use.

O Pro é a camada de colaboração e entrega. Ele acrescenta condições reutilizáveis e agendadas; contexto de dispositivo, referenciador, geografia, carrinho e pedido; histórico de auditoria ilimitado; builds de CSS/JS e ativos externos; eventos de pixel de e-commerce; automação assinada; exportação como plugin; insights agregados locais; espaços de trabalho na nuvem criptografados; revisão por IA opcional; e uma API compatível com REST/MCP controlada por ações.

A nuvem e a IA são ativações separadas. A IA recebe a cópia com dados ocultados e devolve um diff de revisão; ela nunca aplica o diff automaticamente. As gravações na nuvem usam um HMAC assinado com a chave de licença, e as revisões otimistas rejeitam atualizações desatualizadas.

Encontrar e ativar uma licença Pro

Uma licença adquirida fica associada ao e-mail do checkout e aparece em mevvsoft.com/account. A chave começa com MEVD; nunca a cole em um chamado de suporte, URL ou log público.

Instale e ative o pacote gratuito do MevvCode.
Instale e ative o pacote correspondente do MevvCode Pro.
Entre na conta criada para o e-mail do checkout e copie a chave do MevvCode Pro.
Abra MevvCode → Licença, cole a chave MEVD e ative-a.
Confirme que o status está ativo e que o site aparece vinculado à licença na sua conta.

Se a licença não estiver na conta, confirme primeiro que você entrou com o mesmo e-mail usado no checkout. Se ela estiver lá mas a ativação informar um limite de sites, libere um site antigo pela conta ou entre em contato com o suporte sem enviar a chave completa.

Perguntas frequentes e solução de problemas

Um snippet foi salvo mas não rodou: Verifique se ele está ativo, se o local corresponde à requisição, se cada grupo de condições pode ser satisfeito e se o modo seguro está desligado.
O plugin antigo continua ativo depois da migração: A transição não foi confirmada. Leia o resultado da migração; uma verificação de análise, de compilação ou de integridade por loopback falhou, e a reversão protegeu o site.
O site entrou em modo seguro: Abra o painel pela URL de recuperação assinada, inspecione o registro desativado mais recentemente, corrija-o ou deixe-o desativado, compile e depois saia do modo seguro.
A nuvem informa um conflito: Outro cliente alterou o espaço de trabalho depois da revisão que você carregou. Compare o registro remoto com o seu registro local e envie de novo usando a nova revisão base.
A revisão por IA está indisponível: Tanto a licença Pro quanto a ativação explícita da IA precisam estar ativas, e o adaptador do serviço precisa estar configurado. Os snippets locais continuam funcionando.

Ao pedir suporte, envie as versões dos plugins, as versões de WordPress/PHP, o UUID do registro e o texto exato do erro. Remova segredos e dados de clientes. Não envie uma chave de licença de produção nem o código-fonte completo, a menos que seja necessário e você o tenha revisado.

Rode código pequeno com uma fronteira de segurança de verdade.