--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_captcha_registration/README.md	Tue Oct 22 10:26:01 2024 +0200
@@ -0,0 +1,54 @@
+---
+labels:
+- 'Stage-Beta'
+summary: provides captcha protection for registration form
+...
+
+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 —
+[lua-gd](https://github.com/ittner/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.