Environments: Add support forums environment.

environments/README.md

@@ -154,6 +154,44 @@ npm run translate:env -- run cli -- wp <command>
 
 **Local overrides:** create `translate/.wp-env.override.json` (git-ignored) to override config values like `WP_HOME` / `WP_SITEURL` for testing behind a custom hostname.
 
+### Support Forums
+
+A local instance of the WordPress.org Support Forums with bbPress, the support theme, and supporting plugins.
+
+**Start:**
+
+```bash
+npm run support:env start
+```
+
+First start automatically sets up a multisite network, creates sub-sites for Plugins (`/plugins`) and Themes (`/themes`), and provisions the default user accounts.
+
+**Note that these plugin and theme directories are only used for forum references, not for development of the respective environments.**
+
+**Access:** `http://localhost:8888`
+
+**WP CLI:**
+
+```bash
+npm run support:env -- run cli -- wp <command>
+```
+
+**User accounts:**
+
+All accounts use the password `password`.
+
+| Username | Forum role | Notes |
+|---|---|---|
+| `admin` | Network administrator | Full network admin access |
+| `keymaster` | `bbp_keymaster` | Top-level forum admin; can manage all forum content |
+| `moderator` | `bbp_moderator` | Can moderate topics and replies |
+| `pluginauthor` | `bbp_participant` | Subscriber on the Plugins sub-site |
+| `plugincontributor` | `bbp_participant` | Subscriber on the Plugins sub-site |
+| `pluginsupport` | `bbp_participant` | Plugin support rep; subscriber on the Plugins sub-site |
+| `themeauthor` | `bbp_participant` | Subscriber on the Themes sub-site |
+| `themesupport` | `bbp_participant` | Theme support rep; subscriber on the Themes sub-site (unused) |
+| `visitor` | `bbp_participant` | Regular site visitor |
+
 ### Handbook (in-plugin)
 
 The Handbook plugin has its own `.wp-env.json` in `wordpress.org/public_html/wp-content/plugins/handbook/`.

environments/mocks/mu-plugins/wporg-two-factor-fns-stub.php

@@ -21,3 +21,14 @@ function get_onboarding_account_url() {
 		return home_url( '/' );
 	}
 }
+
+if ( ! function_exists( __NAMESPACE__ . '\get_edit_account_url' ) ) {
+	/**
+	 * URL for editing account details via the new two-factor interface. Points at the local home.
+	 *
+	 * @return string
+	 */
+	function get_edit_account_url( $username = null ) {
+		return home_url( '/' );
+	}
+}

environments/package.json

@@ -20,7 +20,8 @@
 		"browsehappy:env": "wp-env --config browsehappy/.wp-env.json",
 		"translate:env": "wp-env --config translate/.wp-env.json",
 		"translate:import": "npm run translate:env -- run cli -- wp eval-file wp-content/env-bin/import-from-wporg.php",
-		"translate:refresh": "npm run translate:env -- run cli -- wp option delete wporg_translate_env_seeded"
+		"translate:refresh": "npm run translate:env -- run cli -- wp option delete wporg_translate_env_seeded",
+		"support:env": "wp-env --config support-forums/.wp-env.json"
 	},
 	"devDependencies": {
 		"@wordpress/env": "^11"

environments/support-forums/.wp-env.json

@@ -0,0 +1,46 @@
+{
+	"core": "WordPress/WordPress#master",
+	"phpVersion": "8.4",
+	"testsEnvironment": false,
+	"plugins": [
+		"https://downloads.wordpress.org/plugin/bbpress.zip",
+		"https://downloads.wordpress.org/plugin/gutenberg.17.9.0.zip",
+		"https://downloads.wordpress.org/plugin/blocks-everywhere.zip",
+		"../wordpress.org/public_html/wp-content/plugins/wporg-bbp-user-moderation",
+		"../wordpress.org/public_html/wp-content/plugins/wporg-bbp-user-mention-autocomplete",
+		"../wordpress.org/public_html/wp-content/plugins/wporg-bbp-user-badges",
+		"../wordpress.org/public_html/wp-content/plugins/wporg-bbp-topic-resolution",
+		"../wordpress.org/public_html/wp-content/plugins/wporg-bbp-topic-archive",
+		"../wordpress.org/public_html/wp-content/plugins/wporg-bbp-term-subscription",
+		"../wordpress.org/public_html/wp-content/plugins/wporg-bbp-redirect",
+		"../wordpress.org/public_html/wp-content/plugins/wporg-bbp-codexify",
+		"../wordpress.org/public_html/wp-content/plugins/wporg-bbp-code-blocks-expand-contract",
+		"../wordpress.org/public_html/wp-content/plugins/support-forums"
+	],
+	"themes": [
+		"../wordpress.org/public_html/wp-content/themes/pub/wporg-support-2024",
+		"WordPress/wporg-parent-2021#build"
+	],
+	"mappings": {
+		".htaccess": "./support-forums/bin/.htaccess",
+		"wp-content/wporg/style": "../wordpress.org/public_html/style",
+		"wp-content/mu-plugins": "./mocks/mu-plugins",
+		"wp-content/mu-plugins/pub": "../wordpress.org/public_html/wp-content/mu-plugins/pub",
+		"wp-content/mu-plugins/wporg-mu-plugins": "WordPress/wporg-mu-plugins#build",
+		"wp-content/plugins/plugin-directory": "../wordpress.org/public_html/wp-content/plugins/plugin-directory",
+		"wp-content/plugins/theme-directory": "../wordpress.org/public_html/wp-content/plugins/theme-directory"
+	},
+	"lifecycleScripts": {
+		"afterStart": "bash support-forums/bin/after-start.sh"
+	},
+	"config": {
+		"WP_DEBUG": true,
+		"JETPACK_DEV_DEBUG": true,
+		"WPORGPATH": "/var/www/html/wp-content/wporg",
+		"WP_ENVIRONMENT_TYPE": "local",
+		"WPORG_SUPPORT_FORUMS_BLOGID": 1,
+		"WPORG_PLUGIN_DIRECTORY_BLOGID": 2,
+		"WPORG_THEME_DIRECTORY_BLOGID": 3,
+		"PLUGINS_TABLE_PREFIX": "wp_2_"
+	}
+}

environments/support-forums/bin/.htaccess

@@ -0,0 +1,19 @@
+# BEGIN WordPress Multisite
+# Using subfolder network type: https://developer.wordpress.org/advanced-administration/server/web-server/httpd/
+
+RewriteEngine On
+RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
+RewriteBase /
+RewriteRule ^index\.php$ - [L]
+
+# add a trailing slash to /wp-admin
+RewriteRule ^([_0-9a-zA-Z-]+/)?wp-admin$ $1wp-admin/ [R=301,L]
+
+RewriteCond %{REQUEST_FILENAME} -f [OR]
+RewriteCond %{REQUEST_FILENAME} -d
+RewriteRule ^ - [L]
+RewriteRule ^([_0-9a-zA-Z-]+/)?(wp-(content|admin|includes).*) $2 [L]
+RewriteRule ^([_0-9a-zA-Z-]+/)?(.*\.php)$ $2 [L]
+RewriteRule . index.php [L]
+
+# END WordPress Multisite

environments/support-forums/bin/after-start.sh

@@ -0,0 +1,205 @@
+#!/bin/bash
+#
+# Runs after wp-env start. Sets up permalinks, creates pages, and imports plugins.
+#
+
+set -euo pipefail
+
+SETUP_VALIDATION_FILE="/var/www/.wp-env-setup-complete"
+
+CONFIG="--config support-forums/.wp-env.json"
+WP="npx wp-env $CONFIG run cli --"
+WPSUDO="npx wp-env $CONFIG run wordpress -- sudo"
+
+MINIMUM_SUPPORT_PLUGINS=(
+  "bbpress"
+  "gutenberg"
+  "blocks-everywhere"
+  "wporg-bbp-user-moderation"
+  "wporg-bbp-user-mention-autocomplete"
+  "wporg-bbp-user-badges"
+  "wporg-bbp-topic-resolution"
+  "wporg-bbp-topic-archive"
+  "wporg-bbp-term-subscription"
+  "wporg-bbp-redirect"
+  "wporg-bbp-codexify"
+  "wporg-bbp-code-blocks-expand-contract"
+  "support-forums"
+)
+
+# Check if the setup has already been completed.
+if $WPSUDO bash -c "[ -f '$SETUP_VALIDATION_FILE' ]"; then
+  echo "Setup already completed. Skipping first-run environment configuration."
+  exit 0
+fi
+
+###
+# Create multisite framework
+###
+echo "Setting up multisite framework..."
+$WP wp core multisite-convert
+
+# Network enable the themes
+$WP wp theme enable wporg-support-2024 --network
+
+# Set up the main site identity.
+$WP wp option update blogname 'WordPress.org Global Forums'
+
+# Create the Plugins sub-site.
+echo "Creating sub-sites..."
+$WP wp site create --slug=plugins --title="Plugins dependency - WordPress.org Forums"
+
+# Create the Themes sub-site.
+$WP wp site create --slug=themes --title="Themes dependency - WordPress.org Forums"
+
+# Create rosetta support sub-site.
+$WP wp site create --slug=rosetta --title="Rosetta Forums - WordPress.org Forums"
+
+# WordPress, per now, does not properly identify port numbers in multisite URLs when creating
+# sites. Because of this, when we set it up using `wp-env`, followed by a `wp core multisite-convert`
+# from the WP-CLI package, strange things happen.
+# This search-replace is in place to undo the weirdness, and make the environment workable.
+echo "Fixing multisite URLs..."
+$WP wp search-replace 'localhost:8888/:8888' 'localhost:8888' --skip-plugins --skip-themes --all-tables
+$WP wp search-replace 'localhost8888' 'localhost:8888' --skip-plugins --skip-themes --all-tables
+
+###
+# Create the various users we will need
+###
+echo "Creating users..."
+
+# Add a forum keymaster account (User ID 2).
+$WP wp user create keymaster keymaster@example.com --role=subscriber --user_pass=password
+
+# Add a rosetta forum keymaster account (User ID 3).
+$WP wp user create rosettakeymaster rosetta-keymaster@example.com --role=subscriber --user_pass=password
+
+# Add a forum moderator account (User ID 4).
+$WP wp user create moderator moderator@example.com --role=subscriber --user_pass=password
+
+# Add a rosetta forum moderator account (User ID 5).
+$WP wp user create rosettamoderator rosetta-moderator@example.com --role=subscriber --user_pass=password
+
+# Add a plugin author (User ID 6).
+$WP wp user create pluginauthor plugin-author@example.com --role=subscriber --user_pass=password
+
+# Add a plugin contributor (User ID 7).
+$WP wp user create plugincontributor plugin-contributor@example.com --role=subscriber --user_pass=password
+
+# Add a plugin support representative (User ID 8).
+$WP wp user create pluginsupport plugin-support@example.com --role=subscriber --user_pass=password
+
+# Add a theme author (User ID 9).
+$WP wp user create themeauthor theme-author@example.com --role=subscriber --user_pass=password
+
+# Add a site support representative (user ID 10) - Currently unused, but added in anticipation.
+$WP wp user create themesupport theme-support@example.com --role=subscriber --user_pass=password
+
+# Add a forum visitor
+$WP wp user create visitor visitor@example.com --role=subscriber --user_pass=password
+
+###
+# Set up the `plugins` sub-site with associated content.
+# The plugins sub-site is a dependency for the Global support forums, and must be prepared first.
+###
+
+echo "Setting up minimum required plugins sub-site..."
+
+# Add site-specific plugins.
+$WP wp plugin install jetpack --activate --url=localhost:8888/plugins
+$WP wp plugin activate plugin-directory --url=localhost:8888/plugins
+
+# Add the plugin-related roles to this subsite.
+$WP wp user set-role pluginauthor subscriber --url=localhost:8888/plugins
+$WP wp user set-role plugincontributor subscriber --url=localhost:8888/plugins
+$WP wp user set-role pluginsupport subscriber --url=localhost:8888/plugins
+
+# Add `Hello Dolly` as a plugin.
+$WP wp post create --post_type=plugin --post_status=publish --post_author=4 --post_title='Hello Dolly' --post_date='2022-08-20 01:00:00' --post_modified='2022-08-20 01:00:00' --post_modified_gmt='2022-08-20 01:00:00' --url=localhost:8888/plugins
+
+###
+# Set up the `themes` sub-site with associated content.
+# The themes sub-site is a dependency for the Global support forums, and must be prepared first.
+###
+
+echo "Setting up minimum required themes sub-site..."
+
+# Add site-specific plugins.
+$WP wp plugin activate theme-directory --url=localhost:8888/themes
+
+# Add the theme-related roles to this subsite.
+$WP wp user set-role themeauthor subscriber --url=localhost:8888/themes
+$WP wp user set-role themesupport subscriber --url=localhost:8888/themes
+
+###
+# Set up the primary network site, the forums, with associated content.
+###
+
+echo "Setting up forums site..."
+
+# Activate the forum plugins and theme.
+$WP wp plugin activate "${MINIMUM_SUPPORT_PLUGINS[@]}"
+$WP wp theme activate wporg-support-2024
+
+# Add all roles to the forums.
+$WP wp user set-role keymaster bbp_keymaster
+$WP wp user set-role moderator bbp_moderator
+$WP wp user set-role rosettakeymaster bbp_participant
+$WP wp user set-role rosettamoderator bbp_participant
+$WP wp user set-role pluginauthor bbp_participant
+$WP wp user set-role plugincontributor bbp_participant
+$WP wp user set-role pluginsupport bbp_participant
+$WP wp user set-role themeauthor bbp_participant
+$WP wp user set-role themesupport bbp_participant
+$WP wp user set-role visitor bbp_participant
+
+# Add the initial set of forums.
+$WP wp post create --post_type=forum --post_status=publish --post_title='Installing WordPress' --post_content='If you encounter any problems while setting up WordPress.' --post_date='2022-08-20 01:00:00' --post_modified='2022-08-20 01:00:00' --post_modified_gmt='2022-08-20 01:00:00'
+$WP wp post create --post_type=forum --post_status=publish --post_title='Fixing WordPress' --post_content='For any problems encountered after setting up WordPress.' --post_date='2022-08-20 01:00:00' --post_modified='2022-08-20 01:00:00' --post_modified_gmt='2022-08-20 01:00:00'
+$WP wp post create --post_type=forum --post_status=publish --post_title='Plugins' --post_content='Forum for plugin-specific support topics (hidden on WordPress.org).' --post_date='2022-08-20 01:00:00' --post_modified='2022-08-20 01:00:00' --post_modified_gmt='2022-08-20 01:00:00'
+$WP wp post create --post_type=forum --post_status=publish --post_title='Themes' --post_content='Forum for theme-specific support topics (hidden on WordPress.org).' --post_date='2022-08-20 01:00:00' --post_modified='2022-08-20 01:00:00' --post_modified_gmt='2022-08-20 01:00:00'
+$WP wp post create --post_type=forum --post_status=publish --post_title='Reviews' --post_content='Forum for plugin and theme reviews (hidden on WordPress.org).' --post_date='2022-08-20 01:00:00' --post_modified='2022-08-20 01:00:00' --post_modified_gmt='2022-08-20 01:00:00'
+
+###
+# Set up the secondary rosetta forums site, with associated content.
+###
+
+echo "Setting up rosetta forums site..."
+
+# Activate the forum plugins and theme.
+$WP wp plugin activate "${MINIMUM_SUPPORT_PLUGINS[@]}" --url=localhost:8888/rosetta
+$WP wp theme activate wporg-support-2024 --url=localhost:8888/rosetta
+
+# Add relevant roles to the rosetta forums.
+$WP wp user set-role rosettakeymaster bbp_keymaster --url=localhost:8888/rosetta
+$WP wp user set-role rosettamoderator bbp_moderator --url=localhost:8888/rosetta
+$WP wp user set-role keymaster bbp_participant --url=localhost:8888/rosetta
+$WP wp user set-role moderator bbp_participant --url=localhost:8888/rosetta
+$WP wp user set-role pluginauthor bbp_participant --url=localhost:8888/rosetta
+$WP wp user set-role plugincontributor bbp_participant --url=localhost:8888/rosetta
+$WP wp user set-role pluginsupport bbp_participant --url=localhost:8888/rosetta
+$WP wp user set-role themeauthor bbp_participant --url=localhost:8888/rosetta
+$WP wp user set-role themesupport bbp_participant --url=localhost:8888/rosetta
+$WP wp user set-role visitor bbp_participant --url=localhost:8888/rosetta
+
+# Add the initial set of forums.
+$WP wp post create --post_type=forum --post_status=publish --post_title='Installing WordPress' --post_content='If you encounter any problems while setting up WordPress.' --post_date='2022-08-20 01:00:00' --post_modified='2022-08-20 01:00:00' --post_modified_gmt='2022-08-20 01:00:00' --url=localhost:8888/rosetta
+$WP wp post create --post_type=forum --post_status=publish --post_title='Fixing WordPress' --post_content='For any problems encountered after setting up WordPress.' --post_date='2022-08-20 01:00:00' --post_modified='2022-08-20 01:00:00' --post_modified_gmt='2022-08-20 01:00:00' --url=localhost:8888/rosetta
+
+###
+# Set up network-wide plugins
+###
+
+echo "Setting up network-wide plugins..."
+
+# Activate network-wide plugins
+#$WP wp plugin activate wporg-two-factor --network
+
+# Setup, and flush rewrite rules.
+echo "Setting up permalinks on forum sites..."
+$WP wp rewrite structure '/%postname%/'
+$WP wp rewrite flush
+$WP wp rewrite structure '/%postname%/' --url=localhost:8888/rosetta
+$WP wp rewrite flush --url=localhost:8888/rosetta
+
+$WPSUDO bash -c "touch '$SETUP_VALIDATION_FILE'"