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.
Administrator Manual¶
Prerequisites¶
Important
You must have set PAGE_TARGET = _top
in the constants
PAGE_TARGET = _top
Some of the TypoScript settings do not function via the constants field, but must be entered in the setup field. Only those settings which can be found using the Constants Editor or in the file Configuration/TypoScript/Default/constants.txt are valid constants. You must include the “Message Board Setup” into your “include static from extensions” of your TYPO3 template setup. The “Message Board CSS styles“ are not required. They provide default CSS styles for the forum.
Use the flexforms in the plugin entry form to configure the plugin functionality.
To prevent from spammers you must set the memberOfGroups constant to the FE groups to which the FE users must belong to be able to post. If you still want to allow to post for everyone, then unset memberOfGroups.
Example Constants¶
plugin.tt_board {
memberOfGroups =
}
Allow postings to everybody. This might lead to many spam postings! Your provider might then take down your website.
Installation¶
To install the extension, perform the following steps:
- Go to the Extension Manager
- Install the extension
- Configure it in the Extension Manager
- exclude creator IP
- exclude.tt_board = cr_ip This option disables the IP address for all tt_board records. If unset then the IP address of each post is stored. GDPR can require that you do not record the IP address. Here you can enter a comma separated list of fields of the tt_board table which will not be used. cr_ip is set by default in order not to store the IP address of the customer client. Remove it if you want to see the IP address of the persons who entered forms.
- Load the static template
- Other configuration
- This other option is for all the rest…
Configuration¶
This extension must be configured in the Extension Manager and in the Constants and Setup. The Exension Manager shows these options on the tt_board page:
- exclude fields: basic.exclude.tt_board
See Installation for more details.
See the chapter Configuration for TypoScript.
Use the spamWords constant and add your own spam words in the Constants.
Example Constants¶
plugin.tt_board {
spamWords := addToList(bad phrase, V1agra, http)
}
Collect the IP addresses of the users which sent too many spams and protect your whole website by putting those IP addresses into your .htaccess file. Or insert it inside of the Directory clauses of an apache config file. See http://www.javascriptkit.com/howto/htaccess5.shtml
Example .htaccess¶
...
order allow,deny
deny from 195.225.177.12 87.118.112.253 81.177.14.45
allow from all
...
Privacy Policy¶
You must set the constant PIDprivacyPolicy
to the page id which shows your DSGVO or GDPR information. This is a legal requirement. You must use a front end registration extension to register the users. They must already have agreed to your privacy policy.
If you use the forum without logged in front end users, then a privacy policy checkbox will appear in the forum entry form. You can overwrite the default texts by the _LOCAL_LANG
setup.
Example Setup¶
plugin.tt_board_list {
_LOCAL_LANG.default {
privacy_policy.title = PRIVACY AGREEMENT
privacy_policy.acknowledgement = The GDPR is applied.
privacy_policy.approval_required = You must approve it.
privacy_policy.acknowledged = You acknowledge to have read the privacy policy.
privacy_policy.acknowledged_2 = You acknowledge that your entered data may be processed according to GDPR.
privacy_policy.hint = You can withdraw this again.
privacy_policy.hint_1 = Just send us an email and your personal data will be removed.
}
}
You must alternatively use plugin.tt_board_tree
for the tree type forum. plugin.tt_board_list
is only used for the list type forum.
Captcha¶
Install the extension sr_freecap. The default constants is empty. Set the constants to captcha = freecap
. This will enable the display of a captcha display in your post forms.
An alternative is the extension captcha. Set the constants to captcha = captcha”
.
Files¶
File | Description |
---|---|
template folder | Example templates. |
board_template1.tmpl | default for the static template ‘plugin.tt_board_list’. |
board_template2.tmpl | default for the static template ‘plugin.tt_board_tree’. |
board_template3.tmpl | listing of the posts in a thread. |
FAQ¶
memberOfGroups must be set correctly. This is set by default to 1 because of the danger of spam.