Help:DiscussionTools

From mediawiki.org

This will be the help page for Wikipedia editors and other end users who are using DiscussionTools .

Reply tool[edit source]

Links are added after each comment for posting quick replies to existing discussions.

Getting started[edit source]

Screenshot of the visual mode
  1. At the end of each signed message, there will be a [ reply ] link. Click that link to reply to the message.
  2. A box will open. Your message will be placed where the box is located.
  3. Type your reply in the box. Your signature and the date will be added to your reply automatically.
  4. When you are ready to post your reply, click the Reply button.

Features[edit source]

  • You can switch between visual and wikitext source editing modes.
  • In the wikitext source mode, a live preview shows what your message will look like while you are typing it.
  • In both the source and visual modes, you can use keyboard shortcuts to make links, to @-mention the person you're replying to, and to add character formatting.

Limitations[edit source]

  • As of 2021, this tool does not work with multi-line templates or wikitext codes that must be placed at the start of a line (e.g., wikitext table syntax). You will not be able to switch to visual mode if your comment contains this syntax. See reply tool visual mode limitations.
  • The tool will only show on:
    • Pages in talk namespaces
    • Pages in namespaces which have been configured to show the 'add signature' tool ($wgExtraSignatureNamespaces). For most Wikimedia wikis this is the project and help namespaces.
    • Pages which have manually added the Add topic button using __NEWSECTIONLINK__
  • The reply tool is visible when it detects a link to a user account and a timestamp on the same line. Some custom signatures will not be detected. See Why can't I reply to this comment?.

To get help with a specific question you have about subscribing to conversations, please post it here: Talk:Talk pages project.

New topic tool[edit source]

Starting a new topic[edit source]

Screenshot of new topic tool
  1. At the top of the page, click the "Add topic" tab.
  2. A box will open at the end of the page. Your message will be placed where the box is located.
  3. Type a subject heading in the box, where it says "Subject". A subject heading is required.
  4. Type your message in the big box. Your signature and the date will be added to the end of your message automatically.
  5. When you are ready to post your message, click the Add topic button.

Features and limitations[edit source]

The features and limitations are very similar to the features and limitations of the reply tool. Complex formatting, such as tables, is allowed.

  • You can switch between visual and wikitext source editing modes.
  • In the wikitext source mode, a live preview shows what your message will look like while you are typing it.
  • In both the source and visual modes, you can use keyboard shortcuts to make links, to @-mention other people, and to add character formatting.

To get help with a specific question you have about subscribing to conversations, please post it here: Talk:Talk pages project.

Mobile[edit source]

This option provides the reply tool and the new topic tool on the mobile web site. It offers automatic signing.

Limitations[edit source]

  • Using the reply tool requires "Read as wiki page".
  • The comment box shows vertical placement of your comment. It does not show horizontal placement ("indentation"). This is because many mobile screens are narrow.

Topic subscriptions[edit source]

A screenshot showing the location of the button, at the end of the section heading
Click the [ subscribe ] button at the top of the section.

The topic subscriptions feature adds a link to [ subscribe ] at the end of the discussion section headings. Click the [ subscribe ] link to receive notifications if and when new comments are added to that section in the future.

You can enable automatic topic subscriptions in Preferences → Discussion pages. If you begin a new discussion or post a comment in a discussion, you will automatically be subscribed to that discussion.

After you have subscribed to this section, there will be an [ unsubscribe ] link. Click that to stop receiving notifications about new comments in that section.

You can also elect to be automatically subscribed to any discussion you start or comment in by visiting Preferences → Discussion pages and enabling the Automatically subscribe to topics setting.

Only edits made with the reply and new topic tools will cause you to be automatically subscribed.
A screenshot showing the notifications someone will see when new comments are posted in a talk page section they have subscribed to.
Notifications for new comments posted in a talk page section someone has subscribed to.

You can see a list of your subscriptions at Special:TopicSubscriptions.

Notes[edit source]

  • Notifications are based on the first comment and its timestamp. Changes to the section heading do not affect the subscription.
  • You can only subscribe to a ==Level 2 section==.
  • You will receive notifications about new comments regardless of the editing interface used to post them.
  • Subscriptions will remain intact even when conversations are moved to other pages or the section heading changes.
  • You can read technical information at Extension:DiscussionTools/How it works#Notifications.

To get help with a specific question you have about subscribing to conversations, please post it here: Talk:Talk pages project.

Information and appearance[edit source]

Discussion pages will show additional information about each section. Discussion pages will not look the same as article pages, to help newcomers recognize them as places for talking to other users.

New features[edit source]