# HG changeset patch
# User mrDoctorWho@gmail.com
# Date 1396109289 0
# Node ID f8ab8f686f9339a253ed0b41a698b4f3c9dd8ea5
# Parent  a07ea836616e63c7a1295d992aff9e783daafc24
Created wiki page through web user interface for mod_captcha_registraion

diff -r a07ea836616e -r f8ab8f686f93 mod_captcha_registration.wiki
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_captcha_registration.wiki	Sat Mar 29 16:08:09 2014 +0000
@@ -0,0 +1,34 @@
+#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.
\ No newline at end of file