Skip to:
Content

BuddyPress.org


Ignore:
Timestamp:
04/15/2016 04:59:34 AM (10 years ago)
Author:
tw2113
Message:

Plenty of @since tag updates for the Members component.

See #6402.

File:
1 edited

Legend:

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

    r10690 r10711  
    293293 * global, enabling the use of BuddyPress templates and template functions to
    294294 * display a list of members.
     295 *
     296 * @since 1.2.0
    295297 *
    296298 * @global object $members_template {@link BP_Members_Template}
     
    439441 * Set up the current member inside the loop.
    440442 *
     443 * @since 1.2.0
     444 *
    441445 * @return object
    442446 */
     
    449453 * Check whether there are more members to iterate over.
    450454 *
     455 * @since 1.2.0
     456 *
    451457 * @return bool
    452458 */
     
    458464/**
    459465 * Output the members pagination count.
     466 *
     467 * @since 1.2.0
    460468 */
    461469function bp_members_pagination_count() {
     
    464472        /**
    465473         * Generate the members pagination count.
     474         *
     475         * @since 1.5.0
    466476         *
    467477         * @return string
     
    516526/**
    517527 * Output the members pagination links.
     528 *
     529 * @since 1.2.0
    518530 */
    519531function bp_members_pagination_links() {
     
    523535         * Fetch the members pagination links.
    524536         *
     537         * @since 1.2.0
     538         *
    525539         * @return string
    526540         */
     
    541555 * Output the ID of the current member in the loop.
    542556 *
     557 * @since 1.2.0
     558 *
    543559 * @uses bp_get_member_user_id()
    544560 */
     
    548564        /**
    549565         * Get the ID of the current member in the loop.
     566         *
     567         * @since 1.2.0
    550568         *
    551569         * @return string Member ID.
     
    581599         *
    582600         * @param array $classes Array of custom classes.
    583          *
    584601         * @return string Row class of the member
    585602         */
     
    592609                        $classes[]   = ( $pos_in_loop % 2 ) ? 'even' : 'odd';
    593610
    594                 // If we've only one member in the loop, don't bother with odd and even.
     611                        // If we've only one member in the loop, don't bother with odd and even.
    595612                } else {
    596613                        $classes[] = 'bp-single-member';
     
    639656/**
    640657 * Output nicename of current member in the loop.
     658 *
     659 * @since 1.2.5
    641660 */
    642661function bp_member_user_nicename() {
     
    646665         * Get the nicename of the current member in the loop.
    647666         *
     667         * @since 1.2.5
     668         *
    648669         * @return string Members nicename.
    649670         */
     
    663684/**
    664685 * Output login for current member in the loop.
     686 *
     687 * @since 1.2.5
    665688 */
    666689function bp_member_user_login() {
     
    670693         * Get the login of the current member in the loop.
    671694         *
     695         * @since 1.2.5
     696         *
    672697         * @return string Member's login.
    673698         */
     
    687712/**
    688713 * Output the email address for the current member in the loop.
     714 *
     715 * @since 1.2.5
    689716 */
    690717function bp_member_user_email() {
     
    694721         * Get the email address of the current member in the loop.
    695722         *
     723         * @since 1.2.5
     724         *
    696725         * @return string Member's email address.
    697726         */
     
    712741 * Check whether the current member in the loop is the logged-in user.
    713742 *
     743 * @since 1.2.5
     744 *
    714745 * @return bool
    715746 */
     
    730761 * Output a member's avatar.
    731762 *
     763 * @since 1.2.0
     764 *
    732765 * @see bp_get_member_avatar() for description of arguments.
    733766 *
     
    747780        /**
    748781         * Get a member's avatar.
     782         *
     783         * @since 1.2.0
    749784         *
    750785         * @see bp_core_fetch_avatar() For a description of arguments and
     
    794829/**
    795830 * Output the permalink for the current member in the loop.
     831 *
     832 * @since 1.2.0
    796833 */
    797834function bp_member_permalink() {
     
    801838         * Get the permalink for the current member in the loop.
    802839         *
     840         * @since 1.2.0
     841         *
    803842         * @return string
    804843         */
     
    818857        /**
    819858         * Alias of {@link bp_member_permalink()}.
     859         *
     860         * @since 1.2.0
    820861         */
    821862        function bp_member_link() { echo bp_get_member_permalink(); }
     
    823864        /**
    824865         * Alias of {@link bp_get_member_permalink()}.
     866         *
     867         * @since 1.2.0
    825868         */
    826869        function bp_get_member_link() { return bp_get_member_permalink(); }
     
    828871/**
    829872 * Output display name of current member in the loop.
     873 *
     874 * @since 1.2.0
    830875 */
    831876function bp_member_name() {
     
    847892         * WP users table, in the following order of preference: display_name,
    848893         * user_nicename, user_login.
     894         *
     895         * @since 1.2.0
    849896         *
    850897         * @return string The user's fullname for display.
     
    888935 * Output the current member's last active time.
    889936 *
     937 * @since 1.2.0
     938 *
    890939 * @param array $args See {@link bp_get_member_last_active()}.
    891940 */
     
    895944        /**
    896945         * Return the current member's last active time.
     946         *
     947         * @since 1.2.0
    897948         *
    898949         * @param array $args {
     
    926977                                : bp_core_time_since( $members_template->member->last_activity );
    927978
    928                 // Member has never logged in or been active.
     979                        // Member has never logged in or been active.
    929980                } else {
    930981                        $last_activity = __( 'Never active', 'buddypress' );
     
    945996 * Output the latest update of the current member in the loop.
    946997 *
     998 * @since 1.2.0
     999 *
    9471000 * @param array|string $args Array of arguments for latest update.
    9481001 */
     
    9521005        /**
    9531006         * Get the latest update from the current member in the loop.
     1007         *
     1008         * @since 1.2.0
    9541009         *
    9551010         * @param array|string $args {
     
    10071062 * Output a piece of user profile data.
    10081063 *
     1064 * @since 1.2.0
     1065 *
    10091066 * @see bp_get_member_profile_data() for a description of params.
    10101067 *
     
    10201077         * to fetch profile data cached in the template global. It is also safe
    10211078         * to use outside of the loop.
     1079         *
     1080         * @since 1.2.0
    10221081         *
    10231082         * @param array|string $args {
     
    10881147/**
    10891148 * Output the 'registered [x days ago]' string for the current member.
     1149 *
     1150 * @since 1.2.0
    10901151 */
    10911152function bp_member_registered() {
     
    10951156         * Get the 'registered [x days ago]' string for the current member.
    10961157         *
     1158         * @since 1.2.0
     1159         *
    10971160         * @return string
    10981161         */
     
    11141177/**
    11151178 * Output a random piece of profile data for the current member in the loop.
     1179 *
     1180 * @since 1.2.0
    11161181 */
    11171182function bp_member_random_profile_data() {
     
    11271192/**
    11281193 * Output hidden input for preserving member search params on form submit.
     1194 *
     1195 * @since 1.2.0
    11291196 */
    11301197function bp_member_hidden_fields() {
     
    11461213/**
    11471214 * Output the Members directory search form.
     1215 *
     1216 * @since 1.0.0
    11481217 */
    11491218function bp_directory_members_search_form() {
     
    11741243/**
    11751244 * Output the total member count.
     1245 *
     1246 * @since 1.2.0
    11761247 */
    11771248function bp_total_site_member_count() {
     
    11811252         * Get the total site member count.
    11821253         *
     1254         * @since 1.2.0
     1255         *
    11831256         * @return int
    11841257         */
     
    12081281 * The function will also analyze the current component the user is in, to
    12091282 * determine whether or not to highlight a particular nav item.
     1283 *
     1284 * @since 1.1.0
    12101285 *
    12111286 * @todo Move to a back-compat file?
     
    12531328/**
    12541329 * Render the navigation markup for the displayed user.
     1330 *
     1331 * @since 1.1.0
    12551332 */
    12561333function bp_get_displayed_user_nav() {
     
    13061383 * Output the logged-in user's avatar.
    13071384 *
     1385 * @since 1.1.0
     1386 *
    13081387 * @see bp_get_loggedin_user_avatar() for a description of params.
    13091388 *
     
    13151394        /**
    13161395         * Get the logged-in user's avatar.
     1396         *
     1397         * @since 1.1.0
    13171398         *
    13181399         * @see bp_core_fetch_avatar() For a description of arguments and
     
    13551436 * Output the displayed user's avatar.
    13561437 *
     1438 * @since 1.1.0
     1439 *
    13571440 * @see bp_get_displayed_user_avatar() for a description of params.
    13581441 *
     
    13641447        /**
    13651448         * Get the displayed user's avatar.
     1449         *
     1450         * @since 1.1.0
    13661451         *
    13671452         * @see bp_core_fetch_avatar() For a description of arguments and
     
    14031488/**
    14041489 * Output the email address of the displayed user.
     1490 *
     1491 * @since 1.5.0
    14051492 */
    14061493function bp_displayed_user_email() {
     
    14091496        /**
    14101497         * Get the email address of the displayed user.
     1498         *
     1499         * @since 1.5.0
    14111500         *
    14121501         * @return string
     
    14341523 * Output the "active [x days ago]" string for a user.
    14351524 *
     1525 * @since 1.0.0
     1526 *
    14361527 * @see bp_get_last_activity() for a description of parameters.
    14371528 *
     
    14511542        /**
    14521543         * Get the "active [x days ago]" string for a user.
     1544         *
     1545         * @since 1.5.0
    14531546         *
    14541547         * @param int $user_id ID of the user. Default: displayed user ID.
     
    14741567/**
    14751568 * Output the calculated first name of the displayed or logged-in user.
     1569 *
     1570 * @since 1.2.0
    14761571 */
    14771572function bp_user_firstname() {
     
    14821577         *
    14831578         * Simply takes all the characters before the first space in a name.
     1579         *
     1580         * @since 1.2.0
    14841581         *
    14851582         * @param string|bool $name Full name to use when generating first name.
     
    15131610/**
    15141611 * Output the link for the logged-in user's profile.
     1612 *
     1613 * @since 1.2.4
    15151614 */
    15161615function bp_loggedin_user_link() {
     
    15201619         * Get the link for the logged-in user's profile.
    15211620         *
     1621         * @since 1.0.0
     1622         *
    15221623         * @return string
    15231624         */
     
    15361637/**
    15371638 * Output the link for the displayed user's profile.
     1639 *
     1640 * @since 1.2.4
    15381641 */
    15391642function bp_displayed_user_link() {
     
    15431646         * Get the link for the displayed user's profile.
    15441647         *
     1648         * @since 1.0.0
     1649         *
    15451650         * @return string
    15461651         */
     
    15661671/**
    15671672 * Alias of {@link bp_displayed_user_id()}.
     1673 *
     1674 * @since 1.0.0
    15681675 */
    15691676function bp_current_user_id() { return bp_displayed_user_id(); }
     
    15711678/**
    15721679 * Generate the link for the displayed user's profile.
     1680 *
     1681 * @since 1.0.0
    15731682 *
    15741683 * @return string
     
    15901699 * Generate the link for the logged-in user's profile.
    15911700 *
     1701 * @since 1.0.0
     1702 *
    15921703 * @return string
    15931704 */
     
    16071718/**
    16081719 * Output the displayed user's display name.
     1720 *
     1721 * @since 1.0.0
    16091722 */
    16101723function bp_displayed_user_fullname() {
     
    16141727         * Get the displayed user's display name.
    16151728         *
     1729         * @since 1.2.0
     1730         *
    16161731         * @return string
    16171732         */
     
    16311746        /**
    16321747         * Alias of {@link bp_get_displayed_user_fullname()}.
     1748         *
     1749         * @since 1.0.0
    16331750         */
    16341751        function bp_user_fullname() { echo bp_get_displayed_user_fullname(); }
     
    16371754/**
    16381755 * Output the logged-in user's display name.
     1756 *
     1757 * @since 1.0.0
    16391758 */
    16401759function bp_loggedin_user_fullname() {
     
    16441763         * Get the logged-in user's display name.
    16451764         *
     1765         * @since 1.0.0
     1766         *
    16461767         * @return string
    16471768         */
     
    16611782/**
    16621783 * Output the username of the displayed user.
     1784 *
     1785 * @since 1.2.0
    16631786 */
    16641787function bp_displayed_user_username() {
     
    16671790        /**
    16681791         * Get the username of the displayed user.
     1792         *
     1793         * @since 1.2.0
    16691794         *
    16701795         * @return string
     
    16911816/**
    16921817 * Output the username of the logged-in user.
     1818 *
     1819 * @since 1.2.0
    16931820 */
    16941821function bp_loggedin_user_username() {
     
    16971824        /**
    16981825         * Get the username of the logged-in user.
     1826         *
     1827         * @since 1.2.0
    16991828         *
    17001829         * @return string
     
    17381867                $message = sprintf( __( 'Viewing members of the type: %s', 'buddypress' ), '<strong>' . $type_object->labels['singular_name'] . '</strong>' );
    17391868
     1869                /**
     1870                 * Filters the current member type message.
     1871                 *
     1872                 * @since 2.3.0
     1873                 *
     1874                 * @param string $message Message to filter.
     1875                 */
    17401876                return apply_filters( 'bp_get_current_member_type_message', $message );
    17411877        }
     
    17641900/**
    17651901 * Output the URL to the signup page.
     1902 *
     1903 * @since 1.0.0
    17661904 */
    17671905function bp_signup_page() {
     
    17701908        /**
    17711909         * Get the URL to the signup page.
     1910         *
     1911         * @since 1.1.0
    17721912         *
    17731913         * @return string
     
    17971937 * @uses bp_get_activate_slug() To make sure there is a slug assigned to the page.
    17981938 * @uses bp_locate_template() To make sure a template exists to provide output.
     1939 *
    17991940 * @return boolean True if page and template exist, false if not.
    18001941 */
     
    18101951/**
    18111952 * Output the URL of the activation page.
     1953 *
     1954 * @since 1.0.0
    18121955 */
    18131956function bp_activation_page() {
     
    18161959        /**
    18171960         * Get the URL of the activation page.
     1961         *
     1962         * @since 1.2.0
    18181963         *
    18191964         * @return string
     
    18381983/**
    18391984 * Output the username submitted during signup.
     1985 *
     1986 * @since 1.1.0
    18401987 */
    18411988function bp_signup_username_value() {
     
    18441991        /**
    18451992         * Get the username submitted during signup.
     1993         *
     1994         * @since 1.1.0
    18461995         *
    18471996         * @todo This should be properly escaped.
     
    18662015/**
    18672016 * Output the user email address submitted during signup.
     2017 *
     2018 * @since 1.1.0
    18682019 */
    18692020function bp_signup_email_value() {
     
    18722023        /**
    18732024         * Get the email address submitted during signup.
     2025         *
     2026         * @since 1.1.0
    18742027         *
    18752028         * @todo This should be properly escaped.
     
    18942047/**
    18952048 * Output the 'signup_with_blog' value submitted during signup.
     2049 *
     2050 * @since 1.1.0
    18962051 */
    18972052function bp_signup_with_blog_value() {
     
    19002055        /**
    19012056         * Get the 'signup_with_blog' value submitted during signup.
     2057         *
     2058         * @since 1.1.0
    19022059         *
    19032060         * @return string
     
    19202077/**
    19212078 * Output the 'signup_blog_url' value submitted at signup.
     2079 *
     2080 * @since 1.1.0
    19222081 */
    19232082function bp_signup_blog_url_value() {
     
    19262085        /**
    19272086         * Get the 'signup_blog_url' value submitted at signup.
     2087         *
     2088         * @since 1.1.0
    19282089         *
    19292090         * @todo Should be properly escaped.
     
    19822143/**
    19832144 * Output the 'signup_blog_titl' value submitted at signup.
     2145 *
     2146 * @since 1.1.0
    19842147 */
    19852148function bp_signup_blog_title_value() {
     
    19882151        /**
    19892152         * Get the 'signup_blog_title' value submitted at signup.
     2153         *
     2154         * @since 1.1.0
    19902155         *
    19912156         * @todo Should be properly escaped.
     
    20102175/**
    20112176 * Output the 'signup_blog_privacy' value submitted at signup.
     2177 *
     2178 * @since 1.1.0
    20122179 */
    20132180function bp_signup_blog_privacy_value() {
     
    20162183        /**
    20172184         * Get the 'signup_blog_privacy' value submitted at signup.
     2185         *
     2186         * @since 1.1.0
    20182187         *
    20192188         * @todo Should be properly escaped.
     
    20382207/**
    20392208 * Output the avatar dir used during signup.
     2209 *
     2210 * @since 1.1.0
    20402211 */
    20412212function bp_signup_avatar_dir_value() {
     
    20442215        /**
    20452216         * Get the avatar dir used during signup.
     2217         *
     2218         * @since 1.1.0
    20462219         *
    20472220         * @return string
     
    20742247/**
    20752248 * Output the current signup step.
     2249 *
     2250 * @since 1.1.0
    20762251 */
    20772252function bp_current_signup_step() {
     
    20812256         * Get the current signup step.
    20822257         *
     2258         * @since 1.1.0
     2259         *
    20832260         * @return string
    20842261         */
     
    20902267 * Output the user avatar during signup.
    20912268 *
     2269 * @since 1.1.0
     2270 *
    20922271 * @see bp_get_signup_avatar() for description of arguments.
    20932272 *
     
    20992278        /**
    21002279         * Get the user avatar during signup.
     2280         *
     2281         * @since 1.1.0
    21012282         *
    21022283         * @see bp_core_fetch_avatar() for description of arguments.
     
    21362317                        ) );
    21372318
    2138                 // No avatar DIR was found.
     2319                        // No avatar DIR was found.
    21392320                } else {
    21402321
     
    21732354 * Output whether signup is allowed.
    21742355 *
     2356 * @since 1.1.0
     2357 *
    21752358 * @todo Remove this function. Echoing a bool is pointless.
    21762359 */
     
    21802363        /**
    21812364         * Is user signup allowed?
     2365         *
     2366         * @since 1.1.0
    21822367         *
    21832368         * @return bool
     
    22292414 * Output a link to a members component subpage.
    22302415 *
     2416 * @since 1.5.0
     2417 *
    22312418 * @see bp_get_members_component_link() for description of parameters.
    22322419 *
     
    22412428        /**
    22422429         * Generate a link to a members component subpage.
     2430         *
     2431         * @since 1.5.0
    22432432         *
    22442433         * @param string       $component  ID of the component (eg 'friends').
Note: See TracChangeset for help on using the changeset viewer.