Skip to:
Content

BuddyPress.org


Ignore:
Timestamp:
09/13/2015 02:02:56 AM (11 years ago)
Author:
tw2113
Message:

Standardizing our @since tags for the Core component.

See #6576.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/bp-core/bp-core-template.php

    r10039 r10108  
    77 */
    88
    9 // Exit if accessed directly
     9// Exit if accessed directly.
    1010defined( 'ABSPATH' ) || exit;
    1111
     
    8181         * This is a dynamic filter that is dependent on the provided css_id value.
    8282         *
    83          * @since BuddyPress (1.1.0)
     83         * @since 1.1.0
    8484         *
    8585         * @param string $value         HTML list item for the submenu item.
     
    113113 * page.
    114114 *
    115  * @since BuddyPress (2.0.0)
     115 * @since 2.0.0
    116116 *
    117117 * @param string $component
     
    134134     * Filters the directory title for a component.
    135135     *
    136      * @since BuddyPress (2.0.0)
     136     * @since 2.0.0
    137137     *
    138138     * @param string $title     Text to be used in <title> tag.
     
    228228         * Filters the current avatar upload step.
    229229         *
    230          * @since BuddyPress (1.1.0)
     230         * @since 1.1.0
    231231         *
    232232         * @param string $step The current avatar upload step.
     
    255255         * Filters the URL of the avatar to crop.
    256256         *
    257          * @since BuddyPress (1.1.0)
     257         * @since 1.1.0
    258258         *
    259259         * @param string $url URL for the avatar.
     
    282282         * Filters the relative file path to the avatar to crop.
    283283         *
    284          * @since BuddyPress (1.1.0)
     284         * @since 1.1.0
    285285         *
    286286         * @param string $src Relative file path for the avatar.
     
    311311     * Returns the name of the BP site. Used in RSS headers.
    312312     *
    313      * @since BuddyPress (1.6.0)
     313     * @since 1.6.0
    314314     */
    315315    function bp_get_site_name() {
     
    318318         * Filters the name of the BP site. Used in RSS headers.
    319319         *
    320          * @since BuddyPress (1.0.0)
     320         * @since 1.0.0
    321321         *
    322322         * @param string $value Current BP site name.
     
    339339 * and times together with timezone offsets and i18n.
    340340 *
    341  * @since BuddyPress (1.1.0)
     341 * @since 1.1.0
    342342 *
    343343 * @param int|string  $time         The UNIX timestamp to be formatted.
     
    399399     * Filters the date based on a UNIX timestamp.
    400400     *
    401      * @since BuddyPress (1.0.0)
     401     * @since 1.0.0
    402402     *
    403403     * @param string $formatted_date Formatted date from the timestamp.
     
    437437             * Filters the text used based on context of own profile or someone else's profile.
    438438             *
    439              * @since BuddyPress (1.0.0)
     439             * @since 1.0.0
    440440             *
    441441             * @param string $youtext Context-determined string to display.
     
    487487     * Filters the "action" attribute for search forms.
    488488     *
    489      * @since BuddyPress (1.0.0)
     489     * @since 1.0.0
    490490     *
    491491     * @param string $value Search form action url.
     
    497497 * Generate the basic search form as used in BP-Default's header.
    498498 *
    499  * @since BuddyPress (1.0.0)
     499 * @since 1.0.0
    500500 *
    501501 * @return string HTML <select> element.
     
    530530     * Filters all of the component options available for search scope.
    531531     *
    532      * @since BuddyPress (1.5.0)
     532     * @since 1.5.0
    533533     *
    534534     * @param array $options Array of options to add to select field.
     
    544544     * Filters the complete <select> input used for search scope.
    545545     *
    546      * @since BuddyPress (1.0.0)
     546     * @since 1.0.0
    547547     *
    548548     * @param string $selection_box <select> input for selecting search scope.
     
    554554 * Output the default text for the search box for a given component.
    555555 *
    556  * @since BuddyPress (1.5.0)
     556 * @since 1.5.0
    557557 *
    558558 * @see bp_get_search_default_text()
     
    566566     * Return the default text for the search box for a given component.
    567567     *
    568      * @since BuddyPress (1.5.0)
     568     * @since 1.5.0
    569569     *
    570570     * @param string $component Component name. Default: current component.
     
    601601         * Filters the default text for the search box for a given component.
    602602         *
    603          * @since BuddyPress (1.5.0)
     603         * @since 1.5.0
    604604         *
    605605         * @param string $default_text Default text for search box.
     
    634634 * Output the attributes for a form field.
    635635 *
    636  * @since BuddyPress (2.2.0)
     636 * @since 2.2.0
    637637 *
    638638 * @param string $name       The field name to output attributes for.
     
    649649     * manipulation.
    650650     *
    651      * @since BuddyPress (2.2.0)
     651     * @since 2.2.0
    652652     *
    653653     * @param string $name       The field name to get attributes for.
     
    691691         * Filter the attributes for a field before rendering output.
    692692         *
    693          * @since BuddyPress (2.2.0)
     693         * @since 2.2.0
    694694         *
    695695         * @param array  $attributes The field attributes.
     
    729729         * Filters the requested button output.
    730730         *
    731          * @since BuddyPress (1.2.6)
     731         * @since 1.2.6
    732732         *
    733733         * @param string    $contents  Button context to be used.
     
    788788     * Filters the excerpt length to trim text to.
    789789     *
    790      * @since BuddyPress (1.5.0)
     790     * @since 1.5.0
    791791     *
    792792     * @param int $length Length of returned string, including ellipsis.
     
    797797     * Filters the excerpt appended text value.
    798798     *
    799      * @since BuddyPress (1.5.0)
     799     * @since 1.5.0
    800800     *
    801801     * @param string $value Text to append to the end of the excerpt.
     
    950950     * Filters the final generated excerpt.
    951951     *
    952      * @since BuddyPress (1.1.0)
     952     * @since 1.1.0
    953953     *
    954954     * @param string $truncate      Generated excerpt.
     
    987987         * Filters the total member count in your BP instance.
    988988         *
    989          * @since BuddyPress (1.2.0)
     989         * @since 1.2.0
    990990         *
    991991         * @param int $value Member count.
     
    10541054     * Filters whether registrations require activation on this installation.
    10551055     *
    1056      * @since BuddyPress (1.2.0)
     1056     * @since 1.2.0
    10571057     *
    10581058     * @param bool $value Whether registrations require activation. Default true.
     
    10671067 * sanitize_option, we want to reverse this for the plain text arena of emails.
    10681068 *
    1069  * @since BuddyPress (1.7.0)
     1069 * @since 1.7.0
    10701070 *
    10711071 * @see https://buddypress.trac.wordpress.org/ticket/4401
     
    10981098     * Filters a client friendly version of the root blog name.
    10991099     *
    1100      * @since BuddyPress (1.7.0)
     1100     * @since 1.7.0
    11011101     *
    11021102     * @param string $subject Client friendy version of the root blog name.
     
    11321132     * Allows templates to pass parameters into the template loops via AJAX.
    11331133     *
    1134      * @since BuddyPress (1.2.0)
     1134     * @since 1.2.0
    11351135     *
    11361136     * @param string $ajax_querystring Current query string.
     
    11561156     * Filters the name of the current component.
    11571157     *
    1158      * @since BuddyPress (1.0.0)
     1158     * @since 1.0.0
    11591159     *
    11601160     * @param string|bool $current_component Current component if available or false.
     
    11771177     * Filters the name of the current action.
    11781178     *
    1179      * @since BuddyPress (1.0.0)
     1179     * @since 1.0.0
    11801180     *
    11811181     * @param string $current_action Current action.
     
    11981198     * Filters the name of the current item.
    11991199     *
    1200      * @since BuddyPress (1.1.0)
     1200     * @since 1.1.0
    12011201     *
    12021202     * @param string|bool $current_item Current item if available or false.
     
    12201220     * Filters the value of $bp->action_variables.
    12211221     *
    1222      * @since BuddyPress (1.0.0)
     1222     * @since 1.0.0
    12231223     *
    12241224     * @param array|bool $action_variables Available action variables.
     
    12301230 * Return the value of a given action variable.
    12311231 *
    1232  * @since BuddyPress (1.5.0)
     1232 * @since 1.5.0
    12331233 *
    12341234 * @param int $position The key of the action_variables array that you want.
     
    12461246     * Filters the value of a given action variable.
    12471247     *
    1248      * @since BuddyPress (1.5.0)
     1248     * @since 1.5.0
    12491249     *
    12501250     * @param string|bool $action_variable Requested action variable based on position.
     
    12781278         * Filters the "root domain", the URL of the BP root blog.
    12791279         *
    1280          * @since BuddyPress (1.2.4)
     1280         * @since 1.2.4
    12811281         *
    12821282         * @param string $domain URL of the BP root blog.
     
    12881288 * Output the root slug for a given component.
    12891289 *
    1290  * @since BuddyPress (1.5.0)
     1290 * @since 1.5.0
    12911291 *
    12921292 * @param string $component The component name.
     
    13201320     * from $bp->groups->root_slug.
    13211321     *
    1322      * @since BuddyPress (1.5.0)
     1322     * @since 1.5.0
    13231323     *
    13241324     * @param string $component Optional. Defaults to the current component.
     
    13581358         * Filters the root slug for given component.
    13591359         *
    1360          * @since BuddyPress (1.5.0)
     1360         * @since 1.5.0
    13611361         *
    13621362         * @param string $root_slug Root slug for given component.
     
    13691369 * Return the component name based on a root slug.
    13701370 *
    1371  * @since BuddyPress (1.5.0)
     1371 * @since 1.5.0
    13721372 *
    13731373 * @param string $root_slug Needle to our active component haystack.
     
    14041404     * Filters whether or not a user has access.
    14051405     *
    1406      * @since BuddyPress (1.2.4)
     1406     * @since 1.2.4
    14071407     *
    14081408     * @param bool $has_access Whether or not user has access.
     
    14141414 * Output the search slug.
    14151415 *
    1416  * @since BuddyPress (1.5.0)
     1416 * @since 1.5.0
    14171417 *
    14181418 * @uses bp_get_search_slug()
     
    14241424     * Return the search slug.
    14251425     *
    1426      * @since BuddyPress (1.5.0)
     1426     * @since 1.5.0
    14271427     *
    14281428     * @return string The search slug. Default: 'search'.
     
    14331433         * Filters the search slug.
    14341434         *
    1435          * @since BuddyPress (1.5.0)
     1435         * @since 1.5.0
    14361436         *
    14371437         * @const string BP_SEARCH_SLUG The search slug. Default "search".
     
    14561456     * Filters the ID of the currently displayed user.
    14571457     *
    1458      * @since BuddyPress (1.0.0)
     1458     * @since 1.0.0
    14591459     *
    14601460     * @param int $id ID of the currently displayed user.
     
    14791479     * Filters the ID of the currently logged-in user.
    14801480     *
    1481      * @since BuddyPress (1.0.0)
     1481     * @since 1.0.0
    14821482     *
    14831483     * @param int $id ID of the currently logged-in user.
     
    14971497 * - the component's id, or 'canonical' name.
    14981498 *
    1499  * @since BuddyPress (1.5.0)
     1499 * @since 1.5.0
    15001500 *
    15011501 * @param string $component Name of the component being checked.
     
    15661566     * Filters whether the current page belongs to the specified component.
    15671567     *
    1568      * @since BuddyPress (1.5.0)
     1568     * @since 1.5.0
    15691569     *
    15701570     * @param bool   $is_current_component Whether or not the current page belongs to specified component.
     
    15861586 * the current_action is 'members'.
    15871587 *
    1588  * @since BuddyPress (1.5.0)
     1588 * @since 1.5.0
    15891589 *
    15901590 * @param string $action The action being tested against.
     
    16081608 * $action_variables[0] is 'group-settings'.
    16091609 *
    1610  * @since BuddyPress (1.5.0)
     1610 * @since 1.5.0
    16111611 *
    16121612 * @param string   $action_variable The action_variable being tested against.
     
    16371637     * Filters whether the current page matches a given action_variable.
    16381638     *
    1639      * @since BuddyPress (1.5.0)
     1639     * @since 1.5.0
    16401640     *
    16411641     * @param bool   $is_action_variable Whether the current page matches a given action_variable.
     
    16591659     * Filters whether or not an item is the current item.
    16601660     *
    1661      * @since BuddyPress (2.1.0)
     1661     * @since 2.1.0
    16621662     *
    16631663     * @param bool   $retval Whether or not an item is the current item.
     
    16831683     * Filters whether or not an item is the a single item. (group, user, etc)
    16841684     *
    1685      * @since BuddyPress (2.1.0)
     1685     * @since 2.1.0
    16861686     *
    16871687     * @param bool $retval Whether or not an item is a single item.
     
    17071707     * Filters whether or not the logged-in user is an admin for the current item.
    17081708     *
    1709      * @since BuddyPress (2.1.0)
     1709     * @since 2.1.0
    17101710     *
    17111711     * @param bool $retval Whether or not the logged-in user is an admin.
     
    17311731     * Filters whether or not the logged-in user is a mod for the current item.
    17321732     *
    1733      * @since BuddyPress (2.1.0)
     1733     * @since 2.1.0
    17341734     *
    17351735     * @param bool $retval Whether or not the logged-in user is a mod.
     
    17541754     * Filters whether or not user is on a component directory page.
    17551755     *
    1756      * @since BuddyPress (2.1.0)
     1756     * @since 2.1.0
    17571757     *
    17581758     * @param bool $retval Whether or not user is on a component directory page.
     
    17961796     * Filters whether or not a component's URL should be in the root, not under a member page.
    17971797     *
    1798      * @since BuddyPress (2.1.0)
     1798     * @since 2.1.0
    17991799     *
    18001800     * @param bool $retval Whether or not URL should be in the root.
     
    18081808 * Corresponds to the setting in wp-admin's Settings > Reading screen.
    18091809 *
    1810  * @since BuddyPress (1.5.0)
     1810 * @since 1.5.0
    18111811 *
    18121812 * @global int $current_blog WordPress global for the current blog.
     
    18441844     * Filters whether or not the specified BuddyPress component directory is set to be the front page.
    18451845     *
    1846      * @since BuddyPress (1.5.0)
     1846     * @since 1.5.0
    18471847     *
    18481848     * @param bool   $value     Whether or not the specified component directory is set as front page.
     
    18741874     * Filters whether or not current page is a blog page or not.
    18751875     *
    1876      * @since BuddyPress (1.5.0)
     1876     * @since 1.5.0
    18771877     *
    18781878     * @param bool $is_blog_page Whether or not current page is a blog page.
     
    18911891 * is unset. Thus the addition of the bp_is_user() check.
    18921892 *
    1893  * @since BuddyPress (1.7.0)
     1893 * @since 1.7.0
    18941894 *
    18951895 * @return bool True if it's a BuddyPress page, false otherwise.
     
    19011901     * Filters whether or not this is a BuddyPress component.
    19021902     *
    1903      * @since BuddyPress (1.7.0)
     1903     * @since 1.7.0
    19041904     *
    19051905     * @param bool $retval Whether or not this is a BuddyPress component.
     
    19131913 * Check whether a given component (or feature of a component) is active.
    19141914 *
    1915  * @since BuddyPress (1.2.0) See r2539.
    1916  * @since BuddyPress (2.3.0) Added $feature as a parameter.
     1915 * @since 1.2.0 See r2539.
     1916 * @since 2.3.0 Added $feature as a parameter.
    19171917 *
    19181918 * @param string $component The component name.
     
    19451945             * that you are checking of active status of.
    19461946             *
    1947              * @since BuddyPress (2.3.0)
     1947             * @since 2.3.0
    19481948             *
    19491949             * @param bool $retval
     
    19561956     * Filters whether or not a given component has been activated by the admin.
    19571957     *
    1958      * @since BuddyPress (2.1.0)
     1958     * @since 2.1.0
    19591959     *
    19601960     * @param bool   $retval    Whether or not a given component has been activated by the admin.
     
    20392039 * Check whether the current page is part of the Notifications component.
    20402040 *
    2041  * @since BuddyPress (1.9.0)
     2041 * @since 1.9.0
    20422042 *
    20432043 * @return bool True if the current page is part of the Notifications component.
     
    20862086 * Is the current page the activity directory?
    20872087 *
    2088  * @since BuddyPress (2.0.0)
     2088 * @since 2.0.0
    20892089 *
    20902090 * @return True if the current page is the activity directory.
     
    21122112 * Is the current page the members directory?
    21132113 *
    2114  * @since BuddyPress (2.0.0)
     2114 * @since 2.0.0
    21152115 *
    21162116 * @return True if the current page is the members directory.
     
    21422142     * Filters whether or not current page is part of the profile for the logged-in user.
    21432143     *
    2144      * @since BuddyPress (1.2.4)
     2144     * @since 1.2.4
    21452145     *
    21462146     * @param bool $my_profile Whether or not current page is part of the profile for the logged-in user.
     
    22722272 * Eg http://example.com/members/joe/forums/topics/.
    22732273 *
    2274  * @since BuddyPress (1.5.0)
     2274 * @since 1.5.0
    22752275 *
    22762276 * @return bool True if the current page is a user's Topics Started page.
     
    22852285 * Eg http://example.com/members/joe/forums/replies/.
    22862286 *
    2287  * @since BuddyPress (1.5.0)
     2287 * @since 1.5.0
    22882288 *
    22892289 * @return bool True if the current page is a user's Replied To forums page.
     
    23642364 * Eg http://example.com/members/joe/notifications/ (or a subpage thereof).
    23652365 *
    2366  * @since BuddyPress (1.9.0)
     2366 * @since 1.9.0
    23672367 *
    23682368 * @return bool True if the current page is a user's Notifications page.
     
    23882388 * Eg http://example.com/members/joe/settings/general/.
    23892389 *
    2390  * @since BuddyPress (1.5.0)
     2390 * @since 1.5.0
    23912391 *
    23922392 * @return bool True if the current page is a user's General Settings page.
     
    24012401 * Eg http://example.com/members/joe/settings/notifications/.
    24022402 *
    2403  * @since BuddyPress (1.5.0)
     2403 * @since 1.5.0
    24042404 *
    24052405 * @return bool True if the current page is a user's Notification Settings page.
     
    24142414 * Eg http://example.com/members/joe/settings/delete-account/.
    24152415 *
    2416  * @since BuddyPress (1.5.0)
     2416 * @since 1.5.0
    24172417 *
    24182418 * @return bool True if the current page is a user's Delete Account page.
     
    24272427 * Eg http://example.com/members/joe/settings/profile/.
    24282428 *
    2429  * @since BuddyPress (2.0.0)
     2429 * @since 2.0.0
    24302430 *
    24312431 * @return bool True if the current page is a user's Profile Settings page.
     
    24402440 * Is the current page the groups directory ?
    24412441 *
    2442  * @since BuddyPress (2.0.0)
     2442 * @since 2.0.0
    24432443 *
    24442444 * @return True if the current page is the groups directory.
     
    26292629 * Is the current page the blogs directory ?
    26302630 *
    2631  * @since BuddyPress (2.0.0)
     2631 * @since 2.0.0
    26322632 *
    26332633 * @return True if the current page is the blogs directory.
     
    29772977         * Filters the BuddyPress classes to be added to body_class()
    29782978         *
    2979          * @since BuddyPress (1.1.0)
     2979         * @since 1.1.0
    29802980         *
    29812981         * @param array $classes        Array of body classes to add.
     
    29932993 * Hooked to the 'post_class' filter.
    29942994 *
    2995  * @since BuddyPress (2.1.0)
     2995 * @since 2.1.0
    29962996 *
    29972997 * @param array $wp_classes The post classes coming from WordPress.
     
    30573057 *
    30583058 * @access private
    3059  * @since BuddyPress (1.7.0)
     3059 * @since 1.7.0
    30603060 *
    30613061 * @param array $a First item.
     
    30793079 * Get the items registered in the primary and secondary BuddyPress navigation menus.
    30803080 *
    3081  * @since BuddyPress (1.7.0)
     3081 * @since 1.7.0
    30823082 *
    30833083 * @return array A multidimensional array of all navigation items.
     
    31583158     * Filters the items registered in the primary and secondary BuddyPress navigation menus.
    31593159     *
    3160      * @since BuddyPress (1.7.0)
     3160     * @since 1.7.0
    31613161     *
    31623162     * @param array $menus Array of items registered in the primary and secondary BuddyPress navigation.
     
    31683168 * Display a navigation menu.
    31693169 *
    3170  * @since BuddyPress (1.7.0)
     3170 * @since 1.7.0
    31713171 *
    31723172 * @param string|array $args {
     
    32273227     * Filters the parsed bp_nav_menu arguments.
    32283228     *
    3229      * @since BuddyPress (1.7.0)
     3229     * @since 1.7.0
    32303230     *
    32313231     * @param array $args Array of parsed arguments.
     
    32523252         * Filters the allowed tags for the wp_nav_menu_container.
    32533253         *
    3254          * @since BuddyPress (1.7.0)
     3254         * @since 1.7.0
    32553255         *
    32563256         * @param array $value Array of allowed tags. Default 'div' and 'nav'.
     
    32703270     * Filters the BuddyPress menu objects.
    32713271     *
    3272      * @since BuddyPress (1.7.0)
     3272     * @since 1.7.0
    32733273     *
    32743274     * @param array $value Array of nav menu objects.
     
    33023302     * Allow plugins to hook into the menu to add their own <li>'s
    33033303     *
    3304      * @since BuddyPress (1.7.0)
     3304     * @since 1.7.0
    33053305     *
    33063306     * @param array $items Array of nav menu items.
     
    33223322     * Filters the final BuddyPress menu output.
    33233323     *
    3324      * @since BuddyPress (1.7.0)
     3324     * @since 1.7.0
    33253325     *
    33263326     * @param string $nav_menu Final nav menu output.
Note: See TracChangeset for help on using the changeset viewer.