Changeset 60139

Timestamp:

04/08/2025 01:59:10 AM (3 weeks ago)

Author:

jorbin

Message:

Docs: Update inline docs for various general template functions.

Reviewed By peterwilsoncc, jorbin.
Merges [60120] and [60121] to the 6.8 branch.

Props dilipbheda, mukesh27, SergeyBiryukov, audrasjb.
Fixes #63215.
See #63166.

Location:

branches/6.8

Files:

• . (modified) (1 prop)
• src/wp-includes/general-template.php (modified) (7 diffs)

branches/6.8/src/wp-includes/general-template.php

@@ -20 +20 @@
  * @since 5.5.0 The `$args` parameter was added.
  *
- * @param string $name The name of the specialized header.
- * @param array  $args Optional. Additional arguments passed to the header template.
- *                     Default empty array.
+ * @param string|null $name The name of the specialized header. Default null.
+ * @param array       $args Optional. Additional arguments passed to the header template.
+ *                          Default empty array.
  * @return void|false Void on success, false if the template does not exist.
  */
@@ -64 +64 @@
  * @since 5.5.0 The `$args` parameter was added.
  *
- * @param string $name The name of the specialized footer.
- * @param array  $args Optional. Additional arguments passed to the footer template.
- *                     Default empty array.
+ * @param string|null $name The name of the specialized footer. Default null.
+ * @param array       $args Optional. Additional arguments passed to the footer template.
+ *                          Default empty array.
  * @return void|false Void on success, false if the template does not exist.
  */
@@ -108 +108 @@
  * @since 5.5.0 The `$args` parameter was added.
  *
- * @param string $name The name of the specialized sidebar.
- * @param array  $args Optional. Additional arguments passed to the sidebar template.
- *                     Default empty array.
+ * @param string|null $name The name of the specialized sidebar. Default null.
+ * @param array       $args Optional. Additional arguments passed to the sidebar template.
+ *                          Default empty array.
  * @return void|false Void on success, false if the template does not exist.
  */
@@ -160 +160 @@
  *
  * @param string      $slug The slug name for the generic template.
- * @param string|null $name Optional. The name of the specialized template.
+ * @param string|null $name Optional. The name of the specialized template. Default null.
  * @param array       $args Optional. Additional arguments passed to the template.
  *                          Default empty array.
@@ -176 +176 @@
      *
      * @param string      $slug The slug name for the generic template.
-     * @param string|null $name The name of the specialized template or null if
-     *                          there is none.
+     * @param string|null $name The name of the specialized template
+     *                          or null if there is none.
      * @param array       $args Additional arguments passed to the template.
      */
@@ -197 +197 @@
      *
      * @param string   $slug      The slug name for the generic template.
-     * @param string   $name      The name of the specialized template or an empty
-     *                            string if there is none.
+     * @param string   $name      The name of the specialized template
+     *                            or an empty string if there is none.
      * @param string[] $templates Array of template files to search for, in order.
      * @param array    $args      Additional arguments passed to the template.
@@ -1917 +1917 @@
  * @param string $before   Optional. Content to prepend to the description. Default empty.
  * @param string $after    Optional. Content to append to the description. Default empty.
- * @param bool   $selected Optional. Set to true if the current page is the selected archive page.
+ * @param bool   $selected Optional. Set to true if the current page is the selected archive page. Default false.
  * @return string HTML link content for archive.
  */