Skip to:
Content

BuddyPress.org


Ignore:
Timestamp:
02/13/2016 07:32:53 PM (9 years ago)
Author:
tw2113
Message:

Addes missing @since tags to many functions, methods, and properties in the BP Friends component.

See #6400.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/bp-friends/bp-friends-functions.php

    r10417 r10587  
    1818/**
    1919 * Create a new friendship.
     20 *
     21 * @since 1.0.0
    2022 *
    2123 * @param int  $initiator_userid ID of the "initiator" user (the user who is
     
    9193 * Will also delete the related "friendship_accepted" activity item.
    9294 *
     95 * @since 1.0.0
     96 *
    9397 * @param int $initiator_userid ID of the friendship initiator.
    9498 * @param int $friend_userid    ID of the friend user.
     
    152156 *
    153157 * Also initiates a "friendship_accepted" activity item.
     158 *
     159 * @since 1.0.0
    154160 *
    155161 * @param int $friendship_id ID of the pending friendship object.
     
    188194 * Mark a friendship request as rejected.
    189195 *
     196 * @since 1.0.0
     197 *
    190198 * @param int $friendship_id ID of the pending friendship object.
    191199 * @return bool True on success, false on failure.
     
    214222 * Withdraw a friendship request.
    215223 *
     224 * @since 1.6.0
     225 *
    216226 * @param int $initiator_userid ID of the friendship initiator - this is the
    217227 *                              user who requested the friendship, and is doing the withdrawing.
     
    247257 * Check whether two users are friends.
    248258 *
     259 * @since 1.0.0
     260 *
    249261 * @param int $user_id            ID of the first user.
    250262 * @param int $possible_friend_id ID of the other user.
     
    263275 *
    264276 * Will return 'is_friends', 'not_friends', 'pending' or 'awaiting_response'.
     277 *
     278 * @since 1.2.0
    265279 *
    266280 * @param int $user_id            ID of the first user.
     
    285299 * Get the friend count of a given user.
    286300 *
     301 * @since 1.2.0
     302 *
    287303 * @param int $user_id ID of the user whose friends are being counted.
    288304 * @return int Friend count of the user.
     
    309325 * Check whether a given user has any friends.
    310326 *
     327 * @since 1.0.0
     328 *
    311329 * @param int $user_id ID of the user whose friends are being checked.
    312330 * @return bool True if the user has friends, otherwise false.
     
    326344/**
    327345 * Get the ID of two users' friendship, if it exists.
     346 *
     347 * @since 1.2.0
    328348 *
    329349 * @param int $initiator_user_id ID of the first user.
     
    337357/**
    338358 * Get the IDs of a given user's friends.
     359 *
     360 * @since 1.0.0
    339361 *
    340362 * @param int  $user_id              ID of the user whose friends are being retrieved.
     
    352374/**
    353375 * Search the friends of a user by a search string.
     376 *
     377 * @since 1.0.0
    354378 *
    355379 * @param string $search_terms The search string, matched against xprofile fields (if
     
    372396 * Get a list of IDs of users who have requested friendship of a given user.
    373397 *
     398 * @since 1.2.0
     399 *
    374400 * @param int $user_id The ID of the user who has received the friendship requests.
    375401 * @return array|bool An array of user IDs, or false if none are found.
     
    381407/**
    382408 * Get a user's most recently active friends.
     409 *
     410 * @since 1.0.0
    383411 *
    384412 * @see BP_Core_User::get_users() for a description of return value.
     
    411439 * Get a user's friends, in alphabetical order.
    412440 *
     441 * @since 1.0.0
     442 *
    413443 * @see BP_Core_User::get_users() for a description of return value.
    414444 *
     
    440470 * Get a user's friends, in the order in which they joined the site.
    441471 *
     472 * @since 1.0.0
     473 *
    442474 * @see BP_Core_User::get_users() for a description of return value.
    443475 *
     
    469501 * Get the last active date of many users at once.
    470502 *
     503 * @since 1.0.0
     504 *
    471505 * @see BP_Friends_Friendship::get_bulk_last_active() for a description of
    472506 *      arguments and return value.
     
    578612 * - users who have been banned from the group
    579613 *
     614 * @since 1.0.0
     615 *
    580616 * @param int $user_id  ID of the user whose friends are being counted.
    581617 * @param int $group_id ID of the group friends are being invited to.
     
    589625 * Get a total friend count for a given user.
    590626 *
     627 * @since 1.0.0
     628 *
    591629 * @param int $user_id Optional. ID of the user whose friendships you are
    592630 *                     counting. Default: displayed user (if any), otherwise logged-in user.
     
    599637/**
    600638 * Return a list of a user's friends, filtered by a search term.
     639 *
     640 * @since 1.0.0
    601641 *
    602642 * @param string $search_terms Search term to filter on.
     
    625665 * Has a friendship been confirmed (accepted)?
    626666 *
     667 * @since 1.0.0
     668 *
    627669 * @param int $friendship_id The ID of the friendship being checked.
    628670 * @return bool True if the friendship is confirmed, otherwise false.
     
    639681 * friendship event (acceptance, deletion), call this function to regenerate
    640682 * the cached values.
     683 *
     684 * @since 1.0.0
    641685 *
    642686 * @param int    $initiator_user_id ID of the first user.
     
    666710 * - Notifications of friendship requests sent by the user.
    667711 *
     712 * @since 1.0.0
     713 *
    668714 * @param int $user_id ID of the user whose friend data is being removed.
    669715 */
     
    701747 *
    702748 * This is intended to speed up @mentions lookups for a majority of use cases.
     749 *
     750 * @since 2.1.0
    703751 *
    704752 * @see bp_activity_mentions_script()
Note: See TracChangeset for help on using the changeset viewer.