DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

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

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

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

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

This extension requires TYPO3 4.1.6+ and PHP 5.0+.

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

Screenshots

img-1

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

General

TypoScript Reference

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

tt_content.mailform.20.captchaImage

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

Property

tt_content.mailform.20.captchaInput.addParams

Data type

String

Description

Additional params to the captcha input field

Default

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

nothing yet to do.

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