Plugin Stuff

.gitignore

@@ -18,6 +18,14 @@ node_modules
 /plugins/two-factor/
 /plugins/vaultpress/
 
+# Loaded via Composer
+/plugins/advanced-custom-fields-pro/
+/plugins/cookie-law-info/
+/plugins/pojo-accessibility/
+/plugins/svg-support/
+/plugins/user-switching/
+/plugins/woocommerce/
+
 # Uploads directory
 /uploads/
 

README.md

@@ -62,12 +62,6 @@ See the [PHPCS documentation](https://github.com/squizlabs/PHP_CodeSniffer/wiki/
 
 If you need help with anything, VIP's support team is [just a ticket away](https://wpvip.com/accessing-vip-support/).
 
-## Your documentation here
+## Additional Documentation
 
-Feel free to add to or replace this README.md content with content unique to your project, for example:
-
-* Project-specific notes; like a list of VIP environments and branches,
-* Workflow documentation; so everyone working in this repo can follow a defined process, or
-* Instructions for testing new features.
-
-This can be detailed in the `docs/` directory.
+More documentation can be found in [docs](docs/index.md).

client-mu-plugins/goodbids/config.json

@@ -0,0 +1,11 @@
+{
+	"version": "1.0",
+	"active-plugins": [
+		"advanced-custom-fields-pro/acf.php",
+		"woocommerce",
+		"pojo-accessibility",
+		"svg-support",
+		"cookie-law-info",
+		"user-switching"
+	]
+}

client-mu-plugins/goodbids/src/classes/Core.php

@@ -15,12 +15,22 @@ class Core {
 
 	/**
 	 * @since 1.0.0
-	 * @var Core|null $instance
+	 * @var Core|null
 	 */
 	private static ?Core $instance = null;
 
+	/**
+	 * @since 1.0.0
+	 * @var bool
+	 */
 	private bool $initialized = false;
 
+	/**
+	 * @since 1.0.0
+	 * @var array
+	 */
+	private array $config = [];
+
 	/**
 	 * Constructor
 	 *
@@ -52,11 +62,50 @@ public static function get_instance() : Core {
 	 * @since 1.0.0
 	 */
 	public function init() {
+		if ( ! $this->load_config() ) {
+			// TODO: Log error.
+			return;
+		}
+
 		$this->load_plugins();
 
 		$this->initialized = true;
 	}
 
+	/**
+	 * Sets the Plugin Config.
+	 *
+	 * @since 1.0.0
+	 * @return bool
+	 */
+	private function load_config() {
+		$json_path = GOODBIDS_PLUGIN_PATH . 'config.json';
+		if ( ! file_exists( $json_path ) ) {
+			return false;
+		}
+
+		$json = json_decode( wpcom_vip_file_get_contents( $json_path ), true );
+
+		if ( ! is_array( $json ) ) {
+			return false;
+		}
+
+		$this->config = $json;
+
+		return true;
+	}
+
+	/**
+	 * Get a config value.
+	 *
+	 * @param string $key Config Key.
+	 *
+	 * @return mixed|null
+	 */
+	public function get_config( string $key ) {
+		return $this->config[ $key ] ?? null;
+	}
+
 	/**
 	 * Load 3rd Party Plugins.
 	 *
@@ -67,11 +116,14 @@ private function load_plugins() {
 			return;
 		}
 
-		wpcom_vip_load_plugin( 'advanced-custom-fields-pro/acf.php' );
-		wpcom_vip_load_plugin( 'woocommerce' );
-		wpcom_vip_load_plugin( 'pojo-accessibility' );
-		wpcom_vip_load_plugin( 'svg-support' );
-		wpcom_vip_load_plugin( 'cookie-law-info' );
-		wpcom_vip_load_plugin( 'user-switching' );
+		$plugins = $this->get_config( 'active-plugins' );
+
+		if ( empty( $plugins ) || ! is_array( $plugins ) ) {
+			return;
+		}
+
+		foreach ( $plugins as $plugin ) {
+			wpcom_vip_load_plugin( $plugin );
+		}
 	}
 }

composer.json

@@ -4,7 +4,7 @@
   "homepage": "https://github.com/automattic/vip-go-skeleton",
   "license": "GPL-2.0-or-later",
   "require": {
-    "php": ">=8.0"
+    "php": ">=8.1"
   },
   "require-dev": {
     "automattic/vipwpcs": "^3",

docs/index.md

@@ -1,20 +1,11 @@
-# Document Your Application Here
+# GoodBids
 
-VIP encourages you to document your application in Markdown. This is a great way of keeping your documentation up to date with what the application actually does.
+## Getting Started
 
-You can create new Markdown files in this `docs/` directory for each important part of your application.
+* [Local installation Guide](local.md)
+* [Git Workflow](workflow.md)
 
-## Examples
-
-For example, you might have:
-- `docs/local.md` that describes how to run your application locally
-- `docs/REST.md` that describes any custom endpoints that your application has
-- `docs/syndication.md` might describe how syndication works between subsites in your application
-- `docs/build.md` describes what parts of your application gets built into the final deployable application
-- `docs/qa.md` describes any manual or automated QA tests and processes that you have run on your application prior to deployment.
-- etc.
-
-## Benefits
-
-Not only does this help you onboard your new engineers, it also helps VIP support staff to understand the moving parts or complexities of your application better at a glance, without having to dig into the code.
+## Plugins
 
+* [Installing Plugins](plugins/installing.md)
+* [Activating Plugins](plugins/activating.md)

docs/local.md

@@ -29,6 +29,14 @@ vip dev-env --slug=goodbids start
 vip dev-env --slug=goodbids stop
 ```
 
+### Install Dependencies
+
+For ACF Pro, copy `auth.json.dist` to `auth.json` in `client-mu-plugins/goodbids` and use config from [ACF's Website](https://www.advancedcustomfields.com/my-account/view-licenses/). (Credentials are in 1Password)
+
+Then, run `composer install` in the following directories:
+1. `root`: Run at project root.
+2. `client-mu-plugins/goodbids`: GoodBids MU Plugin
+
 ## Local Environment URL
 
 [http://goodbids.vipdev.lndo.site/](http://goodbids.vipdev.lndo.site/)

docs/plugins/activating.md

@@ -0,0 +1,23 @@
+# Activating Plugins
+
+## Global Plugins
+
+Global plugins to be used on all sites can be activated by adding the plugin slug to the `active-plugins` array in the GoodBids MU Plugin `config.json` file.
+
+If the plugin slug does not match the plugin filename (e.g. `woocommerce/woocommerce.php`), you need to specify the both the slug and plugin filename. (Example: `advanced-custom-fields-pro/acf.php`)
+
+```json
+{
+  "active-plugins": [
+	"woocommerce",
+	"advanced-custom-fields-pro/acf.php"
+  ]
+}
+```
+
+## Site Specific Plugins
+
+Conditional Plugins can be activated in-code by using:
+```php
+wpcom_vip_load_plugin( 'plugin-name/plugin-file.php' )
+```

docs/plugins/index.md

@@ -0,0 +1,4 @@
+# Plugins
+
+* [Installing Plugins](plugins/installing.md)
+* [Activating Plugins](plugins/activating.md)

docs/plugins/installing.md

@@ -0,0 +1,7 @@
+## Installing Plugins
+
+We are using [Composer](https://getcomposer.org/) and [WPackagist](https://wpackagist.org/) to manage our plugins. To install a new plugin that exists in the WordPress Plugin Repository, run the following command:
+
+```sh
+composer require wpackagist-plugin/plugin-name
+```

themes/goodbids-nonprofit/style.css

@@ -3,7 +3,7 @@ Theme Name: GoodBids Non-profit
 Theme URI: https://goodbids.org
 Author: Viget
 Author URI: https://viget.com
-Description: Twenty Twenty-Four child theme for GoodBids Charity sites.
+Description: Twenty Twenty-Four child theme for GoodBids Non-profit sites.
 Version: 1.0
 License: GNU General Public License v2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html