MevvCode Documentation

Do czego służy MevvCode

Wtyczka MevvCode jest domem dla drobnych zachowań właściwych konkretnej witrynie: reguły wysyłki WooCommerce, pola przy zamówieniu, tagu weryfikacyjnego, krótkiego narzędzia w panelu, wizualnej poprawki CSS albo wielokrotnie używanego kodu HTML lub tekstu. Nadaje kodowi właściciela, miejsce, warunki, historię i strzeżoną drogę na produkcję.

Kiedy jej używać: Zmiana jest mniejsza niż pełna wtyczka, ale na tyle istotna, że nie powinna zniknąć wewnątrz pliku motywu.
Kiedy jej nie używać: Wymaganiem jest kompletny produkt dziedzinowy z własnym modelem danych, ekranami i cyklem wydawniczym; w takim wypadku należy napisać zwykłą wtyczkę.
Własność kodu: Kod napisz sam albo weź sprawdzony kod od programisty lub źródła, któremu ufasz. Wtyczka MevvCode zarządza kodem i chroni go; nie sprawia, że nieznany fragment kodu staje się godny zaufania.

Każdy zapożyczony fragment kodu zaczynaj jako wyłączony. Przeczytaj go, usuń sekrety i identyfikatory właściwe danej witrynie, a dopiero potem sprawdź go przed włączeniem.

Instalacja

Najpierw zainstaluj i włącz darmową wtyczkę MevvCode. Wymaga WordPress 6.6 lub nowszego oraz PHP 8.1 lub nowszego. Pro jest osobną wtyczką towarzyszącą i nigdy nie zastępuje darmowego środowiska wykonawczego.

Wgraj mevvcode-1.1.0.zip i włącz go.
Otwórz MevvCode → Fragmenty kodu. Katalog składowania i pliki chroniące go na serwerze WWW tworzone są automatycznie.
Utwórz wyłączony fragment kodu, wybierz jego typ i miejsce, a następnie zapisz.
Przed włączeniem skorzystaj z podglądu i wyniku sprawdzenia składni.
Wtyczkę mevvcode-pro-1.1.0.zip instaluj tylko wtedy, gdy potrzebujesz ekranów Pro, a następnie aktywuj licencję MEVD w MevvCode → Licencja.

Gdy zainstalowane jest Pro, darmową wtyczkę zostaw włączoną. Wykonywalne środowisko należy do wersji darmowej, więc wygasła licencja nigdy nie sprawi, że opublikowane już zachowanie zniknie.

Pierwszy fragment kodu

Pierwszy rekord utwórz jako wyłączony. Nadaj mu nazwę mówiącą o przeznaczeniu, wybierz PHP i miejsce globalne tylko wtedy, gdy sam kod podpina się do wąskiego haka WordPress lub WooCommerce, i zapisz.

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

Przeczytaj wynik walidacji; błąd parsowania musi zostawić rekord wyłączony.
Upewnij się, że sklep ma już skonfigurowaną metodę darmowej wysyłki.
Włącz fragment kodu w środowisku testowym i sprawdź koszyki poniżej i powyżej progu.
Przed przeniesieniem rekordu na produkcję wyeksportuj kopię w formacie JSON.
Opublikuj, a następnie sprawdź publiczny koszyk oraz punkt końcowy stanu MevvCode.

Przykład pokazuje sposób pracy, a nie uniwersalną politykę wysyłki. Podatki, kupony, waluty i strefy wysyłki mogą zmienić to, którą sumę częściową powinna brać twoja reguła biznesowa.

Turecki panel administracyjny i wiersz wtyczki

Wersja darmowa i Pro 1.1.0 zawierają edytowalne katalogi PO, skompilowane MO oraz POT. Gdy językiem witryny WordPress jest Türkçe (tr_TR), panel administracyjny, stany migracji, błędy walidacji i ekran licencji wczytują się po turecku automatycznie.

Ekran wtyczek pokazuje przetłumaczony opis.
Ustawienia otwierają bezpośrednio kartę ustawień MevvCode.
Dokumentacja otwiera tę stronę, a Wsparcie — stronę kontaktu.
Obsługa zależności w WordPressie nie pozwala usunąć wersji darmowej, dopóki wymaga jej MevvCode Pro.

Jeżeli turecki panel się nie wczytuje, sprawdź Ustawienia → Ogólne → Język witryny, a następnie zaktualizuj wersję darmową i Pro do tej samej wersji. Nie zmieniaj nazw plików w katalogu languages.

Model środowiska wykonawczego

Edytowalne rekordy leżą w wp-content/mevvcode-snippets/records. Zapisanie aktywnej zmiany buduje nową generację w katalogu tymczasowym, sprawdza każdy plik PHP, zapisuje manifest i dopiero wtedy przestawia bieżący wskaźnik.

Rekordy: Edytowalny kod źródłowy, metadane, warunki i historia.
Generacja: Niezmienne, skompilowane pliki dla jednego znanego dobrego stanu.
Manifest: Mała mapa, którą ścieżka żądania czyta, aby odnaleźć bieżącą generację.

Nieudana kompilacja nie aktualizuje witryny połowicznie. Stary manifest pozostaje bieżący, wadliwy kod źródłowy zostaje edytowalny, a panel pokazuje błąd. Nie ma zapytania o kod fragmentu przy każdym żądaniu.

Nie edytuj wygenerowanych plików ręcznie. To jednorazowy wynik budowania, który zostanie zastąpiony przy następnej udanej kompilacji.

Typy, miejsca i warunki

PHP działa poprzez haki WordPress. JavaScript, CSS, HTML i tekst wypisywane są wyłącznie w miejscu, które wskażesz wprost: head, początek body, stopka, przed treścią lub po niej, shortcode, ręcznie albo jeden raz.

Wewnątrz jednej grupy warunków obowiązuje AND; grupy łączy się przez OR.
Konteksty panelu administracyjnego, frontu witryny, adresu URL, użytkownika, roli i żądania można łączyć.
Tagi i grupy porządkują rekordy; blokada zapobiega przypadkowej edycji i działaniom zbiorczym.
Fragment kodu uruchamiany ręcznie nie dołącza do żadnego haka żądania, dopóki nie wywoła go twój własny kod.

Wybieraj najwęższe miejsce i najwęższy warunek, jaki opisuje wymaganie. Globalny hak PHP powinien być świadomym wyborem, a nie domyślnym domem dla kodu skopiowanego z odpowiedzi wsparcia.

Migracja z wtyczki Code Snippets

Otwórz MevvCode → Migracja. Importer czyta tabelę fragmentów kodu z prefiksem witryny, zachowuje każdy identyfikator źródłowy i dokładne bajty kodu oraz tworzy przygotowane rekordy MevvCode, nie zmieniając tego, która wtyczka jest aktywna.

Uruchom wykrywanie i sprawdź liczbę rekordów.
Zaimportuj do przygotowanego, wyłączonego zestawu.
Sparsuj każdy fragment kodu aktywny we wtyczce Code Snippets.
Utwórz migawkę do wycofania: listę aktywnych wtyczek i bieżący manifest MevvCode.
Skompiluj jedną kompletną generację.
Rozpocznij przejście. Wtyczka Code Snippets zostaje wyłączona dopiero wtedy, gdy manifest już istnieje.
Podpisane żądanie zwrotne sprawdza publiczną witrynę. Powodzenie zatwierdza przejście; niepowodzenie automatycznie przywraca listę wtyczek i manifest.

Tabele źródłowe nie są usuwane. Ręczne wycofanie pozostaje dostępne także po udanym przejściu i włącza z powrotem dokładnie tę samą listę aktywnych wtyczek. W witrynie mevvshop.com 1 września 2026 roku zmierzone przejście produkcyjne zachowało 9 rekordów i 6 stanów aktywności oraz dało 0 rozbieżności w nazwie, dokładnych bajtach kodu, priorytecie i statusie. To dowód dla tamtego sklepu, a nie uniwersalny wzorzec.

Jeżeli zaimportowany fragment kodu nie przechodzi parsowania, popraw przygotowaną kopię w MevvCode albo zostaw ją wyłączoną. Nie wyłączaj wtyczki Code Snippets ręcznie, zanim przejście nie zgłosi sprawnej generacji.

Tryb bezpieczny i odzyskiwanie

W tryb bezpieczny można wejść za pomocą udokumentowanej stałej albo krótko żyjącego, podpisanego adresu URL wygenerowanego dla administratora. W trybie bezpiecznym wykonywanie fragmentów kodu zostaje wstrzymane, a panel administracyjny pozostaje dostępny do naprawy.

Błąd parsowania PHP nigdy nie staje się bieżącą generacją.
Wyjątek w czasie wykonania wyłącza odpowiedzialny rekord i zostawia pozostałe fragmenty kodu dostępne.
Ochrona przed błędem krytycznym zapisuje wyłącznie tożsamość i stan rekordu potrzebne do odzyskania — nigdy kodu źródłowego ani sekretów żądania.
Poprzednia znana dobra generacja jest zachowywana, dopóki jej następczyni nie przejdzie wszystkich sprawdzeń.

define( 'MEVVCODE_SAFE_MODE', true );

Po naprawieniu lub wyłączeniu wadliwego rekordu usuń tę stałą. Pozostawiona na miejscu celowo trzyma wszystkie fragmenty kodu wyłączone.

Przenośność i kopie zapasowe

Wybrane rekordy eksportuj jako MevvCode JSON v1, aby przenieść je tam i z powrotem bez strat, albo jako czytelny kod PHP, gdy miejsce docelowe nie powinno zależeć od MevvCode. Importy z wtyczek Code Snippets i WPCode są adapterami do tego samego kanonicznego formatu rekordu.

Eksport do JSON obejmuje metadane, warunki i status.
Eksport do PHP służy przeglądowi i ręcznemu przejęciu własności, a nie ponownemu wczytaniu ukrytych metadanych.
Loader must-use potrafi przenieść skompilowane zachowanie, gdy zwykłą wtyczkę trzeba usunąć.
Pro potrafi spakować wybrane fragmenty kodu jako zwykły plik ZIP wtyczki funkcjonalnej, po sprawdzeniu nazw, ścieżek i kodu PHP.

Przed dużym importem, zbiorczym włączaniem albo migracją trzymaj kopię eksportów poza witryną. Rewizje są historią edycji, a nie kopią zapasową na wypadek awarii.

Free i Pro

Wersja darmowa jest kompletnym, bezpiecznym, lokalnym menedżerem fragmentów kodu. Obejmuje wszystkie pięć typów, atomowe środowisko wykonawcze, miejsca i warunki podstawowe, ochronę przed błędem krytycznym, tryb bezpieczny, migrację z wtyczki Code Snippets, import i eksport, generatory, rewizje, uprawnienia ról, REST tylko do odczytu oraz loader must-use.

Pro jest warstwą współpracy i dostarczania. Dodaje warunki wielokrotnego użytku i zaplanowane; kontekst urządzenia, odsyłacza, lokalizacji, koszyka i zamówienia; nieograniczoną historię audytu; budowanie CSS/JS oraz zasoby zewnętrzne; zdarzenia pikselowe e-commerce; podpisaną automatyzację; eksport wtyczki; lokalne wnioski zbiorcze; szyfrowane przestrzenie robocze w chmurze; przegląd AI włączany osobno; oraz API zgodne z REST/MCP z uprawnieniami na poziomie akcji.

Chmura i AI włączane są osobno. AI otrzymuje kopię z zamaskowanymi sekretami i zwraca różnicę do przeglądu; nigdy nie stosuje jej automatycznie. Zapisy w chmurze używają HMAC podpisanego kluczem licencji, a optymistyczne rewizje odrzucają nieaktualne aktualizacje.

Odnalezienie i aktywacja licencji Pro

Zakupiona licencja jest powiązana z adresem e-mail podanym przy zamówieniu i widnieje pod adresem mevvsoft.com/account. Klucz zaczyna się od MEVD; nigdy nie wklejaj go do zgłoszenia wsparcia, do adresu URL ani do publicznego dziennika.

Zainstaluj i włącz darmowy pakiet MevvCode.
Zainstaluj i włącz odpowiadający mu pakiet MevvCode Pro.
Zaloguj się na konto utworzone dla adresu e-mail z zamówienia i skopiuj klucz MevvCode Pro.
Otwórz MevvCode → Licencja, wklej klucz MEVD i aktywuj go.
Upewnij się, że status jest aktywny, a witryna widnieje przy licencji na twoim koncie.

Jeżeli licencji nie ma na koncie, najpierw upewnij się, że zalogowałeś się tym samym adresem e-mail, którego użyto przy zamówieniu. Jeżeli licencja jest, ale aktywacja zgłasza limit witryn, zwolnij starą witrynę na koncie albo skontaktuj się ze wsparciem bez przesyłania pełnego klucza.

FAQ i rozwiązywanie problemów

Fragment kodu zapisał się, ale nie zadziałał: Sprawdź, czy jest włączony, czy jego miejsce odpowiada żądaniu, czy da się spełnić każdą grupę warunków i czy tryb bezpieczny jest wyłączony.
Po migracji stara wtyczka nadal jest aktywna: Przejście nie zostało zatwierdzone. Przeczytaj wynik migracji: parsowanie, kompilacja albo zwrotny test sprawności nie powiodły się, a wycofanie ochroniło witrynę.
Witryna weszła w tryb bezpieczny: Otwórz panel przez podpisany adres URL odzyskiwania, obejrzyj ostatnio wyłączony rekord, popraw go albo zostaw wyłączony, skompiluj, a następnie wyjdź z trybu bezpiecznego.
Chmura zgłasza konflikt: Inny klient zmienił przestrzeń roboczą po rewizji, którą wczytałeś. Porównaj rekord zdalny z lokalnym i wyślij zmiany ponownie, opierając się na nowej rewizji bazowej.
Przegląd AI jest niedostępny: Aktywne muszą być zarówno licencja Pro, jak i wyraźna zgoda na AI, a adapter usługi musi być skonfigurowany. Lokalne fragmenty kodu działają dalej.

Prosząc o wsparcie, prześlij wersje wtyczek, wersje WordPress i PHP, UUID rekordu oraz dokładną treść błędu. Usuń sekrety i dane klientów. Nie wysyłaj produkcyjnego klucza licencji ani całego kodu źródłowego, chyba że jest to konieczne i sam go przejrzałeś.

Uruchamianie małych fragmentów kodu z prawdziwą granicą bezpieczeństwa.