Ticket #15865: removal-functions-03-refreshed.patch

src/wp-admin/includes/template.php

@@ -1662 +1662 @@
         $wp_settings_sections[ $page ][ $id ] = $section;
 }
 
+/**
+ * Remove a settings section from a settings page.
+ *
+ * Part of the Settings API. Use this to remove a settings section from an admin page.
+ *
+ * @since 6.3.0
+ *
+ * @global array $wp_settings_sections Storage array of all settings sections added to admin pages.
+ * @global array $wp_settings_fields Storage array of settings fields and info about their pages/sections.
+ *
+ * @param string $id    Slug-name to identify the section.
+ * @param string $page  The slug-name of the settings page on which to remove the section.
+ */
+function remove_settings_section( $id, $page ) {
+        global $wp_settings_sections, $wp_settings_fields;
+
+        // Remove item from $wp_settings_sections global.
+        if ( isset( $wp_settings_sections[ $page ][ $id ] ) ) {
+                unset( $wp_settings_sections[ $page ][ $id ] );
+        }
+
+        // Remove containing structure that could potentially now be empty.
+        if ( empty( $wp_settings_sections[ $page ] ) ) {
+                unset( $wp_settings_sections[ $page ] );
+        }
+
+        // Remove related fields from the $wp_settings_fields global.
+        if ( isset( $wp_settings_fields[ $page ][ $id ] ) ) {
+                unset( $wp_settings_fields[ $page ][ $id ] );
+        }
+
+        // Remove containing structure that could potentially now be empty.
+        if ( empty( $wp_settings_fields[ $page ] ) ) {
+                unset( $wp_settings_fields[ $page ] );
+        }
+}
+
 /**
  * Adds a new field to a section of a settings page.
  *
@@ -1734 +1771 @@
         );
 }
 
+/**
+ * Removes field from a section of a settings page.
+ *
+ * Part of the Settings API. Use this to remove a previously
+ * declared settings field.
+ *
+ * @since 6.3,0
+ *
+ * @global array $wp_settings_fields Storage array of settings fields and info about their pages/sections.
+ *
+ * @param string $id       Slug-name to identify the field.
+ * @param string $page     The slug-name of the settings page on which to show the section
+ *                         (general, reading, writing, ...).
+ * @param string $section  Optional. The slug-name of the section of the settings page
+ *                         with which the field is associated. Default 'default'.
+ */
+function remove_settings_field( $id, $page, $section = 'default' ) {
+        global $wp_settings_fields;
+
+        if ( isset( $wp_settings_fields[ $page ][ $section ][ $id ] ) ) {
+                unset( $wp_settings_fields[ $page ][ $section ][ $id ] );
+        }
+
+        // Remove containing structure that could potentially now be empty.
+        if ( empty( $wp_settings_fields[ $page ][ $section ] ) ) {
+                unset( $wp_settings_fields[ $page ][ $section ] );
+        }
+
+        if ( empty( $wp_settings_fields[ $page ] ) ) {
+                unset( $wp_settings_fields[ $page ] );
+        }
+}
+
 /**
  * Prints out all settings sections added to a particular settings page.
  *
@@ -1863 +1933 @@
         );
 }
 
+/**
+ * Removes a settings error to be displayed to the user.
+ *
+ * Part of the Settings API. Use this to remove messages to users about settings validation
+ * problems, missing settings or anything else.
+ *
+ * @since 6.3.0
+ *
+ * @global array[] $wp_settings_errors Storage array of errors registered during this pageload
+ *
+ * @param string $setting Slug title of the setting to which the error
+ *                        we want to remove applies.
+ * @param string $code    Slug-name to identify the error.
+ */
+function remove_settings_error( $setting, $code ) {
+        global $wp_settings_errors;
+
+        if ( ! empty( $wp_settings_errors ) ) {
+                foreach ( $wp_settings_errors as $index => $error ) {
+                        if ( $error['setting'] === $setting && $error['code'] === $code ) {
+                                unset( $wp_settings_errors[ $index ] );
+                        }
+                }
+        }
+}
+
 /**
  * Fetches settings errors registered by add_settings_error().
  *