====== Modern Contact Plugin ======

---- plugin ----
description: Contact Form Plugin for DokuWiki
author     : Marvin Thomas Rabe
email      : mrabe@marvinrabe.de
type       : syntax
lastupdate : 2012-06-05
compatible : Hrun
depends    : 
conflicts  : contact
similar    : contact, form, contact, bureaucracy
tags       : form, email, recaptcha, !discontinued

downloadurl: https://github.com/Tekki/dokuwiki-contact/archive/master.zip
bugtracker : 
sourcerepo : 
----



In the search for a contact form for Dokuwiki I only found that of [[http://bobbaddeley.com/doku.php/projects/programming/wiki/contact|Bob Baddeley]]. It is quite good, although a bit outdated. You can find this plugin on [[https://github.com/marvinrabe/dokuwiki-contact|Github]].

===== Features =====

It is nearly the same form like that by Bob Baddeley, except:

  - reCaptcha instead of "Enter HUMAN to verify."
  - Captcha can be disabled.
  - Improved configuration.
  - Improved anti cache work-around.
  - Intelligent email address checkup.
  - No annoying JavaScript-Alerts.
  - It jumps back to the form after submitting.
  - Name and email field are filled if user is logged in.

If you have some more ideas, feel free to contact me.

Following languages are  available: //German, English, Russian (partially), Portuguese (partially), French (partially)//

===== Requirements =====

To use this Plugin you need the following system:

  * PHP >= 5.1.2
  * DokuWiki >= 2009-02-14b
  * reCaptcha keys (optional)

You can receive the needed reCaptcha keys on [[https://www.google.com/recaptcha|google.com/recaptcha]].

===== Download / Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.


In //Admin -> Configuration settings// you have to set up a valid email address and (if you want) your reCaptcha keys. You can modify and redistribute it under the terms of the [[http://www.gnu.org/licenses/gpl-3.0-standalone.html|GPL Version 3]].

===== Usage =====

The integration is the same as in the plugin by Baddeley. Simply enter this code:

<code>
{{contact>}}
</code>

This will create a contact form with a "name","email address", "subject" and "comment" field. It will send an email to whatever the default value is. If you enabled the captcha by default, than it will also show the well known reCaptcha input fields.

You can also specify several parameters. If you only need one parameter you simply use:

<code>
{{contact>subj=Feedback from Site}}
</code>

or join multiple of them with a | character:

<code>
{{contact>to=profile1|subj=Feedback from Site}}
</code>

Available parameters:

^ Parameter      ^ Value                ^ Description ^
| subj           | String               | When the subject is specified in the parameters, it is not a field on the contact form. |
| to             | Profile name         | If you choose another profile, then emails will be sent to the profile email address. You have to specify other profiles before you can use them.|
| captcha        | Boolean (true/false) | If set to true, the captcha will be enabled. Set it on false to disable it. You must activate the captcha by default in order to change its status with this parameter. |

===== Known bugs =====
==== Unconfirmed new download URL ====
I've found the project at [[https://github.com/Tekki/dokuwiki-contact]].
\\ The download link therefore may be [[https://github.com/Tekki/dokuwiki-contact/zipball/master]].
\\ I did not modify the ''downloadurl'' and ''sourcerepo'' entries of the plugin description above, since I am not sure if its the identical version.
\\ --- //Ralph Reuchlein 09-Dec-2016 10:38//


A newer version is here [[https://github.com/niknah/dokuwiki-contact]].
\\ Updated to php7, dokuwiki 2018-04-22b, recaptcha php v1.2.3
\\ --- [[user>niknah|niknah]] //2019-10-26 05:55//

==== Captcha ====

  * Only one contact form per page accepts reCaptcha.
  * REcaptcha often doesn't load of conflicts with other plugins, e.g. skype. Is it possible to amend this plugin to make use of the Captcha plugin?

==== Versions and disable/enable ====

As far as I can figure it out ...
  * The Download button at the top of the page leads to a file named **marvinrabe-dokuwiki-contact-3fd1753.zip**. The last entry in the CHANGELOG is dated 2013-01-25, "Changed plugin name". This is also the version installed by the automatic plugin manager mechanism.
  * Farther down, in the section [[plugin:contactmodern#download_installation|Download / Installation]], there is a link that leads to a file named **moderncontact_2012-06-06.zip**. The last entry in the CHANGELOG is dated 2012-06-06. The syntax.php file contains the string "contactmodern" several times. This version will only work if every instance of "contactmodern" is changed to "moderncontact", but presumably you want the other version anyway.
Both of these versions initially result in the error message
  Error, the requested extension hasn't been installed or updated
and the code <nowiki>{{contact>}}</nowiki> will be rendered as a red link. Disabling the plugin and (re-)enabling it will cause it to work.

--Arthur Carlson, Max Planck Institute of Biochemistry, Munich, Germany, 2015-07-20

===== Translations =====

[[http://alek.magazynek.org/wiki/darmowe-cmsy/dokuwiki/tlumaczenie-contactmodern-modern-contact-plugin|Polish]]