Adding locale support forums (with HelpHub)


This is the process the Polyglots Leadership team uses to create new locale forums on requests by users. To request a new forum, please post a request on https://make.wordpress.org/polyglots (examples).

Add New Forums

To create a new forum go to:

  • The Global Site Network > Add New
  • Enter the associated subdomain of the locale in the URL field
  • Enter a site title
  • Enter the default wordpress.org email address for Admin Email
  • Select “Is the site a Rosetta forum?”
  • Connect with Jetpack
  • Request #support team to update the Support Forums in Your Language page

Add Forum Keymasters

If you are creating forums just so the local team can add HelpHub (but they are not planning to use forums), you don’t need to add any keymasters.

To add keymasters to the new site:

  • Go to the Rosetta Forums site > Add New User
  • Add users as both Subscriber (site role) & Keymaster (forum role)
  • Select the checkbox for not sending a confirmation email

Forums Setup

Send the following message so they can set up the site:

You can now log into your team’s forums from here:
https://LOCALE.wordpress.org/support/wp-admin/

Please go to https://LOCALE.wordpress.org/support/wp-admin/edit.php?post_type=forum and add forums (categories of topics). For example, there are 9 English forums such as “Installing WordPress”.
https://wordpress.org/support/forums/

Add HelpHub

After adding forums site, go to the dashboard of the locale’s /support:

  • Go to “Plugins”
  • Activate “Support HelpHub” plugin
  • Activate “SyntaxHighlighter Evolved” plugin
  • Go to the requesting user’s support profile page (e.g. https://XX.wordpress.org/support/users/USERNAME/)
  • Assign them “HelpHub Manager” role

Importing Content

  • Go to https://wordpress.org/support/wp-admin/export.php and export “Articles” only
  • Go back to the Plugins screen of the newly added Rosetta /support site
  • Enable “WordPress Importer” and “Importing to WordPress.org” plugins
  • Go to Tools > Import > (WordPress.org) Run Importer and upload file
  • Check “Download and import file attachments”
  • Once the import is done, go to Articles post type list
  • Bulk edit all of the Articles posts and turn on the comments (for feedback) & set the status to “Draft”
  • Turn off both of the importer plugins
  • Bulk update the status of all imported content to “Pending Review”