Dokumentacja MevvForms

Dostępne formularze, lokalne zgłoszenia i odwracalna migracja.

Wtyczka MevvForms jest właścicielem schematu formularza, walidacji po stronie serwera, dostępnego renderowania, lokalnych zgłoszeń i trwałej kolejki powiadomień. Ten przewodnik dokumentuje działające wydanie rdzenia oraz zmierzoną ścieżkę zastąpienia istniejącego formularza WPForms bez usuwania jego danych źródłowych.

Przegląd i wymagania

MevvForms Free jest lokalnym środowiskiem wykonawczym. Opublikowany formularz odczytywany jest z wersjonowanego rekordu formularza WordPress, renderowany z prawdziwymi etykietami i powiązaniami błędów, ponownie sprawdzany na serwerze, zapisywany lokalnie i przekazywany do trwałej kolejki powiadomień.

WordPress
6.6 lub nowszy; przetestowane do WordPress 7.1.
PHP
8.1 lub nowszy; macierz wydań obejmuje PHP 8.1–8.5.
Granica danych
Definicje formularzy, zgłoszenia i zadania w kolejce domyślnie pozostają w witrynie WordPress.
Pliki tłumaczeń
Dla języka tureckiego i angielskiego dołączone są edytowalne katalogi PO, skompilowane MO oraz POT.

Podczas gdy odwiedzający renderuje lub wysyła formularz, wersja darmowa nie wysyła do żadnej usługi zewnętrznej żądania licencji, telemetrii, AI ani aktualizacji.

Instalacja

  1. Wykonaj odtwarzalną kopię zapasową bazy danych i katalogu wp-content.
  2. Wgraj i włącz pakiet ZIP MevvForms Free.
  3. Upewnij się, że tabele bazy danych MevvForms zostały utworzone i że administrator może otworzyć panel.
  4. Trzymaj źródłową wtyczkę formularzy włączoną, dopóki nie zakończą się podgląd migracji, import i testy sprawności.
  5. Odpowiadający pakiet Pro instaluj tylko wtedy, gdy zapisany formularz korzysta z wydanego modułu Pro.

Nie usuwaj pakietu darmowego, gdy zainstalowane jest Pro. Środowisko wykonawcze zapisanego formularza należy do wersji darmowej; Pro je rozszerza.

Renderowanie i wysyłanie formularza

Opublikowany formularz osadź za pomocą [mevvforms id="123"]. Renderer wypisuje stabilne identyfikatory pól, prawdziwe etykiety, opisy, cel podsumowania błędów oraz podpisaną sesję powiązaną z bieżącą rewizją formularza.

  • Wymagalność i reguły walidacji brane są ze schematu należącego do serwera.
  • Ukryte lub nieznane wartości od klienta nie mogą rozluźnić reguł serwera.
  • Poprawne zgłoszenie tworzy wpis, zanim uruchomi się jakikolwiek efekt uboczny powiadomienia.
  • Odpowiedź zawiera skonfigurowany komunikat albo bezpieczne przekierowanie, nigdy zapisanych wartości pól.

Jeżeli formularz zmienił się po otwarciu strony, odśwież ją przed wysłaniem, aby podpisana sesja zgadzała się z bieżącą rewizją.

Odwracalna migracja z wtyczki WPForms

Migracja zaczyna się w trybie tylko do odczytu. Podgląd wymienia zmapowane pola, powiadomienia, potwierdzenia, osadzenia i nieobsługiwane ustawienia. Zastosowanie tworzy albo aktualizuje jeden przygotowany formularz MevvForms i zapisuje skrót źródła. Nie usuwa danych wtyczki WPForms, rewizji, tabel ani treści stron.

  1. Przed zastosowaniem wymagaj dokładnego podglądu.
  2. Zaimportuj formularz jako przygotowany i ponownie porównaj skróty źródła.
  3. Uruchom bramkę sprawności przejścia: publikacja, renderowanie, podpisane zgłoszenie testowe, lokalny wpis i powiadomienie w kolejce.
  4. Źródłową wtyczkę można wyłączyć dopiero po przejściu tych sprawdzeń.
  5. Jeżeli którekolwiek sprawdzenie się nie powiedzie, wycofanie przywraca poprzednią listę aktywnych wtyczek i zwraca zaimportowany formularz do szkiców.

Zmierzony inwentarz witryny mevvshop.com to jeden formularz źródłowy z 4 polami, 1 powiadomieniem, 1 potwierdzeniem i jednym działającym osadzeniem. Te liczby są bramką wydania dla tamtej witryny, a nie obietnicą dotyczącą każdego formularza WPForms.

Zgłoszenia i granica prywatności

Zgłoszenia i typowane projekcje pól przechowywane są w wydzielonych tabelach lokalnych. Hasła, dane kart, kody CVV, wartości nonce WordPress, tokeny sesji oraz pola oznaczone store=false nigdy nie trafiają do wartości zgłoszenia.

  • Adresy IP reprezentowane są wyłącznie przez HMAC właściwy danej witrynie, tam gdzie wymaga tego ograniczanie częstotliwości.
  • Projekcje tekstowe, liczbowe i datowe wspierają późniejsze wyszukiwanie, nie zmieniając pierwotnej tożsamości pola.
  • Nieudany zapis zgłoszenia albo zapis do outbox wycofuje całą transakcję wysyłki.
  • Dowody produkcyjne zapisują wyłącznie identyfikatory formularza, zgłoszenia i zadania; nigdy nie zapisują przesłanych wartości.

Powiadomienia i potwierdzenia

Powiadomienia są trwałymi zadaniami. Awaria poczty nie może wymazać przyjętego zgłoszenia: błędy przejściowe ponawiane są z ograniczonymi opóźnieniami, a trwałe błędy konfiguracji zatrzymują się do działania administratora.

Nagłówki
Odbiorcy i znaczniki scalania w nagłówkach są sprawdzane; wstrzyknięcie CR/LF jest usuwane.
Treść
Kod HTML jest escapowany albo filtrowany pod kątem kontekstu wyjścia.
Potwierdzenie
Decyzja o komunikacie, stronie w tej samej witrynie albo przekierowaniu z listy dozwolonych wybierana jest z zapisanego schematu.
Idempotentność
Ten sam klucz zadania powiadomienia nie może dwukrotnie wywołać tego samego efektu ubocznego.

Granica między wersją darmową a Pro

Do wersji darmowej należy niezawodne środowisko wykonawcze: schemat, pola podstawowe, dostępne renderowanie, walidacja na serwerze, lokalne zgłoszenia, powiadomienia przez outbox, potwierdzenia, dwujęzyczna administracja i odwracalna migracja z wtyczki WPForms.

Pro jest towarzyszem dla zaawansowanych, wydanych modułów. Warunkowe przepływy pracy, wielokrokowe narzędzia konwersji, dokumenty, handel, integracje, analityka i powierzchnie dla programistów włączane są dopiero w miarę zamykania ich bramek wydania. Zapisana konfiguracja Pro musi nadal się renderować i przyjmować zgłoszenia tak długo, jak zainstalowany kod Pro pozostaje dostępny — nawet jeżeli licencja później wygaśnie.

Pozycja z mapy drogowej nie jest reklamowana jako działająca możliwość. Zanim zbudujesz formularz wokół modułu Pro, sprawdź zainstalowaną wersję i informacje o wydaniu.

Rozwiązywanie problemów i wycofanie zmian

Stary shortcode jest pusty
Upewnij się, że identyfikator źródłowy ma aktywne mapowanie migracji i że shortcode wpforms nie należy do innej wtyczki.
Zgłoszenie informuje o wygaśnięciu sesji
Przeładuj stronę i wyślij zgłoszenie względem najnowszej opublikowanej rewizji.
Powiadomienie czeka
Otwórz stan kolejki, popraw trwały błąd konfiguracji albo pozwól na zaplanowane ponowienie przy przejściowym błędzie transportu.
Przejście nie wyłączyło wtyczki WPForms
Przeczytaj wynik sprawdzenia. Bramka bezpieczeństwa zachowała lub przywróciła wtyczkę WPForms, ponieważ nie powiodła się weryfikacja renderowania, wysyłki, zgłoszenia albo zadania.

Do wsparcia podaj wersje wtyczki, WordPress i PHP oraz bezpieczny kod błędu. Przed wysłaniem dzienników usuń wartości pól, dane klientów, tokeny sesji, wartości nonce i klucze licencji.