.. You may want to use the usual include line. Uncomment and adjust the path. 
.. include:: ../Includes.txt


===========
FormCaptcha
===========

:Author:
      Kasper Skårhøj

:Created:
      2002-11-01T00:32:00

:Changed by:
      Urs Maag

:Changed:
      2012-07-12T17:54:08.110000000

:Author:
      Urs Maag

:Email:
      urs@maag-matzingen.ch

:Info 3:


:Info 4:


.. _FormCaptcha:

FormCaptcha
===========

Extension Key:  **maag\_formcaptcha**

Copyright 2004-2006, Urs Maag, <urs@maag-matzingen.ch>

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

\- a GNU/GPL CMS/Framework available from www.typo3.com

.. _Table-of-Contents:

Table of Contents
-----------------

**FormCaptcha 1**

**Introduction 1**

What does it do? 1

Requirements 1

Screenshots 1

Users manual 2

**Configuration 3**

General 3

TypoScript Reference 3

TypoScript Setup 3

**To-Do list 3**

**Changelog 3**


.. _Introduction:

Introduction
------------


.. _What-does-it-do:

What does it do?
^^^^^^^^^^^^^^^^

The maag\_formcaptcha extension protect your standard mailforms with a
captcha code. The extension based on the nd\_antispam extension from
Nepa Webdesign.


.. _Requirements:

Requirements
^^^^^^^^^^^^

This extension requires TYPO3 4.1.6+ and PHP 5.0+.

Captcha Library must be installed (Extension key “captcha”).


.. _Screenshots:

**Screenshots**
^^^^^^^^^^^^^^^

|img-1|


.. _Users-manual:

Users manual
^^^^^^^^^^^^

After installation, there are 3 new field types in the form wizard.

- Captcha Image The Captcha Image from the Captcha Extension

- Captcha Input field The Captcha Input field for entering the code from
  the captcha image. Note that the fieldname is read-only and can not be
  renamed.

- Captcha Error page The Captcha Error page. The Url of a page for
  showing a error message if code was invalid.Note that the field name
  is read-only and can not be renamed.

|img-2|


.. _Configuration:

Configuration
-------------


.. _General:

General
^^^^^^^


.. _TypoScript-Reference:

TypoScript Reference
^^^^^^^^^^^^^^^^^^^^

Please note that the following properties TS template setup are
written in a “plugin.maag\_formcaptcha” section.

.. ### BEGIN~OF~TABLE ###


.. _tt-content-mailform-20-captchaImage:

tt\_content.mailform.20.captchaImage
""""""""""""""""""""""""""""""""""""

.. container:: table-row

   Property
         tt\_content.mailform.20.captchaImage
   
   Data type
         String
   
   Description
         If this property is not set, the extension renders a image tag like
         follows:
         
         <img src=”typo3conf/ext/captcha/captcha/captcha.php” alt="" />
         
         If you wan't to add other attributes to the image tag, feel free and
         make it with this property. Note that the “src” attribute must be the
         captcha source of the Captcha Library.
   
   Default
         see in Description



.. _tt-content-mailform-20-captchaInput-addParams:

tt\_content.mailform.20.captchaInput.addParams
""""""""""""""""""""""""""""""""""""""""""""""

.. container:: table-row

   Property
         tt\_content.mailform.20.captchaInput.addParams
   
   Data type
         String
   
   Description
         Additional params to the captcha input field
   
   Default


.. ###### END~OF~TABLE ######


.. _TypoScript-Setup:

TypoScript Setup
^^^^^^^^^^^^^^^^

You should use the following settings (example):

tt\_content.mailform.20.captchaImage {

captchaImage (<script language="JavaScript"><!--function
reloadCaptchaImage() {var now = new
Date();document.images.captchaImage.src =
"typo3conf/ext/captcha/captcha/captcha.php?" +
now.getTime();}//--></script><a
href="javascript:reloadCaptchaImage();"><img
src="typo3conf/ext/captcha/captcha/captcha.php" id="captchaImage"
alt="Schutz gegen Spam!" vspace="0" hspace="0" class="captchaImage"
/><br/><br/></a>)captchaInput.addParams =
onFocus="reloadCaptchaImage()"

}


.. _To-Do-list:

To-Do list
----------

nothing yet to do.


.. _Changelog:

Changelog
---------

Version 1.0.0:

Initial version.

Version 1.0.1:

Bug fix of rendering the captchaResponse field (no type was given).

Version 1.0.2:

Manual updated

Version 1.1.0:

Make it compatible with Typo3 4.3.0

Version 1.1.1:

bug fix on validating with javascript (add rawurlencode around field
names)

Version 1.1.2:

bug fix on validating with javascript (encoding in javascript
validation)

Version 1.1.3:

bug fix on validating when javascript is disabled (thanks to Jan
Radecker)

Version 1.1.4:

bug fix on regular expression for validating when javascript is
disabled

Version 1.2.0:

make it compatible with typo3 version 4.5 and above

Version 1.2.1:

bug fix of regex to validate even if javascript is disabled and
captcha image is marked as required (thanks to Jan Radecker)

Version 1.2.2:

add possibility to add additional params to the captcha input field

|img-3| FormCaptcha - 4


.. ######CUTTER_MARK_IMAGES######

.. |img-1| image:: img-1.png
.. :align: left
.. :border: 1
.. :height: 163
.. :id: Grafik1
.. :name: Grafik1
.. :width: 403

.. |img-2| image:: img-2.png
.. :align: left
.. :border: 0
.. :height: 553
.. :id: Grafik2
.. :name: Grafik2
.. :width: 585

.. |img-3| image:: img-3.png
.. :align: left
.. :border: 0
.. :height: 32
.. :id: Graphic1
.. :name: Graphic1
.. :width: 102