Learn about DokuWiki
Learn about DokuWiki
This is an old revision of the document!
Compatible with DokuWiki
This plugin implements a Completely Automated Public Turing test to tell Computers and Humans Apart also known as CAPTCHA.
Download the plugin using the plugin manager or manually from the download link above.
sudo apt-get install php5-gd, for php 7 use
sudo apt-get install php7.0-gd.
The plugin provides different methods of CAPTCHAs selectable in the config manager.
The math method is similar to the text mode but displays a simple mathematical problem in the form of an addition or subtraction. The user has to solve the problem and enter the result. This takes a bit more brain work from users. It's still relatively easy to defeat by a customized bot.
The question method allows to specify a single, static question to which a single static answer has to be provided by the user. The accessibility is the same as for the text method but it is very easy to defeat with a custom spam bot. However since the question can be customized (by changing the
answer config options) this can be used to require domain specific knowledge from your users.
The image method finally does display the random chars as an automatically generated image. This test can not be defeated without using costly OCR techniques. Unfortunately this method effectively locks out blind users or users with textbrowsers. This feature needs the libGD PHP extension.
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 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 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.
The figlet method creates an ASCII art rendering of the text. It has very bad accessibility and is relatively easy to defeat by a script, but is funny to look at
You can specify the number of characters to use for all CAPTCHAs (except
question mode of course) in the config.
If you select the image type you may specify the size of the generated image. Larger images take more screen space and might be easier to recognize with OCR. On the other hand larger images are better to read for humans, too. Make sure your image is wide enough to display the configured number of characters.
By default the CAPTCHA method is only applied for anonymous users. You may enable it for logged in users as well through the
The CAPTCHA by default protects the following actions:
You can optionally require a CAPTCHA for logins by enabling the
loginprotect config option.
The plugin provides a helper plugin which let's you add CAPTCHA checks to your own plugins. The helper provides three methods:
true when the CAPTCHA should be used - it checks the
forusers config option for you. Always check this method before using the other methods.
Returns the HTML for the CAPTCHA. It takes care of all other CAPTCHA options.
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.
Read the documentation again. The default settings js method uses a hidden CAPTCHA. There's nothing to see.