Skip to:
Content

BuddyPress.org


Ignore:
Timestamp:
09/27/2015 05:43:55 AM (9 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.