Changeset 56223 for trunk/src/wp-includes/load.php

Timestamp:

07/13/2023 12:27:06 AM (19 months ago)

Author:

peterwilsoncc

Message:

General: Introduce all development mode.

Introduce the development mode all as a a cover-all mode for the existing theme, plugin and core development modes. Developers can use the all mode if they are developing both themes and plugins, for example.

Introduce the utility function wp_in_development_mode() allowing developers to detect the mode via a parameter. If the development mode is set to all this function will always return true. If the development mode is specific then only the chosen mode will return true.

Follow up to [56079,56042].

Props flixos90.
Fixes #57487.

File:

• trunk/src/wp-includes/load.php (modified) (3 diffs)

trunk/src/wp-includes/load.php

@@ -272 +272 @@
  * developing for WordPress.
  *
- * Valid developer modes are 'core', 'plugin', 'theme', or an empty string to disable developer mode.
+ * Valid development modes are 'core', 'plugin', 'theme', 'all', or an empty string to disable development mode.
+ * 'all' is a special value to signify that all three development modes 'core', 'plugin', and 'theme' are enabled.
  *
  * Developer mode is considered separately from `WP_DEBUG` and {@see wp_get_environment_type()}. It does not affect
  * debugging output, but rather functional nuances in WordPress.
+ *
+ * This function controls the currently set development mode value. To check for whether a specific development mode is
+ * enabled, use wp_in_development_mode().
  *
  * @since 6.3.0
@@ -299 +303 @@
         'plugin',
         'theme',
+        'all',
         '',
     );
@@ -308 +313 @@
 
     return $current_mode;
+}
+
+/**
+ * Checks whether the site is in the given development mode.
+ *
+ * @since 6.3.0
+ *
+ * @param string $mode Development mode to check for. Either 'core', 'plugin', 'theme', or 'all'.
+ * @return bool True if the given mode is covered by the current development mode, false otherwise.
+ */
+function wp_in_development_mode( $mode ) {
+    $current_mode = wp_get_development_mode();
+    if ( empty( $current_mode ) ) {
+        return false;
+    }
+
+    // Return true if the current mode encompasses all modes.
+    if ( 'all' === $current_mode ) {
+        return true;
+    }
+
+    // Return true if the current mode is the given mode.
+    return $mode === $current_mode;
 }