Pre vývojárov
Formuláre jadra PrestaShopu a modulov odber noviniek, hodnotenia produktov a upozornenia na dostupnosť modul rozpozná sám. Ak má váš modul alebo téma vlastný formulár, môžete ho nechať chrániť rovnakým mechanizmom. Treba dve veci: atribút vo formulári a jedno volanie na serveri. Obe používajú rovnaký názov akcie.
Krok 1: atribút data-mv-captcha
Section titled “Krok 1: atribút data-mv-captcha”<form method="post" action="{$link->getModuleLink('mojmodul', 'odoslat')}" data-mv-captcha="review"> <!-- polia formulára --> <button type="submit">Odoslať</button></form>Hodnota atribútu je názov akcie: len písmená a podčiarkovník, najviac 32 znakov. Ostatné znaky sa vynechajú, prázdna hodnota znamená custom. Skript modulu pri odoslaní formulára získa token a pridá ho do formulára ako pole mv_captcha_token.
Funguje aj pre formuláre odosielané bez obnovenia stránky (AJAX), ak odosielajú údaje formulára. Ak údaje skladáte sami, pošlite pole mv_captcha_token s hodnotou z formulára.
Krok 2: overenie na serveri
Section titled “Krok 2: overenie na serveri”if (class_exists('MvCaptchaV1') && !MvCaptchaV1::verify('review')) { $this->errors[] = MvCaptchaV1::errorMessage(); return;}// bežné spracovanie formuláraMvCaptchaV1::verify($action)vrátitrue, ak sa formulár môže spracovať, afalse, ak overenie zlyhalo. Názov akcie musí byť rovnaký ako v atribúte formulára.- Volajte ju raz za požiadavku a pred spracovaním, napríklad pred uložením alebo odoslaním e-mailu. Token platí len raz, opakované volanie v tej istej požiadavke vráti ten istý výsledok.
MvCaptchaV1::errorMessage()vráti text hlásenia pre návštevníka v jazyku obchodu, bezpečný pre HTML.- Kontrola
class_exists('MvCaptchaV1')zabezpečí, že váš modul funguje, aj keď modul na ochranu formulárov nie je nainštalovaný.
Kedy verify() vráti true
Section titled “Kedy verify() vráti true”Funkcia vráti true aj vtedy, keď overenie netreba alebo nie je k dispozícii, takže váš formulár nikdy nezablokuje samotný modul:
- modul je vypnutý, bez platnej licencie alebo bez kľúčov,
- zákazník je prihlásený a máte zapnuté Neoverovať prihlásených zákazníkov,
- služba má výpadok a máte zapnuté Pri výpadku služby formulár odoslať.
Pokusy z vlastných formulárov sa počítajú v prehľade v riadku Formuláre iných modulov.
Ďakujeme za odpoveď.
Mrzí nás to. Napíšte nám, čo chýba alebo čo nie je jasné:Napísať podpore