Adding locale support forums (with HelpHub)

This is the process the Polyglots Leadership team uses to create new localeLocale Locale = language version, often a combination of a language code and a region code, for instance es_MX denotes Spanish as it’s used in Mexico. A list of all locales supported by WordPress in https://make.wordpress.org/polyglots/teams/ 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 URLURL A specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org field
  • Enter a site title
  • Enter the default wordpress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/ email address for Admin Email
  • Select “Is the site a RosettaRosetta The code name of the theme for the local WordPress sites (eg. bg.wordpress.org is a “Rosetta” site). All locale specific WordPress sites are referred to as “Rosetta sites.” The name was inspired from the ancient Rosetta Stone, which contained more or less the same text in three different languages. forum?”
  • Connect with Jetpack
  • Request #support team to update the Support Forums in Your Language page

Top ↑

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

Top ↑

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/

Top ↑

Add HelpHub

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

  • Go to “Plugins”
  • Activate “Support HelpHub” pluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party
  • 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

Top ↑

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”

Last updated: