MevvCode Documentation

Waar MevvCode voor is

MevvCode is een thuis voor kleine stukjes sitespecifiek gedrag: een WooCommerce-verzendregel, een afrekenveld, een verificatietag, een kort beheerhulpmiddel, een visuele CSS-correctie of herbruikbare HTML of tekst. Het geeft code een eigenaar, een locatie, voorwaarden, geschiedenis en een bewaakte route naar productie.

Gebruik het wanneer: De wijziging kleiner is dan een volledige plug-in, maar belangrijk genoeg om niet in een themabestand te verdwijnen.
Gebruik het niet wanneer: De vraag een compleet domeinproduct is met een eigen datamodel, eigen schermen en een eigen releasecyclus; bouw dan een gewone plug-in.
Eigenaarschap van de code: Schrijf de code zelf of neem beoordeelde code mee van een ontwikkelaar of bron die u vertrouwt. MevvCode beheert en beschermt code; het maakt een onbekende snippet niet betrouwbaar.

Begin elke overgenomen snippet inactief. Lees haar, verwijder geheimen en sitespecifieke identificatoren en valideer haar daarna vóór activering.

Installatie

Installeer en activeer eerst de gratis plug-in MevvCode. Die vereist WordPress 6.6 of nieuwer en PHP 8.1 of nieuwer. Pro is een aparte begeleidende plug-in en vervangt de gratis runtime nooit.

Upload mevvcode-1.1.0.zip en activeer het.
Open MevvCode → Snippets. De opslagmap en de beschermingsbestanden voor de webserver worden automatisch aangemaakt.
Maak een inactieve snippet aan, kies het type en de locatie en sla haar op.
Gebruik de voorvertoning en het syntaxisresultaat voordat u haar activeert.
Installeer mevvcode-pro-1.1.0.zip alleen als u de Pro-schermen nodig hebt en activeer daarna uw MEVD-licentie onder MevvCode → Licentie.

Houd de gratis plug-in actief wanneer Pro is geïnstalleerd. De uitvoerbare runtime hoort bij Free, zodat een verlopen licentie nooit al gepubliceerd gedrag laat verdwijnen.

Uw eerste snippet

Maak het eerste record inactief aan. Geef het een naam die het doel benoemt en kies PHP en de globale locatie alleen als de code zelf aan een nauw omschreven WordPress- of WooCommerce-hook hangt; sla daarna op.

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

Lees het validatieresultaat; een parseerfout moet het record inactief laten.
Controleer of uw winkel al een verzendmethode met gratis verzending heeft ingesteld.
Activeer de snippet in staging en test winkelwagens onder en boven de drempel.
Exporteer een JSON-kopie voordat u het record naar productie brengt.
Publiceer en controleer daarna de openbare winkelwagen en het MevvCode-health-endpoint.

Het voorbeeld toont de werkwijze, geen universeel verzendbeleid. Belastingen, kortingsbonnen, valuta’s en verzendzones kunnen bepalen welk subtotaal uw bedrijfsregel zou moeten gebruiken.

Turks dashboard en plug-inregel

Free en Pro 1.1.0 leveren bewerkbare PO-, gecompileerde MO- en POT-catalogi mee. Wanneer de sitetaal van WordPress Türkçe (tr_TR) is, laden het dashboard, de migratiestatussen, de validatiefouten en het licentiescherm automatisch in het Turks.

Het plug-inscherm toont de vertaalde beschrijving.
Instellingen opent rechtstreeks het instellingentabblad van MevvCode.
Documentatie opent deze pagina en Ondersteuning opent de contactpagina.
De afhankelijkheidsafhandeling van WordPress voorkomt dat Free wordt verwijderd zolang MevvCode Pro het nodig heeft.

Laadt het Turkse dashboard niet, controleer dan Instellingen → Algemeen → Sitetaal en werk daarna Free en Pro bij naar dezelfde versie. Hernoem geen bestanden in de talenmap.

Het runtimemodel

Bewerkbare records staan onder wp-content/mevvcode-snippets/records. Bij het opslaan van een actieve wijziging wordt in een tijdelijke map een nieuwe generatie gebouwd, wordt elk PHP-bestand gevalideerd, wordt een manifest geschreven en pas daarna wordt de huidige verwijzing omgezet.

Records: De bewerkbare bron, metagegevens, voorwaarden en geschiedenis.
Generatie: Onveranderlijke gecompileerde bestanden voor één werkend bevonden toestand.
Manifest: De kleine kaart die het verzoekpad leest om de huidige generatie te vinden.

Een mislukte compilatie werkt de site niet gedeeltelijk bij. Het oude manifest blijft actueel, de mislukte bron blijft bewerkbaar en het dashboard toont de fout. Er is geen query per verzoek voor snippetcode.

Bewerk gegenereerde bestanden niet met de hand. Het is wegwerpbare build-uitvoer die bij de volgende geslaagde compilatie wordt vervangen.

Typen, locaties en voorwaarden

PHP loopt via WordPress-hooks. JavaScript, CSS, HTML en tekst worden alleen afgedrukt op de locatie die u uitdrukkelijk kiest: head, body-open, voettekst, vóór of na de inhoud, shortcode, handmatig of eenmalig.

Binnen één voorwaardengroep geldt EN; groepen worden met OF verbonden.
Context van beheer, voorkant, URL, gebruiker, rol en verzoek kan worden gecombineerd.
Tags en groepen ordenen records; een vergrendeling voorkomt onbedoelde bewerkingen en bulkacties.
Een handmatige snippet haakt pas aan een verzoek-hook zodra uw eigen code haar aanroept.

Gebruik de smalste locatie en voorwaarde die de vraag beschrijven. Een globale PHP-hook hoort een bewuste keuze te zijn, niet de standaardplek voor code uit een supportticket.

Migreren vanaf Code Snippets

Open MevvCode → Migratie. De importfunctie leest de snippettabel met het siteprefix, behoudt elke bron-id en de exacte codebytes en maakt klaargezette MevvCode-records aan zonder te wijzigen welke plug-in actief is.

Voer de detectie uit en bekijk het aantal records.
Importeer in de klaargezette, inactieve set.
Parseer elke snippet die in Code Snippets actief is.
Maak een terugdraaimomentopname van de lijst met actieve plug-ins en het huidige MevvCode-manifest.
Compileer één volledige generatie.
Start de overschakeling. Code Snippets wordt pas uitgeschakeld nadat het manifest bestaat.
Een ondertekend loopbackverzoek controleert de openbare site. Slaagt het, dan wordt het vastgelegd; mislukt het, dan worden de plug-inlijst en het manifest automatisch hersteld.

De brontabellen worden niet verwijderd. Handmatig terugdraaien blijft ook na een geslaagde overschakeling beschikbaar en zet exact de vorige lijst met actieve plug-ins weer aan. Op mevvshop.com heeft de gemeten productieoverschakeling op 1 september 2026 9 records en 6 actieve statussen behouden en 0 afwijkingen opgeleverd op naam, exacte codebytes, prioriteit en status. Dat is bewijs voor die winkel, geen universele maatstaf.

Komt een geïmporteerde snippet niet door de parsering, herstel dan de klaargezette MevvCode-kopie of laat haar inactief. Schakel Code Snippets niet met de hand uit voordat de overschakeling een gezonde generatie meldt.

Veilige modus en herstel

De veilige modus kan worden ingeschakeld met de gedocumenteerde constante of met een kortlevende ondertekende URL die voor een beheerder wordt gegenereerd. In de veilige modus stopt de uitvoering van snippets, terwijl het dashboard beschikbaar blijft om te repareren.

Een PHP-parseerfout wordt nooit de huidige generatie.
Een runtime-uitzondering schakelt het verantwoordelijke record uit en laat de overige snippets beschikbaar.
De bescherming tegen fatale fouten legt alleen de identiteit en status van het record vast die nodig zijn voor herstel — nooit de broncode of geheimen uit het verzoek.
De vorige, werkend bevonden generatie blijft behouden tot de vervanger alle controles doorstaat.

define( 'MEVVCODE_SAFE_MODE', true );

Verwijder de constante nadat het defecte record is hersteld of uitgeschakeld. Haar bewust laten staan houdt alle snippets uit.

Overdraagbaarheid en back-ups

Exporteer geselecteerde records als MevvCode JSON v1 voor een verliesvrije heen-en-terugweg, of als leesbare PHP wanneer de bestemming niet van MevvCode afhankelijk mag zijn. Imports uit Code Snippets en WPCode zijn adapters naar hetzelfde canonieke recordformaat.

Een JSON-export bevat metagegevens, voorwaarden en status.
Een PHP-export is bedoeld voor beoordeling en handmatig eigenaarschap, niet om verborgen metagegevens opnieuw te importeren.
De must-use-loader kan gecompileerd gedrag blijven dragen wanneer de gewone plug-in verwijderd moet worden.
Pro kan geselecteerde snippets als een gewone functionaliteitsplug-in-ZIP verpakken nadat namen, paden en PHP zijn gevalideerd.

Bewaar een kopie van de exports buiten de site voordat u een grote import, bulkactivering of migratie uitvoert. Revisies zijn een bewerkingsgeschiedenis, geen back-up voor noodgevallen.

Free en Pro

Free is de complete, veilige lokale snippetbeheerder. Die bevat alle vijf typen, de atomaire runtime, locaties en basisvoorwaarden, de bescherming tegen fatale fouten, de veilige modus, de migratie vanaf Code Snippets, import/export, generatoren, revisies, rolrechten, alleen-lezen REST en de must-use-loader.

Pro is de laag voor samenwerking en uitlevering. Die voegt herbruikbare en geplande voorwaarden toe; context voor apparaat, referrer, geo, winkelwagen en bestelling; onbeperkte auditgeschiedenis; CSS-/JS-builds en externe assets; e-commerce-pixelgebeurtenissen; ondertekende automatisering; plug-inexport; lokale geaggregeerde inzichten; versleutelde cloudwerkruimtes; AI-review op basis van opt-in; en een REST-/MCP-compatibele API met actiepoort.

Cloud en AI zijn afzonderlijke opt-ins. De AI krijgt de geredigeerde kopie en levert een reviewdiff terug; die diff wordt nooit automatisch toegepast. Schrijfacties naar de cloud gebruiken een HMAC die met de licentiesleutel is ondertekend, en optimistische revisies wijzen verouderde updates af.

Een Pro-licentie vinden en activeren

Een gekochte licentie is gekoppeld aan het e-mailadres van de bestelling en verschijnt op mevvsoft.com/account. De sleutel begint met MEVD; plak hem nooit in een supportticket, een URL of een openbaar logboek.

Installeer en activeer het gratis MevvCode-pakket.
Installeer en activeer het bijbehorende MevvCode Pro-pakket.
Meld u aan met het account dat is aangemaakt voor het e-mailadres van de bestelling en kopieer de MevvCode Pro-sleutel.
Open MevvCode → Licentie, plak de MEVD-sleutel en activeer die.
Controleer of de status actief is en of de site bij de licentie in uw account verschijnt.

Ontbreekt de licentie in het account, controleer dan eerst of u zich hebt aangemeld met hetzelfde e-mailadres als bij de bestelling. Staat ze er wel, maar meldt de activering een sitelimiet, geef dan in het account een oude site vrij of neem contact op met de ondersteuning zonder de volledige sleutel mee te sturen.

Veelgestelde vragen en probleemoplossing

Een snippet is opgeslagen maar liep niet: Controleer of ze actief is, of haar locatie bij het verzoek past, of elke voorwaardengroep vervuld kan worden en of de veilige modus uit staat.
De oude plug-in is na de migratie nog steeds actief: De overschakeling is niet vastgelegd. Lees het migratieresultaat; een parseer-, compilatie- of loopbackgezondheidscontrole is mislukt en het terugdraaien heeft de site beschermd.
De site is in de veilige modus gegaan: Open het dashboard via de ondertekende herstel-URL, bekijk het meest recent uitgeschakelde record, herstel het of laat het uitgeschakeld, compileer en verlaat daarna de veilige modus.
De cloud meldt een conflict: Een andere client heeft de werkruimte gewijzigd na de revisie die u had geladen. Vergelijk het externe record met uw lokale record en verstuur het opnieuw op basis van de nieuwe basisrevisie.
AI-review is niet beschikbaar: Zowel de Pro-licentie als de uitdrukkelijke AI-opt-in moeten actief zijn en de serviceadapter moet zijn ingesteld. Lokale snippets blijven werken.

Stuur bij een vraag aan de ondersteuning de plug-inversies, de WordPress-/PHP-versies, de record-UUID en de exacte fouttekst mee. Verwijder geheimen en klantgegevens. Stuur geen productielicentiesleutel en niet de volledige broncode, tenzij dat nodig is en u die hebt nagekeken.

Kleine stukjes code draaien met een echte veiligheidsgrens.