Merge pull request #138 from dreamsicle-io/release/3.5.0

Release/3.5.0
dreamsicle-io · Nov 26, 2022 · d3d018f · d3d018f
2 parents 005f839 + 0b86cf1
commit d3d018f
Show file tree

Hide file tree

Showing 8 changed files with 117 additions and 42 deletions.
diff --git a/docs/reference/classes/WP-Backstage-Nav-Menu-Item.html b/docs/reference/classes/WP-Backstage-Nav-Menu-Item.html
@@ -2496,7 +2496,7 @@ <h4 class="phpdocumentor-element__name" id="method_init">
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage-nav-menu-item.php"><a href="files/includes-class-wp-backstage-nav-menu-item.html"><abbr title="includes/class-wp-backstage-nav-menu-item.php">class-wp-backstage-nav-menu-item.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">120</span>
+    <span class="phpdocumentor-element-found-in__line">121</span>
 
     </aside>
 
@@ -2521,6 +2521,16 @@ <h5 class="phpdocumentor-tag-list__heading" id="tags">
                                             <span class="phpdocumentor-tag-link">2.0.0</span>
 
 
+                                    </dd>
+                            <dt class="phpdocumentor-tag-list__entry">
+                    <span class="phpdocumentor-tag__name">since</span>
+                </dt>
+                <dd class="phpdocumentor-tag-list__definition">
+                                            <span class="phpdocumentor-tag-link">3.5.0</span>
+
+                                                 <section class="phpdocumentor-description"><p>Hooks the <code class="prettyprint">manage_customizer_meta_preview</code> method at a much later priority.</p>
+</section>
+
                                     </dd>
                         </dl>
 
@@ -2657,7 +2667,7 @@ <h4 class="phpdocumentor-element__name" id="method_inline_customizer_style">
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage-nav-menu-item.php"><a href="files/includes-class-wp-backstage-nav-menu-item.html"><abbr title="includes/class-wp-backstage-nav-menu-item.php">class-wp-backstage-nav-menu-item.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">156</span>
+    <span class="phpdocumentor-element-found-in__line">157</span>
 
     </aside>
 
@@ -2706,7 +2716,7 @@ <h4 class="phpdocumentor-element__name" id="method_manage_customizer_meta_previe
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage-nav-menu-item.php"><a href="files/includes-class-wp-backstage-nav-menu-item.html"><abbr title="includes/class-wp-backstage-nav-menu-item.php">class-wp-backstage-nav-menu-item.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">507</span>
+    <span class="phpdocumentor-element-found-in__line">515</span>
 
     </aside>
 
@@ -2719,7 +2729,10 @@ <h4 class="phpdocumentor-element__name" id="method_manage_customizer_meta_previe
         <section class="phpdocumentor-description"><p>Preview changes to the nav menu item roles. Note the unimplemented
 to-do in the doc block for the setting's preview method. This will only
 work for existing menu items. New menu items have a dynamically generated ID
-and do not exist in the database yet.</p>
+and do not exist in the database yet. Note that this is a &quot;short-circuit&quot; filter,
+which means if a non-null value is returned, it will be used instead of the DB or
+cache value. This filter always receives <code class="prettyprint">null</code> as the <code class="prettyprint">$value</code>. The return value
+must always be an array, even if it is a single value.</p>
 </section>
 
         <h5 class="phpdocumentor-argument-list__heading">Parameters</h5>
@@ -2744,6 +2757,14 @@ <h5 class="phpdocumentor-tag-list__heading" id="tags">
                                     <dt class="phpdocumentor-tag-list__entry">
                     <span class="phpdocumentor-tag__name">link</span>
                 </dt>
+                <dd class="phpdocumentor-tag-list__definition">
+                                                                                                        <a class="phpdocumentor-tag-link" href="https://developer.wordpress.org/reference/hooks/get_meta_type_metadata/"> <p>Filter: get_{$meta_type}_metadata</p>
+ </a>
+
+                                    </dd>
+                            <dt class="phpdocumentor-tag-list__entry">
+                    <span class="phpdocumentor-tag__name">link</span>
+                </dt>
                 <dd class="phpdocumentor-tag-list__definition">
                                                                                                         <a class="phpdocumentor-tag-link" href="https://wordpress.stackexchange.com/questions/372493/add-settings-to-menu-items-in-the-customizer"> <p>Stack Overflow Discussion on Nav Menu Items in the Customizer</p>
  </a>
@@ -2756,6 +2777,24 @@ <h5 class="phpdocumentor-tag-list__heading" id="tags">
                                                                                                         <a class="phpdocumentor-tag-link" href="https://gist.github.com/westonruter/7f2b9c18113f0576a72e0aca3ce3dbcb"> <p>Customizer Roles Plugin Example by Weston Ruter</p>
  </a>
 
+                                    </dd>
+                                                <dt class="phpdocumentor-tag-list__entry">
+                    <span class="phpdocumentor-tag__name">since</span>
+                </dt>
+                <dd class="phpdocumentor-tag-list__definition">
+                                            <span class="phpdocumentor-tag-link">2.0.0</span>
+
+
+                                    </dd>
+                            <dt class="phpdocumentor-tag-list__entry">
+                    <span class="phpdocumentor-tag__name">since</span>
+                </dt>
+                <dd class="phpdocumentor-tag-list__definition">
+                                            <span class="phpdocumentor-tag-link">3.5.0</span>
+
+                                                 <section class="phpdocumentor-description"><p>Always cast value to array, more strict checks of value existence, upped the priority so this always runs last.</p>
+</section>
+
                                     </dd>
                         </dl>
 
@@ -2778,7 +2817,7 @@ <h4 class="phpdocumentor-element__name" id="method_manage_default_hidden_columns
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage-nav-menu-item.php"><a href="files/includes-class-wp-backstage-nav-menu-item.html"><abbr title="includes/class-wp-backstage-nav-menu-item.php">class-wp-backstage-nav-menu-item.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">473</span>
+    <span class="phpdocumentor-element-found-in__line">475</span>
 
     </aside>
 
@@ -3111,7 +3150,7 @@ <h4 class="phpdocumentor-element__name" id="method_render_customizer_fields">
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage-nav-menu-item.php"><a href="files/includes-class-wp-backstage-nav-menu-item.html"><abbr title="includes/class-wp-backstage-nav-menu-item.php">class-wp-backstage-nav-menu-item.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">308</span>
+    <span class="phpdocumentor-element-found-in__line">310</span>
 
     </aside>
 
@@ -3140,6 +3179,16 @@ <h5 class="phpdocumentor-tag-list__heading" id="tags">
                                             <span class="phpdocumentor-tag-link">2.0.0</span>
 
 
+                                    </dd>
+                            <dt class="phpdocumentor-tag-list__entry">
+                    <span class="phpdocumentor-tag__name">since</span>
+                </dt>
+                <dd class="phpdocumentor-tag-list__definition">
+                                            <span class="phpdocumentor-tag-link">3.5.0</span>
+
+                                                 <section class="phpdocumentor-description"><p>Uses the menu item ID as the dynamic portion of the name/id instead of the instance number.</p>
+</section>
+
                                     </dd>
                         </dl>
 
@@ -3214,7 +3263,7 @@ <h4 class="phpdocumentor-element__name" id="method_render_fields">
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage-nav-menu-item.php"><a href="files/includes-class-wp-backstage-nav-menu-item.html"><abbr title="includes/class-wp-backstage-nav-menu-item.php">class-wp-backstage-nav-menu-item.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">249</span>
+    <span class="phpdocumentor-element-found-in__line">250</span>
 
     </aside>
 
@@ -4699,7 +4748,7 @@ <h4 class="phpdocumentor-element__name" id="method_save">
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage-nav-menu-item.php"><a href="files/includes-class-wp-backstage-nav-menu-item.html"><abbr title="includes/class-wp-backstage-nav-menu-item.php">class-wp-backstage-nav-menu-item.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">367</span>
+    <span class="phpdocumentor-element-found-in__line">369</span>
 
     </aside>
 
@@ -4776,7 +4825,7 @@ <h4 class="phpdocumentor-element__name" id="method_save_customizer">
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage-nav-menu-item.php"><a href="files/includes-class-wp-backstage-nav-menu-item.html"><abbr title="includes/class-wp-backstage-nav-menu-item.php">class-wp-backstage-nav-menu-item.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">417</span>
+    <span class="phpdocumentor-element-found-in__line">419</span>
 
     </aside>
 
@@ -4846,7 +4895,7 @@ <h4 class="phpdocumentor-element__name" id="method_setup_nav_menu_item">
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage-nav-menu-item.php"><a href="files/includes-class-wp-backstage-nav-menu-item.html"><abbr title="includes/class-wp-backstage-nav-menu-item.php">class-wp-backstage-nav-menu-item.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">220</span>
+    <span class="phpdocumentor-element-found-in__line">221</span>
 
     </aside>
 
@@ -5316,7 +5365,7 @@ <h4 class="phpdocumentor-element__name" id="method_get_fields">
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage-nav-menu-item.php"><a href="files/includes-class-wp-backstage-nav-menu-item.html"><abbr title="includes/class-wp-backstage-nav-menu-item.php">class-wp-backstage-nav-menu-item.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">194</span>
+    <span class="phpdocumentor-element-found-in__line">195</span>
 
     </aside>
 

diff --git a/docs/reference/classes/WP-Backstage.html b/docs/reference/classes/WP-Backstage.html
@@ -708,7 +708,7 @@ <h4 class="phpdocumentor-element__name" id="method_ajax_render_media">
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage.php"><a href="files/includes-class-wp-backstage.html"><abbr title="includes/class-wp-backstage.php">class-wp-backstage.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">2976</span>
+    <span class="phpdocumentor-element-found-in__line">2977</span>
 
     </aside>
 
@@ -1964,7 +1964,7 @@ <h4 class="phpdocumentor-element__name" id="method_inline_nav_menu_item_customiz
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage.php"><a href="files/includes-class-wp-backstage.html"><abbr title="includes/class-wp-backstage.php">class-wp-backstage.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">2150</span>
+    <span class="phpdocumentor-element-found-in__line">2151</span>
 
     </aside>
 
@@ -2005,6 +2005,16 @@ <h5 class="phpdocumentor-tag-list__heading" id="tags">
                                             <span class="phpdocumentor-tag-link">2.0.0</span>
 
 
+                                    </dd>
+                            <dt class="phpdocumentor-tag-list__entry">
+                    <span class="phpdocumentor-tag__name">since</span>
+                </dt>
+                <dd class="phpdocumentor-tag-list__definition">
+                                            <span class="phpdocumentor-tag-link">3.5.0</span>
+
+                                                 <section class="phpdocumentor-description"><p>Uses the menu item ID instead of the instance number for dynamic portion of the id/name attributes.</p>
+</section>
+
                                     </dd>
                         </dl>
 
@@ -2084,7 +2094,7 @@ <h4 class="phpdocumentor-element__name" id="method_inline_options_script">
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage.php"><a href="files/includes-class-wp-backstage.html"><abbr title="includes/class-wp-backstage.php">class-wp-backstage.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">2569</span>
+    <span class="phpdocumentor-element-found-in__line">2570</span>
 
     </aside>
 
@@ -2238,7 +2248,7 @@ <h4 class="phpdocumentor-element__name" id="method_inline_taxonomy_script">
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage.php"><a href="files/includes-class-wp-backstage.html"><abbr title="includes/class-wp-backstage.php">class-wp-backstage.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">2517</span>
+    <span class="phpdocumentor-element-found-in__line">2518</span>
 
     </aside>
 
@@ -2332,7 +2342,7 @@ <h4 class="phpdocumentor-element__name" id="method_inline_user_script">
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage.php"><a href="files/includes-class-wp-backstage.html"><abbr title="includes/class-wp-backstage.php">class-wp-backstage.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">2807</span>
+    <span class="phpdocumentor-element-found-in__line">2808</span>
 
     </aside>
 
@@ -2379,7 +2389,7 @@ <h4 class="phpdocumentor-element__name" id="method_inline_widget_customizer_scri
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage.php"><a href="files/includes-class-wp-backstage.html"><abbr title="includes/class-wp-backstage.php">class-wp-backstage.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">2726</span>
+    <span class="phpdocumentor-element-found-in__line">2727</span>
 
     </aside>
 
@@ -2426,7 +2436,7 @@ <h4 class="phpdocumentor-element__name" id="method_inline_widget_script">
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage.php"><a href="files/includes-class-wp-backstage.html"><abbr title="includes/class-wp-backstage.php">class-wp-backstage.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">2602</span>
+    <span class="phpdocumentor-element-found-in__line">2603</span>
 
     </aside>
 
@@ -2528,7 +2538,7 @@ <h4 class="phpdocumentor-element__name" id="method_render_media_item">
     <aside class="phpdocumentor-element-found-in">
     <abbr class="phpdocumentor-element-found-in__file" title="includes/class-wp-backstage.php"><a href="files/includes-class-wp-backstage.html"><abbr title="includes/class-wp-backstage.php">class-wp-backstage.php</abbr></a></abbr>
     :
-    <span class="phpdocumentor-element-found-in__line">2846</span>
+    <span class="phpdocumentor-element-found-in__line">2847</span>
 
     </aside>
 

diff --git a/docs/reference/reports/markers.html b/docs/reference/reports/markers.html
@@ -126,7 +126,7 @@ <h3><abbr title="includes/class-wp-backstage-nav-menu-item.php">class-wp-backsta
                 <tbody>
                                     <tr>
                         <td class="phpdocumentor-cell">TODO</td>
-                        <td class="phpdocumentor-cell">417</td>
+                        <td class="phpdocumentor-cell">419</td>
                         <td class="phpdocumentor-cell">Though it&#039;s probably not needed, try to check nonce here.</td>
                     </tr>
                                 </tbody>