Help:Wiki-style forums

DPLforum
Version	3.6.1
Author(s)	Ross McClure
Extension link	MediaWiki.org
Description
DPL-based forum extension
Default?
UCP?
GP?

Fandom's wiki-style forums are pages that contain automatically organized indexes of other pages, based on the DPLforum extension. To engage readers and editors in conversation, please note that Fandom generally recommends the use of the mobile-friendly Discussions feature over this version of forums.

In the default installation, the main page of the forum contains an index of all sub-forums. Each sub-forum is a page that contains an index of the conversation threads that belong to that particular forum. Conversation threads are put in sub-forums via using categories.

The default main page is named "Forum:Index". There are two default sub-forums: "Forum:Help desk" (for help topics) and "Forum:Watercooler" (for discussing the wiki). You can customize your sub-forums with different names, or add additional sub-forums.

Note: This page assumes that the standard wiki-style forum setup already exists on your wiki. In some cases, the initial setup will need to be done manually - see Help:Wiki-style forums/set up.

How do I use the forums?

Conversation threads are listed in the sub-forums. Each forum has an input box that allows you to type a title for a new conversation thread and press a button to create it.

The new thread is an ordinary wiki page, and it is preloaded with a template. This template ensures that the page has the correct category for indexing in the corresponding forum. It is important that you do not delete this template when you write your message.

Once the page is saved, it is an ordinary page in the "Forum:" namespace, and it will be a new thread listed on the sub-forum's index page. Other contributors can then edit and add to the page, similar to other pages. Pages with new messages are moved to the top of the list. They are also shown in bold and with a icon if the appropriate CSS and image have been added to the wiki as described in Help:Wiki-style forums/set up.

To add your own comments to a conversation: click the "edit" button, use one or more colons (:) to indent your comments beneath the comment you are replying to, and sign your name and the date/time by typing four tildes (~~~~) or clicking the "signature" button above the edit box or the equivalent markup symbol below it (in the 2010 Source editor only).

You can view all recent changes for the forum by clicking the link above the forum list.

How do I add new sub-forums?

Small communities may not need sub-forums other than "Help Desk" and "Watercooler", but as your community grows you may want to add new ones to address particular topics.

Step 1

A new forum can be added by editing Forum:Index on your community.

To add a forum, copy the following code from this page to Forum:Index on your wiki, after the previous </forum> tag if there are any.

<forum>
  namespace=Forum
  category=Name of forum
  title=Forum:Name of forum
  shownamespace=false
  addlasteditor=true
</forum>

The only part of this code that needs editing is the "Name of forum" after category= and title=Forum:. This can be set as anything you choose, and will show in the index and in the navigation links at the top of each page.

Step 2

Once this is saved, there will be a link to the new forum page. Go to this page, edit it, and copy this code:

<div class="forumheader">'''Forums:''' [[Forum:Index|Index]] > {{PAGENAME}}</div><br />

[[Special:Recentchangeslinked/Category:{{PAGENAME}}|View recent changes for this forum]]

----
<table width="100%"><tr><td><!-- You could create (or transclude) a forum header here --></td>
<td width="50%">
<inputbox>
type=create
break=no
prefix=Forum:
preload=Template:Forumheader/{{PAGENAME}}
buttonlabel=Add new topic
</inputbox>
</td>
</tr>
</table>
<table class="forumlist" width="100%"><tr><th class="forum_title" align="left">Topic</th>
<th class="forum_edited" align="left">Last Edit</th>
<th class="forum_editor" align="left">Last Author</th></tr>
<forum>
namespace=Forum
category={{PAGENAME}}
shownamespace=false
addlasteditor=true
</forum>
</table>

[[Category:Forums]]

Nothing usually needs changing in this text.

However, there is occasionally an issue with {{PAGENAME}} in the preload= section. If you find the template not preloading, change this to the name of the template specifically. So if the Forum name is Forum:Gossip, create the preload template as Template:Forumheader/Gossip and change the preload line to preload=Template:Forumheader/Gossip.

Step 3

The next step is to create a template called Template:Forumheader. If this template is already created, skip this step.

<div class="forumheader">'''Forums:''' [[Forum:Index|Index]] > [[Forum:{{{1}}}|{{{1}}}]] > {{PAGENAME}}</div><br />

[[Category:{{{1}}}]]
<noinclude>
[[Category:Forums]]
</noinclude>

Step 4

The last thing to do is to set up a template to be loaded when someone adds a page to the new forum. This should be at "Template:Forumheader/Name of forum", changing the name to the same forum name you used in the index. This should contain the following:

{{Forumheader|Name of forum}}

<!-- Please put your content under this paragraph.  Be sure to sign your edits with four tildes ~~~~ -->

Again, "Name of forum" needs to be changed to the new forum's name. Once this is saved, the forum is complete.

Can I customize the forums further?

Appearance and list

As with many elements of Fandom wikis, many aspects of this can be changed. The layout, the template style, the items shown in the index, the new messages icon, etc. You could, for example, have an image appear automatically at the top of each page added, or have new messages show in red text.

Sub-sub-forums

It's also possible to use the same code as above to make sub-sub-forums such as "Forum:Help/technical". For this, the first code should be put into the parent forum page instead of the index.

The input box forms can have an instructional template displayed above the edit box, using the "editintro" parameter. See Help:Inputbox for details.

Sticky threads

The DPL forums are just a list of pages in a specific category. If you want a stickied thread, just set up your own second category, called something like "stickied threads" and add it to that category too, and just make another DPLforum call at the top of your forum index page to list pages that are in forum "ForumName" AND "Stickied threads". A good idea would be to build into your forum header template something where you could just add |sticky=1 and let the template take care of it.

Using multiple pages

You can also setup pagination links, to split the forum index into multiple pages. See Extension:DPLforum for the #forumlink and <forum>…</forum> syntax.

Additional Notes

• If you see strange output from your wiki-style forum, try putting ?action=purge (or &action=purge, if ? is already used) at the end of your URL and reload the URL. This can fix problems where DPL or DPLforum backend code was updated, but the server cache was not refreshed.
• On some legacy communities, the "Forum:" namespace is in an archived state, due to past usage of the Forum feature. An admin can contact Fandom staff to have the archived state removed.

See also

• Help:Discussions - Fandom's newer cross-platform conversation feature

Further help and feedback

• Browse and search other help pages at Help:Contents
• Check Fandom Community Central for sources of further help and support
• Check Contacting Fandom for how to report any errors or unclear steps in this article