Skip to:
Content

BuddyPress.org


Ignore:
Timestamp:
09/27/2015 05:43:55 AM (11 years ago)
Author:
tw2113
Message:

Standardizing our @since tags for the Members Component.

See #6576.

File:
1 edited

Legend:

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

    r10022 r10149  
    11<?php
    2 
    32/**
    43 * BuddyPress Member Functions.
     
    109 */
    1110
    12 // Exit if accessed directly
     11// Exit if accessed directly.
    1312defined( 'ABSPATH' ) || exit;
    1413
     
    1615 * Check for the existence of a Members directory page.
    1716 *
    18  * @since BuddyPress (1.5.0)
     17 * @since 1.5.0
    1918 *
    2019 * @return bool True if found, otherwise false.
     
    148147         * Filters the results of the user query.
    149148         *
    150          * @since BuddyPress (1.2.0)
     149         * @since 1.2.0
    151150         *
    152151         * @param array $retval Array of users for the current query.
     
    187186         * Filters the domain for the passed user.
    188187         *
    189          * @since BuddyPress (1.0.1)
     188         * @since 1.0.1
    190189         *
    191190         * @param string $domain        Domain for the passed user.
     
    217216         * Filters the userdata for a passed user.
    218217         *
    219          * @since BuddyPress (1.2.0)
     218         * @since 1.2.0
    220219         *
    221220         * @param array $userdata Array of user data for a passed user.
     
    242241 * Return the user ID based on a user's user_login.
    243242 *
    244  * @since BuddyPress (1.0.0)
     243 * @since 1.0.0
    245244 *
    246245 * @param string $username user_login to check.
     
    258257         * Filters the ID of a user, based on user_login.
    259258         *
    260          * @since BuddyPress (1.0.1)
     259         * @since 1.0.1
    261260         *
    262261         * @param int|null $value    ID of the user or null.
     
    269268 * Return the user ID based on a user's user_nicename.
    270269 *
    271  * @since BuddyPress (1.2.3)
     270 * @since 1.2.3
    272271 *
    273272 * @param string $user_nicename user_nicename to check.
     
    285284         * Filters the user ID based on user_nicename.
    286285         *
    287          * @since BuddyPress (1.2.3)
     286         * @since 1.2.3
    288287         *
    289288         * @param int|null $value         ID of the user or null.
     
    368367         * Filters the username based on originally provided user ID.
    369368         *
    370          * @since BuddyPress (1.0.1)
     369         * @since 1.0.1
    371370         *
    372371         * @param string $username Username determined by user ID.
     
    381380 * sanitized and unique slug to a user is needed.
    382381 *
    383  * @since BuddyPress (1.5.0)
     382 * @since 1.5.0
    384383 *
    385384 * @todo Refactor to use a WP core function, if possible.
     
    433432         * Filters the user_nicename based on originally provided user ID.
    434433         *
    435          * @since BuddyPress (1.5.0)
     434         * @since 1.5.0
    436435         *
    437436         * @param string $username User nice name determined by user ID.
     
    468467         * Filters the user email for user based on user ID.
    469468         *
    470          * @since BuddyPress (1.0.1)
     469         * @since 1.0.1
    471470         *
    472471         * @param string $email Email determined for the user.
     
    513512         * Filters the link text for the passed in user.
    514513         *
    515          * @since BuddyPress (1.2.0)
     514         * @since 1.2.0
    516515         *
    517516         * @param string $value   Link text based on passed parameters.
     
    527526 * display_name, and then user_nicename.
    528527 *
    529  * @since BuddyPress (2.0.0)
     528 * @since 2.0.0
    530529 *
    531530 * @param array $user_ids
     
    640639         * Filters the display name for the passed in user.
    641640         *
    642          * @since BuddyPress (1.0.1)
     641         * @since 1.0.1
    643642         *
    644643         * @param string $fullname Display name for the user.
     
    665664         * Filters the user link for the user based on user email address.
    666665         *
    667          * @since BuddyPress (1.0.1)
     666         * @since 1.0.1
    668667         *
    669668         * @param string|bool $value URL for the user if found, otherwise false.
     
    691690         * Filters the user link for the user based on username.
    692691         *
    693          * @since BuddyPress (1.0.1)
     692         * @since 1.0.1
    694693         *
    695694         * @param string|bool $value URL for the user if found, otherwise false.
     
    721720         * Filters the total number of members for the installation.
    722721         *
    723          * @since BuddyPress (1.2.0)
     722         * @since 1.2.0
    724723         *
    725724         * @param int $count Total number of members.
     
    757756         * Filters the total number of members for the installation limited to those with last_activity.
    758757         *
    759          * @since BuddyPress (1.6.0)
     758         * @since 1.6.0
    760759         *
    761760         * @param int $count Total number of active members.
     
    773772 * - bp_core_mark_user_ham_admin()        (from wp-admin)
    774773 *
    775  * @since BuddyPress (1.6.0)
     774 * @since 1.6.0
    776775 *
    777776 * @param int    $user_id       The ID of the user being spammed/hammed.
     
    845844                         * Fires at end of processing spammer in Dashboard if not multisite and user is spam.
    846845                         *
    847                          * @since BuddyPress (1.5.0)
     846                         * @since 1.5.0
    848847                         *
    849848                         * @param int $value user ID.
     
    855854                         * Fires at end of processing spammer in Dashboard if not multisite and user is not spam.
    856855                         *
    857                          * @since BuddyPress (1.5.0)
     856                         * @since 1.5.0
    858857                         *
    859858                         * @param int $value user ID.
     
    874873                 * Fires at the end of the process spammer process if the user is spam.
    875874                 *
    876                  * @since BuddyPress (1.5.0)
     875                 * @since 1.5.0
    877876                 *
    878877                 * @param int $value Displayed user ID.
     
    884883                 * Fires at the end of the process spammer process if the user is not spam.
    885884                 *
    886                  * @since BuddyPress (1.5.0)
     885                 * @since 1.5.0
    887886                 *
    888887                 * @param int $value Displayed user ID.
     
    894893         * Fires at the end of the process for hanlding spammer status.
    895894         *
    896          * @since BuddyPress (1.5.5)
     895         * @since 1.5.5
    897896         *
    898897         * @param int  $user_id ID of the processed user.
     
    910909 * Hook to WP's make_spam_user and run our custom BP spam functions.
    911910 *
    912  * @since BuddyPress (1.6.0)
     911 * @since 1.6.0
    913912 *
    914913 * @param int $user_id The user ID passed from the make_spam_user hook.
     
    922921 * Hook to WP's make_ham_user and run our custom BP spam functions.
    923922 *
    924  * @since BuddyPress (1.6.0)
     923 * @since 1.6.0
    925924 *
    926925 * @param int $user_id The user ID passed from the make_ham_user hook.
     
    989988         * Filters whether a user is marked as a spammer.
    990989         *
    991          * @since BuddyPress (1.6.0)
     990         * @since 1.6.0
    992991         *
    993992         * @param bool $is_spammer Whether or not user is marked as spammer.
     
    10541053         * Filters whether a user is marked as deleted.
    10551054         *
    1056          * @since BuddyPress (1.6.0)
     1055         * @since 1.6.0
    10571056         *
    10581057         * @param bool $is_deleted Whether or not user is marked as deleted.
     
    10641063 * Check whether a user is "active", ie neither deleted nor spammer.
    10651064 *
    1066  * @since BuddyPress (1.6.0)
     1065 * @since 1.6.0
    10671066 *
    10681067 * @uses is_user_logged_in() To check if user is logged in
     
    11041103 * Check whether user is not active.
    11051104 *
    1106  * @since BuddyPress (1.6.0)
     1105 * @since 1.6.0
    11071106 *
    11081107 * @todo No need for the user fallback checks, since they're done in
     
    11361135 * Update a user's last activity.
    11371136 *
    1138  * @since BuddyPress (1.9.0)
     1137 * @since 1.9.0
    11391138 *
    11401139 * @param int    $user_id ID of the user being updated.
     
    11801179 * the data from the proper location.
    11811180 *
    1182  * @since BuddyPress (2.0.0)
     1181 * @since 2.0.0
    11831182 *
    11841183 * @access private For internal use only.
     
    12151214 * the data in the proper location.
    12161215 *
    1217  * @since BuddyPress (2.0.0)
     1216 * @since 2.0.0
    12181217 *
    12191218 * @access private For internal use only.
     
    12511250         * Filters the last activity for a given user.
    12521251         *
    1253          * @since BuddyPress (1.9.0)
     1252         * @since 1.9.0
    12541253         *
    12551254         * @param string $activity Time of last activity, in 'Y-m-d H:i:s' format or
     
    12661265 * be called directly from the BuddyPress Tools panel.
    12671266 *
    1268  * @since BuddyPress (2.0.0)
     1267 * @since 2.0.0
    12691268 */
    12701269function bp_last_activity_migrate() {
     
    13471346         * Fires before the processing of an account deletion.
    13481347         *
    1349          * @since BuddyPress (1.6.0)
     1348         * @since 1.6.0
    13501349         *
    13511350         * @param int $user_id ID of the user account being deleted.
     
    13691368         * Fires after the deletion of an account.
    13701369         *
    1371          * @since BuddyPress (1.6.0)
     1370         * @since 1.6.0
    13721371         *
    13731372         * @param int $user_id ID of the user account that was deleted.
     
    13811380 * Delete a user's avatar when the user is deleted.
    13821381 *
    1383  * @since BuddyPress (1.9.0)
     1382 * @since 1.9.0
    13841383 *
    13851384 * @param int $user_id ID of the user who is about to be deleted.
     
    14201419 * then simply redirect them to the home page and stop them from logging in.
    14211420 *
    1422  * @since BuddyPress (1.1.2)
     1421 * @since 1.1.2
    14231422 *
    14241423 * @param WP_User|WP_Error $user Either the WP_User object or the WP_Error
     
    15561555         * Filters the array of default illegal usernames.
    15571556         *
    1558          * @since BuddyPress (1.2.2)
     1557         * @since 1.2.2
    15591558         *
    15601559         * @param array $value Merged and unique array of illegal usernames.
     
    15711570         * Filters the array of default illegal names.
    15721571         *
    1573          * @since BuddyPress (1.2.5)
     1572         * @since 1.2.5
    15741573         *
    15751574         * @param array $value Merged and unique array of illegal names.
     
    15881587 *   - If there's an email domain whitelest, is the current domain on it?
    15891588 *
    1590  * @since BuddyPress (1.6.2)
     1589 * @since 1.6.2
    15911590 *
    15921591 * @param string $user_email The email being checked.
     
    16381637 * parses, adding the appropriate error messages to the WP_Error object.
    16391638 *
    1640  * @since BuddyPress (1.7.0)
     1639 * @since 1.7.0
    16411640 *
    16421641 * @see bp_core_validate_email_address()
     
    16911690                 * Filters the username before being validated.
    16921691                 *
    1693                  * @since BuddyPress (1.5.5)
     1692                 * @since 1.5.5
    16941693                 *
    16951694                 * @param string $user_name Username to validate.
     
    17611760         * Filters the result of the user signup validation.
    17621761         *
    1763          * @since BuddyPress (1.2.2)
     1762         * @since 1.2.2
    17641763         *
    17651764         * @param array $result Results of user validation including errors, if any.
     
    17861785         * Filters the validated blog url and title provided at signup.
    17871786         *
    1788          * @since BuddyPress (1.2.2)
     1787         * @since 1.2.2
    17891788         *
    17901789         * @param array $value Array with the new site data and error messages.
     
    18581857                 * Filters if BuddyPress should send an activation key for a new signup.
    18591858                 *
    1860                  * @since BuddyPress (1.2.3)
     1859                 * @since 1.2.3
    18611860                 *
    18621861                 * @param bool   $value          Whether or not to send the activation key.
     
    18771876         * Fires at the end of the process to sign up a user.
    18781877         *
    1879          * @since BuddyPress (1.2.2)
     1878         * @since 1.2.2
    18801879         *
    18811880         * @param bool|WP_Error   $user_id       True on success, WP_Error on failure.
     
    19141913         * backwards compatibility.
    19151914         *
    1916          * @since BuddyPress (1.2.2)
     1915         * @since 1.2.2
    19171916         *
    19181917         * @param void $value
     
    20242023                         * Fires if the user has already been created.
    20252024                         *
    2026                          * @since BuddyPress (1.2.2)
     2025                         * @since 1.2.2
    20272026                         *
    20282027                         * @param int    $user_id ID of the user being checked.
     
    20682067         * Fires at the end of the user activation process.
    20692068         *
    2070          * @since BuddyPress (1.2.2)
     2069         * @since 1.2.2
    20712070         *
    20722071         * @param int    $user_id ID of the user being checked.
     
    20822081 * Migrate signups from pre-2.0 configuration to wp_signups.
    20832082 *
    2084  * @since BuddyPress (2.0.1)
     2083 * @since 2.0.1
    20852084 */
    20862085function bp_members_migrate_signups() {
     
    22142213         * Filters the avatar storage directory for use during registration.
    22152214         *
    2216          * @since BuddyPress (1.1.1)
     2215         * @since 1.1.1
    22172216         *
    22182217         * @param array $value Array of path and URL values for created storage directory.
     
    22452244         * Filters the user email that the validation email will be sent to.
    22462245         *
    2247          * @since BuddyPress (1.5.0)
     2246         * @since 1.5.0
    22482247         *
    22492248         * @param string $user_email User email the notification is being sent to.
     
    22552254         * Filters the validation email subject that will be sent to user.
    22562255         *
    2257          * @since BuddyPress (1.5.0)
     2256         * @since 1.5.0
    22582257         *
    22592258         * @param string $subject Email validation subject text.
     
    22652264         * Filters the validation email message that will be sent to user.
    22662265         *
    2267          * @since BuddyPress (1.5.0)
     2266         * @since 1.5.0
    22682267         *
    22692268         * @param string $message      Email validation message text.
     
    22782277         * Fires after the sending of activation email to a newly registered user.
    22792278         *
    2280          * @since BuddyPress (1.5.0)
     2279         * @since 1.5.0
    22812280         *
    22822281         * @param string $subject    Subject for the sent email.
     
    22922291 * Display a "resend email" link when an unregistered user attempts to log in.
    22932292 *
    2294  * @since BuddyPress (1.2.2)
     2293 * @since 1.2.2
    22952294 *
    22962295 * @param WP_User|WP_Error $user     Either the WP_User or the WP_Error object.
     
    23532352 * On the login screen, resends the activation email for a user.
    23542353 *
    2355  * @since BuddyPress (2.0.0)
     2354 * @since 2.0.0
    23562355 *
    23572356 * @see bp_core_signup_disable_inactive()
     
    24242423 * This is important as the $bp->loggedin_user object is setup at priority 4.
    24252424 *
    2426  * @since BuddyPress (1.8.0)
     2425 * @since 1.8.0
    24272426 */
    24282427function bp_stop_live_spammer() {
     
    24582457                 * Filters the url used for redirection for a logged in user marked as spam.
    24592458                 *
    2460                  * @since BuddyPress (1.8.0)
     2459                 * @since 1.8.0
    24612460                 *
    24622461                 * @param string $value URL to redirect user to.
     
    24742473 * Show a custom error message when a logged-in user is marked as a spammer.
    24752474 *
    2476  * @since BuddyPress (1.8.0)
     2475 * @since 1.8.0
    24772476 */
    24782477function bp_live_spammer_login_error() {
     
    24912490 * Register a member type.
    24922491 *
    2493  * @since BuddyPress (2.2.0)
     2492 * @since 2.2.0
    24942493 *
    24952494 * @param string $member_type Unique string identifier for the member type.
     
    25312530         * - '_none' is used internally to denote an item that should not apply to any member types.
    25322531         *
    2533          * @since BuddyPress (2.4.0)
     2532         * @since 2.4.0
    25342533         *
    25352534         * @param array $illegal_names Array of illegal names.
     
    25722571         * Fires after a member type is registered.
    25732572         *
    2574          * @since BuddyPress (2.2.0)
     2573         * @since 2.2.0
    25752574         *
    25762575         * @param string $member_type Member type identifier.
     
    25852584 * Retrieve a member type object by name.
    25862585 *
    2587  * @since BuddyPress (2.2.0)
     2586 * @since 2.2.0
    25882587 *
    25892588 * @param string $member_type The name of the member type.
     
    26042603 * Get a list of all registered member type objects.
    26052604 *
    2606  * @since BuddyPress (2.2.0)
     2605 * @since 2.2.0
    26072606 *
    26082607 * @see bp_register_member_type() for accepted arguments.
     
    26292628         * filtering functions have access to the entire member type objects.
    26302629         *
    2631          * @since BuddyPress (2.2.0)
     2630         * @since 2.2.0
    26322631         *
    26332632         * @param array  $types     Member type objects, keyed by name.
     
    26472646 * Set type for a member.
    26482647 *
    2649  * @since BuddyPress (2.2.0)
     2648 * @since 2.2.0
    26502649 *
    26512650 * @param int    $user_id     ID of the user.
     
    26702669                 * Fires just after a user's member type has been changed.
    26712670                 *
    2672                  * @since BuddyPress (2.2.0)
     2671                 * @since 2.2.0
    26732672                 *
    26742673                 * @param int    $user_id     ID of the user whose member type has been updated.
     
    26852684 * Remove type for a member.
    26862685 *
    2687  * @since BuddyPress (2.3.0)
     2686 * @since 2.3.0
    26882687 *
    26892688 * @param int    $user_id     ID of the user.
     
    27072706                 * Fires just after a user's member type has been removed.
    27082707                 *
    2709                  * @since BuddyPress (2.3.0)
     2708                 * @since 2.3.0
    27102709                 *
    27112710                 * @param int    $user_id     ID of the user whose member type has been updated.
     
    27212720 * Get type for a member.
    27222721 *
    2723  * @since BuddyPress (2.2.0)
     2722 * @since 2.2.0
    27242723 *
    27252724 * @param int               $user_id ID of the user.
     
    27542753         * Filters a user's member type(s).
    27552754         *
    2756          * @since BuddyPress (2.2.0)
     2755         * @since 2.2.0
    27572756         *
    27582757         * @param string $type    Member type.
     
    27662765 * Check whether the given user has a certain member type.
    27672766 *
    2768  * @since BuddyPress (2.3.0)
     2767 * @since 2.3.0
    27692768 *
    27702769 * @param int    $user_id     $user_id ID of the user.
     
    27922791 * Delete a user's member type when the user when the user is deleted.
    27932792 *
    2794  * @since BuddyPress (2.2.0)
     2793 * @since 2.2.0
    27952794 *
    27962795 * @param int $user_id ID of the user.
     
    28072806 * Get the "current" member type, if one is provided, in member directories.
    28082807 *
    2809  * @since BuddyPress (2.3.0)
     2808 * @since 2.3.0
    28102809 *
    28112810 * @return string
Note: See TracChangeset for help on using the changeset viewer.