EXT: Spamshield¶

Table of Contents¶

EXT: Readable name of your extension 1

`Introduction 3 <#1.1.Introduction|outline>`_

What does it do? 3

Screenshots 3

`Users manual 4 <#1.2.Users%20manual|outline>`_

FAQ 4

`Administration 5 <#1.3.Administration|outline>`_

FAQ 5

`Configuration 6 <#1.4.Configuration|outline>`_

FAQ 6

Reference 6

`Tutorial 7 <#1.5.Tutorial|outline>`_

`Known problems 8 <#1.6.Known%20problems|outline>`_

`To-Do list 9 <#1.7.To-Do%20list|outline>`_

`ChangeLog 10 <#1.8.ChangeLog|outline>`_

Important guidelines 11

`Issues with Open Office documentation for TYPO3 12 <#2.1.Issues%20w ith%20Open%20Office%20documentation%20for%20TYPO3|outline>`_

Inserting images 12

Paragraph styles 12

Linking 13

Meta data and updates 13

HowTo: Update a manual to the new layout 13

HowTo: (alternative) Import the styles from another document 14

`HowTo: Fix the Table Of Contents when it is empty 14 <#2.1.8.HowTo:%2 0Fix%20the%20Table%20Of%20Contents%20when%20it%20is%20empty%20|outline >`_

HowTo: Fix the Table Of Contents when a chapter is missing 14

Help by documentation.openoffice.org 14

Introduction¶

Users manual¶

• Import SpamShield from Extension repository and install it.
• You can configure rulesets, redirection, logging, blocking message and many more. Have a look at the configuration part of the documentation for details.
• Add the static template to your main template of the site.
• You can configure the honeypots with TypoScript. Have a look at the configuration part of the documentation for details.

Administration¶

Afer you have installed the extension as in user manual described you can configure spamshield to your needs. Have a look at the configuration chapter of this manual. In this chapter we show some special features of spamshield.

• Frontent plugin with captcha if spam detected You may insert the spamshield frontend plugin to any TYPO3 page. Enter this pid in the configuration of spamshield in the extension manager to the property “redirecttopid”. After saving this value blocked users gets redirected now instead of just getting the blocking message. The frontent plugin delivers a captcha and a submit button. If the captcha is solved the user gets redirected to the page he comes from and the post variables are getting submitted too. As a result it will lead the user in most cases to the expected result.NOTE: You have to install either the “sr_freecap” or “captcha” extension. Hint: if you have installed both extensions, “sr_freecap” will be used.

• Add new honepot field Just enter new fields to the plugin.tx_spamshield.add2forms.fields section of the spamshield TypoScript. Spamshield recognises the fields by their name. So you have to the “honeypot” property (Honepot field names) of the extension configuration in the extension manager, separated by comma.NOTE: Spamshield needs the following hidden input field in order to work. Do not remove it!

  <input type="hidden" name="spamshield[mark]" value="true" />
  

• Disable check for specific forms Just enter a valid regular expression to your TypoScript setting to have spamshield ignore forms that matches any expression in: plugin.tx_spamshield.add2forms.off

• Disable spamshield for a whole pageExample

  Here spamshield gets disabled for logged in users:

  [loginUser = *]
      page.headerData.5289 >
  plugin.tx_spamshield >
[global]

Configuration¶

fields {
10 = <input type="text" name="email" value="" style="display:none !important;" />
20 = <input type="text" name="name" value="" class="tx_spamshield_honey1" />
30 = <input type="text" name="first-name" value="" style="position: absolute !important; margin: 0 0 0 -9999px !important;" />
40 = <input type="text" name="e-mail" value="" class="tx_spamshield_honey1" />
50 = <input type="hidden" name="spamshield[mark]" value="true" />
}

<h1>You have been blocked.</h1><p>Sorry for that.</p>

Known problems¶

• JavaScript and Cookie-Check and multiple Domains Problem:If you are using forms that POST data across multiple domains / subdomains. Spamshield does not find the cookies. Therefore JavaScript and Cookie check will always fail.

  Solution:

  Go to the TYPO3 install-tool and define “cookieDomain”

• Referer-Check and multiple Domains

• Problem:If you are using forms that POST data across multiple domains / subdomains. Spamshield Referer check will block this as spam.

  Solution:

  Define all your domains the config of the install tool:

whitelist = domain1.de, domain2.com

Feel free to submit bugs at: TYPO3 Forge

To-Do list¶

• Captcha templates should be configurable by TypoScript.
• Feeld free to submit feature request or other suggestions at out project page: TYPO3 Forge

ChangeLog¶