Changeset 7361 for trunk/src/includes/admin/replies.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/replies.php (modified) (4 diffs)

trunk/src/includes/admin/replies.php

@@ -612 +612 @@
     private function get_row_action_sort_order() {
 
-        // Filter & return
+        /**
+         * Filters the row action sort order for replies.
+         *
+         * @since 2.6.0 bbPress (r6771)
+         *
+         * @param array $order The default sort order.
+         */
         return (array) apply_filters( 'bbp_admin_reply_row_action_sort_order', array(
             'edit',
@@ -635 +641 @@
     private function get_allowed_notice_toggles() {
 
-        // Filter & return
-        return apply_filters( 'bbp_admin_replies_allowed_notice_toggles', array(
+        /**
+         * Filters the allowed notice toggles for replies.
+         *
+         * @since 2.6.0 bbPress (r6396)
+         *
+         * @param array $toggles The default notice toggles.
+         */
+        return (array) apply_filters( 'bbp_admin_replies_allowed_notice_toggles', array(
             'spammed',
             'unspammed',
@@ -653 +665 @@
     private function get_allowed_action_toggles() {
 
-        // Filter & return
-        return apply_filters( 'bbp_admin_replies_allowed_action_toggles', array(
+        /**
+         * Filters the allowed action toggles for replies.
+         *
+         * @since 2.6.0 bbPress (r6396)
+         *
+         * @param array $toggles The default action toggles.
+         */
+        return (array) apply_filters( 'bbp_admin_replies_allowed_action_toggles', array(
             'bbp_toggle_reply_spam',
             'bbp_toggle_reply_approve'
@@ -679 +697 @@
         );
 
-        // Filter & return
-        return apply_filters( 'bbp_admin_replies_column_headers', $columns );
+        /**
+         * Filters the column headers for the replies page.
+         *
+         * @since 2.0.0 bbPress (r2577)
+         *
+         * @param array $columns The column headers.
+         */
+        return (array) apply_filters( 'bbp_admin_replies_column_headers', $columns );
     }