Skip to:
Content

bbPress.org


Ignore:
Timestamp:
10/28/2015 04:07:50 AM (10 years ago)
Author:
netweb
Message:

Standardize @since PHPDoc tags style and format

This changeset updates the style and formatting of all of our @since instances for compatibility with phpDocumentor 2 and WP-Parser as we move toward implementing the bbPress developer code reference.

Props thebrandonallen
Fixes #2879

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/includes/common/template.php

    r5908 r5951  
    1919 * Ouput the forum URL
    2020 *
    21  * @since bbPress (r3979)
     21 * @since 2.1.0 bbPress (r3979)
    2222 *
    2323 * @uses bbp_get_forums_url() To get the forums URL
     
    3030     * Return the forum URL
    3131     *
    32      * @since bbPress (r3979)
     32     * @since 2.1.0 bbPress (r3979)
    3333     *
    3434     * @uses home_url() To get the home URL
     
    4343 * Ouput the forum URL
    4444 *
    45  * @since bbPress (r3979)
     45 * @since 2.1.0 bbPress (r3979)
    4646 *
    4747 * @uses bbp_get_topics_url() To get the topics URL
     
    5454     * Return the forum URL
    5555     *
    56      * @since bbPress (r3979)
     56     * @since 2.1.0 bbPress (r3979)
    5757     *
    5858     * @uses home_url() To get the home URL
     
    7070 * Add our custom head action to wp_head
    7171 *
    72  * @since bbPress (r2464)
     72 * @since 2.0.0 bbPress (r2464)
    7373 *
    7474 * @uses do_action() Calls 'bbp_head'
     
    8181 * Add our custom head action to wp_head
    8282 *
    83  * @since bbPress (r2464)
     83 * @since 2.0.0 bbPress (r2464)
    8484 *
    8585 * @uses do_action() Calls 'bbp_footer'
     
    9494 * Check if current site is public
    9595 *
    96  * @since bbPress (r3398)
     96 * @since 2.0.0 bbPress (r3398)
    9797 *
    9898 * @param int $site_id
     
    118118 * Check if current page is a bbPress forum
    119119 *
    120  * @since bbPress (r2549)
     120 * @since 2.0.0 bbPress (r2549)
    121121 *
    122122 * @param int $post_id Possible post_id to check
     
    140140 * Check if we are viewing a forum archive.
    141141 *
    142  * @since bbPress (r3251)
     142 * @since 2.0.0 bbPress (r3251)
    143143 *
    144144 * @uses is_post_type_archive() To check if we are looking at the forum archive
     
    164164 * Viewing a single forum
    165165 *
    166  * @since bbPress (r3338)
     166 * @since 2.0.0 bbPress (r3338)
    167167 *
    168168 * @uses is_single()
     
    194194 * Check if current page is a forum edit page
    195195 *
    196  * @since bbPress (r3553)
     196 * @since 2.1.0 bbPress (r3553)
    197197 *
    198198 * @uses WP_Query Checks if WP_Query::bbp_is_forum_edit is true
     
    220220 * Check if current page is a bbPress topic
    221221 *
    222  * @since bbPress (r2549)
     222 * @since 2.0.0 bbPress (r2549)
    223223 *
    224224 * @param int $post_id Possible post_id to check
     
    243243 * Viewing a single topic
    244244 *
    245  * @since bbPress (r3338)
     245 * @since 2.0.0 bbPress (r3338)
    246246 *
    247247 * @uses is_single()
     
    273273 * Check if we are viewing a topic archive.
    274274 *
    275  * @since bbPress (r3251)
     275 * @since 2.0.0 bbPress (r3251)
    276276 *
    277277 * @uses is_post_type_archive() To check if we are looking at the topic archive
     
    296296 * Check if current page is a topic edit page
    297297 *
    298  * @since bbPress (r2753)
     298 * @since 2.0.0 bbPress (r2753)
    299299 *
    300300 * @uses WP_Query Checks if WP_Query::bbp_is_topic_edit is true
     
    322322 * Check if current page is a topic merge page
    323323 *
    324  * @since bbPress (r2756)
     324 * @since 2.0.0 bbPress (r2756)
    325325 *
    326326 * @uses bbp_is_topic_edit() To check if it's a topic edit page
     
    343343 * Check if current page is a topic split page
    344344 *
    345  * @since bbPress (r2756)
     345 * @since 2.0.0 bbPress (r2756)
    346346 *
    347347 * @uses bbp_is_topic_edit() To check if it's a topic edit page
     
    364364 * Check if the current page is a topic tag
    365365 *
    366  * @since bbPress (r3311)
     366 * @since 2.0.0 bbPress (r3311)
    367367 *
    368368 * @return bool True if it's a topic tag, false if not
     
    394394 * Check if the current page is editing a topic tag
    395395 *
    396  * @since bbPress (r3346)
     396 * @since 2.0.0 bbPress (r3346)
    397397 *
    398398 * @uses WP_Query Checks if WP_Query::bbp_is_topic_tag_edit is true
     
    425425 * Check if the current post type is one of bbPress's
    426426 *
    427  * @since bbPress (r3311)
     427 * @since 2.0.0 bbPress (r3311)
    428428 *
    429429 * @param mixed $the_post Optional. Post object or post ID.
     
    455455 * Check if current page is a bbPress reply
    456456 *
    457  * @since bbPress (r2549)
     457 * @since 2.0.0 bbPress (r2549)
    458458 *
    459459 * @param int $post_id Possible post_id to check
     
    478478 * Check if current page is a reply edit page
    479479 *
    480  * @since bbPress (r2753)
     480 * @since 2.0.0 bbPress (r2753)
    481481 *
    482482 * @uses WP_Query Checks if WP_Query::bbp_is_reply_edit is true
     
    523523 * Viewing a single reply
    524524 *
    525  * @since bbPress (r3344)
     525 * @since 2.0.0 bbPress (r3344)
    526526 *
    527527 * @uses is_single()
     
    553553 * Check if current page is a bbPress user's favorites page (profile page)
    554554 *
    555  * @since bbPress (r2652)
     555 * @since 2.0.0 bbPress (r2652)
    556556 *
    557557 * @return bool True if it's the favorites page, false if not
     
    574574 * Check if current page is a bbPress user's subscriptions page (profile page)
    575575 *
    576  * @since bbPress (r2652)
     576 * @since 2.0.0 bbPress (r2652)
    577577 *
    578578 * @return bool True if it's the subscriptions page, false if not
     
    596596 * page)
    597597 *
    598  * @since bbPress (r2688)
     598 * @since 2.0.0 bbPress (r2688)
    599599 *
    600600 * @return bool True if it's the topics created page, false if not
     
    618618 * page)
    619619 *
    620  * @since bbPress (r4225)
     620 * @since 2.2.0 bbPress (r4225)
    621621 *
    622622 * @return bool True if it's the topics created page, false if not
     
    639639 * Check if current page is the currently logged in users author page
    640640 *
    641  * @since bbPress (r2688)
     641 * @since 2.0.0 bbPress (r2688)
     642 *
    642643 * @uses bbp_is_single_user() Check query variable
    643644 * @uses is_user_logged_in() Must be logged in to be home
     
    663664 * Check if current page is the currently logged in users author edit page
    664665 *
    665  * @since bbPress (r3918)
     666 * @since 2.1.0 bbPress (r3918)
     667 *
    666668 * @uses bbp_is_single_user_edit() Check query variable
    667669 * @uses is_user_logged_in() Must be logged in to be home
     
    685687 * Check if current page is a user profile page
    686688 *
    687  * @since bbPress (r2688)
     689 * @since 2.0.0 bbPress (r2688)
    688690 *
    689691 * @uses WP_Query Checks if WP_Query::bbp_is_single_user is set to true
     
    707709 * Check if current page is a user profile edit page
    708710 *
    709  * @since bbPress (r2688)
     711 * @since 2.0.0 bbPress (r2688)
    710712 *
    711713 * @uses WP_Query Checks if WP_Query::bbp_is_single_user_edit is set to true
     
    729731 * Check if current page is a user profile page
    730732 *
    731  * @since bbPress (r4225)
     733 * @since 2.2.0 bbPress (r4225)
    732734 *
    733735 * @uses WP_Query Checks if WP_Query::bbp_is_single_user_profile is set to true
     
    751753 * Check if current page is a user topics created page
    752754 *
    753  * @since bbPress (r4225)
     755 * @since 2.2.0 bbPress (r4225)
    754756 *
    755757 * @uses WP_Query Checks if WP_Query::bbp_is_single_user_topics is set to true
     
    773775 * Check if current page is a user replies created page
    774776 *
    775  * @since bbPress (r4225)
     777 * @since 2.2.0 bbPress (r4225)
    776778 *
    777779 * @uses WP_Query Checks if WP_Query::bbp_is_single_user_replies is set to true
     
    795797 * Check if current page is a view page
    796798 *
    797  * @since bbPress (r2789)
     799 * @since 2.0.0 bbPress (r2789)
    798800 *
    799801 * @global WP_Query $wp_query To check if WP_Query::bbp_is_view is true
     
    823825 * Check if current page is a search page
    824826 *
    825  * @since bbPress (r4579)
     827 * @since 2.3.0 bbPress (r4579)
    826828 *
    827829 * @global WP_Query $wp_query To check if WP_Query::bbp_is_search is true
     
    861863 * Check if current page is a search results page
    862864 *
    863  * @since bbPress (r4919)
     865 * @since 2.4.0 bbPress (r4919)
    864866 *
    865867 * @global WP_Query $wp_query To check if WP_Query::bbp_is_search is true
     
    899901 * Check if current page is an edit page
    900902 *
    901  * @since bbPress (r3585)
     903 * @since 2.1.0 bbPress (r3585)
    902904 *
    903905 * @uses WP_Query Checks if WP_Query::bbp_is_edit is true
     
    921923 * Use the above is_() functions to output a body class for each scenario
    922924 *
    923  * @since bbPress (r2926)
     925 * @since 2.0.0 bbPress (r2926)
    924926 *
    925927 * @param array $wp_classes
     
    10741076 * Use the above is_() functions to return if in any bbPress page
    10751077 *
    1076  * @since bbPress (r3344)
     1078 * @since 2.0.0 bbPress (r3344)
    10771079 *
    10781080 * @uses bbp_is_single_forum()
     
    11891191 * Output the login form action url
    11901192 *
    1191  * @since bbPress (r2815)
     1193 * @since 2.0.0 bbPress (r2815)
    11921194 *
    11931195 * @param array $args This function supports these arguments:
     
    12051207     * Return the login form action url
    12061208     *
    1207      * @since bbPress (r5684)
     1209     * @since 2.6.0 bbPress (r5684)
    12081210     *
    12091211     * @param array $args This function supports these arguments:
     
    12431245 * check the field manually, use bbp_get_redirect_to().
    12441246 *
    1245  * @since bbPress (r2815)
     1247 * @since 2.0.0 bbPress (r2815)
    12461248 *
    12471249 * @param string $redirect_to Pass a URL to redirect to
     
    12751277 * ensures correct sanitization of the value for the receiving input.
    12761278 *
    1277  * @since bbPress (r2815)
     1279 * @since 2.0.0 bbPress (r2815)
    12781280 *
    12791281 * @param string $request Name of $_REQUEST to look for
     
    12911293     * ensures correct sanitization of the value for the receiving input.
    12921294     *
    1293      * @since bbPress (r2815)
     1295     * @since 2.0.0 bbPress (r2815)
    12941296     *
    12951297     * @param string $request Name of $_REQUEST to look for
     
    13371339 * tab index by default.
    13381340 *
    1339  * @since bbPress (r2810)
    1340  * @deprecated since version 2.6
     1341 * @since 2.0.0 bbPress (r2810)
     1342 *
     1343 * @deprecated 2.6.0 bbPress (r5561)
     1344 *
    13411345 * @link https://bbpress.trac.wordpress.org/attachment/ticket/2714 Trac Ticket
    13421346 * @param int $auto_increment Optional. Default true. Set to false to prevent
     
    13541358     * increment the global tab index by default.
    13551359     *
    1356      * @since bbPress (r2810)
    1357      * @deprecated bbPress (r5560)
     1360     * @since 2.0.0 bbPress (r2810)
     1361     *
     1362     * @deprecated 2.6.0 bbPress (r5561)
     1363     *
    13581364     * @link https://bbpress.trac.wordpress.org/attachment/ticket/2714 Trac Ticket
    13591365     * @uses apply_filters Allows return value to be filtered
     
    13781384 * Can be used for any post type, but is mostly used for topics and forums.
    13791385 *
    1380  * @since bbPress (r2746)
     1386 * @since 2.0.0 bbPress (r2746)
    13811387 *
    13821388 * @param array $args See {@link bbp_get_dropdown()} for arguments
     
    13891395     * topic/reply belongs in.
    13901396     *
    1391      * @since bbPress (r2746)
     1397     * @since 2.0.0 bbPress (r2746)
    13921398     *
    13931399     * @param array $args The function supports these args:
     
    15621568 * Output the required hidden fields when creating/editing a forum
    15631569 *
    1564  * @since bbPress (r3553)
     1570 * @since 2.1.0 bbPress (r3553)
    15651571 *
    15661572 * @uses bbp_is_forum_edit() To check if it's the forum edit page
     
    16051611 * Output the required hidden fields when creating/editing a topic
    16061612 *
    1607  * @since bbPress (r2753)
     1613 * @since 2.0.0 bbPress (r2753)
    16081614 *
    16091615 * @uses bbp_is_topic_edit() To check if it's the topic edit page
     
    16481654 * Output the required hidden fields when creating/editing a reply
    16491655 *
    1650  * @since bbPress (r2753)
     1656 * @since 2.0.0 bbPress (r2753)
    16511657 *
    16521658 * @uses bbp_is_reply_edit() To check if it's the reply edit page
     
    16911697 * Output the required hidden fields when editing a user
    16921698 *
    1693  * @since bbPress (r2690)
     1699 * @since 2.0.0 bbPress (r2690)
    16941700 *
    16951701 * @uses bbp_displayed_user_id() To output the displayed user id
     
    17101716 * Output the required hidden fields when merging a topic
    17111717 *
    1712  * @since bbPress (r2756)
     1718 * @since 2.0.0 bbPress (r2756)
    17131719 *
    17141720 * @uses wp_nonce_field() To generate a hidden nonce field
     
    17291735 * Output the required hidden fields when splitting a topic
    17301736 *
    1731  * @since bbPress (r2756)
     1737 * @since 2.0.0 bbPress (r2756)
    17321738 *
    17331739 * @uses wp_nonce_field() To generate a hidden nonce field
     
    17611767 * Output a textarea or TinyMCE if enabled
    17621768 *
    1763  * @since bbPress (r3586)
     1769 * @since 2.1.0 bbPress (r3586)
    17641770 *
    17651771 * @param array $args
     
    17721778     * Return a textarea or TinyMCE if enabled
    17731779     *
    1774      * @since bbPress (r3586)
     1780     * @since 2.1.0 bbPress (r3586)
    17751781     *
    17761782     * @param array $args
     
    18791885 * Edit TinyMCE plugins to match core behaviour
    18801886 *
    1881  * @since bbPress (r4574)
     1887 * @since 2.3.0 bbPress (r4574)
    18821888 *
    18831889 * @param array $plugins
     
    19041910 * Edit TeenyMCE buttons to match allowedtags
    19051911 *
    1906  * @since bbPress (r4605)
     1912 * @since 2.3.0 bbPress (r4605)
    19071913 *
    19081914 * @param array $buttons
     
    19291935 * Edit TinyMCE quicktags buttons to match allowedtags
    19301936 *
    1931  * @since bbPress (r4606)
     1937 * @since 2.3.0 bbPress (r4606)
    19321938 *
    19331939 * @param array $settings
     
    19581964 * Output the view id
    19591965 *
    1960  * @since bbPress (r2789)
     1966 * @since 2.0.0 bbPress (r2789)
    19611967 *
    19621968 * @param string $view Optional. View id
     
    19721978     * Use view id if supplied, otherwise bbp_get_view_rewrite_id() query var.
    19731979     *
    1974      * @since bbPress (r2789)
     1980     * @since 2.0.0 bbPress (r2789)
    19751981     *
    19761982     * @param string $view Optional. View id.
     
    20012007 * Output the view name aka title
    20022008 *
    2003  * @since bbPress (r2789)
     2009 * @since 2.0.0 bbPress (r2789)
    20042010 *
    20052011 * @param string $view Optional. View id
     
    20162022     * query var is checked for.
    20172023     *
    2018      * @since bbPress (r2789)
     2024     * @since 2.0.0 bbPress (r2789)
    20192025     *
    20202026     * @param string $view Optional. View id
     
    20362042 * Output the view url
    20372043 *
    2038  * @since bbPress (r2789)
     2044 * @since 2.0.0 bbPress (r2789)
    20392045 *
    20402046 * @param string $view Optional. View id
     
    20472053     * Return the view url
    20482054     *
    2049      * @since bbPress (r2789)
     2055     * @since 2.0.0 bbPress (r2789)
    20502056     *
    20512057     * @param string $view Optional. View id
     
    20852091 * Check the passed parameter against the current _bbp_query_name
    20862092 *
    2087  * @since bbPress (r2980)
     2093 * @since 2.0.0 bbPress (r2980)
    20882094 *
    20892095 * @uses bbp_get_query_name() Get the query var '_bbp_query_name'
     
    20972103 * Get the '_bbp_query_name' setting
    20982104 *
    2099  * @since bbPress (r2695)
     2105 * @since 2.0.0 bbPress (r2695)
    21002106 *
    21012107 * @uses get_query_var() To get the query var '_bbp_query_name'
     
    21092115 * Set the '_bbp_query_name' setting to $name
    21102116 *
    2111  * @since bbPress (r2692)
     2117 * @since 2.0.0 bbPress (r2692)
    21122118 *
    21132119 * @param string $name What to set the query var to
     
    21212127 * Used to clear the '_bbp_query_name' setting
    21222128 *
    2123  * @since bbPress (r2692)
     2129 * @since 2.0.0 bbPress (r2692)
    21242130 *
    21252131 * @uses bbp_set_query_name() To set the query var '_bbp_query_name' value to ''
     
    21342140 * Output the page title as a breadcrumb
    21352141 *
    2136  * @since bbPress (r2589)
     2142 * @since 2.0.0 bbPress (r2589)
    21372143 *
    21382144 * @param string $sep Separator. Defaults to '←'
     
    21482154 * Output a breadcrumb
    21492155 *
    2150  * @since bbPress (r2589)
     2156 * @since 2.0.0 bbPress (r2589)
    21512157 *
    21522158 * @param string $sep Separator. Defaults to '←'
     
    21612167     * Return a breadcrumb ( forum -> topic -> reply )
    21622168     *
    2163      * @since bbPress (r2589)
     2169     * @since 2.0.0 bbPress (r2589)
    21642170     *
    21652171     * @param string $sep Separator. Defaults to '←'
     
    24492455 * attributes are supported. As well as any plugins which want to display it.
    24502456 *
    2451  * @since bbPress (r2780)
     2457 * @since 2.0.0 bbPress (r2780)
    24522458 *
    24532459 * @uses bbp_get_allowed_tags()
     
    24622468     * attributes are supported. As well as any plugins which want to display it.
    24632469     *
    2464      * @since bbPress (r2780)
     2470     * @since 2.0.0 bbPress (r2780)
    24652471     *
    24662472     * @uses bbp_kses_allowed_tags() To get the allowed tags
     
    24902496 * Display possible errors & messages inside a template file
    24912497 *
    2492  * @since bbPress (r2688)
     2498 * @since 2.0.0 bbPress (r2688)
    24932499 *
    24942500 * @uses WP_Error bbPress::errors::get_error_codes() To get the error codes
     
    25552561 * Output the logout link
    25562562 *
    2557  * @since bbPress (r2827)
     2563 * @since 2.0.0 bbPress (r2827)
    25582564 *
    25592565 * @param string $redirect_to Redirect to url
     
    25662572     * Return the logout link
    25672573     *
    2568      * @since bbPress (r2827)
     2574     * @since 2.0.0 bbPress (r2827)
    25692575     *
    25702576     * @param string $redirect_to Redirect to url
     
    25832589 * Custom page title for bbPress pages
    25842590 *
    2585  * @since bbPress (r2788)
     2591 * @since 2.0.0 bbPress (r2788)
    25862592 *
    25872593 * @param string $title Optional. The title (not used).
Note: See TracChangeset for help on using the changeset viewer.