Merge branch 'develop' into feature/environment-indicator

10up-experience.php

@@ -3,7 +3,7 @@
  * Plugin Name:       10up Experience
  * Plugin URI:        https://github.com/10up/10up-experience
  * Description:       The 10up Experience plugin configures WordPress to better protect and inform clients, aligned to 10up’s best practices.
- * Version:           1.11.2
+ * Version:           1.12.0
  * Author:            10up
  * Author URI:        https://10up.com
  * License:           GPLv2 or later
@@ -19,7 +19,7 @@
 
 use YahnisElsts\PluginUpdateChecker\v5\PucFactory;
 
-define( 'TENUP_EXPERIENCE_VERSION', '1.11.2' );
+define( 'TENUP_EXPERIENCE_VERSION', '1.12.0' );
 define( 'TENUP_EXPERIENCE_DIR', __DIR__ );
 define( 'TENUP_EXPERIENCE_FILE', __FILE__ );
 
@@ -74,6 +74,7 @@ function ( $class_name ) {
 API\API::instance();
 Authentication\Usernames::instance();
 Authors\Authors::instance();
+Comments\Comments::instance();
 Gutenberg\Gutenberg::instance();
 Headers\Headers::instance();
 Plugins\Plugins::instance();

README.md

@@ -143,10 +143,58 @@ Filters how many log items to store. Items are stored in array saved to the opti
 
 Define `TENUP_DISABLE_ACTIVITYLOG` as `true` to disable Activity Log.
 
+
 ### Environment Indicator
 
 To enhance user awareness and minimize the risk of making unintended changes, 10up Experience includes a visual indicator integrated into the admin bar. This feature clearly displays which environment (e.g., development, staging, production) the user is currently working in.
 
+
+### Comments
+
+10up Experience includes a feature to disable comments across the site. This feature can be enabled or disabled in `Settings > General`. It is disabled by default.
+
+On top of disabling the comment form, this feature removes the following:
+
+- Comments from the admin menu.
+- Comment blocks from the post editor.
+- Comments from the admin bar.
+
+#### Constants
+
+- `TENUP_DISABLE_COMMENTS`
+
+Define this as `true` to force disable comments or `false` to enable comments from a config file.
+Setting this constant will disable the UI for enabling/disabling comments in the admin.
+
+#### Filters
+
+- `tenup_experience_disable_comments`
+
+Filters whether to disable comments. Default is `false`.
+Defining this filter will disable the UI for enabling/disabling comments in the admin.
+
+- `tenup_experience_disable_comments_disallowed_blocks`
+
+Filters the list of blocks that should be disallowed when comments are disabled. This is useful when core adds new blocks that aren't covered by the default list.
+
+The default list of disallowed blocks is:
+
+- `core/comment-author-name`
+- `core/comment-content`
+- `core/comment-date`
+- `core/comment-edit-link`
+- `core/comment-reply-link`
+- `core/comment-template`
+- `core/comments`
+- `core/comments-pagination`
+- `core/comments-pagination-next`
+- `core/comments-pagination-numbers`
+- `core/comments-pagination-previous`
+- `core/comments-title`
+- `core/post-comments`
+- `core/post-comments-form`
+- `core/latest-comments`
+
 ## Support Level
 
 **Active:** 10up is actively working on this, and we expect to continue work for the foreseeable future including keeping tested up to the most recent version of WordPress.  Bug reports, feature requests, questions, and pull requests are welcome.