FANDOM


m (r2.7.2) (Robot: Adding es:Ayuda:Foro de estilo wiki)
(Added back statement that is still possible.)
 
(55 intermediate revisions by 37 users not shown)
Line 1: Line 1:
[[Image:Wiki Forums.png|thumb|A screenshot of the Wiki Forums.]]
+
{{tocright}}Fandom's '''wiki-style forums''' are pages that contain automatically organized indexes of other pages, based on the [[mw:Extension:DPLforum|DPLforum]] extension. To engage readers and editors in conversation, please note that Fandom generally recommends the use of the mobile-friendly [[Help:Discussions|Discussions]] feature over this version of forums.
{{tocright}}
 
{{enabled by default}}
 
   
Wikia's '''wiki-style forums''' are wiki pages that contain automatically organized indexes of other pages, based on the [http://www.mediawiki.org/wiki/Extension:DPLforum DPLforum] extension.
+
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.
   
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 discussion topics that belong to that particular forum. Discussion topics are pages whose category places them in one of the sub-forums.
+
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.
   
The default main page is named "Forum:Index". There are two default sub-forums, named "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]].''
 
:'''''Note:''' This page assumes that the standard wiki-style forum setup already exists on your Wikia. This happens automatically for new wikis, but sometimes has to be done manually for older ones. See [[Help:Wiki-style forum set up{{#ifexist:Forum:Index|]]|]] or ask a member of the [[Help:Community Team|Community Team]] for help if [[Forum:Index]] is blank in your wiki}}.''
 
   
 
==How do I use the forums?==
 
==How do I use the forums?==
The existing discussion topics are listed in the sub-forums. Each such forum has an input box that allows you to type a title for a new discussion topic and press a button to create it. The discussion topic is an ordinary wiki page, that is preloaded with a [[Help:Preloaded template|template]]. This template ensures that the page has the correct category for indexing in the corresponding forum. It's important not to delete this template when you write your message.
+
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 [[Help:Preloaded templates|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:" [[Help:Namespaces|namespace]] and has become a new thread listed on the sub-forum's index page. Other contributors can then edit and add to the page in the same way as to other wiki pages. Pages with new messages are moved to the top of the list, and are shown in bold and with an [[File:Forum new.gif]] icon.
+
Once the page is saved, it is an ordinary page in the "Forum:" [[Help:Namespace|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 [[File:Forum new.gif]] 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 discussion, click "edit" as with any other wiki page, 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 (<nowiki>~~~~</nowiki>) or clicking the "signature" button above the edit box or the equivalent markup symbol below it.
+
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 (<nowiki>~~~~</nowiki>) 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.
 
You can view all recent changes for the forum by clicking the link above the forum list.
Line 20: Line 20:
   
 
===Step 1===
 
===Step 1===
A new forum can be added by editing [[Forum:Index]] on your wiki.
+
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 Wikia, after the previous <code><nowiki></forum></nowiki></code> tag if there are any.
+
To add a forum, copy the following code from this page to '''Forum:Index''' on your wiki, after the previous <code><nowiki></forum></nowiki></code> tag if there are any.
   
<nowiki><forum>
+
<pre>
namespace=Forum
+
<forum>
category=</nowiki><span style="color:red">Name of forum</span><nowiki>
+
namespace=Forum
title=Forum:</nowiki><span style="color:red">Name of forum</span><nowiki>
+
category=Name of forum
shownamespace=false
+
title=Forum:Name of forum
addlasteditor=true
+
shownamespace=false
</forum></nowiki>
+
addlasteditor=true
  +
</forum>
  +
</pre>
   
The only part of this code that needs editing is the "Name of forum" after "category" and "title". 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.
+
The only part of this code that needs editing is the "Name of forum" after <code>category=</code> and <code>title=Forum:</code>. 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===
 
===Step 2===
Once this is saved, there will be a link to the new forum page. Go to this page, edit it, and copy in this code:
+
Once this is saved, there will be a link to the new forum page. Go to this page, edit it, and copy this code:
   
<nowiki><div class="forumheader">'''Forums:''' [[Forum:Index|Index]] > {{PAGENAME}}</div><br />
+
<pre>
  +
<div class="forumheader">'''Forums:''' [[Forum:Index|Index]] > {{PAGENAME}}</div><br />
   
[{{fullurl:Special:Recentchangeslinked/Category:{{PAGENAME}}}} View recent changes for this forum]
+
[[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>
 
<table width="100%"><tr><td><!-- You could create (or transclude) a forum header here --></td>
 
<td width="50%">
 
<td width="50%">
<createbox>
+
<inputbox>
  +
type=create
 
break=no
 
break=no
 
prefix=Forum:
 
prefix=Forum:
preload=Template:Forumheader/</nowiki><span style="color:red"><nowiki>{{PAGENAME}}</nowiki></span><nowiki>
+
preload=Template:Forumheader/{{PAGENAME}}
 
buttonlabel=Add new topic
 
buttonlabel=Add new topic
</createbox>
+
</inputbox>
 
</td>
 
</td>
</tr></table>
+
</tr>
  +
</table>
 
<table class="forumlist" width="100%"><tr><th class="forum_title" align="left">Topic</th>
 
<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_edited" align="left">Last Edit</th>
Line 60: Line 60:
 
shownamespace=false
 
shownamespace=false
 
addlasteditor=true
 
addlasteditor=true
</forum></table>
+
</forum>
  +
</table>
   
 
[[Category:Forums]]
 
[[Category:Forums]]
</nowiki>
+
</pre>
   
Nothing usually needs changing in this text. ''However, there is occasionally an issue with <nowiki>{{PAGENAME}}</nowiki> in the preload= section (highlighted in red). 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'''.''
+
Nothing usually needs changing in this text.
  +
  +
''However, there is occasionally an issue with <code><nowiki>{{PAGENAME}}</nowiki></code> in the <code>preload=</code> 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 '''<code>preload=Template:Forumheader/Gossip</code>'''.''
   
 
===Step 3===
 
===Step 3===
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:
+
The next step is to create a template called '''Template:Forumheader'''. If this template is already created, skip this step.
  +
<pre>
  +
<div class="forumheader">'''Forums:''' [[Forum:Index|Index]] > [[Forum:{{{1}}}|{{{1}}}]] > {{PAGENAME}}</div><br />
   
<nowiki>{{Forumheader|</nowiki><span style="color:red">Name of forum</span><nowiki>}}
+
[[Category:{{{1}}}]]
  +
<noinclude>
  +
[[Category:Forums]]
  +
</noinclude>
  +
</pre>
   
<!-- Please put your content under this paragraph. Be sure to sign your edits with four tildes ~~~~ --></nowiki>
+
===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:
   
Again, "Name of forum" needs to be changed to the new forum's name. Once this is saved, the forum is complete.
+
<pre>
  +
{{Forumheader|Name of forum}}
   
===Step 4===
+
<!-- Please put your content under this paragraph. Be sure to sign your edits with four tildes ~~~~ -->
You can setup pagination links, to split the forum index into multiple pages.
+
</pre>
   
See details at the extension page
+
Again, "Name of forum" needs to be changed to the new forum's name. Once this is saved, the forum is complete.
http://www.mediawiki.org/wiki/Extension:DPLforum#Multipage_support_with_.23forumlink
 
   
 
==Can I customize the forums further?==
 
==Can I customize the forums further?==
  +
 
===Appearance and list===
 
===Appearance and list===
As with many elements of Wikia, many aspects of this can be changed. The layout, the template style, the items shown in the index, the new messages icon .... You could, for example, have an image appear automatically at the top of each page added, or have new messages show in red text.
+
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===
 
===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.
+
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.
+
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===
 
===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 <code><nowiki>|sticky=1</nowiki></code> and let the template take care of it.
+
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 <code>|sticky=1</code> 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 [[mw:Extension:DPLforum|Extension:DPLforum]] for the [[mw:Extension:DPLforum#Multipage_support_with_.23forumlink|#forumlink]] and <code><nowiki><forum>&hellip;</forum></nowiki></code> syntax.
   
==Related Links==
+
==Additional Notes==
* [[Help:Wiki-style forum set up]]
+
* If you see strange output from your wiki-style forum, try putting <code>?action=purge</code> (or <code>&action=purge</code>, if <code>?</code> 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.
<!--* [[Help:Message board forums|Help:Message board forums]]-->
+
* On some legacy communities, the "Forum:" namespace is in an archived state, due to past usage of the [[Help:Forum|Forum]] (Special:Forum—not available on the UCP) feature. An admin can [[Special:Contact|contact Fandom staff]] to have the archived state removed only if the [[Help:Forum|Forum]] is removed.
   
[[Category:Help|Forums]]
+
==See also==
[[Category:Forum help|{{PAGENAME}}]]
+
* [[Help:Discussions]] - Fandom's newer cross-platform conversation feature
  +
* [[Help:Forum]]
   
[[de:Hilfe:Foren]]
+
==Further help and feedback==
  +
{{Help and feedback section}}[[de:Hilfe:Forum-Seiten]]
 
[[es:Ayuda:Foro de estilo wiki]]
 
[[es:Ayuda:Foro de estilo wiki]]
 
[[fr:Aide:Forums de type wiki]]
 
[[fr:Aide:Forums de type wiki]]
  +
[[ja:ヘルプ:ウィキスタイルフォーラム]]
 
[[nl:Help:Wiki-stijl forums]]
 
[[nl:Help:Wiki-stijl forums]]
[[pt:Ajuda:Fóruns ao estilo wiki]]
+
[[pl:Pomoc:Forum w stylu wiki]]
[[ru:Справка:Форумы]]
+
[[pt:Ajuda:Fóruns estilo-wiki]]
  +
[[ru:Справка:Вики-форум]]
  +
[[tr:Yardım:Wiki stili forumları]]
  +
[[uk:Довідка:Вікі-форум]]
  +
[[zh:Help:Wiki格式论坛]]
  +
[[Category:Help|{{PAGENAME}}]]

Latest revision as of 01:37, September 19, 2020

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?Edit

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 Forum new 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?Edit

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 1Edit

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 2Edit

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 3Edit

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 4Edit

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?Edit

Appearance and listEdit

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-forumsEdit

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 threadsEdit

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 pagesEdit

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 NotesEdit

  • 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 (Special:Forum—not available on the UCP) feature. An admin can contact Fandom staff to have the archived state removed only if the Forum is removed.

See alsoEdit

Further help and feedbackEdit

Community content is available under CC-BY-SA unless otherwise noted.