Jump to content

Extension:WikiForum

From mediawiki.org
MediaWiki extensions manual
WikiForum
Release status: unstable
Implementation Database , Special page
Description Forum extension
Author(s)
Latest version 2.5.1 (2019-03-22)
MediaWiki 1.39+
Database changes Yes
License GNU General Public License 3.0 or later
Download
  • $wgWikiForumAllowAnonymous
  • $wgWikiForumLogInRC

  • ‎<WikiForumList>
  • ‎<WikiForumThread>
  • wikiforum-admin
  • wikiforum-moderator
Quarterly downloads 7 (Ranked 133rd)
Translate the WikiForum extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The WikiForum extension adds a discussion forum in the form of a new special page, Special:WikiForum. WikiForum pages for the most part are indexed by search engines (such as Google) and you can search them by using WikiForum's internal search.

If the SocialProfile extension is installed, its avatars will be displayed on forum threads. Currently WikiForum has no built-in avatar support.

Please see the WikiForum help page on ShoutWiki for more information.

Installation

  • Download and move the extracted WikiForum folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/WikiForum
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'WikiForum' );
    
  • Run the update script which will automatically create the necessary database tables that this extension needs.
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration

In the original WikiForum, there were plenty of configuration globals. Most of these have been removed in favor of configuration done via the MediaWiki namespace.

Parameter Default value Description
$wgWikiForumAllowAnonymous true Allow anonymous users to write threads and replies?
$wgWikiForumLogsInRC true Show WikiForum logs at Special:RecentChanges?

CAPTCHAs have now been integrated into WikiForum. If Extension:ConfirmEdit is installed, CAPTCHAs will be shown to users without the skipcaptcha permission. You may need to set $wgCaptchaTriggers['wikiforum'] = true; in LocalSettings.php below where ConfirmEdit is required in order for CAPTCHAs to show. To disable CAPTCHAs, simply set that to false.

User rights

WikiForum adds two new user rights, wikiforum-admin and wikiforum-moderator. Users with the wikiforum-admin permission can create, delete and edit categories and forums, while the wikiforum-moderator permission is required to edit and delete threads and individual replies.

By default administrators (the sysop group) have both of these rights. WikiForum also creates a new group, forumadmin, which has both of these user rights. Bureaucrats can assign users to the forumadmin group and remove them from the group.

See also