Skip to:
Content

bbPress.org

Changeset 6438


Ignore:
Timestamp:
05/27/2017 05:04:31 PM (8 years ago)
Author:
johnjamesjacoby
Message:

Tools: Add //Filter & return note for future discovery of missing filter documentation.

Also adjust some type-casting on filtered results.

Location:
trunk/src/includes
Files:
41 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/includes/admin/admin.php

    r6419 r6438  
    448448        }
    449449
     450        // Filter & return
    450451        return apply_filters( 'bbp_map_settings_meta_caps', $caps, $cap, $user_id, $args );
    451452    }

  • trunk/src/includes/admin/common.php

    r6415 r6438  
    167167    $value = rtrim( $value, '/' );
    168168
    169     // Filter the result and return
     169    // Filter & return
    170170    return apply_filters( 'bbp_sanitize_slug', $value, $slug );
    171171}

  • trunk/src/includes/admin/forums.php

    r6398 r6438  
    540540     */
    541541    private function get_allowed_notice_toggles() {
     542
     543        // Filter & return
    542544        return apply_filters( 'bbp_admin_forums_allowed_notice_toggles', array(
    543545            'opened',
    … …  
    554556     */
    555557    private function get_allowed_action_toggles() {
     558
     559        // Filter & return
    556560        return apply_filters( 'bbp_admin_forums_allowed_action_toggles', array(
    557561            'bbp_toggle_forum_close'
    … …  
    588592        }
    589593
     594        // Filter & return
    590595        return apply_filters( 'bbp_admin_forums_column_headers', $columns );
    591596    }

  • trunk/src/includes/admin/metaboxes.php

    r6424 r6438  
    5151    }
    5252
    53     // Filter and return
     53    // Filter & return
    5454    return apply_filters( 'bbp_dashboard_at_a_glance', $elements, $r );
    5555}

  • trunk/src/includes/admin/replies.php

    r6424 r6438  
    642642     */
    643643    private function get_allowed_notice_toggles() {
     644
     645        // Filter & return
    644646        return apply_filters( 'bbp_admin_replies_allowed_notice_toggles', array(
    645647            'spammed',
    … …  
    658660     */
    659661    private function get_allowed_action_toggles() {
     662
     663        // Filter & return
    660664        return apply_filters( 'bbp_admin_replies_allowed_action_toggles', array(
    661665            'bbp_toggle_reply_spam',
    … …  
    684688        );
    685689
     690        // Filter & return
    686691        return apply_filters( 'bbp_admin_replies_column_headers', $columns );
    687692    }

  • trunk/src/includes/admin/settings.php

    r6435 r6438  
    2121 */
    2222function bbp_admin_get_settings_sections() {
     23
     24    // Filter & return
    2325    return (array) apply_filters( 'bbp_admin_get_settings_sections', array(
    2426        'bbp_settings_users' => array(
    … …  
    8385 */
    8486function bbp_admin_get_settings_fields() {
     87
     88    // Filter & return
    8589    return (array) apply_filters( 'bbp_admin_get_settings_fields', array(
    8690
    … …  
    17551759        }
    17561760
    1757         // Allow plugins to further filter the output
     1761        // Filter & return
    17581762        return apply_filters( 'bbp_get_form_option', $value, $option );
    17591763    }

  • trunk/src/includes/admin/tools.php

    r6393 r6438  
    458458 */
    459459function bbp_get_tools_admin_pages() {
    460     return apply_filters( 'bbp_tools_admin_tabs', array(
     460
     461    // Filter & return
     462    return (array) apply_filters( 'bbp_tools_admin_tabs', array(
    461463        array(
    462464            'page' => 'bbp-repair',

  • trunk/src/includes/admin/tools/common.php

    r6415 r6438  
    2222}
    2323
    24 /**
    25  * Return the URL to run a specific repair tool
    26  *
    27  * @since 2.6.0 bbPress (r5885)
    28  *
    29  * @param string $component
    30  */
    31 function bbp_get_admin_repair_tool_run_url( $component = array() ) {
    32     $tools  = admin_url( 'tools.php' );
    33     $page   = ( 'repair' === $component['type'] ) ? 'bbp-repair' : 'bbp-upgrade';
    34     $args   = array( 'page' => $page, 'action' => 'run', 'checked' => array( $component['id'] ) );
    35     $url    = add_query_arg( $args, $tools );
    36     $nonced = wp_nonce_url( $url, 'bbpress-do-counts' );
    37 
    38     return apply_filters( 'bbp_get_admin_repair_tool_run_url', $nonced, $component );
    39 }
     24    /**
     25     * Return the URL to run a specific repair tool
     26     *
     27     * @since 2.6.0 bbPress (r5885)
     28     *
     29     * @param string $component
     30     */
     31    function bbp_get_admin_repair_tool_run_url( $component = array() ) {
     32        $tools  = admin_url( 'tools.php' );
     33        $page   = ( 'repair' === $component['type'] ) ? 'bbp-repair' : 'bbp-upgrade';
     34        $args   = array( 'page' => $page, 'action' => 'run', 'checked' => array( $component['id'] ) );
     35        $url    = add_query_arg( $args, $tools );
     36        $nonced = wp_nonce_url( $url, 'bbpress-do-counts' );
     37
     38        // Filter & return
     39        return apply_filters( 'bbp_get_admin_repair_tool_run_url', $nonced, $component );
     40    }
    4041
    4142/**
    … …  
    174175    }
    175176
     177    // Filter & return
    176178    return apply_filters( 'bbp_get_admin_repair_tools', $tools, $type );
    177179}
    … …  
    198200    }
    199201
     202    // Filter & return
    200203    return apply_filters( 'bbp_get_admin_repair_tool_registered_components', $retval );
    201204}
    … …  
    380383    ksort( $repair_list );
    381384
     385    // Filter & return
    382386    return (array) apply_filters( 'bbp_repair_list', $repair_list );
    383387}

  • trunk/src/includes/admin/topics.php

    r6424 r6438  
    840840     */
    841841    private function get_allowed_notice_toggles() {
    842         return apply_filters( 'bbp_admin_topics_allowed_notice_toggles', array(
     842
     843        // Filter & return
     844        return (array) apply_filters( 'bbp_admin_topics_allowed_notice_toggles', array(
    843845            'opened',
    844846            'closed',
    … …  
    861863     */
    862864    private function get_allowed_action_toggles() {
    863         return apply_filters( 'bbp_admin_topics_allowed_action_toggles', array(
     865
     866        // Filter & return
     867        return (array) apply_filters( 'bbp_admin_topics_allowed_action_toggles', array(
    864868            'bbp_toggle_topic_close',
    865869            'bbp_toggle_topic_stick',
    … …  
    891895        );
    892896
    893         return apply_filters( 'bbp_admin_topics_column_headers', $columns );
     897        // Filter & return
     898        return (array) apply_filters( 'bbp_admin_topics_column_headers', $columns );
    894899    }
    895900

  • trunk/src/includes/common/ajax.php

    r5951 r6438  
    3838        $ajaxurl  = add_query_arg( array( 'bbp-ajax' => 'true' ), $base_url );
    3939
     40        // Filter & return
    4041        return apply_filters( 'bbp_get_ajax_url', $ajaxurl );
    4142    }

  • trunk/src/includes/common/formatting.php

    r6380 r6438  
    2323 */
    2424function bbp_kses_allowed_tags() {
    25     return apply_filters( 'bbp_kses_allowed_tags', array(
     25
     26    // Filter & return
     27    return (array) apply_filters( 'bbp_kses_allowed_tags', array(
    2628
    2729        // Links
    … …  
    528530
    529531    // Filter & return
    530     return apply_filters( 'bbp_number_not_negative', $not_less_than_zero, $int, $number );
     532    return (int) apply_filters( 'bbp_number_not_negative', $not_less_than_zero, $int, $number );
    531533}
    532534
    … …  
    549551    }
    550552
     553    // Filter & return
    551554    return apply_filters( 'bbp_number_format', number_format( $number, $decimals, $dec_point, $thousands_sep ), $number, $decimals, $dec_point, $thousands_sep );
    552555}
    … …  
    570573    }
    571574
     575    // Filter & return
    572576    return apply_filters( 'bbp_number_format_i18n', number_format_i18n( $number, $decimals ), $number, $decimals );
    573577}
    … …  
    593597    $new_time = mysql2date( $d, $time, $translate );
    594598
     599    // Filter & return
    595600    return apply_filters( 'bbp_convert_date', $new_time, $d, $translate, $time );
    596601}
    … …  
    711716        }
    712717
     718        // Filter & return
    713719        return apply_filters( 'bbp_get_time_since', $output, $older_date, $newer_date );
    714720    }

  • trunk/src/includes/common/functions.php

    r6437 r6438  
    2424 */
    2525function bbp_get_redirect_to() {
    26     $retval = ! empty( $_REQUEST['redirect_to'] ) ? $_REQUEST['redirect_to'] : '';
    27 
     26
     27    // Check 'redirect_to' request parameter
     28    $retval = ! empty( $_REQUEST['redirect_to'] )
     29        ? $_REQUEST['redirect_to']
     30        : '';
     31
     32    // Filter & return
    2833    return apply_filters( 'bbp_get_redirect_to', $retval );
    2934}
    … …  
    4449
    4550    // Are we appending the view=all vars?
    46     if ( bbp_get_view_all() || ! empty( $force ) ) {
    47         $link = add_query_arg( array( 'view' => 'all' ), $original_link );
    48     } else {
    49         $link = $original_link;
    50     }
    51 
     51    $link = ( bbp_get_view_all() || ! empty( $force ) )
     52        ? add_query_arg( array( 'view' => 'all' ), $original_link )
     53        : $original_link;
     54
     55    // Filter & return
    5256    return apply_filters( 'bbp_add_view_all', $link, $original_link );
    5357}
    … …  
    6569 */
    6670function bbp_remove_view_all( $original_link = '' ) {
    67     return apply_filters( 'bbp_remove_view_all', remove_query_arg( 'view', $original_link ), $original_link );
     71
     72    // Remove `view' argument
     73    $link = remove_query_arg( 'view', $original_link );
     74
     75    // Filter & return
     76    return apply_filters( 'bbp_remove_view_all', $link, $original_link );
    6877}
    6978
    … …  
    7988function bbp_get_view_all( $cap = 'moderate' ) {
    8089    $retval = ( ( ! empty( $_GET['view'] ) && ( 'all' === $_GET['view'] ) && current_user_can( $cap ) ) );
     90
     91    // Filter & return
    8192    return apply_filters( 'bbp_get_view_all', (bool) $retval );
    8293}
    … …  
    192203    }
    193204
     205    // Filter & return
    194206    return apply_filters( 'bbp_past_edit_lock', (bool) $retval, $cur_time, $lock_time, $post_date_gmt );
    195207}
    … …  
    424436    $statistics['hidden_reply_title'] = isset( $hidden_reply_title ) ? $hidden_reply_title : '';
    425437
     438    // Filter & return
    426439    return apply_filters( 'bbp_get_statistics', $statistics, $r );
    427440}
    … …  
    480493    $r['bbp_anonymous_website'] = apply_filters( 'bbp_pre_anonymous_post_author_website', $r['bbp_anonymous_website'] );
    481494
    482     // Finally, return filtered anonymous post data
     495    // Filter & return
    483496    return (array) apply_filters( 'bbp_filter_anonymous_post_data', $r, $args );
    484497}
    … …  
    519532    }
    520533
    521     // Filter and return
     534    // Filter & return
    522535    return (array) apply_filters( 'bbp_sanitize_anonymous_post_author', $r, $anonymous_data );
    523536}
    … …  
    972985        $sitename = substr( $sitename, 4 );
    973986    }
     987
     988    // Filter & return
    974989    return apply_filters( 'bbp_get_do_not_reply_address', 'noreply@' . $sitename );
    975990}
    … …  
    13651380    }
    13661381
    1367     // Filter and return
     1382    // Filter & return
    13681383    return apply_filters( 'bbp_logout_url', $url, $redirect_to );
    13691384}
    … …  
    15151530    unset( $query );
    15161531
    1517     // Filter and return
     1532    // Filter & return
    15181533    return (int) apply_filters( 'bbp_get_public_child_last_id', $child_id, $parent_id, $post_type );
    15191534}
    … …  
    15661581    unset( $query );
    15671582
    1568     // Filter and return
     1583    // Filter & return
    15691584    return (int) apply_filters( 'bbp_get_public_child_count', $child_count, $parent_id, $post_type );
    15701585}
    … …  
    16171632    unset( $query );
    16181633
    1619     // Filter and return
     1634    // Filter & return
    16201635    return (array) apply_filters( 'bbp_get_public_child_ids', $child_ids, $parent_id, $post_type );
    16211636}
    … …  
    17011716    $child_ids = wp_parse_id_list( $child_ids );
    17021717
    1703     // Filter and return
     1718    // Filter & return
    17041719    return (array) apply_filters( 'bbp_get_all_child_ids', $child_ids, $parent_id, $post_type );
    17051720}
    … …  
    17261741        : '';
    17271742
     1743    // Filter & return
    17281744    return apply_filters( 'bbp_get_global_post_field', $retval, $post, $field, $context );
    17291745}
    … …  
    20592075    }
    20602076
     2077    // Filter & return
    20612078    return apply_filters( 'bbp_get_page_by_path', $retval, $path );
    20622079}

  • trunk/src/includes/common/shortcodes.php

    r6415 r6438  
    175175        $this->unset_globals();
    176176
     177        // Get the query name, for filter
     178        $query_name = bbp_get_query_name();
     179
    177180        // Reset the query name
    178181        bbp_reset_query_name();
    179182
    180183        // Return and flush the output buffer
    181         return ob_get_clean();
     184        $output = ob_get_clean();
     185
     186        // Filter & return
     187        return apply_filters( 'bbp_display_shortcode', $output, $query_name );
    182188    }
    183189

  • trunk/src/includes/common/template.php

    r6433 r6438  
    112112    $public = get_blog_option( $site_id, 'blog_public', 1 );
    113113
     114    // Filter & return
    114115    return (bool) apply_filters( 'bbp_is_site_public', $public, $site_id );
    115116}
    … …  
    134135    }
    135136
     137    // Filter & return
    136138    return (bool) apply_filters( 'bbp_is_forum', $retval, $post_id );
    137139}
    … …  
    158160    }
    159161
     162    // Filter & return
    160163    return (bool) apply_filters( 'bbp_is_forum_archive', $retval );
    161164}
    … …  
    188191    }
    189192
     193    // Filter & return
    190194    return (bool) apply_filters( 'bbp_is_single_forum', $retval );
    191195}
    … …  
    214218    }
    215219
     220    // Filter & return
    216221    return (bool) apply_filters( 'bbp_is_forum_edit', $retval );
    217222}
    … …  
    237242    }
    238243
     244    // Filter & return
    239245    return (bool) apply_filters( 'bbp_is_topic', $retval, $post_id );
    240246}
    … …  
    267273    }
    268274
     275    // Filter & return
    269276    return (bool) apply_filters( 'bbp_is_single_topic', $retval );
    270277}
    … …  
    290297    }
    291298
     299    // Filter & return
    292300    return (bool) apply_filters( 'bbp_is_topic_archive', $retval );
    293301}
    … …  
    316324    }
    317325
     326    // Filter & return
    318327    return (bool) apply_filters( 'bbp_is_topic_edit', $retval );
    319328}
    … …  
    337346    }
    338347
     348    // Filter & return
    339349    return (bool) apply_filters( 'bbp_is_topic_merge', $retval );
    340350}
    … …  
    358368    }
    359369
     370    // Filter & return
    360371    return (bool) apply_filters( 'bbp_is_topic_split', $retval );
    361372}
    … …  
    388399    }
    389400
     401    // Filter & return
    390402    return (bool) apply_filters( 'bbp_is_topic_tag', $retval );
    391403}
    … …  
    419431    }
    420432
     433    // Filter & return
    421434    return (bool) apply_filters( 'bbp_is_topic_tag_edit', $retval );
    422435}
    … …  
    449462    }
    450463
     464    // Filter & return
    451465    return (bool) apply_filters( 'bbp_is_custom_post_type', $retval, $the_post );
    452466}
    … …  
    472486    }
    473487
     488    // Filter & return
    474489    return (bool) apply_filters( 'bbp_is_reply', $retval, $post_id );
    475490}
    … …  
    498513    }
    499514
     515    // Filter & return
    500516    return (bool) apply_filters( 'bbp_is_reply_edit', $retval );
    501517}
    … …  
    517533    }
    518534
     535    // Filter & return
    519536    return (bool) apply_filters( 'bbp_is_reply_move', $retval );
    520537}
    … …  
    547564    }
    548565
     566    // Filter & return
    549567    return (bool) apply_filters( 'bbp_is_single_reply', $retval );
    550568}
    … …  
    568586    }
    569587
     588    // Filter & return
    570589    return (bool) apply_filters( 'bbp_is_favorites', $retval );
    571590}
    … …  
    589608    }
    590609
     610    // Filter & return
    591611    return (bool) apply_filters( 'bbp_is_subscriptions', $retval );
    592612}
    … …  
    611631    }
    612632
     633    // Filter & return
    613634    return (bool) apply_filters( 'bbp_is_topics_created', $retval );
    614635}
    … …  
    633654    }
    634655
     656    // Filter & return
    635657    return (bool) apply_filters( 'bbp_is_replies_created', $retval );
    636658}
    … …  
    658680    }
    659681
     682    // Filter & return
    660683    return (bool) apply_filters( 'bbp_is_user_home', $retval );
    661684}
    … …  
    681704    }
    682705
     706    // Filter & return
    683707    return (bool) apply_filters( 'bbp_is_user_home_edit', $retval );
    684708}
    … …  
    703727    }
    704728
     729    // Filter & return
    705730    return (bool) apply_filters( 'bbp_is_single_user', $retval );
    706731}
    … …  
    725750    }
    726751
     752    // Filter & return
    727753    return (bool) apply_filters( 'bbp_is_single_user_edit', $retval );
    728754}
    … …  
    747773    }
    748774
     775    // Filter & return
    749776    return (bool) apply_filters( 'bbp_is_single_user_profile', $retval );
    750777}
    … …  
    769796    }
    770797
     798    // Filter & return
    771799    return (bool) apply_filters( 'bbp_is_single_user_topics', $retval );
    772800}
    … …  
    791819    }
    792820
     821    // Filter & return
    793822    return (bool) apply_filters( 'bbp_is_single_user_replies', $retval );
    794823}
    … …  
    813842    }
    814843
     844    // Filter & return
    815845    return (bool) apply_filters( 'bbp_is_single_user_engagements', $retval );
    816846}
    … …  
    841871    }
    842872
     873    // Filter & return
    843874    return (bool) apply_filters( 'bbp_is_single_view', $retval );
    844875}
    … …  
    879910    }
    880911
     912    // Filter & return
    881913    return (bool) apply_filters( 'bbp_is_search', $retval );
    882914}
    … …  
    917949    }
    918950
     951    // Filter & return
    919952    return (bool) apply_filters( 'bbp_is_search_results', $retval );
    920953}
    … …  
    939972    }
    940973
     974    // Filter & return
    941975    return (bool) apply_filters( 'bbp_is_edit', $retval );
    942976}
    … …  
    10921126    $classes = apply_filters( 'bbp_get_the_body_class', $classes, $bbp_classes, $wp_classes, $custom_classes );
    10931127
    1094     return apply_filters( 'bbp_body_class', $classes, $bbp_classes, $wp_classes, $custom_classes );
     1128    // Filter & return
     1129    return (array) apply_filters( 'bbp_body_class', $classes, $bbp_classes, $wp_classes, $custom_classes );
    10951130}
    10961131
    … …  
    12481283
    12491284        // Add action as query arg
    1250         if ( ! empty( $r['action'] ) ) {
    1251             $login_url = add_query_arg( array( 'action' => $r['action'] ), $r['url'] );
    1252 
    1253         // No query arg
    1254         } else {
    1255             $login_url = $r['url'];
    1256         }
     1285        $login_url = ! empty( $r['action'] )
     1286            ? add_query_arg( array( 'action' => $r['action'] ), $r['url'] )
     1287            : $r['url'];
    12571288
    12581289        $login_url = site_url( $login_url, $r['context'] );
    12591290
     1291        // Filter & return
    12601292        return apply_filters( 'bbp_get_wp_login_action', $login_url, $r, $args );
    12611293    }
    … …  
    12901322    $redirect_field = '<input type="hidden" id="bbp_redirect_to" name="redirect_to" value="' . esc_url( $redirect_to ) . '" />';
    12911323
     1324    // Filter & return
    12921325    echo apply_filters( 'bbp_redirect_to_field', $redirect_field, $redirect_to );
    12931326}
    … …  
    13511384        }
    13521385
     1386        // Filter & return
    13531387        return apply_filters( 'bbp_get_sanitize_val', $retval, $request, $input_type );
    13541388    }
    … …  
    13971431        }
    13981432
     1433        // Filter & return
    13991434        return apply_filters( 'bbp_get_tab_index', (int) $bbp->tab_index );
    14001435    }
    … …  
    16251660        }
    16261661
     1662        // Filter & return
    16271663        return apply_filters( 'bbp_get_dropdown', $retval, $r );
    16281664    }
    … …  
    19391975        $output = ob_get_clean();
    19401976
     1977        // Filter & return
    19411978        return apply_filters( 'bbp_get_the_content', $output, $args, $post_content );
    19421979    }
    … …  
    19642001    $plugins[] = 'tabfocus';
    19652002
     2003    // Filter & return
    19662004    return apply_filters( 'bbp_get_tiny_mce_plugins', $plugins );
    19672005}
    … …  
    19892027    array_push( $buttons, 'image' );
    19902028
     2029    // Filter & return
    19912030    return apply_filters( 'bbp_get_teeny_mce_buttons', $buttons );
    19922031}
    … …  
    20162055    $settings['buttons'] = implode( ',', $buttons );
    20172056
     2057    // Filter & return
    20182058    return apply_filters( 'bbp_get_quicktags_settings', $settings );
    20192059}
    … …  
    21432183        }
    21442184
     2185        // Filter & return
    21452186        return apply_filters( 'bbp_get_view_link', $url, $view );
    21462187    }
    … …  
    25042545        $trail  = ! empty( $crumbs ) ? ( $r['before'] . $r['crumb_before'] . implode( $sep . $r['crumb_after'] . $r['crumb_before'] , $crumbs ) . $r['crumb_after'] . $r['after'] ) : '';
    25052546
     2547        // Filter & return
    25062548        return apply_filters( 'bbp_get_breadcrumb', $trail, $crumbs, $r );
    25072549    }
    … …  
    25482590        }
    25492591
     2592        // Filter & return
    25502593        return apply_filters( 'bbp_get_allowed_tags', htmlentities( $allowed ) );
    25512594    }
    … …  
    26412684     */
    26422685    function bbp_get_logout_link( $redirect_to = '' ) {
    2643         return apply_filters( 'bbp_get_logout_link', '<a href="' . wp_logout_url( $redirect_to ) . '" class="button logout-link">' . esc_html__( 'Log Out', 'bbpress' ) . '</a>', $redirect_to );
     2686
     2687        // Build the link
     2688        $link = '<a href="' . wp_logout_url( $redirect_to ) . '" class="button logout-link">' . esc_html__( 'Log Out', 'bbpress' ) . '</a>';
     2689
     2690        // Filter & return
     2691        return apply_filters( 'bbp_get_logout_link', $link, $redirect_to );
    26442692    }
    26452693
    … …  
    28582906    }
    28592907
    2860     // Filter and return
     2908    // Filter & return
    28612909    return apply_filters( 'bbp_title', $new_title, $sep, $seplocation );
    28622910}

  • trunk/src/includes/core/abstraction.php

    r6243 r6438  
    103103 */
    104104function bbp_get_root_url() {
     105
     106    // Filter & return
    105107    return apply_filters( 'bbp_get_root_url', bbp_rewrite()->root );
    106108}
    … …  
    114116 */
    115117function bbp_get_paged_slug() {
     118
     119    // Filter & return
    116120    return apply_filters( 'bbp_get_paged_slug', bbp_rewrite()->pagination_base );
    117121}

  • trunk/src/includes/core/capabilities.php

    r6118 r6438  
    208208    }
    209209
     210    // Filter & return
    210211    return apply_filters( 'bbp_get_caps_for_role', $caps, $role );
    211212}
    … …  
    265266    $all_roles = apply_filters( 'editable_roles', $the_roles );
    266267
     268    // Filter & return
    267269    return apply_filters( 'bbp_get_blog_roles', $all_roles, $wp_roles );
    268270}
    … …  
    395397        : '';
    396398
     399    // Filter & return
    397400    return apply_filters( 'bbp_get_dynamic_role_name', $role, $role_id, $roles );
    398401}
    … …  
    436439 */
    437440function bbp_get_keymaster_role() {
     441
     442    // Filter & return
    438443    return apply_filters( 'bbp_get_keymaster_role', 'bbp_keymaster' );
    439444}
    … …  
    448453 */
    449454function bbp_get_moderator_role() {
     455
     456    // Filter & return
    450457    return apply_filters( 'bbp_get_moderator_role', 'bbp_moderator' );
    451458}
    … …  
    460467 */
    461468function bbp_get_participant_role() {
     469
     470    // Filter & return
    462471    return apply_filters( 'bbp_get_participant_role', 'bbp_participant' );
    463472}
    … …  
    472481 */
    473482function bbp_get_spectator_role() {
     483
     484    // Filter & return
    474485    return apply_filters( 'bbp_get_spectator_role', 'bbp_spectator' );
    475486}
    … …  
    484495 */
    485496function bbp_get_blocked_role() {
     497
     498    // Filter & return
    486499    return apply_filters( 'bbp_get_blocked_role', 'bbp_blocked' );
    487500}

  • trunk/src/includes/core/filters.php

    r6431 r6438  
    342342 */
    343343function _bbp_has_forums_query( $args = array() ) {
     344
     345    // Filter & return
    344346    return apply_filters( 'bbp_has_forums_query', $args );
    345347}
    … …  
    355357 */
    356358function _bbp_has_topics_query( $args = array() ) {
     359
     360    // Filter & return
    357361    return apply_filters( 'bbp_has_topics_query', $args );
    358362}
    … …  
    368372 */
    369373function _bbp_has_replies_query( $args = array() ) {
     374
     375    // Filter & return
    370376    return apply_filters( 'bbp_has_replies_query', $args );
    371377}

  • trunk/src/includes/core/functions.php

    r6353 r6438  
    284284        : false;
    285285
     286    // Filter & return
    286287    return apply_filters( 'bbp_get_view_query_args', $retval, $view );
    287288}
    … …  
    337338 */
    338339function bbp_find_mentions_pattern() {
     340
     341    // Filter & return
    339342    return apply_filters( 'bbp_find_mentions_pattern', '/[@]+([A-Za-z0-9-_\.@]+)\b/' );
    340343}
    … …  
    359362    }
    360363
     364    // Filter & return
    361365    return apply_filters( 'bbp_find_mentions', $usernames, $pattern, $content );
    362366}

  • trunk/src/includes/core/options.php

    r6419 r6438  
    2222function bbp_get_default_options() {
    2323
    24     // Default options
     24    // Filter & return
    2525    return apply_filters( 'bbp_get_default_options', array(
    2626
    … …  
    216216 */
    217217function bbp_is_favorites_active( $default = 1 ) {
     218
     219    // Filter & return
    218220    return (bool) apply_filters( 'bbp_is_favorites_active', (bool) get_option( '_bbp_enable_favorites', $default ) );
    219221}
    … …  
    229231 */
    230232function bbp_is_subscriptions_active( $default = 1 ) {
     233
     234    // Filter & return
    231235    return (bool) apply_filters( 'bbp_is_subscriptions_active', (bool) get_option( '_bbp_enable_subscriptions', $default ) );
    232236}
    … …  
    242246 */
    243247function bbp_is_engagements_active( $default = 1 ) {
     248
     249    // Filter & return
    244250    return (bool) apply_filters( 'bbp_is_engagements_active', (bool) get_option( '_bbp_enable_engagements', $default ) );
    245251}
    … …  
    255261 */
    256262function bbp_allow_topic_tags( $default = 1 ) {
     263
     264    // Filter & return
    257265    return (bool) apply_filters( 'bbp_allow_topic_tags', (bool) get_option( '_bbp_allow_topic_tags', $default ) );
    258266}
    … …  
    269277 */
    270278function bbp_allow_forum_mods( $default = 1 ) {
     279
     280    // Filter & return
    271281    return (bool) apply_filters( 'bbp_allow_forum_mods', (bool) get_option( '_bbp_allow_forum_mods', $default ) );
    272282}
    … …  
    282292 */
    283293function bbp_allow_search( $default = 1 ) {
     294
     295    // Filter & return
    284296    return (bool) apply_filters( 'bbp_allow_search', (bool) get_option( '_bbp_allow_search', $default ) );
    285297}
    … …  
    295307 */
    296308function bbp_allow_threaded_replies( $default = 0 ) {
     309
     310    // Filter & return
    297311    return (bool) apply_filters( '_bbp_allow_threaded_replies', (bool) get_option( '_bbp_allow_threaded_replies', $default ) );
    298312}
    … …  
    310324 */
    311325function bbp_thread_replies_depth( $default = 2 ) {
     326
     327    // Filter & return
    312328    return (int) apply_filters( 'bbp_thread_replies_depth', (int) get_option( '_bbp_thread_replies_depth', $default ) );
    313329}
    … …  
    323339 */
    324340function bbp_allow_revisions( $default = 1 ) {
     341
     342    // Filter & return
    325343    return (bool) apply_filters( 'bbp_allow_revisions', (bool) get_option( '_bbp_allow_revisions', $default ) );
    326344}
    … …  
    336354 */
    337355function bbp_allow_anonymous( $default = 0 ) {
     356
     357    // Filter & return
    338358    return apply_filters( 'bbp_allow_anonymous', (bool) get_option( '_bbp_allow_anonymous', $default ) );
    339359}
    … …  
    349369 */
    350370function bbp_allow_global_access( $default = 1 ) {
     371
     372    // Filter & return
    351373    return (bool) apply_filters( 'bbp_allow_global_access', (bool) get_option( '_bbp_allow_global_access', $default ) );
    352374}
    … …  
    362384 */
    363385function bbp_get_default_role( $default = 'bbp_participant' ) {
     386
     387    // Filter & return
    364388    return apply_filters( 'bbp_get_default_role', get_option( '_bbp_default_role', $default ) );
    365389}
    … …  
    375399 */
    376400function bbp_use_wp_editor( $default = 1 ) {
     401
     402    // Filter & return
    377403    return (bool) apply_filters( 'bbp_use_wp_editor', (bool) get_option( '_bbp_use_wp_editor', $default ) );
    378404}
    … …  
    388414 */
    389415function bbp_use_autoembed( $default = 1 ) {
     416
     417    // Filter & return
    390418    return (bool) apply_filters( 'bbp_use_autoembed', (bool) get_option( '_bbp_use_autoembed', $default ) );
    391419}
    … …  
    401429 */
    402430function bbp_get_theme_package_id( $default = 'default' ) {
     431
     432    // Filter & return
    403433    return apply_filters( 'bbp_get_theme_package_id', get_option( '_bbp_theme_package_id', $default ) );
    404434}
    … …  
    424454     */
    425455    function bbp_get_title_max_length( $default = 80 ) {
     456
     457        // Filter & return
    426458        return (int) apply_filters( 'bbp_get_title_max_length', (int) get_option( '_bbp_title_max_length', $default ) );
    427459    }
    … …  
    447479     */
    448480    function bbp_get_group_forums_root_id( $default = 0 ) {
     481
     482        // Filter & return
    449483        return (int) apply_filters( 'bbp_get_group_forums_root_id', (int) get_option( '_bbp_group_forums_root_id', $default ) );
    450484    }
    … …  
    460494 */
    461495function bbp_is_group_forums_active( $default = 1 ) {
     496
     497    // Filter & return
    462498    return (bool) apply_filters( 'bbp_is_group_forums_active', (bool) get_option( '_bbp_enable_group_forums', $default ) );
    463499}
    … …  
    473509 */
    474510function bbp_is_akismet_active( $default = 1 ) {
     511
     512    // Filter & return
    475513    return (bool) apply_filters( 'bbp_is_akismet_active', (bool) get_option( '_bbp_enable_akismet', $default ) );
    476514}
    … …  
    521559 */
    522560function bbp_get_root_slug( $default = 'forums' ) {
     561
     562    // Filter & return
    523563    return apply_filters( 'bbp_get_root_slug', get_option( '_bbp_root_slug', $default ) );
    524564}
    … …  
    532572 */
    533573function bbp_include_root_slug( $default = 1 ) {
     574
     575    // Filter & return
    534576    return (bool) apply_filters( 'bbp_include_root_slug', (bool) get_option( '_bbp_include_root', $default ) );
    535577}
    … …  
    543585 */
    544586function bbp_show_on_root( $default = 'forums' ) {
     587
     588    // Filter & return
    545589    return apply_filters( 'bbp_show_on_root', get_option( '_bbp_show_on_root', $default ) );
    546590}
    … …  
    560604    }
    561605
     606    // Filter & return
    562607    return apply_filters( 'bbp_maybe_get_root_slug', $retval );
    563608}
    … …  
    571616 */
    572617function bbp_get_forum_slug( $default = 'forum' ) {
     618
     619    // Filter & return
    573620    return apply_filters( 'bbp_get_forum_slug', bbp_maybe_get_root_slug() . get_option( '_bbp_forum_slug', $default ) );
    574621}
    … …  
    582629 */
    583630function bbp_get_topic_archive_slug( $default = 'topics' ) {
     631
     632    // Filter & return
    584633    return apply_filters( 'bbp_get_topic_archive_slug', get_option( '_bbp_topic_archive_slug', $default ) );
    585634}
    … …  
    593642 */
    594643function bbp_get_reply_archive_slug( $default = 'replies' ) {
     644
     645    // Filter & return
    595646    return apply_filters( 'bbp_get_reply_archive_slug', get_option( '_bbp_reply_archive_slug', $default ) );
    596647}
    … …  
    604655 */
    605656function bbp_get_topic_slug( $default = 'topic' ) {
     657
     658    // Filter & return
    606659    return apply_filters( 'bbp_get_topic_slug', bbp_maybe_get_root_slug() . get_option( '_bbp_topic_slug', $default ) );
    607660}
    … …  
    615668 */
    616669function bbp_get_topic_tag_tax_slug( $default = 'topic-tag' ) {
     670
     671    // Filter & return
    617672    return apply_filters( 'bbp_get_topic_tag_tax_slug', bbp_maybe_get_root_slug() . get_option( '_bbp_topic_tag_slug', $default ) );
    618673}
    … …  
    626681 */
    627682function bbp_get_reply_slug( $default = 'reply' ) {
     683
     684    // Filter & return
    628685    return apply_filters( 'bbp_get_reply_slug', bbp_maybe_get_root_slug() . get_option( '_bbp_reply_slug', $default ) );
    629686}
    … …  
    637694 */
    638695function bbp_get_user_slug( $default = 'users' ) {
     696
     697    // Filter & return
    639698    return apply_filters( 'bbp_get_user_slug', bbp_maybe_get_root_slug() . get_option( '_bbp_user_slug', $default ) );
    640699}
    … …  
    648707 */
    649708function bbp_get_user_favorites_slug( $default = 'favorites' ) {
     709
     710    // Filter & return
    650711    return apply_filters( 'bbp_get_user_favorites_slug', get_option( '_bbp_user_favs_slug', $default ) );
    651712}
    … …  
    659720 */
    660721function bbp_get_user_subscriptions_slug( $default = 'subscriptions' ) {
     722
     723    // Filter & return
    661724    return apply_filters( 'bbp_get_user_subscriptions_slug', get_option( '_bbp_user_subs_slug', $default ) );
    662725}
    … …  
    670733 */
    671734function bbp_get_user_engagements_slug( $default = 'engagements' ) {
     735
     736    // Filter & return
    672737    return apply_filters( 'bbp_get_user_engagements_slug', get_option( '_bbp_user_engagements_slug', $default ) );
    673738}
    … …  
    681746 */
    682747function bbp_get_view_slug( $default = 'view' ) {
     748
     749    // Filter & return
    683750    return apply_filters( 'bbp_get_view_slug', bbp_maybe_get_root_slug() . get_option( '_bbp_view_slug', $default ) );
    684751}
    … …  
    692759 */
    693760function bbp_get_search_slug( $default = 'search' ) {
     761
     762    // Filter & return
    694763    return apply_filters( 'bbp_get_search_slug', bbp_maybe_get_root_slug() . get_option( '_bbp_search_slug', $default ) );
    695764}
    … …  
    707776 */
    708777function bbp_get_config_location( $default = '' ) {
     778
     779    // Filter & return
    709780    return apply_filters( 'bbp_get_config_location', get_option( 'bb-config-location', $default ) );
    710781}

  • trunk/src/includes/core/sub-actions.php

    r6302 r6438  
    468468 */
    469469function bbp_plugin_locale( $locale = '', $domain = '' ) {
     470
     471    // Filter & return
    470472    return apply_filters( 'bbp_plugin_locale', $locale, $domain );
    471473}
    … …  
    480482 */
    481483function bbp_request( $query_vars = array() ) {
     484
     485    // Filter & return
    482486    return apply_filters( 'bbp_request', $query_vars );
    483487}
    … …  
    494498 */
    495499function bbp_template_include( $template = '' ) {
     500
     501    // Filter & return
    496502    return apply_filters( 'bbp_template_include', $template );
    497503}
    … …  
    516522 * @since 2.0.0 bbPress (r2944)
    517523 *
     524 * @param array $themes
    518525 * @uses apply_filters() Calls 'bbp_allowed_themes' with the allowed themes list
    519526 */
    520527function bbp_allowed_themes( $themes ) {
     528
     529    // Filter & return
    521530    return apply_filters( 'bbp_allowed_themes', $themes );
    522531}
    … …  
    533542 */
    534543function bbp_map_meta_caps( $caps = array(), $cap = '', $user_id = 0, $args = array() ) {
     544
     545    // Filter & return
    535546    return apply_filters( 'bbp_map_meta_caps', $caps, $cap, $user_id, $args );
    536547}

  • trunk/src/includes/core/template-functions.php

    r6320 r6438  
    353353    $stack = array_unique( array_filter( $stack ) );
    354354
     355    // Filter & return
    355356    return (array) apply_filters( 'bbp_get_template_stack', $stack ) ;
    356357}
    … …  
    412413    $template  = bbp_set_theme_compat_template( $template );
    413414
     415    // Filter & return
    414416    return apply_filters( "bbp_{$type}_template", $template );
    415417}
    … …  
    429431        ''
    430432    );
     433
     434    // Filter & return
    431435    return apply_filters( 'bbp_get_template_locations', $locations, $templates );
    432436}
    … …  
    453457    }
    454458
     459    // Filter & return
    455460    return apply_filters( 'bbp_add_template_stack_locations', array_unique( $retval ), $stacks );
    456461}

  • trunk/src/includes/core/template-loader.php

    r5951 r6438  
    115115    }
    116116
     117    // Filter & return
    117118    return apply_filters( 'bbp_template_include_theme_supports', $template );
    118119}

  • trunk/src/includes/core/theme-compat.php

    r6353 r6438  
    126126 */
    127127function bbp_get_theme_compat_id() {
     128
     129    // Filter & return
    128130    return apply_filters( 'bbp_get_theme_compat_id', bbpress()->theme_compat->theme->id );
    129131}
    … …  
    141143 */
    142144function bbp_get_theme_compat_name() {
     145
     146    // Filter & return
    143147    return apply_filters( 'bbp_get_theme_compat_name', bbpress()->theme_compat->theme->name );
    144148}
    145149
    146150/**
    147  * Gets the version of the bbPress compatable theme used, in the event the
     151 * Gets the version of the bbPress compatible theme used, in the event the
    148152 * currently active WordPress theme does not explicitly support bbPress.
    149153 * This can be filtered or set manually. Tricky theme authors can override the
    … …  
    156160 */
    157161function bbp_get_theme_compat_version() {
     162
     163    // Filter & return
    158164    return apply_filters( 'bbp_get_theme_compat_version', bbpress()->theme_compat->theme->version );
     165}
     166
     167/**
     168 * Gets the bbPress compatible theme used in the event the currently active
     169 * WordPress theme does not explicitly support bbPress. This can be filtered,
     170 * or set manually. Tricky theme authors can override the default and include
     171 * their own bbPress compatibility layers for their themes.
     172 *
     173 * @since 2.0.0 bbPress (r3032)
     174 *
     175 * @uses apply_filters()
     176 * @return string
     177 */
     178function bbp_get_theme_compat_dir() {
     179
     180    // Filter & return
     181    return apply_filters( 'bbp_get_theme_compat_dir', bbpress()->theme_compat->theme->dir );
    159182}
    160183
    … …  
    170193 * @return string
    171194 */
    172 function bbp_get_theme_compat_dir() {
    173     return apply_filters( 'bbp_get_theme_compat_dir', bbpress()->theme_compat->theme->dir );
    174 }
    175 
    176 /**
    177  * Gets the bbPress compatable theme used in the event the currently active
    178  * WordPress theme does not explicitly support bbPress. This can be filtered,
    179  * or set manually. Tricky theme authors can override the default and include
    180  * their own bbPress compatibility layers for their themes.
    181  *
    182  * @since 2.0.0 bbPress (r3032)
    183  *
    184  * @uses apply_filters()
    185  * @return string
    186  */
    187195function bbp_get_theme_compat_url() {
     196
     197    // Filter & return
    188198    return apply_filters( 'bbp_get_theme_compat_url', bbpress()->theme_compat->theme->url );
    189199}
    … …  
    823833    }
    824834
     835    // Filter & return
    825836    return apply_filters( 'bbp_template_include_theme_compat', $template );
    826837}
    … …  
    10171028    }
    10181029
    1019     // Allow override of the override
     1030    // Filter & return
    10201031    return (bool) apply_filters( 'bbp_force_comment_status', $retval, $open, $post_id, $post_type );
    10211032}

  • trunk/src/includes/extend/buddypress/functions.php

    r6415 r6438  
    3030function bbp_get_component_name() {
    3131
    32     // Use existing ID
    33     if ( ! empty( bbpress()->extend->buddypress->id ) ) {
    34         $retval = bbpress()->extend->buddypress->id;
    35 
    36     // Use default
    37     } else {
    38         $retval = 'forums';
    39     }
    40 
     32    // Use existing ID or default
     33    $retval = ! empty( bbpress()->extend->buddypress->id )
     34        ? bbpress()->extend->buddypress->id
     35        : 'forums';
     36
     37    // Filter & return
    4138    return apply_filters( 'bbp_get_component_name', $retval );
    4239}
    … …  
    6562    if ( ! empty( $user_id ) && is_numeric( $user_id ) ) {
    6663        $bbp_user_id = $user_id;
    67     }
    6864
    6965    // Currently viewing or editing a user
    70     elseif ( ( true === $displayed_user_fallback ) && ! empty( $did ) ) {
     66    } elseif ( ( true === $displayed_user_fallback ) && ! empty( $did ) ) {
    7167        $bbp_user_id = $did;
    72     }
    7368
    7469    // Maybe fallback on the current_user ID
    75     elseif ( ( true === $current_user_fallback ) && ! empty( $lid ) ) {
     70    } elseif ( ( true === $current_user_fallback ) && ! empty( $lid ) ) {
    7671        $bbp_user_id = $lid;
    7772    }
    … …  
    8176
    8277/**
    83  * Filter the bbPress is_single_user function with BuddyPress eqivalent
     78 * Filter the bbPress is_single_user function with BuddyPress equivalent
    8479 *
    8580 * @since 2.1.0 bbPress (r3552)
    … …  
    9792
    9893/**
    99  * Filter the bbPress is_user_home function with BuddyPress eqivalent
     94 * Filter the bbPress is_user_home function with BuddyPress equivalent
    10095 *
    10196 * @since 2.1.0 bbPress (r3552)
    … …  
    578573    $retval    = (bool) ! empty( $group_ids );
    579574
     575    // Filter & return
    580576    return (bool) apply_filters( 'bbp_is_forum_group_forum', $retval, $forum_id, $group_ids );
    581577}
    … …  
    748744 */
    749745function bbp_get_activity_actions() {
    750     return apply_filters( 'bbp_get_activity_actions', array(
     746
     747    // Filter & return
     748    return (array) apply_filters( 'bbp_get_activity_actions', array(
    751749        'topic' => __( '%1$s started the topic %2$s in the forum %3$s',    'bbpress' ),
    752750        'reply' => __( '%1$s replied to the topic %2$s in the forum %3$s', 'bbpress' )

  • trunk/src/includes/extend/buddypress/groups.php

    r6433 r6438  
    293293        }
    294294
    295         return apply_filters( 'bbp_map_group_forum_topic_meta_caps', $caps, $cap, $user_id, $args );
     295        // Filter & return
     296        return (array) apply_filters( 'bbp_map_group_forum_topic_meta_caps', $caps, $cap, $user_id, $args );
    296297    }
    297298

  • trunk/src/includes/forums/capabilities.php

    r6426 r6438  
    1919 */
    2020function bbp_get_forum_caps() {
    21     return apply_filters( 'bbp_get_forum_caps', array (
     21
     22    // Filter & return
     23    return (array) apply_filters( 'bbp_get_forum_caps', array (
    2224        'edit_posts'          => 'edit_forums',
    2325        'edit_others_posts'   => 'edit_others_forums',
    … …  
    200202    }
    201203
    202     return apply_filters( 'bbp_map_forum_meta_caps', $caps, $cap, $user_id, $args );
     204    // Filter & return
     205    return (array) apply_filters( 'bbp_map_forum_meta_caps', $caps, $cap, $user_id, $args );
    203206}
    204207

  • trunk/src/includes/forums/functions.php

    r6434 r6438  
    8383    do_action( 'bbp_insert_forum', (int) $forum_id );
    8484
    85     // Return new forum ID
     85    // Return forum_id
    8686    return $forum_id;
    8787}
    … …  
    11671167    $forum_topic_count = (int) ( $total_topic_count + $difference );
    11681168
     1169    // Filter & return
    11691170    return (int) apply_filters( 'bbp_bump_forum_topic_count', $forum_topic_count, $forum_id, $difference, $update_ancestors );
    11701171}
    … …  
    12671268    update_post_meta( $forum_id, '_bbp_topic_count_hidden', $new_count );
    12681269
     1270    // Filter & return
    12691271    return (int) apply_filters( 'bbp_bump_forum_topic_count_hidden', $new_count, $forum_id, $difference );
    12701272}
    … …  
    13851387    $forum_reply_count = (int) ( $total_reply_count + $difference );
    13861388
     1389    // Filter & return
    13871390    return (int) apply_filters( 'bbp_bump_forum_reply_count', $forum_reply_count, $forum_id, $difference, $update_ancestors );
    13881391}
    … …  
    15541557    }
    15551558
     1559    // Filter & return
    15561560    return (int) apply_filters( 'bbp_update_forum_last_topic_id', $topic_id, $forum_id );
    15571561}
    … …  
    16191623    }
    16201624
     1625    // Filter & return
    16211626    return (int) apply_filters( 'bbp_update_forum_last_reply_id', $reply_id, $forum_id );
    16221627}
    … …  
    16861691    }
    16871692
     1693    // Filter & return
    16881694    return (int) apply_filters( 'bbp_update_forum_last_active_id', $active_id, $forum_id );
    16891695}
    … …  
    17171723    }
    17181724
     1725    // Filter & return
    17191726    return apply_filters( 'bbp_update_forum_last_active', $new_time, $forum_id );
    17201727}
    … …  
    17401747    update_post_meta( $forum_id, '_bbp_forum_subforum_count', $subforums );
    17411748
     1749    // Filter & return
    17421750    return (int) apply_filters( 'bbp_update_forum_subforum_count', $subforums, $forum_id );
    17431751}
    … …  
    17841792    update_post_meta( $forum_id, '_bbp_total_topic_count', $total_topics );
    17851793
     1794    // Filter & return
    17861795    return (int) apply_filters( 'bbp_update_forum_topic_count', $total_topics, $forum_id );
    17871796}
    … …  
    18491858    }
    18501859
     1860    // Filter & return
    18511861    return (int) apply_filters( 'bbp_update_forum_topic_count_hidden', $topic_count, $forum_id );
    18521862}
    … …  
    19131923    update_post_meta( $forum_id, '_bbp_total_reply_count', $total_replies );
    19141924
     1925    // Filter & return
    19151926    return (int) apply_filters( 'bbp_update_forum_reply_count', $total_replies, $forum_id );
    19161927}
    … …  
    20012012 */
    20022013function bbp_get_forum_statuses( $forum_id = 0 ) {
    2003     return apply_filters( 'bbp_get_forum_statuses', array(
     2014
     2015    // Filter & return
     2016    return (array) apply_filters( 'bbp_get_forum_statuses', array(
    20042017        'open'   => _x( 'Open',    'Open the forum',  'bbpress' ),
    20052018        'closed' => _x( 'Closed',  'Close the forum', 'bbpress' )
    … …  
    20172030 */
    20182031function bbp_get_forum_types( $forum_id = 0 ) {
    2019     return apply_filters( 'bbp_get_forum_types', array(
     2032
     2033    // Filter & return
     2034    return (array) apply_filters( 'bbp_get_forum_types', array(
    20202035        'forum'    => _x( 'Forum',    'Forum accepts new topics', 'bbpress' ),
    20212036        'category' => _x( 'Category', 'Forum is a category',      'bbpress' )
    … …  
    20332048 */
    20342049function bbp_get_forum_visibilities( $forum_id = 0) {
    2035     return apply_filters( 'bbp_get_forum_visibilities', array(
     2050
     2051    // Filter & return
     2052    return (array) apply_filters( 'bbp_get_forum_visibilities', array(
    20362053        bbp_get_public_status_id()  => _x( 'Public',  'Make forum public',  'bbpress' ),
    20372054        bbp_get_private_status_id() => _x( 'Private', 'Make forum private', 'bbpress' ),
    … …  
    20602077        : array();
    20612078
    2062     return apply_filters( 'bbp_get_hidden_forum_ids', (array) $forum_ids );
     2079    // Filter & return
     2080    return (array) apply_filters( 'bbp_get_hidden_forum_ids', $forum_ids );
    20632081}
    20642082
    … …  
    20812099        : array();
    20822100
    2083     return apply_filters( 'bbp_get_private_forum_ids', (array) $forum_ids );
     2101    // Filter & return
     2102    return (array) apply_filters( 'bbp_get_private_forum_ids', $forum_ids );
    20842103}
    20852104
    … …  
    21772196    }
    21782197
    2179     // Filter and return the results
     2198    // Filter & return
    21802199    return apply_filters( 'bbp_exclude_forum_ids', $retval, $forum_ids, $type );
    21812200}
    … …  
    23062325    $topic_ids = bbp_get_public_child_ids( $forum_id, bbp_get_topic_post_type() );
    23072326
     2327    // Filter & return
    23082328    return (array) apply_filters( 'bbp_forum_query_topic_ids', $topic_ids, $forum_id );
    23092329}
    … …  
    23252345    $subforum_ids = bbp_get_all_child_ids( $forum_id, bbp_get_forum_post_type() );
    23262346
     2347    // Filter & return
    23272348    return (array) apply_filters( 'bbp_forum_query_subforum_ids', $subforum_ids, $forum_id );
    23282349}
    … …  
    23732394    unset( $query );
    23742395
     2396    // Filter & return
    23752397    return (int) apply_filters( 'bbp_forum_query_last_reply_id', $reply_id, $forum_id );
    23762398}

  • trunk/src/includes/forums/template.php

    r6433 r6438  
    3333     */
    3434    function bbp_get_forum_post_type() {
     35
     36        // Filter & return
    3537        return apply_filters( 'bbp_get_forum_post_type', bbpress()->forum_post_type );
    3638    }
    … …  
    4547 */
    4648function bbp_get_forum_post_type_labels() {
    47     return apply_filters( 'bbp_get_forum_post_type_labels', array(
     49
     50    // Filter & return
     51    return (array) apply_filters( 'bbp_get_forum_post_type_labels', array(
    4852        'name'                  => __( 'Forums',                   'bbpress' ),
    4953        'menu_name'             => __( 'Forums',                   'bbpress' ),
    … …  
    7680 */
    7781function bbp_get_forum_post_type_rewrite() {
    78     return apply_filters( 'bbp_get_forum_post_type_rewrite', array(
     82
     83    // Filter & return
     84    return (array) apply_filters( 'bbp_get_forum_post_type_rewrite', array(
    7985        'slug'       => bbp_get_forum_slug(),
    8086        'with_front' => false
    … …  
    9096 */
    9197function bbp_get_forum_post_type_supports() {
    92     return apply_filters( 'bbp_get_forum_post_type_supports', array(
     98
     99    // Filter & return
     100    return (array) apply_filters( 'bbp_get_forum_post_type_supports', array(
    93101        'title',
    94102        'editor',
    … …  
    148156    $bbp->forum_query = new WP_Query( $bbp_f );
    149157
     158    // Filter & return
    150159    return apply_filters( 'bbp_has_forums', $bbp->forum_query->have_posts(), $bbp->forum_query );
    151160}
    … …  
    250259        }
    251260
     261        // Filter & return
    252262        return (int) apply_filters( 'bbp_get_forum_id', (int) $bbp_forum_id, $forum_id );
    253263    }
    … …  
    298308    }
    299309
     310    // Filter & return
    300311    return apply_filters( 'bbp_get_forum', $forum, $output, $filter );
    301312}
    … …  
    340351        }
    341352
     353        // Filter & return
    342354        return apply_filters( 'bbp_get_forum_permalink', $forum_permalink, $forum_id );
    343355    }
    … …  
    369381        $title    = get_the_title( $forum_id );
    370382
     383        // Filter & return
    371384        return apply_filters( 'bbp_get_forum_title', $title, $forum_id );
    372385    }
    … …  
    415428        }
    416429
     430        // Filter & return
    417431        return apply_filters( 'bbp_get_forum_archive_title', $title );
    418432    }
    … …  
    453467        $content = get_post_field( 'post_content', $forum_id );
    454468
     469        // Filter & return
    455470        return apply_filters( 'bbp_get_forum_content', $content, $forum_id );
    456471    }
    … …  
    495510        $active_id = get_post_meta( $forum_id, '_bbp_last_active_id', true );
    496511
     512        // Filter & return
    497513        return (int) apply_filters( 'bbp_get_forum_last_active_id', (int) $active_id, $forum_id );
    498514    }
    … …  
    548564        $active_time = ! empty( $last_active ) ? bbp_get_time_since( bbp_convert_date( $last_active ) ) : '';
    549565
     566        // Filter & return
    550567        return apply_filters( 'bbp_get_forum_last_active', $active_time, $forum_id );
    551568    }
    … …  
    617634        }
    618635
     636        // Filter & return
    619637        return apply_filters( 'bbp_get_forum_freshness_link', $anchor, $forum_id, $time_since, $link_url, $title, $active_id );
    620638    }
    … …  
    646664        $parent_id = get_post_field( 'post_parent', $forum_id );
    647665
     666        // Filter & return
    648667        return (int) apply_filters( 'bbp_get_forum_parent_id', (int) $parent_id, $forum_id );
    649668    }
    … …  
    673692    }
    674693
     694    // Filter & return
    675695    return apply_filters( 'bbp_get_forum_ancestors', $ancestors, $forum_id );
    676696}
    … …  
    741761        : array();
    742762
     763    // Filter & return
    743764    return (array) apply_filters( 'bbp_forum_get_subforums', $sub_forums, $r, $args );
    744765}
    … …  
    889910        }
    890911
     912        // Filter & return
    891913        return apply_filters( 'bbp_get_forum_subscribe_link', $retval, $r, $args );
    892914    }
    … …  
    921943        $topic_id = get_post_meta( $forum_id, '_bbp_last_topic_id', true );
    922944
     945        // Filter & return
    923946        return (int) apply_filters( 'bbp_get_forum_last_topic_id', (int) $topic_id, $forum_id );
    924947    }
    … …  
    953976        $title    = ! empty( $topic_id ) ? bbp_get_topic_title( $topic_id ) : '';
    954977
     978        // Filter & return
    955979        return apply_filters( 'bbp_get_forum_last_topic_title', $title, $forum_id );
    956980    }
    … …  
    9861010        $link     = bbp_get_topic_permalink( $topic_id );
    9871011
     1012        // Filter & return
    9881013        return apply_filters( 'bbp_get_forum_last_topic_permalink', $link, $forum_id, $topic_id );
    9891014    }
    … …  
    10071032    $author_id = bbp_get_topic_author_id( $topic_id );
    10081033
     1034    // Filter & return
    10091035    return (int) apply_filters( 'bbp_get_forum_last_topic_author_id', (int) $author_id, $forum_id, $topic_id );
    10101036}
    … …  
    10411067        $author_link = bbp_get_user_profile_link( $author_id );
    10421068
     1069        // Filter & return
    10431070        return apply_filters( 'bbp_get_forum_last_topic_author_link', $author_link, $forum_id );
    10441071    }
    … …  
    10741101        $reply_id = get_post_meta( $forum_id, '_bbp_last_reply_id', true );
    10751102
     1103        // Filter & return
    10761104        return (int) apply_filters( 'bbp_get_forum_last_reply_id', (int) $reply_id, $forum_id );
    10771105    }
    … …  
    11021130        $title    = bbp_get_reply_title( $reply_id );
    11031131
     1132        // Filter & return
    11041133        return apply_filters( 'bbp_get_forum_last_reply_title', $title, $forum_id, $reply_id );
    11051134    }
    … …  
    11341163        $link     = bbp_get_reply_permalink( $reply_id );
    11351164
     1165        // Filter & return
    11361166        return apply_filters( 'bbp_get_forum_last_reply_permalink', $link, $forum_id, $reply_id );
    11371167    }
    … …  
    11811211        }
    11821212
    1183         // Filter and return
     1213        // Filter & return
    11841214        return apply_filters( 'bbp_get_forum_last_reply_url', $reply_url, $forum_id, $reply_id );
    11851215    }
    … …  
    12161246        $author_id = bbp_get_reply_author_id( $reply_id );
    12171247
     1248        // Filter & return
    12181249        return apply_filters( 'bbp_get_forum_last_reply_author_id', $author_id, $forum_id, $reply_id );
    12191250    }
    … …  
    12511282        $author_link = bbp_get_user_profile_link( $author_id );
    12521283
     1284        // Filter & return
    12531285        return apply_filters( 'bbp_get_forum_last_reply_author_link', $author_link, $forum_id, $author_id );
    12541286    }
    … …  
    13101342        }
    13111343
     1344        // Filter & return
    13121345        return apply_filters( 'bbp_get_forum_topics_link', $retval, $forum_id );
    13131346    }
    … …  
    15351568        }
    15361569
     1570        // Filter & return
    15371571        return apply_filters( 'bbp_get_forum_status', $status, $forum_id );
    15381572    }
    … …  
    15651599        $visibility = get_post_status( $forum_id );
    15661600
     1601        // Filter & return
    15671602        return apply_filters( 'bbp_get_forum_visibility', $visibility, $forum_id );
    15681603    }
    … …  
    15961631        }
    15971632
     1633        // Filter & return
    15981634        return apply_filters( 'bbp_get_forum_type', $retval, $forum_id );
    15991635    }
    … …  
    16131649    $retval   = ( ! empty( $type ) && 'category' === $type );
    16141650
     1651    // Filter & return
    16151652    return (bool) apply_filters( 'bbp_is_forum_category', (bool) $retval, $forum_id );
    16161653}
    … …  
    16511688    $retval   = bbp_is_forum_status( $forum_id, bbp_get_closed_status_id(), $check_ancestors, 'OR' );
    16521689
     1690    // Filter & return
    16531691    return (bool) apply_filters( 'bbp_is_forum_closed', (bool) $retval, $forum_id, $check_ancestors );
    16541692}
    … …  
    17241762    }
    17251763
    1726     // Filter and return
     1764    // Filter & return
    17271765    return (bool) apply_filters( 'bbp_is_forum_status', $retval, $count, $forum_id, $status_name, $check_ancestors, $operator );
    17281766}
    … …  
    17471785    $retval   = bbp_is_forum_visibility( $forum_id, bbp_get_public_status_id(), $check_ancestors );
    17481786
    1749     return (bool) apply_filters( 'bbp_is_forum_public', (bool) $retval, $forum_id, $check_ancestors );
     1787    // Filter & return
     1788    return (bool) apply_filters( 'bbp_is_forum_public', $retval, $forum_id, $check_ancestors );
    17501789}
    17511790
    … …  
    17691808    $retval   = bbp_is_forum_visibility( $forum_id, bbp_get_private_status_id(), $check_ancestors, 'OR' );
    17701809
    1771     return (bool) apply_filters( 'bbp_is_forum_private', (bool) $retval, $forum_id, $check_ancestors );
     1810    // Filter & return
     1811    return (bool) apply_filters( 'bbp_is_forum_private', $retval, $forum_id, $check_ancestors );
    17721812}
    17731813
    … …  
    17921832    $retval   = bbp_is_forum_visibility( $forum_id, bbp_get_hidden_status_id(), $check_ancestors, 'OR' );
    17931833
    1794     return (bool) apply_filters( 'bbp_is_forum_hidden', (bool) $retval, $forum_id, $check_ancestors );
     1834    // Filter & return
     1835    return (bool) apply_filters( 'bbp_is_forum_hidden', $retval, $forum_id, $check_ancestors );
    17951836}
    17961837
    … …  
    18681909    }
    18691910
    1870     // Filter and return
     1911    // Filter & return
    18711912    return (bool) apply_filters( 'bbp_is_forum_visibility', $retval, $count, $forum_id, $status_name, $check_ancestors, $operator );
    18721913}
    … …  
    18991940        $author_id = get_post_field( 'post_author', $forum_id );
    19001941
     1942        // Filter & return
    19011943        return (int) apply_filters( 'bbp_get_forum_author_id', (int) $author_id, $forum_id );
    19021944    }
    … …  
    19311973        $author    = get_the_author_meta( 'display_name', $author_id );
    19321974
     1975        // Filter & return
    19331976        return apply_filters( 'bbp_get_forum_author_display_name', $author, $forum_id, $author_id );
    19341977    }
    … …  
    19521995    }
    19531996
     1997    // Filter & return
    19541998    return apply_filters( 'bbp_suppress_private_forum_meta', $retval );
    19551999}
    … …  
    20062050    }
    20072051
     2052    // Filter & return
    20082053    return apply_filters( 'bbp_suppress_private_author_link', $retval, $author_link, $args );
    20092054}
    … …  
    21952240        $retstr = $r['before'] . $retstr . $r['after'];
    21962241
    2197         // Return filtered result
     2242        // Filter & return
    21982243        return apply_filters( 'bbp_get_single_forum_description', $retstr, $r, $args );
    21992244    }
    … …  
    22352280        }
    22362281
     2282        // Filter & return
    22372283        return apply_filters( 'bbp_get_form_forum_title', $forum_title );
    22382284    }
    … …  
    22722318        }
    22732319
     2320        // Filter & return
    22742321        return apply_filters( 'bbp_get_form_forum_content', $forum_content );
    22752322    }
    … …  
    23262373        }
    23272374
     2375        // Filter & return
    23282376        return apply_filters( 'bbp_get_form_forum_moderators', $forum_mods );
    23292377    }
    … …  
    23642412        }
    23652413
     2414        // Filter & return
    23662415        return apply_filters( 'bbp_get_form_forum_parent', $forum_parent );
    23672416    }
    … …  
    24022451        }
    24032452
     2453        // Filter & return
    24042454        return apply_filters( 'bbp_get_form_forum_type', $forum_type );
    24052455    }
    … …  
    24402490        }
    24412491
     2492        // Filter & return
    24422493        return apply_filters( 'bbp_get_form_forum_visibility', $forum_visibility );
    24432494    }
    … …  
    25002551        $checked = checked( $forum_subscribed, true, false );
    25012552
     2553        // Filter & return
    25022554        return apply_filters( 'bbp_get_form_forum_subscribed', $checked, $forum_subscribed );
    25032555    }
    … …  
    25912643        <?php
    25922644
    2593         // Return the results
     2645        // Filter & return
    25942646        return apply_filters( 'bbp_get_form_forum_type_dropdown', ob_get_clean(), $r, $args );
    25952647    }
    … …  
    26812733        <?php
    26822734
    2683         // Return the results
     2735        // Filter & return
    26842736        return apply_filters( 'bbp_get_form_forum_status_dropdown', ob_get_clean(), $r, $args );
    26852737    }
    … …  
    27712823        <?php
    27722824
    2773         // Return the results
     2825        // Filter & return
    27742826        return apply_filters( 'bbp_get_form_forum_type_dropdown', ob_get_clean(), $r, $args );
    27752827    }
    … …  
    28682920        }
    28692921
     2922        // Filter & return
    28702923        return apply_filters( 'bbp_get_forum_topics_feed_link', $link, $url, $forum_id );
    28712924    }
    … …  
    29322985        }
    29332986
     2987        // Filter & return
    29342988        return apply_filters( 'bbp_get_forum_replies_feed_link', $link, $url, $forum_id );
    29352989    }

  • trunk/src/includes/replies/capabilities.php

    r6384 r6438  
    1919 */
    2020function bbp_get_reply_caps() {
    21     return apply_filters( 'bbp_get_reply_caps', array (
     21
     22    // Filter & return
     23    return (array) apply_filters( 'bbp_get_reply_caps', array (
    2224        'edit_posts'          => 'edit_replies',
    2325        'edit_others_posts'   => 'edit_others_replies',
    … …  
    207209    }
    208210
    209     return apply_filters( 'bbp_map_reply_meta_caps', $caps, $cap, $user_id, $args );
     211    // Filter & return
     212    return (array) apply_filters( 'bbp_map_reply_meta_caps', $caps, $cap, $user_id, $args );
    210213}

  • trunk/src/includes/replies/functions.php

    r6415 r6438  
    7777    do_action( 'bbp_insert_reply', (int) $reply_id, (int) $reply_meta['topic_id'], (int) $reply_meta['forum_id'] );
    7878
    79     // Return new reply ID
     79    // Return reply_id
    8080    return $reply_id;
    8181}
    … …  
    10891089    $forum_id = bbp_update_forum_id( $reply_id, $forum_id );
    10901090
     1091    // Filter & return
    10911092    return (int) apply_filters( 'bbp_update_reply_forum_id', $forum_id, $reply_id );
    10921093}
    … …  
    11381139    $topic_id = bbp_update_topic_id( $reply_id, $topic_id );
    11391140
     1141    // Filter & return
    11401142    return (int) apply_filters( 'bbp_update_reply_topic_id', $topic_id, $reply_id );
    11411143}
    … …  
    11731175    }
    11741176
     1177    // Filter & return
    11751178    return (int) apply_filters( 'bbp_update_reply_to', $reply_to, $reply_id );
    11761179}
    … …  
    12221225    }
    12231226
     1227    // Filter & return
    12241228    return (array) apply_filters( 'bbp_get_reply_ancestors', $ancestors, $reply_id );
    12251229}
    … …  
    12641268    update_post_meta( $r['reply_id'], '_bbp_revision_log', $revision_log );
    12651269
     1270    // Filter & return
    12661271    return apply_filters( 'bbp_update_reply_revision_log', $revision_log, $r['reply_id'] );
    12671272}
    … …  
    17651770 */
    17661771function bbp_get_reply_statuses( $reply_id = 0 ) {
    1767     return apply_filters( 'bbp_get_reply_statuses', array(
     1772
     1773    // Filter & return
     1774    return (array) apply_filters( 'bbp_get_reply_statuses', array(
    17681775        bbp_get_public_status_id()  => _x( 'Publish', 'Publish the reply',     'bbpress' ),
    17691776        bbp_get_spam_status_id()    => _x( 'Spam',    'Spam the reply',        'bbpress' ),
    … …  
    17831790 */
    17841791function bbp_get_reply_toggles( $reply_id = 0 ) {
    1785     return apply_filters( 'bbp_get_toggle_reply_actions', array(
     1792
     1793    // Filter & return
     1794    return (array) apply_filters( 'bbp_get_toggle_reply_actions', array(
    17861795        'bbp_toggle_reply_spam',
    17871796        'bbp_toggle_reply_trash',
    … …  
    21152124    }
    21162125
    2117     // Filter and return
     2126    // Filter & return
    21182127    return (int) apply_filters( 'bbp_get_replies_per_page', $retval, $default );
    21192128}
    … …  
    21392148    }
    21402149
    2141     // Filter and return
     2150    // Filter & return
    21422151    return (int) apply_filters( 'bbp_get_replies_per_rss_page', $retval, $default );
    21432152}
    … …  
    25132522    }
    25142523
     2524    // Filter & return
    25152525    return (bool) apply_filters( 'bbp_thread_replies', $retval, $depth, $allow );
    25162526}

  • trunk/src/includes/replies/template.php

    r6437 r6438  
    3333     */
    3434    function bbp_get_reply_post_type() {
     35
     36        // Filter & return
    3537        return apply_filters( 'bbp_get_reply_post_type', bbpress()->reply_post_type );
    3638    }
    … …  
    4446 */
    4547function bbp_get_reply_post_type_labels() {
    46     return apply_filters( 'bbp_get_reply_post_type_labels', array(
     48
     49    // Filter & return
     50    return (array) apply_filters( 'bbp_get_reply_post_type_labels', array(
    4751        'name'                  => __( 'Replies',                   'bbpress' ),
    4852        'menu_name'             => __( 'Replies',                   'bbpress' ),
    … …  
    7579 */
    7680function bbp_get_reply_post_type_rewrite() {
    77     return apply_filters( 'bbp_get_reply_post_type_rewrite', array(
     81
     82    // Filter & return
     83    return (array) apply_filters( 'bbp_get_reply_post_type_rewrite', array(
    7884        'slug'       => bbp_get_reply_slug(),
    7985        'with_front' => false
    … …  
    8995 */
    9096function bbp_get_reply_post_type_supports() {
    91     return apply_filters( 'bbp_get_reply_post_type_supports', array(
     97
     98    // Filter & return
     99    return (array) apply_filters( 'bbp_get_reply_post_type_supports', array(
    92100        'title',
    93101        'editor',
    … …  
    283291    }
    284292
    285     // Return object
     293    // Filter & return
    286294    return apply_filters( 'bbp_has_replies', $bbp->reply_query->have_posts(), $bbp->reply_query );
    287295}
    … …  
    379387        }
    380388
     389        // Filter & return
    381390        return (int) apply_filters( 'bbp_get_reply_id', $bbp_reply_id, $reply_id );
    382391    }
    … …  
    422431    }
    423432
     433    // Filter & return
    424434    return apply_filters( 'bbp_get_reply', $reply, $output, $filter );
    425435}
    … …  
    451461        $reply_id = bbp_get_reply_id( $reply_id );
    452462
     463        // Filter & return
    453464        return apply_filters( 'bbp_get_reply_permalink', get_permalink( $reply_id ), $reply_id );
    454465    }
    … …  
    524535        }
    525536
     537        // Filter & return
    526538        return apply_filters( 'bbp_get_reply_url', $url, $reply_id, $redirect_to );
    527539    }
    … …  
    555567        $title    = get_the_title( $reply_id );
    556568
     569        // Filter & return
    557570        return apply_filters( 'bbp_get_reply_title', $title, $reply_id );
    558571    }
    … …  
    582595        $reply_title = sprintf( __( 'Reply To: %s', 'bbpress' ), $topic_title );
    583596
     597        // Filter & return
    584598        return apply_filters( 'bbp_get_reply_title_fallback', $reply_title, $post_id, $topic_title );
    585599    }
    … …  
    620634        $content = get_post_field( 'post_content', $reply_id );
    621635
     636        // Filter & return
    622637        return apply_filters( 'bbp_get_reply_content', $content, $reply_id );
    623638    }
    … …  
    673688        }
    674689
     690        // Filter & return
    675691        return apply_filters( 'bbp_get_reply_excerpt', $excerpt, $reply_id, $length );
    676692    }
    … …  
    719735        }
    720736
     737        // Filter & return
    721738        return apply_filters( 'bbp_get_reply_post_date', $result, $reply_id, $humanize, $gmt, $date, $time );
    722739    }
    … …  
    744761    $reply_id = bbp_get_reply_id( $reply_id );
    745762
     763    // Filter & return
    746764    return apply_filters( 'bbp_reply_append_revisions', $content . bbp_get_reply_revision_log( $reply_id ), $content, $reply_id );
    747765}
    … …  
    827845        $r .= "\n" . '</ul>' . "\n\n";
    828846
     847        // Filter & return
    829848        return apply_filters( 'bbp_get_reply_revision_log', $r, $reply_id );
    830849    }
    … …  
    846865            $revision_log = empty( $revision_log ) ? array() : $revision_log;
    847866
     867            // Filter & return
    848868            return apply_filters( 'bbp_get_reply_raw_revision_log', $revision_log, $reply_id );
    849869        }
    … …  
    865885    $revisions = wp_get_post_revisions( $reply_id, array( 'order' => 'ASC' ) );
    866886
     887    // Filter & return
    867888    return apply_filters( 'bbp_get_reply_revisions', $revisions, $reply_id );
    868889}
    … …  
    914935    function bbp_get_reply_status( $reply_id = 0 ) {
    915936        $reply_id = bbp_get_reply_id( $reply_id );
     937
     938        // Filter & return
    916939        return apply_filters( 'bbp_get_reply_status', get_post_status( $reply_id ), $reply_id );
    917940    }
    … …  
    932955    $reply_status = bbp_get_reply_status( $reply_id ) === $status;
    933956
     957    // Filter & return
    934958    return (bool) apply_filters( 'bbp_is_reply_published', (bool) $reply_status, $reply_id );
    935959}
    … …  
    950974    $reply_status = bbp_get_reply_status( $reply_id ) === $status;
    951975
     976    // Filter & return
    952977    return (bool) apply_filters( 'bbp_is_reply_spam', (bool) $reply_status, $reply_id );
    953978}
    … …  
    968993    $reply_status = bbp_get_reply_status( $reply_id ) === $status;
    969994
     995    // Filter & return
    970996    return (bool) apply_filters( 'bbp_is_reply_trash', (bool) $reply_status, $reply_id );
    971997}
    … …  
    9871013    $reply_status = bbp_get_reply_status( $reply_id ) === $status;
    9881014
     1015    // Filter & return
    9891016    return (bool) apply_filters( 'bbp_is_reply_pending', (bool) $reply_status, $reply_id );
    9901017}
    … …  
    10061033    $reply_status = bbp_get_reply_status( $reply_id ) === $status;
    10071034
     1035    // Filter & return
    10081036    return (bool) apply_filters( 'bbp_is_reply_private', (bool) $reply_status, $reply_id );
    10091037}
    … …  
    10341062    }
    10351063
     1064    // Filter & return
    10361065    return (bool) apply_filters( 'bbp_is_reply_anonymous', $retval, $reply_id );
    10371066}
    … …  
    10801109        }
    10811110
     1111        // Filter & return
    10821112        return apply_filters( 'bbp_get_reply_author', $author, $reply_id );
    10831113    }
    … …  
    11101140        $author_id = get_post_field( 'post_author', $reply_id );
    11111141
     1142        // Filter & return
    11121143        return (int) apply_filters( 'bbp_get_reply_author_id', $author_id, $reply_id );
    11131144    }
    … …  
    11721203        }
    11731204
     1205        // Filter & return
    11741206        return apply_filters( 'bbp_get_reply_author_display_name', $author_name, $reply_id );
    11751207    }
    … …  
    12171249        }
    12181250
     1251        // Filter & return
    12191252        return apply_filters( 'bbp_get_reply_author_avatar', $author_avatar, $reply_id, $size );
    12201253    }
    … …  
    13271360        }
    13281361
     1362        // Filter & return
    13291363        return apply_filters( 'bbp_get_reply_author_link', $author_link, $r );
    13301364    }
    … …  
    13711405        }
    13721406
     1407        // Filter & return
    13731408        return apply_filters( 'bbp_get_reply_author_url', $author_url, $reply_id );
    13741409    }
    … …  
    14241459        }
    14251460
     1461        // Filter & return
    14261462        return apply_filters( 'bbp_get_reply_author_email', $author_email, $reply_id );
    14271463    }
    … …  
    14741510        }
    14751511
     1512        // Filter & return
    14761513        return apply_filters( 'bbp_get_reply_author_role', $author_role, $r );
    14771514    }
    … …  
    15051542        $topic_id = bbp_get_reply_topic_id( $reply_id );
    15061543
     1544        // Filter & return
    15071545        return apply_filters( 'bbp_get_reply_topic_title', bbp_get_topic_title( $topic_id ), $reply_id );
    15081546    }
    … …  
    15461584        }
    15471585
     1586        // Filter & return
    15481587        return (int) apply_filters( 'bbp_get_reply_topic_id', $topic_id, $reply_id );
    15491588    }
    … …  
    15861625        }
    15871626
     1627        // Filter & return
    15881628        return (int) apply_filters( 'bbp_get_reply_forum_id', $forum_id, $reply_id );
    15891629    }
    … …  
    16641704        }
    16651705
     1706        // Filter & return
    16661707        return (int) apply_filters( 'bbp_get_reply_to', $reply_to, $reply_id );
    16671708    }
    … …  
    17431784        $retval   = $r['link_before'] . '<a role="button" href="' . esc_url( $r['uri'] ) . '" class="bbp-reply-to-link"' . $onclick . '>' . $r['reply_text'] . '</a>' . $r['link_after'];
    17441785
     1786        // Filter & return
    17451787        return apply_filters( 'bbp_get_reply_to_link', $retval, $r, $args );
    17461788    }
    … …  
    17881830        $retval = sprintf( '<a href="%1$s" id="bbp-cancel-reply-to-link"%2$s>%3$s</a>', esc_url( $link ), $style, esc_html( $text ) );
    17891831
     1832        // Filter & return
    17901833        return apply_filters( 'bbp_get_cancel_reply_to_link', $retval, $link, $text );
    17911834    }
    … …  
    18561899        }
    18571900
     1901        // Filter & return
    18581902        return (int) apply_filters( 'bbp_get_reply_position', $reply_position, $reply_id, $topic_id );
    18591903    }
    … …  
    19582002        $retval = $r['before'] . $links . $r['after'];
    19592003
     2004        // Filter & return
    19602005        return apply_filters( 'bbp_get_reply_admin_links', $retval, $r, $args );
    19612006    }
    … …  
    20242069        $retval = $r['link_before'] . '<a href="' . esc_url( $uri ) . '" class="bbp-reply-edit-link">' . $r['edit_text'] . '</a>' . $r['link_after'];
    20252070
     2071        // Filter & return
    20262072        return apply_filters( 'bbp_get_reply_edit_link', $retval, $r, $args );
    20272073    }
    … …  
    20792125        $url = bbp_add_view_all( $url );
    20802126
     2127        // Filter & return
    20812128        return apply_filters( 'bbp_get_reply_edit_url', $url, $reply_id );
    20822129    }
    … …  
    21622209        $retval = $r['link_before'] . implode( $r['sep'], $actions ) . $r['link_after'];
    21632210
     2211        // Filter & return
    21642212        return apply_filters( 'bbp_get_reply_trash_link', $retval, $r, $args );
    21652213    }
    … …  
    22252273        $retval  = $r['link_before'] . '<a href="' . esc_url( $uri ) . '" class="bbp-reply-spam-link">' . $display . '</a>' . $r['link_after'];
    22262274
     2275        // Filter & return
    22272276        return apply_filters( 'bbp_get_reply_spam_link', $retval, $r, $args );
    22282277    }
    … …  
    22952344        $retval = $r['link_before'] . '<a href="' . esc_url( $uri ) . '" title="' . $r['split_title'] . '" class="bbp-reply-move-link">' . $r['split_text'] . '</a>' . $r['link_after'];
    22962345
     2346        // Filter & return
    22972347        return apply_filters( 'bbp_get_reply_move_link', $retval, $r, $args );
    22982348    }
    … …  
    23652415        $retval = $r['link_before'] . '<a href="' . esc_url( $uri ) . '" title="' . $r['split_title'] . '" class="bbp-topic-split-link">' . $r['split_text'] . '</a>' . $r['link_after'];
    23662416
     2417        // Filter & return
    23672418        return apply_filters( 'bbp_get_topic_split_link', $retval, $r, $args );
    23682419    }
    … …  
    24282479        $retval  = $r['link_before'] . '<a href="' . esc_url( $uri ) . '" class="bbp-reply-approve-link">' . $display . '</a>' . $r['link_after'];
    24292480
     2481        // Filter & return
    24302482        return apply_filters( 'bbp_get_reply_approve_link', $retval, $r, $args );
    24312483    }
    … …  
    25472599        }
    25482600
    2549         // Filter and return
     2601        // Filter & return
    25502602        return apply_filters( 'bbp_get_topic_pagination_count', $retstr );
    25512603    }
    … …  
    25772629        }
    25782630
     2631        // Filter & return
    25792632        return apply_filters( 'bbp_get_topic_pagination_links', $bbp->reply_query->pagination_links );
    25802633    }
    … …  
    26162669        }
    26172670
     2671        // Filter & return
    26182672        return apply_filters( 'bbp_get_form_reply_content', $reply_content );
    26192673    }
    … …  
    26542708        }
    26552709
     2710        // Filter & return
    26562711        return apply_filters( 'bbp_get_form_reply_to', $reply_to );
    26572712    }
    … …  
    27432798        ) );
    27442799
    2745         // Filter and return
     2800        // Filter & return
    27462801        return apply_filters( 'bbp_get_reply_to_dropdown', $retval, $reply_id, $reply_to, $topic_id );
    27472802    }
    … …  
    27802835        $checked = checked( $reply_revision, true, false );
    27812836
     2837        // Filter & return
    27822838        return apply_filters( 'bbp_get_form_reply_log_edit', $checked, $reply_revision );
    27832839    }
    … …  
    28132869        }
    28142870
     2871        // Filter & return
    28152872        return apply_filters( 'bbp_get_form_reply_edit_reason', $reply_edit_reason );
    28162873    }
    … …  
    28932950        <?php
    28942951
    2895         // Return the results
     2952        // Filter & return
    28962953        return apply_filters( 'bbp_get_form_reply_status_dropdown', ob_get_clean(), $r );
    28972954    }

  • trunk/src/includes/search/functions.php

    r5951 r6438  
    5050    // Get search terms
    5151    $search_terms = bbp_get_search_terms();
    52     $retval       = ! empty( $search_terms ) ? array( 's' => $search_terms ) : array();
     52    $retval       = ! empty( $search_terms )
     53        ? array( 's' => $search_terms )
     54        : array();
    5355
     56    // Filter & return
    5457    return apply_filters( 'bbp_get_search_query_args', $retval );
    5558}

  • trunk/src/includes/search/template.php

    r6414 r6438  
    160160    }
    161161
    162     // Return object
     162    // Filter & return
    163163    return apply_filters( 'bbp_has_search_results', $bbp->search_query->have_posts(), $bbp->search_query );
    164164}
    … …  
    237237        }
    238238
     239        // Filter & return
    239240        return apply_filters( 'bbp_get_search_title', $title, $search_terms );
    240241    }
    … …  
    277278        }
    278279
     280        // Filter & return
    279281        return apply_filters( 'bbp_get_search_url', $url );
    280282    }
    … …  
    329331        }
    330332
     333        // Filter & return
    331334        return apply_filters( 'bbp_get_search_results_url', $url );
    332335    }
    … …  
    371374        $search_terms = ! empty( $search_terms ) ? urldecode( trim( $search_terms ) ) : false;
    372375
     376        // Filter & return
    373377        return apply_filters( 'bbp_get_search_terms', $search_terms, $passed_terms );
    374378    }
    … …  
    423427        }
    424428
    425         // Filter and return
     429        // Filter & return
    426430        return apply_filters( 'bbp_get_search_pagination_count', esc_html( $retstr ) );
    427431    }
    … …  
    454458        }
    455459
     460        // Filter & return
    456461        return apply_filters( 'bbp_get_search_pagination_links', $bbp->search_query->pagination_links );
    457462    }

  • trunk/src/includes/topics/capabilities.php

    r6384 r6438  
    1919 */
    2020function bbp_get_topic_caps() {
    21     return apply_filters( 'bbp_get_topic_caps', array (
     21
     22    // Filter & return
     23    return (array) apply_filters( 'bbp_get_topic_caps', array (
    2224        'edit_posts'          => 'edit_topics',
    2325        'edit_others_posts'   => 'edit_others_topics',
    … …  
    3941 */
    4042function bbp_get_topic_tag_caps() {
    41     return apply_filters( 'bbp_get_topic_tag_caps', array (
     43
     44    // Filter & return
     45    return (array) apply_filters( 'bbp_get_topic_tag_caps', array (
    4246        'manage_terms' => 'manage_topic_tags',
    4347        'edit_terms'   => 'edit_topic_tags',
    … …  
    225229    }
    226230
    227     return apply_filters( 'bbp_map_topic_meta_caps', $caps, $cap, $user_id, $args );
     231    // Filter & return
     232    return (array) apply_filters( 'bbp_map_topic_meta_caps', $caps, $cap, $user_id, $args );
    228233}
    229234
    … …  
    256261    }
    257262
    258     return apply_filters( 'bbp_map_topic_tag_meta_caps', $caps, $cap, $user_id, $args );
    259 }
     263    // Filter & return
     264    return (array) apply_filters( 'bbp_map_topic_tag_meta_caps', $caps, $cap, $user_id, $args );
     265}

  • trunk/src/includes/topics/functions.php

    r6415 r6438  
    8181    do_action( 'bbp_insert_topic', (int) $topic_id, (int) $topic_meta['forum_id'] );
    8282
    83     // Return new topic ID
     83    // Return topic_id
    8484    return $topic_id;
    8585}
    … …  
    20192019 */
    20202020function bbp_get_topic_statuses( $topic_id = 0 ) {
    2021     return apply_filters( 'bbp_get_topic_statuses', array(
     2021
     2022    // Filter & return
     2023    return (array) apply_filters( 'bbp_get_topic_statuses', array(
    20222024        bbp_get_public_status_id()  => _x( 'Open',    'Open the topic',        'bbpress' ),
    20232025        bbp_get_closed_status_id()  => _x( 'Closed',  'Close the topic',       'bbpress' ),
    … …  
    20382040 */
    20392041function bbp_get_topic_types( $topic_id = 0 ) {
    2040     return apply_filters( 'bbp_get_topic_types', array(
     2042
     2043    // Filter & return
     2044    return (array) apply_filters( 'bbp_get_topic_types', array(
    20412045        'unstick' => _x( 'Normal',       'Unstick a topic',         'bbpress' ),
    20422046        'stick'   => _x( 'Sticky',       'Make topic sticky',       'bbpress' ),
    … …  
    20552059 */
    20562060function bbp_get_topic_toggles( $topic_id = 0 ) {
    2057     return apply_filters( 'bbp_get_toggle_topic_actions', array(
     2061
     2062    // Filter & return
     2063    return (array) apply_filters( 'bbp_get_toggle_topic_actions', array(
    20582064        'bbp_toggle_topic_close',
    20592065        'bbp_toggle_topic_stick',
    … …  
    20892095        : wp_parse_id_list( $stickies );
    20902096
    2091     // Filter and return
     2097    // Filter & return
    20922098    return (array) apply_filters( 'bbp_get_stickies', $stickies, $forum_id );
    20932099}
    … …  
    21122118        : wp_parse_id_list( $stickies );
    21132119
    2114     // Filter and return
     2120    // Filter & return
    21152121    return (array) apply_filters( 'bbp_get_super_stickies', $stickies );
    21162122}
    … …  
    24732479    update_post_meta( $topic_id, '_bbp_reply_count', $new_count );
    24742480
     2481    // Filter & return
    24752482    return (int) apply_filters( 'bbp_bump_topic_reply_count', $new_count, $topic_id, $difference );
    24762483}
    … …  
    25722579    update_post_meta( $topic_id, '_bbp_reply_count_hidden', $new_count );
    25732580
     2581    // Filter & return
    25742582    return (int) apply_filters( 'bbp_bump_topic_reply_count_hidden', $new_count, $topic_id, $difference );
    25752583}
    … …  
    26952703    update_post_meta( $topic_id, '_bbp_forum_id', $forum_id );
    26962704
     2705    // Filter & return
    26972706    return (int) apply_filters( 'bbp_update_topic_forum_id', $forum_id, $topic_id );
    26982707}
    … …  
    27142723    update_post_meta( $topic_id, '_bbp_topic_id', $topic_id );
    27152724
     2725    // Filter & return
    27162726    return apply_filters( 'bbp_update_topic_topic_id', $topic_id );
    27172727}
    … …  
    27522762    update_post_meta( $topic_id, '_bbp_reply_count', $reply_count );
    27532763
     2764    // Filter & return
    27542765    return (int) apply_filters( 'bbp_update_topic_reply_count', $reply_count, $topic_id );
    27552766}
    … …  
    27992810    update_post_meta( $topic_id, '_bbp_reply_count_hidden', $reply_count );
    28002811
     2812    // Filter & return
    28012813    return (int) apply_filters( 'bbp_update_topic_reply_count_hidden', $reply_count, $topic_id );
    28022814}
    … …  
    28452857    }
    28462858
     2859    // Filter & return
    28472860    return (int) apply_filters( 'bbp_update_topic_last_active_id', $active_id, $topic_id );
    28482861}
    … …  
    28832896    }
    28842897
     2898    // Filter & return
    28852899    return apply_filters( 'bbp_update_topic_last_active_time', $new_time, $topic_id );
    28862900}
    … …  
    29312945    }
    29322946
     2947    // Filter & return
    29332948    return (int) apply_filters( 'bbp_update_topic_last_reply_id', $reply_id, $topic_id );
    29342949}
    … …  
    29893004    update_post_meta( $topic_id, '_bbp_voice_count', $count );
    29903005
     3006    // Filter & return
    29913007    return (int) apply_filters( 'bbp_update_topic_voice_count', $count, $topic_id );
    29923008}
    … …  
    30293045    update_post_meta( $topic_id, '_bbp_anonymous_reply_count', $replies );
    30303046
     3047    // Filter & return
    30313048    return (int) apply_filters( 'bbp_update_topic_anonymous_reply_count', $replies, $topic_id );
    30323049}
    … …  
    39423959    }
    39433960
    3944     // Filter and return
     3961    // Filter & return
    39453962    return (int) apply_filters( 'bbp_get_topics_per_page', $retval, $default );
    39463963}
    … …  
    39663983    }
    39673984
    3968     // Filter and return
     3985    // Filter & return
    39693986    return (int) apply_filters( 'bbp_get_topics_per_rss_page', $retval, $default );
    39703987}
    … …  
    39864003    $topic_tags = array_filter( $terms );
    39874004
     4005    // Filter & return
    39884006    return apply_filters( 'bbp_get_topic_tags', $topic_tags, $topic_id );
    39894007}
    … …  
    40024020    $topic_tags = bbp_get_topic_tags( $topic_id );
    40034021    $pluck      = wp_list_pluck( $topic_tags, 'name' );
    4004     $terms      = ! empty( $pluck ) ? implode( $sep, $pluck ) : '';
    4005 
     4022    $terms      = ! empty( $pluck )
     4023        ? implode( $sep, $pluck )
     4024        : '';
     4025
     4026    // Filter & return
    40064027    return apply_filters( 'bbp_get_topic_tag_names', $terms, $topic_id, $sep );
    40074028}

  • trunk/src/includes/topics/template.php

    r6433 r6438  
    3333     */
    3434    function bbp_get_topic_post_type() {
     35
     36        // Filter & return
    3537        return apply_filters( 'bbp_get_topic_post_type', bbpress()->topic_post_type );
    3638    }
    … …  
    4446 */
    4547function bbp_get_topic_post_type_labels() {
    46     return apply_filters( 'bbp_get_topic_post_type_labels', array(
     48
     49    // Filter & return
     50    return (array) apply_filters( 'bbp_get_topic_post_type_labels', array(
    4751        'name'                  => __( 'Topics',                   'bbpress' ),
    4852        'menu_name'             => __( 'Topics',                   'bbpress' ),
    … …  
    7579 */
    7680function bbp_get_topic_post_type_rewrite() {
    77     return apply_filters( 'bbp_get_topic_post_type_rewrite', array(
     81
     82    // Filter & return
     83    return (array) apply_filters( 'bbp_get_topic_post_type_rewrite', array(
    7884        'slug'       => bbp_get_topic_slug(),
    7985        'with_front' => false
    … …  
    8995 */
    9096function bbp_get_topic_post_type_supports() {
    91     return apply_filters( 'bbp_get_topic_post_type_supports', array(
     97
     98    // Filter & return
     99    return (array) apply_filters( 'bbp_get_topic_post_type_supports', array(
    92100        'title',
    93101        'editor',
    … …  
    113121    }
    114122
     123    // Filter & return
    115124    return (bool) apply_filters( 'bbp_show_lead_topic', (bool) $show_lead );
    116125}
    … …  
    265274    }
    266275
    267     // Return object
     276    // Filter & return
    268277    return apply_filters( 'bbp_has_topics', $bbp->topic_query->have_posts(), $bbp->topic_query );
    269278}
    … …  
    502511        }
    503512
     513        // Filter & return
    504514        return (int) apply_filters( 'bbp_get_topic_id', (int) $bbp_topic_id, $topic_id );
    505515    }
    … …  
    549559    }
    550560
     561    // Filter & return
    551562    return apply_filters( 'bbp_get_topic', $topic, $output, $filter );
    552563}
    … …  
    592603        }
    593604
     605        // Filter & return
    594606        return apply_filters( 'bbp_get_topic_permalink', $topic_permalink, $topic_id );
    595607    }
    … …  
    622634        $title    = get_the_title( $topic_id );
    623635
     636        // Filter & return
    624637        return apply_filters( 'bbp_get_topic_title', $title, $topic_id );
    625638    }
    … …  
    668681        }
    669682
     683        // Filter & return
    670684        return apply_filters( 'bbp_get_topic_archive_title', $title );
    671685    }
    … …  
    706720        $content = get_post_field( 'post_content', $topic_id );
    707721
     722        // Filter & return
    708723        return apply_filters( 'bbp_get_topic_content', $content, $topic_id );
    709724    }
    … …  
    759774        }
    760775
     776        // Filter & return
    761777        return apply_filters( 'bbp_get_topic_excerpt', $excerpt, $topic_id, $length );
    762778    }
    … …  
    805821        }
    806822
     823        // Filter & return
    807824        return apply_filters( 'bbp_get_topic_post_date', $result, $topic_id, $humanize, $gmt, $date, $time );
    808825    }
    … …  
    901918        }
    902919
     920        // Filter & return
    903921        return apply_filters( 'bbp_get_topic_pagination', $pagination_links, $args );
    904922    }
    … …  
    926944    $topic_id = bbp_get_topic_id( $topic_id );
    927945
     946    // Filter & return
    928947    return apply_filters( 'bbp_topic_append_revisions', $content . bbp_get_topic_revision_log( $topic_id ), $content, $topic_id );
    929948}
    … …  
    9991018        $retval .= "\n" . '</ul>' . "\n\n";
    10001019
     1020        // Filter & return
    10011021        return apply_filters( 'bbp_get_topic_revision_log', $retval, $topic_id );
    10021022    }
    … …  
    10191039            $revision_log = empty( $revision_log ) ? array() : $revision_log;
    10201040
     1041            // Filter & return
    10211042            return apply_filters( 'bbp_get_topic_raw_revision_log', $revision_log, $topic_id );
    10221043        }
    … …  
    10381059    $revisions = wp_get_post_revisions( $topic_id, array( 'order' => 'ASC' ) );
    10391060
     1061    // Filter & return
    10401062    return apply_filters( 'bbp_get_topic_revisions', $revisions, $topic_id );
    10411063}
    … …  
    10881110    }
    10891111
     1112    // Filter & return
    10901113    return (bool) apply_filters( 'bbp_is_topic_sticky', $retval, $topic_id, $check_super );
    10911114}
    … …  
    11041127    $topic_id = bbp_get_topic_id( $topic_id );
    11051128    $stickies = bbp_get_super_stickies( $topic_id );
    1106     $retval   = in_array( $topic_id, $stickies );
    1107 
     1129    $retval   = in_array( $topic_id, $stickies, true );
     1130
     1131    // Filter & return
    11081132    return (bool) apply_filters( 'bbp_is_topic_super_sticky', $retval, $topic_id );
    11091133}
    … …  
    11351159        $topic_id = bbp_get_topic_id( $topic_id );
    11361160
     1161        // Filter & return
    11371162        return apply_filters( 'bbp_get_topic_status', get_post_status( $topic_id ), $topic_id );
    11381163    }
    … …  
    11491174 */
    11501175function bbp_get_public_topic_statuses() {
    1151     $statuses = array( bbp_get_public_status_id(), bbp_get_closed_status_id() );
    1152 
     1176    $statuses = array(
     1177        bbp_get_public_status_id(),
     1178        bbp_get_closed_status_id()
     1179    );
     1180
     1181    // Filter & return
    11531182    return (array) apply_filters( 'bbp_get_public_topic_statuses', $statuses );
    11541183}
    … …  
    11681197    $topic_id     = bbp_get_topic_id( $topic_id );
    11691198    $status       = bbp_get_closed_status_id();
    1170     $topic_status = bbp_get_topic_status( $topic_id ) === $status;
    1171 
    1172     return (bool) apply_filters( 'bbp_is_topic_closed', (bool) $topic_status, $topic_id );
     1199    $topic_status = ( bbp_get_topic_status( $topic_id ) === $status );
     1200
     1201    // Filter & return
     1202    return (bool) apply_filters( 'bbp_is_topic_closed', $topic_status, $topic_id );
    11731203}
    11741204
    … …  
    12051235    $is_public = in_array( $status, $public, true );
    12061236
    1207     return (bool) apply_filters( 'bbp_is_topic_public', (bool) $is_public, $topic_id );
     1237    // Filter & return
     1238    return (bool) apply_filters( 'bbp_is_topic_public', $is_public, $topic_id );
    12081239}
    12091240
    … …  
    12221253    $topic_id     = bbp_get_topic_id( $topic_id );
    12231254    $status       = bbp_get_public_status_id();
    1224     $topic_status = bbp_get_topic_status( $topic_id ) === $status;
    1225 
    1226     return (bool) apply_filters( 'bbp_is_topic_published', (bool) $topic_status, $topic_id );
     1255    $topic_status = ( bbp_get_topic_status( $topic_id ) === $status );
     1256
     1257    // Filter & return
     1258    return (bool) apply_filters( 'bbp_is_topic_published', $topic_status, $topic_id );
    12271259}
    12281260
    … …  
    12411273    $topic_id     = bbp_get_topic_id( $topic_id );
    12421274    $status       = bbp_get_spam_status_id();
    1243     $topic_status = bbp_get_topic_status( $topic_id ) === $status;
    1244 
    1245     return (bool) apply_filters( 'bbp_is_topic_spam', (bool) $topic_status, $topic_id );
     1275    $topic_status = ( bbp_get_topic_status( $topic_id ) === $status );
     1276
     1277    // Filter & return
     1278    return (bool) apply_filters( 'bbp_is_topic_spam', $topic_status, $topic_id );
    12461279}
    12471280
    … …  
    12601293    $topic_id     = bbp_get_topic_id( $topic_id );
    12611294    $status       = bbp_get_trash_status_id();
    1262     $topic_status = bbp_get_topic_status( $topic_id ) === $status;
    1263 
    1264     return (bool) apply_filters( 'bbp_is_topic_trash', (bool) $topic_status, $topic_id );
     1295    $topic_status = ( bbp_get_topic_status( $topic_id ) === $status );
     1296
     1297    // Filter & return
     1298    return (bool) apply_filters( 'bbp_is_topic_trash', $topic_status, $topic_id );
    12651299}
    12661300
    … …  
    12791313    $topic_id     = bbp_get_topic_id( $topic_id );
    12801314    $status       = bbp_get_pending_status_id();
    1281     $topic_status = bbp_get_topic_status( $topic_id ) === $status;
    1282 
    1283     return (bool) apply_filters( 'bbp_is_topic_pending', (bool) $topic_status, $topic_id );
     1315    $topic_status = ( bbp_get_topic_status( $topic_id ) === $status );
     1316
     1317    // Filter & return
     1318    return (bool) apply_filters( 'bbp_is_topic_pending', $topic_status, $topic_id );
    12841319}
    12851320
    … …  
    12981333    $topic_id     = bbp_get_topic_id( $topic_id );
    12991334    $status       = bbp_get_private_status_id();
    1300     $topic_status = bbp_get_topic_status( $topic_id ) === $status;
    1301 
    1302     return (bool) apply_filters( 'bbp_is_topic_private', (bool) $topic_status, $topic_id );
     1335    $topic_status = ( bbp_get_topic_status( $topic_id ) === $status );
     1336
     1337    // Filter & return
     1338    return (bool) apply_filters( 'bbp_is_topic_private', $topic_status, $topic_id );
    13031339}
    13041340
    … …  
    13291365    }
    13301366
    1331     // The topic is by an anonymous user
     1367    // Filter & return
    13321368    return (bool) apply_filters( 'bbp_is_topic_anonymous', $retval, $topic_id );
    13331369}
    … …  
    13771413        }
    13781414
     1415        // Filter & return
    13791416        return apply_filters( 'bbp_get_topic_author', $author, $topic_id );
    13801417    }
    … …  
    14071444        $author_id = get_post_field( 'post_author', $topic_id );
    14081445
     1446        // Filter & return
    14091447        return (int) apply_filters( 'bbp_get_topic_author_id', (int) $author_id, $topic_id );
    14101448    }
    … …  
    14701508        }
    14711509
     1510        // Filter & return
    14721511        return apply_filters( 'bbp_get_topic_author_display_name', $author_name, $topic_id );
    14731512    }
    … …  
    15141553        }
    15151554
     1555        // Filter & return
    15161556        return apply_filters( 'bbp_get_topic_author_avatar', $author_avatar, $topic_id, $size );
    15171557    }
    … …  
    16271667        }
    16281668
     1669        // Filter & return
    16291670        return apply_filters( 'bbp_get_topic_author_link', $author_link, $args );
    16301671    }
    … …  
    16741715        }
    16751716
     1717        // Filter & return
    16761718        return apply_filters( 'bbp_get_topic_author_url', $author_url, $topic_id );
    16771719    }
    … …  
    17271769        }
    17281770
     1771        // Filter & return
    17291772        return apply_filters( 'bbp_get_topic_author_email', $author_email, $topic_id );
    17301773    }
    … …  
    17771820        }
    17781821
     1822        // Filter & return
    17791823        return apply_filters( 'bbp_get_topic_author_role', $author_role, $r );
    17801824    }
    … …  
    18081852        $forum_id = bbp_get_topic_forum_id( $topic_id );
    18091853
     1854        // Filter & return
    18101855        return apply_filters( 'bbp_get_topic_forum', bbp_get_forum_title( $forum_id ), $topic_id, $forum_id );
    18111856    }
    … …  
    18381883        $forum_id = get_post_meta( $topic_id, '_bbp_forum_id', true );
    18391884
     1885        // Filter & return
    18401886        return (int) apply_filters( 'bbp_get_topic_forum_id', (int) $forum_id, $topic_id );
    18411887    }
    … …  
    18681914        $active_id = get_post_meta( $topic_id, '_bbp_last_active_id', true );
    18691915
     1916        // Filter & return
    18701917        return (int) apply_filters( 'bbp_get_topic_last_active_id', (int) $active_id, $topic_id );
    18711918    }
    … …  
    19141961        $last_active = ! empty( $last_active ) ? bbp_get_time_since( bbp_convert_date( $last_active ) ) : '';
    19151962
    1916         // Return the time since
     1963        // Filter & return
    19171964        return apply_filters( 'bbp_get_topic_last_active', $last_active, $topic_id );
    19181965    }
    … …  
    19682015        $retval = bbp_get_user_subscribe_link( $r );
    19692016
     2017        // Filter & return
    19702018        return apply_filters( 'bbp_get_topic_subscribe_link', $retval, $r, $args );
    19712019    }
    … …  
    20212069        $retval = bbp_get_user_favorites_link( $r );
    20222070
     2071        // Filter & return
    20232072        return apply_filters( 'bbp_get_topic_favorite_link', $retval, $r, $args );
    20242073    }
    … …  
    20532102        $reply_id = get_post_meta( $topic_id, '_bbp_last_reply_id', true );
    20542103
     2104        // Filter & return
    20552105        return (int) apply_filters( 'bbp_get_topic_last_reply_id', (int) $reply_id, $topic_id );
    20562106    }
    … …  
    20892139        $retval = apply_filters( 'bbp_get_topic_last_topic_title', $retval, $topic_id, $reply_id );
    20902140
     2141        // Filter & return
    20912142        return apply_filters( 'bbp_get_topic_last_reply_title', $retval, $topic_id, $reply_id );
    20922143    }
    … …  
    21212172        $retval   = bbp_get_reply_permalink( $reply_id );
    21222173
     2174        // Filter & return
    21232175        return apply_filters( 'bbp_get_topic_last_reply_permalink', $retval, $topic_id, $reply_id );
    21242176    }
    … …  
    21592211        }
    21602212
     2213        // Filter & return
    21612214        return apply_filters( 'bbp_get_topic_last_reply_url', $reply_url, $topic_id, $reply_id );
    21622215    }
    … …  
    22012254        }
    22022255
     2256        // Filter & return
    22032257        return apply_filters( 'bbp_get_topic_freshness_link', $anchor, $topic_id, $time_since, $link_url, $title );
    22042258    }
    … …  
    22582312        }
    22592313
     2314        // Filter & return
    22602315        return apply_filters( 'bbp_get_topic_replies_link', $retval, $topic_id );
    22612316    }
    … …  
    25952650        $retval = $r['before'] . $links . $r['after'];
    25962651
     2652        // Filter & return
    25972653        return apply_filters( 'bbp_get_topic_admin_links', $retval, $r, $args );
    25982654    }
    … …  
    26612717        $retval = $r['link_before'] . '<a href="' . esc_url( $uri ) . '" class="bbp-topic-edit-link">' . $r['edit_text'] . '</a>' . $r['link_after'];
    26622718
     2719        // Filter & return
    26632720        return apply_filters( 'bbp_get_topic_edit_link', $retval, $r, $args );
    26642721    }
    … …  
    27152772        $url = bbp_add_view_all( $url );
    27162773
     2774        // Filter & return
    27172775        return apply_filters( 'bbp_get_topic_edit_url', $url, $topic_id );
    27182776    }
    … …  
    27932851        $retval = $r['link_before'] . implode( $r['sep'], $actions ) . $r['link_after'];
    27942852
     2853        // Filter & return
    27952854        return apply_filters( 'bbp_get_topic_trash_link', $retval, $r, $args );
    27962855    }
    … …  
    28552914        $retval  = $r['link_before'] . '<a href="' . esc_url( $uri ) . '" class="bbp-topic-close-link">' . $display . '</a>' . $r['link_after'];
    28562915
     2916        // Filter & return
    28572917        return apply_filters( 'bbp_get_topic_close_link', $retval, $r, $args );
    28582918    }
    … …  
    29182978        $retval  = $r['link_before'] . '<a href="' . esc_url( $uri ) . '" class="bbp-topic-approve-link">' . $display . '</a>' . $r['link_after'];
    29192979
     2980        // Filter & return
    29202981        return apply_filters( 'bbp_get_topic_approve_link', $retval, $r, $args );
    29212982    }
    … …  
    29973058        $retval = $r['link_before'] . $stick_display . $super_display . $r['link_after'];
    29983059
     3060        // Filter & return
    29993061        return apply_filters( 'bbp_get_topic_stick_link', $retval, $r, $args );
    30003062    }
    … …  
    30523114        $retval = $r['link_before'] . '<a href="' . esc_url( $uri ) . '" class="bbp-topic-merge-link">' . $r['merge_text'] . '</a>' . $r['link_after'];
    30533115
     3116        // Filter & return
    30543117        return apply_filters( 'bbp_get_topic_merge_link', $retval, $r, $args );
    30553118    }
    … …  
    31123175        $retval  = $r['link_before'] . '<a href="' . esc_url( $uri ) . '" class="bbp-topic-spam-link">' . $display . '</a>' . $r['link_after'];
    31133176
     3177        // Filter & return
    31143178        return apply_filters( 'bbp_get_topic_spam_link', $retval, $r, $args );
    31153179    }
    … …  
    31623226        $retval   = $r['link_before'] . '<a role="button" href="' . esc_url( $r['uri'] ) . '" class="bbp-topic-reply-link">' . $r['reply_text'] . '</a>' . $r['link_after'];
    31633227
     3228        // Filter & return
    31643229        return apply_filters( 'bbp_get_topic_reply_link', $retval, $r, $args );
    31653230    }
    … …  
    32333298    }
    32343299
     3300    // Filter & return
    32353301    return apply_filters( 'bbp_get_topics_pagination_base', $base );
    32363302}
    … …  
    32793345        }
    32803346
    3281         // Filter and return
     3347        // Filter & return
    32823348        return apply_filters( 'bbp_get_forum_pagination_count', $retstr );
    32833349    }
    … …  
    33083374        }
    33093375
     3376        // Filter & return
    33103377        return apply_filters( 'bbp_get_forum_pagination_links', $bbp->topic_query->pagination_links );
    33113378    }
    … …  
    34643531        <?php
    34653532
    3466         // Return the results
     3533        // Filter & return
    34673534        return apply_filters( 'bbp_get_form_topic_type_dropdown', ob_get_clean(), $r, $args );
    34683535    }
    … …  
    35453612        <?php
    35463613
    3547         // Return the results
     3614        // Filter & return
    35483615        return apply_filters( 'bbp_get_form_topic_status_dropdown', ob_get_clean(), $r, $args );
    35493616    }
    … …  
    36303697        $retstr = $r['before'] . $retstr . $r['after'];
    36313698
    3632         // Return filtered result
     3699        // Filter & return
    36333700        return apply_filters( 'bbp_get_single_topic_description', $retstr, $r, $args );
    36343701    }
    … …  
    36553722     */
    36563723    function bbp_get_topic_tag_tax_id() {
     3724
     3725        // Filter & return
    36573726        return apply_filters( 'bbp_get_topic_tag_tax_id', bbpress()->topic_tag_tax_id );
    36583727    }
    … …  
    36663735 */
    36673736function bbp_get_topic_tag_tax_labels() {
    3668     return apply_filters( 'bbp_get_topic_tag_tax_labels', array(
     3737
     3738    // Filter & return
     3739    return (array) apply_filters( 'bbp_get_topic_tag_tax_labels', array(
    36693740        'name'                       => __( 'Topic Tags',                      'bbpress' ),
    36703741        'singular_name'              => __( 'Topic Tag',                       'bbpress' ),
    … …  
    36923763 */
    36933764function bbp_get_topic_tag_tax_rewrite() {
    3694     return apply_filters( 'bbp_get_topic_tag_tax_rewrite', array(
     3765
     3766    // Filter & return
     3767    return (array) apply_filters( 'bbp_get_topic_tag_tax_rewrite', array(
    36953768        'slug'       => bbp_get_topic_tag_tax_slug(),
    36963769        'with_front' => false
    … …  
    37353808            : 0;
    37363809
     3810        // Filter & return
    37373811        return (int) apply_filters( 'bbp_get_topic_tag_id', (int) $retval, $tag, $term );
    37383812    }
    … …  
    37753849            : '';
    37763850
     3851        // Filter & return
    37773852        return apply_filters( 'bbp_get_topic_tag_name', $retval, $tag, $term );
    37783853    }
    … …  
    38153890            : '';
    38163891
     3892        // Filter & return
    38173893        return apply_filters( 'bbp_get_topic_tag_slug', $retval, $tag, $term );
    38183894    }
    … …  
    38553931            : '';
    38563932
     3933        // Filter & return
    38573934        return apply_filters( 'bbp_get_topic_tag_link', $retval, $tag, $term );
    38583935    }
    … …  
    39033980        }
    39043981
     3982        // Filter & return
    39053983        return apply_filters( 'bbp_get_topic_tag_edit_link', $retval, $tag, $term );
    39063984    }
    … …  
    39514029            : '';
    39524030
     4031        // Filter & return
    39534032        return apply_filters( 'bbp_get_topic_tag_description', $retval, $r, $args, $tag, $term );
    39544033    }
    … …  
    39904069        }
    39914070
     4071        // Filter & return
    39924072        return apply_filters( 'bbp_get_form_topic_title', $topic_title );
    39934073    }
    … …  
    40274107        }
    40284108
     4109        // Filter & return
    40294110        return apply_filters( 'bbp_get_form_topic_content', $topic_content );
    40304111    }
    … …  
    41044185        }
    41054186
     4187        // Filter & return
    41064188        return apply_filters( 'bbp_get_form_topic_tags', $topic_tags );
    41074189    }
    … …  
    41424224        }
    41434225
     4226        // Filter & return
    41444227        return apply_filters( 'bbp_get_form_topic_forum', $topic_forum );
    41454228    }
    … …  
    42004283        $checked = checked( $topic_subscribed, true, false );
    42014284
     4285        // Filter & return
    42024286        return apply_filters( 'bbp_get_form_topic_subscribed', $checked, $topic_subscribed );
    42034287    }
    … …  
    42364320        $checked = checked( $topic_revision, true, false );
    42374321
     4322        // Filter & return
    42384323        return apply_filters( 'bbp_get_form_topic_log_edit', $checked, $topic_revision );
    42394324    }
    … …  
    42694354        }
    42704355
     4356        // Filter & return
    42714357        return apply_filters( 'bbp_get_form_topic_edit_reason', $topic_edit_reason );
    42724358    }
    … …  
    43374423    }
    43384424
     4425    // Filter & return
    43394426    return (bool) apply_filters( 'bbp_show_topic_lock_alert', $retval, $topic_id );
    43404427}
    … …  
    43694456        $text = sprintf( esc_html__( '%1$s is currently editing this topic.', 'bbpress' ), $person );
    43704457
     4458        // Filter & return
    43714459        return apply_filters( 'bbp_get_topic_lock_description', $text, $user_id, $topic_id );
    43724460    }

  • trunk/src/includes/users/capabilities.php

    r6384 r6438  
    118118    }
    119119
    120     return apply_filters( 'bbp_map_primary_meta_caps', $caps, $cap, $user_id, $args );
     120    // Filter & return
     121    return (array) apply_filters( 'bbp_map_primary_meta_caps', $caps, $cap, $user_id, $args );
    121122}
    122123
    … …  
    167168    }
    168169
     170    // Filter & return
    169171    return apply_filters( 'bbp_set_user_role', $new_role, $user_id, $user );
    170172}
    … …  
    205207    }
    206208
     209    // Filter & return
    207210    return apply_filters( 'bbp_get_user_role', $role, $user_id, $user );
    208211}
    … …  
    243246    }
    244247
     248    // Filter & return
    245249    return apply_filters( 'bbp_get_user_blog_role', $role, $user_id, $user );
    246250}
    … …  
    393397    $default_role = bbp_get_default_role();
    394398
    395     // Return filtered results, forcing admins to keymasters.
     399    // Filter & return
    396400    return (array) apply_filters( 'bbp_get_user_role_map', array (
    397401        'administrator' => bbp_get_keymaster_role(),
    … …  
    440444    }
    441445
     446    // Filter & return
    442447    return (bool) apply_filters( 'bbp_core_is_user_spammer', $is_spammer );
    443448}
    … …  
    661666    }
    662667
     668    // Filter & return
    663669    return (bool) apply_filters( 'bbp_core_is_user_deleted', $is_deleted );
    664670}
    … …  
    744750    $_user_id = (int) ! empty( $user_id ) ? $user_id : bbp_get_current_user_id();
    745751
    746     // Filter and return
     752    // Filter & return
    747753    return (bool) apply_filters( 'bbp_is_user_keymaster', user_can( $_user_id, 'keep_gate' ), $_user_id, $user_id );
    748754}
    … …  
    783789    }
    784790
    785     // Filter and return
     791    // Filter & return
    786792    return (bool) apply_filters( 'bbp_show_user_profile', $retval, $user_id );
    787793}
    … …  
    855861    }
    856862
    857     return apply_filters( 'bbp_get_moderators', $users, $object_id );
    858 }
     863    // Filter & return
     864    return (array) apply_filters( 'bbp_get_moderators', $users, $object_id );
     865}

  • trunk/src/includes/users/engagements.php

    r6422 r6438  
    3232    $retval = add_metadata( $meta_type, $object_id, $meta_key, $user_id, false );
    3333
     34    // Filter & return
    3435    return (bool) apply_filters( 'bbp_add_user_to_object', (bool) $retval, $object_id, $user_id, $meta_key, $meta_type );
    3536}
    … …  
    5455    $retval = delete_metadata( $meta_type, $object_id, $meta_key, $user_id, false );
    5556
     57    // Filter & return
    5658    return (bool) apply_filters( 'bbp_remove_user_from_object', (bool) $retval, $object_id, $user_id, $meta_key, $meta_type );
    5759}
    … …  
    7577    $retval = wp_parse_id_list( $meta );
    7678
    77     return (array) apply_filters( 'bbp_get_users_for_object', (array) $retval, $object_id, $meta_key, $meta_type );
     79    // Filter & return
     80    return (array) apply_filters( 'bbp_get_users_for_object', $retval, $object_id, $meta_key, $meta_type );
    7881}
    7982
    … …  
    98101    $retval   = is_numeric( array_search( $user_id, $user_ids, true ) );
    99102
    100     return (bool) apply_filters( 'bbp_is_object_of_user', (bool) $retval, $object_id, $user_id, $meta_key, $meta_type );
     103    // Filter & return
     104    return (bool) apply_filters( 'bbp_is_object_of_user', $retval, $object_id, $user_id, $meta_key, $meta_type );
    101105}
    102106
    … …  
    118122    $users    = bbp_get_users_for_object( $topic_id, '_bbp_engagement' );
    119123
     124    // Filter & return
    120125    return (array) apply_filters( 'bbp_get_topic_engagements', $users, $topic_id );
    121126}
    … …  
    144149    ) );
    145150
     151    // Filter & return
    146152    return apply_filters( 'bbp_get_user_engagements', $engagements, $user_id );
    147153}
    … …  
    173179    ) );
    174180
     181    // Filter & return
    175182    return (array) apply_filters( 'bbp_get_user_engaged_topic_ids', $engagements->posts, $user_id );
    176183}
    … …  
    195202    $retval   = bbp_is_object_of_user( $topic_id, $user_id, '_bbp_engagement' );
    196203
     204    // Filter & return
    197205    return (bool) apply_filters( 'bbp_is_user_engaged', (bool) $retval, $user_id, $topic_id );
    198206}
    … …  
    288296    $users    = bbp_get_users_for_object( $topic_id, '_bbp_favorite' );
    289297
     298    // Filter & return
    290299    return (array) apply_filters( 'bbp_get_topic_favoriters', $users, $topic_id );
    291300}
    … …  
    314323    ) );
    315324
     325    // Filter & return
    316326    return apply_filters( 'bbp_get_user_favorites', $query, $user_id );
    317327}
    … …  
    343353    ) );
    344354
     355    // Filter & return
    345356    return (array) apply_filters( 'bbp_get_user_favorites_topic_ids', $favorites->posts, $user_id );
    346357}
    … …  
    389400    }
    390401
     402    // Filter & return
    391403    return (bool) apply_filters( 'bbp_is_user_favorite', (bool) $retval, $user_id, $topic_id, $favorites );
    392404}
    … …  
    585597    $users    = bbp_get_users_for_object( $forum_id, '_bbp_subscription' );
    586598
     599    // Filter & return
    587600    return (array) apply_filters( 'bbp_get_forum_subscribers', $users, $forum_id );
    588601}
    … …  
    602615    $users    = bbp_get_users_for_object( $topic_id, '_bbp_subscription' );
    603616
     617    // Filter & return
    604618    return (array) apply_filters( 'bbp_get_topic_subscribers', $users, $topic_id );
    605619}
    … …  
    619633    _deprecated_function( __FUNCTION__, 2.5, 'bbp_get_user_topic_subscriptions()' );
    620634    $query = bbp_get_user_topic_subscriptions( $user_id );
     635
     636    // Filter & return
    621637    return apply_filters( 'bbp_get_user_subscriptions', $query, $user_id );
    622638}
    … …  
    645661    ) );
    646662
     663    // Filter & return
    647664    return apply_filters( 'bbp_get_user_topic_subscriptions', $query, $user_id );
    648665}
    … …  
    671688    ) );
    672689
     690    // Filter & return
    673691    return apply_filters( 'bbp_get_user_forum_subscriptions', $query, $user_id );
    674692}
    … …  
    700718    ) );
    701719
     720    // Filter & return
    702721    return (array) apply_filters( 'bbp_get_user_subscribed_forum_ids', $subscriptions->posts, $user_id );
    703722}
    … …  
    729748    ) );
    730749
     750    // Filter & return
    731751    return (array) apply_filters( 'bbp_get_user_subscribed_topic_ids', $subscriptions->posts, $user_id );
    732752}
    … …  
    783803    }
    784804
     805    // Filter & return
    785806    return (bool) apply_filters( 'bbp_is_user_subscribed', $retval, $user_id, $object_id, $subscribed_ids );
    786807}
    … …  
    840861    }
    841862
     863    // Filter & return
    842864    return (bool) apply_filters( 'bbp_is_user_subscribed_to_forum', (bool) $retval, $user_id, $forum_id, $subscribed_ids );
    843865}
    … …  
    897919    }
    898920
     921    // Filter & return
    899922    return (bool) apply_filters( 'bbp_is_user_subscribed_to_topic', (bool) $retval, $user_id, $topic_id, $subscribed_ids );
    900923}

  • trunk/src/includes/users/functions.php

    r6422 r6438  
    4040    }
    4141
     42    // Filter & return
    4243    return apply_filters( 'bbp_redirect_login', $url, $raw_url, $user );
    4344}
    … …  
    5556 */
    5657function bbp_is_anonymous() {
    57     if ( ! is_user_logged_in() && bbp_allow_anonymous() ) {
    58         $is_anonymous = true;
    59     } else {
    60         $is_anonymous = false;
    61     }
    62 
    63     return apply_filters( 'bbp_is_anonymous', $is_anonymous );
     58    $is_anonymous = ( ! is_user_logged_in() && bbp_allow_anonymous() );
     59
     60    // Filter & return
     61    return (bool) apply_filters( 'bbp_is_anonymous', $is_anonymous );
    6462}
    6563
    … …  
    167165    $retval = preg_replace( '/[^0-9a-fA-F:., ]/', '', $remote_address );
    168166
     167    // Filter & return
    169168    return apply_filters( 'bbp_current_author_ip', $retval, $remote_address );
    170169}
    … …  
    182181        : '';
    183182
     183    // Filter & return
    184184    return apply_filters( 'bbp_current_author_ua', $retval );
    185185}
    … …  
    553553    ) );
    554554
     555    // Filter & return
    555556    return apply_filters( 'bbp_get_user_topics_started', $query, $user_id );
    556557}
    … …  
    581582    ) );
    582583
     584    // Filter & return
    583585    return apply_filters( 'bbp_get_user_replies_created', $query, $user_id );
    584586}
    … …  
    595597function bbp_get_total_users() {
    596598    $user_count = count_users();
    597     return apply_filters( 'bbp_get_total_users', (int) $user_count['total_users'] );
     599
     600    // Filter & return
     601    return (int) apply_filters( 'bbp_get_total_users', (int) $user_count['total_users'] );
    598602}
    599603
    … …  
    632636    }
    633637
    634     return apply_filters( 'bbp_get_user_ids_from_nicenames', $retval, $user_nicenames );
     638    // Filter & return
     639    return (array) apply_filters( 'bbp_get_user_ids_from_nicenames', $retval, $user_nicenames );
    635640}
    636641
    … …  
    664669    }
    665670
    666     return apply_filters( 'bbp_get_user_nicenames_from_ids', $retval, $user_ids );
     671    // Filter & return
     672    return (array) apply_filters( 'bbp_get_user_nicenames_from_ids', $retval, $user_ids );
    667673}
    668674
    … …  
    693699    $count = $count + bbp_get_user_closed_topic_count( $user_id );
    694700
     701    // Filter & return
    695702    return (int) apply_filters( 'bbp_get_user_topic_count_raw', $count, $user_id );
    696703}
    … …  
    718725    $count = count_user_posts( $user_id, bbp_get_reply_post_type(), false );
    719726
     727    // Filter & return
    720728    return (int) apply_filters( 'bbp_get_user_reply_count_raw', $count, $user_id );
    721729}
    … …  
    748756    ) );
    749757
     758    // Filter & return
    750759    return (int) apply_filters( 'bbp_get_user_closed_topic_count', $count, $user_id );
    751760}

  • trunk/src/includes/users/options.php

    r6359 r6438  
    2020function bbp_get_default_user_options() {
    2121
    22     // Default options
    23     return apply_filters( 'bbp_get_default_user_options', array(
     22    // Filter & return
     23    return (array) apply_filters( 'bbp_get_default_user_options', array(
    2424        '_bbp_last_posted' => '0', // For checking flooding
    2525        '_bbp_topic_count' => '0', // Total topics per site
    … …  
    225225            : 'bbp_get_user_topic_count';
    226226
     227        // Filter & return
    227228        return apply_filters( $filter, $count, $user_id );
    228229    }
    … …  
    369370        $time = get_user_option( '_bbp_last_posted', $user_id );
    370371
     372        // Filter & return
    371373        return apply_filters( 'bbp_get_user_last_posted', $time, $user_id );
    372374    }

  • trunk/src/includes/users/template.php

    r6427 r6438  
    191191    $bbp->user_query = new BBP_User_Query( $r );
    192192
     193    // Filter & return
    193194    return apply_filters( 'bbp_has_users', $bbp->user_query->have_users(), $bbp->user_query );
    194195}
    … …  
    270271        }
    271272
     273        // Filter & return
    272274        return (int) apply_filters( 'bbp_get_user_id', (int) $bbp_user_id, $displayed_user_fallback, $current_user_fallback );
    273275    }
    … …  
    293295     */
    294296    function bbp_get_current_user_id() {
    295         return apply_filters( 'bbp_get_current_user_id', bbp_get_user_id( 0, false, true ) );
     297
     298        // Filter & return
     299        return (int) apply_filters( 'bbp_get_current_user_id', bbp_get_user_id( 0, false, true ) );
    296300    }
    297301
    … …  
    316320     */
    317321    function bbp_get_displayed_user_id() {
     322
     323        // Filter & return
    318324        return apply_filters( 'bbp_get_displayed_user_id', bbp_get_user_id( 0, true, false ) );
    319325    }
    … …  
    368374        $user->filter = $old_filter;
    369375
    370         // Return empty
     376        // Filter & return
    371377        return apply_filters( 'bbp_get_displayed_user_field', $value, $field, $filter );
    372378    }
    … …  
    394400        global $user_identity;
    395401
    396         $current_user_name = is_user_logged_in() ? $user_identity : __( 'Anonymous', 'bbpress' );
    397 
     402        $current_user_name = is_user_logged_in()
     403            ? $user_identity
     404            : esc_html__( 'Anonymous', 'bbpress' );
     405
     406        // Filter & return
    398407        return apply_filters( 'bbp_get_current_user_name', $current_user_name );
    399408    }
    … …  
    434443        $avatar = get_avatar( $user, $size );
    435444
     445        // Filter & return
    436446        return apply_filters( 'bbp_get_current_user_avatar', $avatar, $size );
    437447    }
    … …  
    472482        $user_link = '<a href="' . esc_url( bbp_get_user_profile_url( $user_id ) ) . '">' . esc_html( $user->display_name ) . '</a>';
    473483
     484        // Filter & return
    474485        return apply_filters( 'bbp_get_user_profile_link', $user_link, $user_id );
    475486    }
    … …  
    524535        $retval = ! empty( $nicename ) ? ( $r['before'] . $nicename . $r['after'] ) : '';
    525536
    526         // Filter and return
     537        // Filter & return
    527538        return (string) apply_filters( 'bbp_get_user_nicename', $retval, $user_id, $r );
    528539    }
    … …  
    588599        }
    589600
     601        // Filter & return
    590602        return apply_filters( 'bbp_get_user_profile_url', $url, $user_id, $user_nicename );
    591603    }
    … …  
    625637        $user      = get_userdata( $user_id );
    626638        $edit_link = '<a href="' . esc_url( bbp_get_user_profile_edit_url( $user_id ) ) . '">' . esc_html( $user->display_name ) . '</a>';
     639
     640        // Filter & return
    627641        return apply_filters( 'bbp_get_user_profile_edit_link', $edit_link, $user_id );
    628642    }
    … …  
    684698        }
    685699
     700        // Filter & return
    686701        return apply_filters( 'bbp_get_user_edit_profile_url', $url, $user_id, $user_nicename );
    687 
    688702    }
    689703
    … …  
    736750        }
    737751
     752        // Filter & return
    738753        return apply_filters( 'bbp_get_user_display_role', $role, $user_id );
    739754    }
    … …  
    784799        $retval = $r['before'] . '<a href="' . esc_url( admin_url() ) . '">' . $r['text'] . '</a>' . $r['after'];
    785800
     801        // Filter & return
    786802        return apply_filters( 'bbp_get_admin_link', $retval, $r );
    787803    }
    … …  
    831847        }
    832848
     849        // Filter & return
    833850        return apply_filters( 'bbp_get_author_ip', $author_ip, $r );
    834851    }
    … …  
    889906        }
    890907
     908        // Filter & return
    891909        return apply_filters( 'bbp_get_author_display_name', $retval, $post_id );
    892910    }
    … …  
    945963        }
    946964
     965        // Filter & return
    947966        return apply_filters( 'bbp_get_author_email', $retval, $post_id );
    948967    }
    … …  
    10011020        }
    10021021
     1022        // Filter & return
    10031023        return apply_filters( 'bbp_get_author_url', $retval, $post_id );
    10041024    }
    … …  
    10801100        }
    10811101
     1102        // Filter & return
    10821103        return apply_filters( 'bbp_get_favorites_permalink', $url, $user_id );
    10831104    }
    … …  
    11911212        }
    11921213
    1193         // Return the link
     1214        // Filter & return
    11941215        return apply_filters( 'bbp_get_user_favorites_link', $html, $r, $user_id, $topic_id );
    11951216    }
    … …  
    12811302        }
    12821303
     1304        // Filter & return
    12831305        return apply_filters( 'bbp_get_subscriptions_permalink', $url, $user_id );
    12841306    }
    … …  
    14351457        }
    14361458
    1437         // Return the link
     1459        // Filter & return
    14381460        return apply_filters( 'bbp_get_user_subscribe_link', $html, $r, $user_id, $topic_id );
    14391461    }
    … …  
    16031625function bbp_edit_user_blog_role() {
    16041626
    1605     // Return if no user is being edited
     1627    // Bail if no user is being edited
    16061628    if ( ! bbp_is_single_user_edit() ) {
    16071629        return;
    … …  
    16351657function bbp_edit_user_forums_role() {
    16361658
    1637     // Return if no user is being edited
     1659    // Bail if no user is being edited
    16381660    if ( ! bbp_is_single_user_edit() ) {
    16391661        return;
    … …  
    16791701    $contact_methods = wp_get_user_contact_methods( bbpress()->displayed_user );
    16801702
    1681     return apply_filters( 'bbp_edit_user_contact_methods', $contact_methods );
     1703    // Filter & return
     1704    return (array) apply_filters( 'bbp_edit_user_contact_methods', $contact_methods );
    16821705}
    16831706
    … …  
    17351758        }
    17361759
     1760        // Filter & return
    17371761        return apply_filters( 'bbp_get_user_topics_created_url', $url, $user_id );
    17381762    }
    … …  
    17911815        }
    17921816
     1817        // Filter & return
    17931818        return apply_filters( 'bbp_get_user_replies_created_url', $url, $user_id );
    17941819    }
    … …  
    18471872        }
    18481873
     1874        // Filter & return
    18491875        return apply_filters( 'bbp_get_user_engagements_url', $url, $user_id );
    18501876    }
    … …  
    21052131        }
    21062132
     2133        // Filter & return
    21072134        return apply_filters( 'bbp_get_author_link', $author_link, $r );
    21082135    }
    … …  
    21572184
    21582185    // Forum is hidden, and user can see it
    2159     } elseif ( bbp_is_forum_hidden ( $forum_id, $r['check_ancestors'] ) && user_can( $user_id, 'read_forum', $forum_id  ) ) {
     2186    } elseif ( bbp_is_forum_hidden( $forum_id, $r['check_ancestors'] ) && user_can( $user_id, 'read_forum', $forum_id  ) ) {
    21602187        $retval = true;
    21612188    }
    21622189
     2190    // Filter & return
    21632191    return apply_filters( 'bbp_user_can_view_forum', $retval, $forum_id, $user_id );
    21642192}
    … …  
    21962224    }
    21972225
    2198     // Allow access to be filtered
     2226    // Filter & return
    21992227    return (bool) apply_filters( 'bbp_current_user_can_publish_topics', $retval );
    22002228}
    … …  
    22262254    }
    22272255
    2228     // Allow access to be filtered
     2256    // Filter & return
    22292257    return (bool) apply_filters( 'bbp_current_user_can_publish_forums', $retval );
    22302258}
    … …  
    22622290    }
    22632291
    2264     // Allow access to be filtered
     2292    // Filter & return
    22652293    return (bool) apply_filters( 'bbp_current_user_can_publish_replies', $retval );
    22662294}
    … …  
    23032331    }
    23042332
     2333    // Filter & return
    23052334    return apply_filters( 'bbp_get_forums_for_current_user', $forums, $r, $args );
    23062335}
    … …  
    23362365    }
    23372366
    2338     // Allow access to be filtered
     2367    // Filter & return
    23392368    return (bool) apply_filters( 'bbp_current_user_can_access_create_forum_form', (bool) $retval );
    23402369}
    … …  
    23722401    }
    23732402
    2374     // Allow access to be filtered
     2403    // Filter & return
    23752404    return (bool) apply_filters( 'bbp_current_user_can_access_create_topic_form', (bool) $retval );
    23762405}
    … …  
    24082437    }
    24092438
    2410     // Allow access to be filtered
     2439    // Filter & return
    24112440    return (bool) apply_filters( 'bbp_current_user_can_access_create_reply_form', (bool) $retval );
    24122441}
    … …  
    24442473    }
    24452474
    2446     // Allow access to be filtered
     2475    // Filter & return
    24472476    return (bool) apply_filters( 'bbp_current_user_can_access_anonymous_user_form', (bool) $retval );
    24482477}
    … …  
    25082537        }
    25092538
     2539        // Filter & return
    25102540        return apply_filters( 'bbp_get_moderator_list', $retval );
    25112541    }
Note: See TracChangeset for help on using the changeset viewer.