Ticket #17851: 17851.4.diff

src/wp-admin/includes/template.php

@@ -1561 +1561 @@
  * fields. It can output nothing if you want.
  *
  * @since 2.7.0
+ * @since 6.1.0 Added an `$args` parameter for the section's wrapper HTML and class name.
  *
  * @global array $wp_settings_sections Storage array of all settings sections added to admin pages.
  *
@@ -1570 +1571 @@
  * @param string   $page     The slug-name of the settings page on which to show the section. Built-in pages include
  *                           'general', 'reading', 'writing', 'discussion', 'media', etc. Create your own using
  *                           add_options_page();
+ * @param array    $args     {
+ *     Arguments used to create the settings section.
+ *
+ *     @type string $before_section HTML content to prepend to the section's HTML output.
+ *                                  Receives the section's class name as `%s`. Default empty.
+ *     @type string $after_section  HTML content to append to the section's HTML output. Default empty.
+ *     @type string $section_class  The class name to use for the section. Default empty.
+ * }
  */
-function add_settings_section( $id, $title, $callback, $page ) {
+function add_settings_section( $id, $title, $callback, $page, $args = array() ) {
         global $wp_settings_sections;
 
+        $defaults = array(
+                'id'             => $id,
+                'title'          => $title,
+                'callback'       => $callback,
+                'before_section' => '',
+                'after_section'  => '',
+                'section_class'  => '',
+        );
+
+        $section = wp_parse_args( $args, $defaults );
+
         if ( 'misc' === $page ) {
                 _deprecated_argument(
                         __FUNCTION__,
@@ -1600 +1620 @@
                 $page = 'reading';
         }
 
-        $wp_settings_sections[ $page ][ $id ] = array(
-                'id'       => $id,
-                'title'    => $title,
-                'callback' => $callback,
-        );
+        $wp_settings_sections[ $page ][ $id ] = $section;
 }
 
 /**
@@ -1700 +1716 @@
         }
 
         foreach ( (array) $wp_settings_sections[ $page ] as $section ) {
+                if ( '' !== $section['before_section'] ) {
+                        echo sprintf( $section['before_section'], $section['section_class'] );
+                }
+
                 if ( $section['title'] ) {
                         echo "<h2>{$section['title']}</h2>\n";
                 }
@@ -1714 +1734 @@
                 echo '<table class="form-table" role="presentation">';
                 do_settings_fields( $page, $section['id'] );
                 echo '</table>';
+
+                if ( '' !== $section['after_section'] ) {
+                        echo $section['after_section'];
+                }
         }
 }