#summary provides captcha protection for registration form
#labels Stage-Beta
= Introduction =
Prosody-captcha is a little modification of prosody's "mod_register.lua" module that provides captcha protection for registration form.
= Installation =
First of all you should build and install lua bindings for libgd — [https://github.com/ittner/lua-gd/ lua-gd].
Then clone repsository lua-captcha:
*{{{ $ git clone https://github.com/mrDoctorWho/lua-captcha }}}*
install it:
*{{{ $ make install }}}*
= Configuration =
After that you would configure prosody. This module requires from you 4 fields, you should add this into your VirtualHost entry.
{{{
captcha_config = {
dir = "/tmp"; -- Directory used to storage captcha images. Please make sure prosody user allowed to write there.
timeout = 60; -- Timeout when captcha will expire
web_path = "challenge"; -- Web path used to separate main prosody site from itself modules.
font = "/usr/lib/prosody/FiraSans-Regular.ttf" -- Font used for captcha text
}
}}}
You can run script "install.lua" to install this or instead of that while prosody developers didn't accepted "dataforms" changes you should replace standard prosody "dataforms.lua" located in ubuntu in /usr/lib/prosody/util by another one from this repository. You should do the same thing with "mod_register.lua" located in ubuntu in /usr/lib/prosody/modules.
After this all you can try to register on your server and see the captcha.
= TODO =
* Maybe use recaptcha instead of libgd.