pforum
jweiland/pforum
main
en
Stefan Froemken, Hoja Mustaffa Abdul Latheef
This document is published under the Creative Commons BY 4.0 license.
Tue, 08 Sep 2026 15:14:59 +0000
With pforum you can add a small forum to your TYPO3 website.
Table of Contents:
pforum is a very tiny forum extension for TYPO3 CMS.
fe_users ) is assigned to topics and postsPlease keep in mind that we don't want to provide a full-featured forum extension. If you need one, please use the forum extension by Mittwald.
Create a page
First of all, you need a page where you can add the pforum plugin.
Add the plugin
Switch to the Page module and select your newly created page in the page tree. Click the "+ Content" button
to open the Content Element Wizard. Switch to the Plugin tab and click the panel named Forum to add the
plugin to the page.
Configure the plugin
If you want, you can give the content element a name and configure a different detail page on the Plugin
tab.
Save
Don't forget to save your record.
It's your job to create forum records that users can create topics and posts in. A forum record is meant to be a category or discussion topic, such as "Let's talk about cars", "Sell and buy", or simply "Windows 11".
Create storage
Create a new page of type "Storage Folder" in the page tree.
Create a forum record
Switch to the List module and choose your newly created storage folder from the page tree. In the right-hand
frame, click the + button in the upper left. Look for the Forum section and click Forum from the list
to create a new forum record.
Fill in the title (required) and teaser fields. Don't add any teaser records yourself — that's the job of your users in the frontend.
If your TYPO3 installation runs in Composer mode, please execute the following command:
composer req jweiland/pforum
vendor/bin/typo3 extension:setup --extension=pforumIf you work with DDEV please execute this command:
ddev composer req jweiland/pforum
ddev exec vendor/bin/typo3 extension:setup --extension=pforumOn TYPO3 installations that don't run in Composer mode, you can still install pforum via the Extension Manager:
Log in
Log in to the backend of your TYPO3 installation as an administrator or system maintainer.
Open the Extension Manager
Click on Extensions in the left-hand menu to open the Extension Manager.
Update extensions
Choose Get Extensions from the upper select box and click the Update now button in the upper right.
Install pforum
Use the search field to find pforum. Select the pforum entry from the search results and click the cloud
icon to install pforum.
Some general settings for pforum can be configured in Admin Tools > Settings.
Default: <empty>
Define the email address that is used to inform users about new topics and posts.
If this value is empty, pforum tries to use the email address from
$GLOBALS. If this is not set either, sending an email
fails with an exception.
Default: <empty>
Define the sender name that is used to inform users about new topics and posts.
If this value is empty, pforum tries to use the sender name from
$GLOBALS. If this is not set either, sending an email
fails with an exception.
pforum needs some basic TypoScript configuration. To do so, you have to add an extension template
("+ext template") to either the root page of your website or to the specific page that contains the pforum
plugin.
Locate the page
Decide where you want to insert the TypoScript template. Either the root page or the page with the pforum
plugin works fine.
Create a TypoScript template
Switch to the Template module and select the page you chose above in the page tree. Choose
Click here to create an extension template from the right-hand frame. In the TYPO3 community, this is also
known as an "+ext template".
Add the static template
Choose Info/ from the upper select box and then click the Edit the whole template record button
below the small table. On the Includes tab, locate the Include static section. Use the
search field below Available items to search for pforum. Usually only one record is shown. Select it to
move that record to the left.
Save
If you want, give the template a name on the General tab, then save and close it.
Open the Constant Editor
Choose Constant Editor from the upper select box.
pforum constants
Choose PLUGIN. from the category select box to show only pforum-related constants.
Configure constants
Adapt the constants to your needs.
Configure TypoScript
Since constants only allow you to modify a fixed selection of TypoScript, switch back to Info/ and
click Setup. Here you can configure all pforum-related settings.
Default: Value from constants EXT:
You can override our templates with your own site package extension. We recommend changing this value in the TypoScript constants.
Default: Value from constants EXT:
You can override our partials with your own site package extension. We recommend changing this value in the TypoScript constants.
Default: Value from constants EXT:
You can override our layouts with your own site package extension. We recommend changing this value in the TypoScript constants.
Set this value to a Storage Folder (PID) where you have stored the records.
Example: plugin.
Default: 1 (no authentication)
Example: plugin.
Define whether creating new topics and posts requires an authenticated frontend user.
1: No authentication. Everyone can create topics and posts. We recommend this for intranet environments.2: An authenticated frontend user is required to create topics and posts.Note
If you choose 1, a new pforum user record is created for every topic and post.
Default: 0
Example: plugin.
If activated, an additional input field is displayed where the user must enter a valid email address.
Useful in case of auth = 1. The email address is added to the pforum user record.
Default: 0
Example: plugin.
If activated, an additional input field is displayed where the user must enter a username.
Useful in case of auth = 1. The username is added to the pforum user record.
Default: 0
Example: plugin.
If activated, two additional upload fields are added to the form for new topics and posts.
Default: 0
Example: plugin.
By default, you, as an administrator, have to modify or delete topic and post records in the TYPO3 backend. With this setting you can define a frontend user group that should act as an administrator to edit and delete records in the frontend.
Default: 0
Example: plugin.
If authentication is required (auth = 2), you have to define a frontend user group that is allowed to create
new topics and posts.
Default: 0
Example: plugin.
By default, all detail views are displayed on the same page as the forum record list. For design reasons, it may make sense to define a dedicated detail view page.
Default: 0
Example: plugin.
By default, every new topic created in the frontend is directly visible. If you want to prevent this, activate this option — an administrator will then have to review the topic first.
Default: 0
Example: plugin.
By default, hidden records can only be activated by a backend editor. If you want your frontend administrator to be able to enable hidden topics, activate this option here.
Default: 0
Example: plugin.
By default, every new post created in the frontend is directly visible. If you want to prevent this, activate this option — an administrator will then have to review the post first.
Default: 0
Example: plugin.
By default, hidden records can only be activated by a backend editor. If you want your frontend administrator to be able to enable hidden posts, activate this option here.
Default: 1:user_upload/tx_pforum/
Example: plugin.
Only valid if you have activated use. Define the default storage location for uploaded images in the
frontend.
Default:
settings.image {
width = 120c
height = 90c
minWidth = 120
maxWidth = 120
minHeight = 90
maxHeight = 90
}With these values you can manipulate the topic and post image size.
Default: 15
Example: plugin.
If there are a lot of records, the page browser helps you navigate through all these records. Define the maximum number of records to display per page.
pforum comes with its own administration module.
Here an administrator, or an editor with the appropriate permissions, can activate hidden topic and post records.
If settings. and settings. are deactivated in TypoScript, you can hide
this module for editors, since it serves no purpose in that case.
Currently, we don't have any route configuration here. There is no slug field in the frontend forms for topics and posts, so there is currently no way to create human-readable URLs. We may add a slug field to the forum records, since these records are created in the backend.
Please file an issue ticket for this if you're interested.
If you update pforum to a newer version, please read this section carefully!
#[FileUpload] attribute instead of a custom
PropertyMappingConfiguration type converter. If you have overridden Resources/Private/Partials/Post/FormFields.html
or Resources/Private/Partials/Topic/FormFields.html in your own site package, replace the two indexed
<f:form.upload name="{post}[images][0]" /> / [1] fields with a single
<f:form.upload property="images" multiple="1" /> field and adjust your template accordingly.Topic::getCrdate() and Post::getCrdate() now return ?DateTime instead of DateTime . If your own code
or overridden templates rely on a non-nullable creation date, add a null check.We have changed many parts of the Fluid templates. Please check the image and link sections in your overridden templates and adjust them accordingly.
Currently, there are no known problems.
settings.new.uploadFolder TypoScript/FlexForm setting to Post/Topic file uploads again,
which had no effect since the migration to the native FileUpload API