Ticket #22487: section-priority.patch

wp-admin/includes/template.php

@@ -988 +988 @@
  * @param string $callback Function that echos out any content at the top of the section (between heading and fields).
  * @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();
  */
-function add_settings_section($id, $title, $callback, $page) {
+function add_settings_section($id, $title, $callback, $page, $priority = 10) {
         global $wp_settings_sections;
 
         if ( 'misc' == $page ) {
@@ -1008 +1008 @@
         if ( !isset($wp_settings_sections[$page][$id]) )
                 $wp_settings_sections[$page][$id] = array();
 
-        $wp_settings_sections[$page][$id] = array('id' => $id, 'title' => $title, 'callback' => $callback);
+        $wp_settings_sections[$page][$id] = array('id' => $id, 'title' => $title, 'callback' => $callback, 'priority' => $priority);
 }
 
 /**
@@ -1075 +1075 @@
         if ( ! isset( $wp_settings_sections ) || !isset( $wp_settings_sections[$page] ) )
                 return;
 
+        uasort($wp_settings_sections[$page], 'compare_priority');
+
         foreach ( (array) $wp_settings_sections[$page] as $section ) {
                 if ( $section['title'] )
                         echo "<h3>{$section['title']}</h3>\n";
@@ -1091 +1093 @@
 }
 
 /**
+ * Helper function to compare two objects by priority.
+ *
+ * @since 3.4.0
+ *
+ * @param object $a Object A.
+ * @param object $b Object B.
+ */
+function compare_priority( $a, $b ) {
+        $ap = $a['priority'];
+        $bp = $b['priority'];
+
+        if ( $ap == $bp )
+                return 0;
+        return ( $ap > $bp ) ? 1 : -1;
+}
+
+/**
  * Print out the settings fields for a particular settings section
  *
  * Part of the Settings API. Use this in a settings page to output