Preskočiť na obsah

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.

<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.

if (class_exists('MvCaptchaV1') && !MvCaptchaV1::verify('review')) {
$this->errors[] = MvCaptchaV1::errorMessage();
return;
}
// bežné spracovanie formulára
  • MvCaptchaV1::verify($action) vráti true, ak sa formulár môže spracovať, a false, 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ý.

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.

Bol tento článok užitočný?