Differences

This shows you the differences between two versions of the page.

--- plugin:captcha [2017-02-02 09:15] – andi
+++ plugin:captcha [2023-12-06 23:50] (current) – version upped andi
@@ Line 6: / Line 6: @@
 email      : andi@splitbrain.org
 type       : action, helper
-lastupdate : 2017-02-02
+lastupdate : 2023-12-06
-compatible : Elenor Of Tsort, Detritus, Binky, Ponder Stibbons, Hrun
+compatible : Elenor Of Tsort, Detritus, Binky, Ponder Stibbons, Hrun, "Frusterick Manners", "Greebo", Hogfather
 depends    :
 conflicts  :
@@ Line 25: / Line 25: @@
 ===== Download =====
-Download the plugin using the plugin manager or manually from the download link above.
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
 ==== Changes ====
@@ Line 52: / Line 52: @@
 The **audio** method improves the accessibility of the image CAPTCHA by adding a .wav download. The .wav file plays the letters of the CAPTCHA read in the [[wp>NATO phonetic alphabet]]. Please note, that because of the way how the wave file is generated it might be easier to automatically decode than the image.
-The **svg** method works similar to the image method, but creates an inline SVG of the random letters. It should be much easier to read for humans. Until spammers catch up OCR'ing embedded SVG it should be relatively save against automated solving. It has the same accessibility problems as the image method.
+The **svg** method works similar to the image method, but creates an inline SVG of the random letters. It should be much easier to read for humans. Until spammers catch up OCR'ing embedded SVG it should be relatively safe against automated solving. It has the same accessibility problems as the image method.
 The **svgaudio** method combines the svg method with the audio method, providing an alternative audio version next to the SVG image.
@@ Line 89: / Line 89: @@
 Use this function to check if the CAPTCHA was filled correctly. It returns ''false'' if the CAPTCHA was not filled correctly and by default also prints a message about it. If you don't want this message, pass ''false'' as first parameter.
+==== Example ====
+<code php>
+//add captcha if available
+/** @var helper_plugin_captcha $captcha */
+$captcha = $this->loadHelper('captcha', false);
+if ($captcha && $captcha->isEnabled()) {
+    $form->addHTML($captcha->getHTML());
+}
+...
+/** @var helper_plugin_captcha $captcha */
+$captcha = $this->loadHelper('captcha', false);
+if ($captcha && $captcha->isEnabled()) {
+    $captchaok = $captcha->check();
+}
+</code>
 ===== FAQ =====
-==== It's installed but I see no CAPTCHA ====
+==== It's installed but I see no CAPTCHA? ====
 Read the documentation again. The default settings **js** method uses a [[http://www.google.com/search?q=javascript+invisible+captcha|hidden CAPTCHA]]. There's nothing to see.