Changeset 7361 for trunk/src/includes/admin/forums.php

Timestamp:

11/16/2025 11:04:14 PM (3 months ago)

Author:

johnjamesjacoby

Message:

Tools - Code Improvement: Document some filters.

This commit improves the code documentation of several filters across the codebase.

Props johnjamesjacoby, narenin, sirlouen.

In trunk, for 2.7.

See #3110.

File:

• trunk/src/includes/admin/forums.php (modified) (4 diffs)

trunk/src/includes/admin/forums.php

@@ -483 +483 @@
     private function get_row_action_sort_order() {
 
-        // Filter & return
+        /**
+         * Filters the row action sort order.
+         *
+         * @since 2.6.0 bbPress (r6771)
+         *
+         * @param array $order The default sort order.
+         */
         return (array) apply_filters( 'bbp_admin_forum_row_action_sort_order', array(
             'edit',
@@ -503 +509 @@
     private function get_allowed_notice_toggles() {
 
-        // Filter & return
-        return apply_filters( 'bbp_admin_forums_allowed_notice_toggles', array(
+        /**
+         * Filters the allowed notice toggles.
+         *
+         * @since 2.6.0 bbPress (r6396)
+         *
+         * @param array $toggles The default notice toggles.
+         */
+        return (array) apply_filters( 'bbp_admin_forums_allowed_notice_toggles', array(
             'opened',
             'closed'
@@ -519 +531 @@
     private function get_allowed_action_toggles() {
 
-        // Filter & return
+        /**
+         * Filters the allowed action toggles.
+         *
+         * @since 2.6.0 bbPress (r6396)
+         *
+         * @param array $toggles The default action toggles.
+         */
         return apply_filters( 'bbp_admin_forums_allowed_action_toggles', array(
             'bbp_toggle_forum_close'
@@ -553 +571 @@
         }
 
-        // Filter & return
-        return apply_filters( 'bbp_admin_forums_column_headers', $columns );
+        /**
+         * Filters the column headers for the forums page.
+         *
+         * @since 2.0.0 bbPress (r2485)
+         *
+         * @param array $columns The column headers.
+         */
+        return (array) apply_filters( 'bbp_admin_forums_column_headers', $columns );
     }