MevvCode Documentation

Wofür MevvCode da ist

MevvCode ist ein Zuhause für kleine Teile seitenspezifischen Verhaltens: eine WooCommerce-Versandregel, ein Kassenfeld, ein Verifizierungs-Tag, ein kurzes Admin-Werkzeug, eine visuelle CSS-Korrektur oder wiederverwendbares HTML bzw. Text. Es gibt dem Code einen Verantwortlichen, einen Ausführungsort, Bedingungen, eine Historie und einen abgesicherten Weg in die Produktion.

Setzen Sie es ein, wenn: Die Änderung ist kleiner als ein vollständiges Plugin, aber wichtig genug, dass sie nicht in einer Theme-Datei verschwinden sollte.
Setzen Sie es nicht ein, wenn: Die Anforderung ist ein vollständiges Fachprodukt mit eigenem Datenmodell, eigenen Bildschirmen und eigenem Release-Zyklus; bauen Sie dann ein herkömmliches Plugin.
Verantwortung für den Code: Schreiben Sie den Code selbst oder bringen Sie geprüften Code von einem Entwickler oder einer Quelle mit, dem oder der Sie vertrauen. MevvCode verwaltet und schützt Code; es macht ein unbekanntes Snippet nicht vertrauenswürdig.

Beginnen Sie jedes übernommene Snippet inaktiv. Lesen Sie es, entfernen Sie Geheimnisse und seitenspezifische Kennungen und validieren Sie es dann vor der Aktivierung.

Installation

Installieren und aktivieren Sie zuerst das kostenlose Plugin MevvCode. Es setzt WordPress 6.6 oder neuer und PHP 8.1 oder neuer voraus. Pro ist ein separates Begleit-Plugin und ersetzt niemals die kostenlose Laufzeitumgebung.

Laden Sie mevvcode-1.1.0.zip hoch und aktivieren Sie es.
Öffnen Sie MevvCode → Snippets. Das Speicherverzeichnis und seine Schutzdateien für den Webserver werden automatisch angelegt.
Legen Sie ein inaktives Snippet an, wählen Sie Typ und Ausführungsort und speichern Sie es.
Nutzen Sie die Vorschau und das Syntaxergebnis, bevor Sie es aktivieren.
Installieren Sie mevvcode-pro-1.1.0.zip nur, wenn Sie die Pro-Oberflächen benötigen, und aktivieren Sie dann Ihre MEVD-Lizenz unter MevvCode → Lizenz.

Lassen Sie das kostenlose Plugin aktiv, wenn Pro installiert ist. Die ausführbare Laufzeitumgebung gehört zu Free, damit eine abgelaufene Lizenz niemals bereits veröffentlichtes Verhalten verschwinden lässt.

Ihr erstes Snippet

Legen Sie den ersten Datensatz inaktiv an. Geben Sie ihm einen zweckbezogenen Namen und wählen Sie PHP und den globalen Ausführungsort nur dann, wenn der Code selbst an einem eng gefassten WordPress- oder WooCommerce-Hook hängt; speichern Sie danach.

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

Lesen Sie das Validierungsergebnis; ein Parse-Fehler muss den Datensatz inaktiv lassen.
Vergewissern Sie sich, dass in Ihrem Shop bereits eine Versandart für kostenlosen Versand eingerichtet ist.
Aktivieren Sie das Snippet in der Staging-Umgebung und testen Sie Warenkörbe unter und über dem Schwellenwert.
Exportieren Sie eine JSON-Kopie, bevor Sie den Datensatz in die Produktion übertragen.
Veröffentlichen Sie und prüfen Sie danach den öffentlichen Warenkorb und den MevvCode-Health-Endpunkt.

Das Beispiel zeigt den Arbeitsablauf, keine allgemeingültige Versandrichtlinie. Steuern, Gutscheine, Währungen und Versandzonen können ändern, welche Zwischensumme Ihre Geschäftsregel verwenden sollte.

Türkisches Dashboard und Plugin-Zeile

Free und Pro 1.1.0 liefern bearbeitbare PO-, kompilierte MO- und POT-Kataloge mit. Wenn die Sprache der WordPress-Website Türkçe (tr_TR) ist, laden Dashboard, Migrationszustände, Validierungsfehler und Lizenzbildschirm automatisch auf Türkisch.

Der Plugin-Bildschirm zeigt die übersetzte Beschreibung.
Einstellungen öffnet direkt den Einstellungsreiter von MevvCode.
Dokumentation öffnet diese Seite und Support die Kontaktseite.
Die Abhängigkeitsverwaltung von WordPress verhindert, dass Free entfernt wird, solange MevvCode Pro es benötigt.

Wenn das türkische Dashboard nicht lädt, prüfen Sie Einstellungen → Allgemein → Sprache der Website und bringen Sie danach Free und Pro auf dieselbe Version. Benennen Sie keine Dateien im Sprachverzeichnis um.

Das Laufzeitmodell

Bearbeitbare Datensätze liegen unter wp-content/mevvcode-snippets/records. Beim Speichern einer aktiven Änderung wird in einem temporären Verzeichnis eine neue Generation gebaut, jede PHP-Datei validiert, ein Manifest geschrieben — und erst dann der aktuelle Zeiger umgeschaltet.

Datensätze: Die bearbeitbare Quelle, Metadaten, Bedingungen und Historie.
Generation: Unveränderliche kompilierte Dateien für einen bekannten guten Zustand.
Manifest: Die kleine Karte, die der Anfrageweg liest, um die aktuelle Generation zu finden.

Ein fehlgeschlagener Kompiliervorgang aktualisiert die Website nicht teilweise. Das alte Manifest bleibt aktuell, die fehlgeschlagene Quelle bleibt bearbeitbar und das Dashboard zeigt den Fehler. Es gibt keine Abfrage des Snippet-Codes je Anfrage.

Bearbeiten Sie generierte Dateien nicht von Hand. Sie sind wegwerfbare Build-Ausgabe und werden beim nächsten erfolgreichen Kompiliervorgang ersetzt.

Typen, Ausführungsorte und Bedingungen

PHP läuft über WordPress-Hooks. JavaScript, CSS, HTML und Text werden nur an dem ausdrücklich gewählten Ausführungsort ausgegeben: head, body-open, Fußzeile, vor oder nach dem Inhalt, Shortcode, manuell oder einmalig.

Innerhalb einer Bedingungsgruppe gilt UND; Gruppen werden mit ODER verknüpft.
Admin-, Frontend-, URL-, Benutzer-, Rollen- und Anfragekontext lassen sich kombinieren.
Tags und Gruppen ordnen Datensätze; eine Sperre verhindert versehentliche Bearbeitungen und Massenaktionen.
Ein manuelles Snippet hängt sich erst dann an einen Anfrage-Hook, wenn Ihr eigener Code es aufruft.

Verwenden Sie den engsten Ausführungsort und die engste Bedingung, die die Anforderung beschreiben. Ein globaler PHP-Hook sollte eine bewusste Entscheidung sein und nicht der Standardplatz für Code aus einem Support-Ticket.

Migration von Code Snippets

Öffnen Sie MevvCode → Migration. Der Importer liest die Snippets-Tabelle mit dem Website-Präfix, bewahrt jede Quell-ID und die exakten Code-Bytes und legt bereitgestellte MevvCode-Datensätze an, ohne zu ändern, welches Plugin aktiv ist.

Führen Sie die Erkennung aus und prüfen Sie die Anzahl der Datensätze.
Importieren Sie in den bereitgestellten, inaktiven Satz.
Parsen Sie jedes Snippet, das in Code Snippets aktiv ist.
Legen Sie einen Rollback-Snapshot der Liste aktiver Plugins und des aktuellen MevvCode-Manifests an.
Kompilieren Sie eine vollständige Generation.
Starten Sie die Umschaltung. Code Snippets wird erst abgeschaltet, nachdem das Manifest existiert.
Eine signierte Loopback-Anfrage prüft die öffentliche Website. Bei Erfolg wird übernommen; bei einem Fehler werden Plugin-Liste und Manifest automatisch wiederhergestellt.

Die Quelltabellen werden nicht gelöscht. Ein manuelles Rollback bleibt auch nach einer erfolgreichen Umschaltung verfügbar und reaktiviert exakt die frühere Liste aktiver Plugins. Auf mevvshop.com hat die gemessene Produktionsumschaltung am 1. September 2026 9 Datensätze und 6 Aktivzustände erhalten und 0 Abweichungen bei Name, exakten Code-Bytes, Priorität und Status erzeugt. Das ist ein Nachweis für diesen Shop, kein allgemeiner Richtwert.

Wenn ein importiertes Snippet die Prüfung nicht besteht, korrigieren Sie die bereitgestellte MevvCode-Kopie oder lassen Sie sie inaktiv. Deaktivieren Sie Code Snippets nicht von Hand, bevor die Umschaltung eine gesunde Generation meldet.

Sicherer Modus und Wiederherstellung

Der sichere Modus lässt sich mit der dokumentierten Konstante oder über eine kurzlebige signierte URL aktivieren, die für einen Administrator erzeugt wird. Im sicheren Modus wird die Ausführung von Snippets gestoppt, während das Dashboard für Reparaturen erreichbar bleibt.

Ein PHP-Parse-Fehler wird niemals zur aktuellen Generation.
Eine Laufzeit-Ausnahme deaktiviert den verantwortlichen Datensatz und lässt die übrigen Snippets verfügbar.
Der Schutz vor schweren Fehlern hält nur Identität und Zustand des Datensatzes fest, die zur Wiederherstellung nötig sind — niemals den Quellcode oder Anfragegeheimnisse.
Die vorherige, als funktionierend bekannte Generation bleibt erhalten, bis der Ersatz alle Prüfungen besteht.

define( 'MEVVCODE_SAFE_MODE', true );

Entfernen Sie die Konstante, nachdem der fehlerhafte Datensatz korrigiert oder deaktiviert wurde. Sie bewusst stehen zu lassen, hält alle Snippets ausgeschaltet.

Portabilität und Sicherungen

Exportieren Sie ausgewählte Datensätze als MevvCode JSON v1 für einen verlustfreien Rundlauf oder als lesbares PHP, wenn das Ziel nicht von MevvCode abhängen soll. Importe aus Code Snippets und WPCode sind Adapter in dasselbe kanonische Datensatzformat.

Ein JSON-Export enthält Metadaten, Bedingungen und Status.
Ein PHP-Export ist für die Prüfung und die manuelle Übernahme der Verantwortung gedacht, nicht für den Reimport verborgener Metadaten.
Der Must-Use-Loader kann kompiliertes Verhalten weitertragen, wenn das normale Plugin entfernt werden muss.
Pro kann ausgewählte Snippets als herkömmliches Funktions-Plugin-ZIP verpacken, nachdem Namen, Pfade und PHP validiert wurden.

Bewahren Sie vor einem großen Import, einer Massenaktivierung oder einer Migration eine Kopie der Exporte außerhalb der Website auf. Revisionen sind ein Bearbeitungsverlauf, keine Notfallsicherung.

Free und Pro

Free ist der vollständige, sichere lokale Snippet-Manager. Er enthält alle fünf Typen, die atomare Laufzeitumgebung, Ausführungsorte und Basisbedingungen, den Schutz vor schweren Fehlern, den sicheren Modus, die Migration von Code Snippets, Import/Export, Generatoren, Revisionen, Rollenrechte, schreibgeschützte REST und den Must-Use-Loader.

Pro ist die Ebene für Zusammenarbeit und Auslieferung. Sie ergänzt wiederverwendbare und zeitgesteuerte Bedingungen; Kontext für Gerät, Referrer, Geo, Warenkorb und Bestellung; unbegrenzte Audit-Historie; CSS-/JS-Builds und externe Assets; E-Commerce-Pixel-Ereignisse; signierte Automatisierung; Plugin-Export; lokale aggregierte Auswertungen; verschlüsselte Cloud-Arbeitsbereiche; optionale KI-Prüfung; und eine aktionsgeschützte REST-/MCP-kompatible API.

Cloud und KI sind getrennte Opt-ins. Die KI erhält die geschwärzte Kopie und liefert einen Prüf-Diff zurück; sie wendet den Diff niemals automatisch an. Cloud-Schreibvorgänge nutzen einen mit dem Lizenzschlüssel signierten HMAC, und optimistische Revisionen weisen veraltete Aktualisierungen ab.

Eine Pro-Lizenz finden und aktivieren

Eine gekaufte Lizenz ist mit der E-Mail-Adresse aus dem Kauf verknüpft und erscheint unter mevvsoft.com/account. Der Schlüssel beginnt mit MEVD; fügen Sie ihn niemals in ein Support-Ticket, eine URL oder ein öffentliches Protokoll ein.

Installieren und aktivieren Sie das kostenlose MevvCode-Paket.
Installieren und aktivieren Sie das passende MevvCode-Pro-Paket.
Melden Sie sich mit dem Konto an, das für die E-Mail-Adresse aus dem Kauf angelegt wurde, und kopieren Sie den MevvCode-Pro-Schlüssel.
Öffnen Sie MevvCode → Lizenz, fügen Sie den MEVD-Schlüssel ein und aktivieren Sie ihn.
Prüfen Sie, dass der Status aktiv ist und die Website in Ihrem Konto bei der Lizenz erscheint.

Fehlt die Lizenz im Konto, prüfen Sie zuerst, ob Sie sich mit derselben E-Mail-Adresse angemeldet haben, die Sie beim Kauf verwendet haben. Ist sie vorhanden, meldet die Aktivierung aber ein Website-Limit, geben Sie im Konto eine alte Website frei oder wenden Sie sich an den Support, ohne den vollständigen Schlüssel zu senden.

FAQ und Fehlerbehebung

Ein Snippet wurde gespeichert, lief aber nicht: Prüfen Sie, ob es aktiv ist, ob sein Ausführungsort zur Anfrage passt, ob jede Bedingungsgruppe erfüllbar ist und ob der sichere Modus aus ist.
Das alte Plugin ist nach der Migration weiterhin aktiv: Die Umschaltung wurde nicht übernommen. Lesen Sie das Migrationsergebnis; eine Parse-, Kompilier- oder Loopback-Zustandsprüfung ist fehlgeschlagen und das Rollback hat die Website geschützt.
Die Website ist in den sicheren Modus gewechselt: Öffnen Sie das Dashboard über die signierte Wiederherstellungs-URL, prüfen Sie den zuletzt deaktivierten Datensatz, korrigieren Sie ihn oder lassen Sie ihn deaktiviert, kompilieren Sie und verlassen Sie dann den sicheren Modus.
Die Cloud meldet einen Konflikt: Ein anderer Client hat den Arbeitsbereich nach der von Ihnen geladenen Revision geändert. Vergleichen Sie den entfernten Datensatz mit Ihrem lokalen Datensatz und übertragen Sie ihn erneut auf Basis der neuen Revision.
Die KI-Prüfung ist nicht verfügbar: Sowohl die Pro-Lizenz als auch das ausdrückliche KI-Opt-in müssen aktiv sein, und der Dienstadapter muss konfiguriert sein. Lokale Snippets funktionieren weiter.

Nennen Sie bei einer Supportanfrage die Plugin-Versionen, die WordPress-/PHP-Versionen, die UUID des Datensatzes und den exakten Fehlertext. Entfernen Sie Geheimnisse und Kundendaten. Senden Sie keinen produktiven Lizenzschlüssel und nicht den vollständigen Quellcode, sofern das nicht nötig ist und Sie ihn geprüft haben.

Kleinen Code mit einer echten Sicherheitsgrenze ausführen.