MevvCode Documentation

Para qué sirve MevvCode

MevvCode es un hogar para pequeñas piezas de comportamiento propio del sitio: una regla de envío de WooCommerce, un campo del proceso de pago, una etiqueta de verificación, una pequeña herramienta de administración, un arreglo visual en CSS o HTML/texto reutilizable. Le da al código un propietario, una ubicación, condiciones, historial y una ruta protegida hacia producción.

Úselo cuando: El cambio es más pequeño que un plugin completo, pero lo bastante importante como para que no deba desaparecer dentro de un archivo del tema.
No lo use cuando: El requisito es un producto de dominio completo, con su propio modelo de datos, sus pantallas y su ciclo de vida de versiones; en ese caso, construya un plugin convencional.
Propiedad del código: Escriba el código usted mismo o traiga código revisado de un desarrollador o de una fuente de confianza. MevvCode gestiona y protege el código; no convierte en fiable un snippet desconocido.

Empiece cada snippet prestado en estado inactivo. Léalo, elimine los secretos y los identificadores propios del sitio, y valídelo antes de activarlo.

Instalación

Instale y active primero el plugin gratuito MevvCode. Requiere WordPress 6.6 o posterior y PHP 8.1 o posterior. Pro es un plugin complementario aparte y nunca sustituye el runtime gratuito.

Suba mevvcode-1.1.0.zip y actívelo.
Abra MevvCode → Fragmentos de código. El directorio de almacenamiento y sus archivos de protección del servidor web se crean automáticamente.
Cree un snippet inactivo, elija su tipo y su ubicación, y guárdelo.
Use la vista previa y el resultado de sintaxis antes de activarlo.
Instale mevvcode-pro-1.1.0.zip solo si necesita las pantallas de Pro y active después su licencia MEVD en MevvCode → Licencia.

Mantenga activo el plugin gratuito cuando Pro esté instalado. El runtime ejecutable pertenece a Free, de modo que una licencia caducada nunca hace desaparecer un comportamiento ya publicado.

Su primer snippet

Cree el primer registro inactivo. Póngale un nombre que describa su propósito, seleccione PHP y la ubicación global solo si el propio código se engancha a un hook concreto de WordPress o WooCommerce, y guarde.

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;
    } );
} );

Lea el resultado de la validación; un error de análisis debe dejar el registro inactivo.
Confirme que su tienda ya tiene configurado un método de envío gratuito.
Active el snippet en un entorno de pruebas y pruebe carritos por debajo y por encima del umbral.
Exporte una copia en JSON antes de llevar el registro a producción.
Publique y verifique después el carrito público y el endpoint de salud de MevvCode.

El ejemplo demuestra el flujo de trabajo, no una política de envíos universal. Los impuestos, los cupones, las monedas y las zonas de envío pueden cambiar qué subtotal debería usar su regla de negocio.

Panel en turco y fila del plugin

Free y Pro 1.1.0 incluyen catálogos PO editables, MO compilados y POT. Cuando el idioma del sitio WordPress es Türkçe (tr_TR), el panel, los estados de la migración, los errores de validación y la pantalla de licencia se cargan en turco automáticamente.

La pantalla de Plugins muestra la descripción traducida.
Ajustes abre directamente la pestaña de ajustes de MevvCode.
Documentación abre esta página y Soporte abre la página de contacto.
La gestión de dependencias de WordPress impide eliminar Free mientras MevvCode Pro lo necesite.

Si el panel en turco no se carga, revise Ajustes → Generales → Idioma del sitio y actualice después Free y Pro a la misma versión. No cambie el nombre de los archivos del directorio de idiomas.

El modelo de ejecución

Los registros editables viven en wp-content/mevvcode-snippets/records. Al guardar un cambio activo se construye una nueva generación en un directorio temporal, se valida cada archivo PHP, se escribe un manifiesto y solo entonces se cambia el puntero actual.

Registros: El origen editable, los metadatos, las condiciones y el historial.
Generación: Archivos compilados inmutables para un estado que se sabe correcto.
Manifiesto: El pequeño mapa que lee la ruta de la petición para encontrar la generación actual.

Un fallo de compilación no actualiza el sitio a medias. El manifiesto antiguo sigue siendo el actual, el origen fallido permanece editable y el panel muestra el error. No hay ninguna consulta por petición para el código de los snippets.

No edite a mano los archivos generados. Son salida de compilación desechable y serán reemplazados por la siguiente compilación correcta.

Tipos, ubicaciones y condiciones

PHP se ejecuta a través de los hooks de WordPress. JavaScript, CSS, HTML y texto se imprimen solo en la ubicación explícita que usted seleccione: head, apertura del body, pie, antes o después del contenido, shortcode, manual o una sola vez.

Dentro de un grupo de condiciones se aplica Y; los grupos se unen con O.
Se pueden combinar el contexto de administración, del front-end, de URL, de usuario, de rol y de la petición.
Las etiquetas y los grupos organizan los registros; un bloqueo evita ediciones accidentales y acciones en lote.
Un snippet manual nunca se engancha a una petición hasta que su propio código lo llama.

Use la ubicación y la condición más estrechas que describan el requisito. Un hook PHP global debería ser una decisión deliberada, no el hogar por defecto de código copiado de un ticket de soporte.

Migrar desde Code Snippets

Abra MevvCode → Migración. El importador lee la tabla de snippets con el prefijo del sitio, conserva cada id de origen y los bytes exactos del código, y crea registros de MevvCode preparados sin cambiar qué plugin está activo.

Ejecute la detección y revise el número de registros.
Importe al conjunto preparado e inactivo.
Analice cada snippet que esté activo en Code Snippets.
Cree una instantánea de reversión de la lista de plugins activos y del manifiesto actual de MevvCode.
Compile una generación completa.
Inicie la conmutación. Code Snippets se apaga solo después de que exista el manifiesto.
Una petición de bucle firmada comprueba el sitio público. Si tiene éxito, se confirma; si falla, la lista de plugins y el manifiesto se restauran automáticamente.

Las tablas de origen no se borran. La reversión manual sigue disponible después de una conmutación correcta y vuelve a habilitar exactamente la lista anterior de plugins activos. En mevvshop.com, el 1 de septiembre de 2026, la conmutación de producción medida conservó 9 registros y 6 estados activos, y produjo 0 discrepancias en nombre, bytes exactos del código, prioridad y estado. Eso es evidencia para esa tienda, no una referencia universal.

Si un snippet importado no supera el análisis, corrija la copia preparada en MevvCode o déjela inactiva. No desactive Code Snippets a mano antes de que la conmutación informe de una generación sana.

Modo seguro y recuperación

Se puede entrar en modo seguro con la constante documentada o con una URL firmada de corta duración generada para un administrador. En modo seguro la ejecución de snippets se detiene mientras el panel sigue disponible para reparar.

Un error de análisis de PHP nunca se convierte en la generación actual.
Una excepción en tiempo de ejecución desactiva el registro responsable y deja disponibles los demás snippets.
La guardia ante errores fatales registra solo la identidad y el estado del registro necesarios para la recuperación — nunca el código fuente ni los secretos de la petición.
La generación anterior que se sabe correcta se conserva hasta que la sustituta supera todas las comprobaciones.

define( 'MEVVCODE_SAFE_MODE', true );

Elimine la constante después de haber arreglado o desactivado el registro roto. Dejarla puesta mantiene, a propósito, todos los snippets apagados.

Portabilidad y copias de seguridad

Exporte los registros seleccionados como MevvCode JSON v1 para un viaje de ida y vuelta sin pérdidas, o como PHP legible cuando el destino no deba depender de MevvCode. Las importaciones de Code Snippets y WPCode son adaptadores hacia ese mismo formato de registro canónico.

Una exportación en JSON incluye metadatos, condiciones y estado.
Una exportación en PHP está pensada para la revisión y la propiedad manual, no para reimportar metadatos ocultos.
El cargador must-use puede llevar el comportamiento compilado cuando haya que eliminar el plugin normal.
Pro puede empaquetar los snippets seleccionados como un ZIP de plugin de funcionalidad convencional tras validar nombres, rutas y PHP.

Guarde una copia de las exportaciones fuera del servidor antes de una importación grande, una activación en lote o una migración. Las revisiones son un historial de edición, no una copia de seguridad para recuperación ante desastres.

Free y Pro

Free es el gestor local seguro de snippets, completo. Incluye los cinco tipos, el runtime atómico, las ubicaciones y las condiciones básicas, la guardia ante errores fatales, el modo seguro, la migración desde Code Snippets, la importación/exportación, los generadores, las revisiones, las capacidades por rol, el REST de solo lectura y el cargador must-use.

Pro es la capa de colaboración y entrega. Añade condiciones reutilizables y programadas; contexto de dispositivo, referente, geografía, carrito y pedido; historial de auditoría ilimitado; compilaciones CSS/JS y recursos externos; eventos de píxel de comercio electrónico; automatización firmada; exportación como plugin; información agregada local; espacios de trabajo en la nube cifrados; revisión por IA opcional; y una API compatible con REST/MCP controlada por acciones.

La nube y la IA se activan por separado. La IA recibe la copia con los secretos ocultos y devuelve un diff de revisión; nunca aplica el diff automáticamente. Las escrituras en la nube usan un HMAC firmado con la clave de licencia, y las revisiones optimistas rechazan las actualizaciones obsoletas.

Encontrar y activar una licencia Pro

Una licencia comprada queda asociada al correo electrónico del pago y aparece en mevvsoft.com/account. La clave empieza por MEVD; no la pegue nunca en un ticket de soporte, una URL o un log público.

Instale y active el paquete gratuito de MevvCode.
Instale y active el paquete de MevvCode Pro correspondiente.
Inicie sesión en la cuenta creada para el correo del pago y copie la clave de MevvCode Pro.
Abra MevvCode → Licencia, pegue la clave MEVD y actívela.
Confirme que el estado es activo y que el sitio aparece asociado a la licencia en su cuenta.

Si la licencia no está en la cuenta, confirme primero que ha iniciado sesión con el mismo correo usado en el pago. Si está pero la activación informa de un límite de sitios, libere un sitio antiguo desde la cuenta o contacte con soporte sin enviar la clave completa.

Preguntas frecuentes y resolución de problemas

Un snippet se guardó pero no se ejecutó: Compruebe que está activo, que su ubicación coincide con la petición, que cada grupo de condiciones se puede satisfacer y que el modo seguro está desactivado.
El plugin antiguo sigue activo después de la migración: La conmutación no se confirmó. Lea el resultado de la migración; falló una comprobación de análisis, de compilación o de salud por bucle, y la reversión protegió el sitio.
El sitio entró en modo seguro: Abra el panel mediante la URL de recuperación firmada, revise el registro desactivado más recientemente, corríjalo o déjelo desactivado, compile y salga después del modo seguro.
La nube informa de un conflicto: Otro cliente cambió el espacio de trabajo después de la revisión que usted cargó. Compare el registro remoto con su registro local y vuelva a enviarlo usando la nueva revisión base.
La revisión por IA no está disponible: Deben estar activas tanto la licencia Pro como la activación explícita de la IA, y el adaptador del servicio tiene que estar configurado. Los snippets locales siguen funcionando.

Cuando pida soporte, envíe las versiones de los plugins, las versiones de WordPress/PHP, el UUID del registro y el texto exacto del error. Elimine los secretos y los datos de clientes. No envíe una clave de licencia de producción ni el código fuente completo salvo que sea necesario y lo haya revisado.

Ejecute código pequeño con un límite de seguridad real.