Mercurial > prosody-modules
diff mod_captcha_registration/README.wiki @ 1782:29f3d6b7ad16
Import wiki pages
author | Kim Alvefur <zash@zash.se> |
---|---|
date | Mon, 24 Aug 2015 16:43:56 +0200 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mod_captcha_registration/README.wiki Mon Aug 24 16:43:56 2015 +0200 @@ -0,0 +1,37 @@ +#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. \ No newline at end of file