Skip to:
Content

bbPress.org


Ignore:
Timestamp:
06/16/2017 09:20:52 PM (7 years ago)
Author:
johnjamesjacoby
Message:

Documentation: Remove all @uses usages.

Per the WordPress inline documentation standards:

the @uses tag is not recommended to be used to indicate a used-by relationship, as this information can be derived through other means. These tags also are very likely to become out-of-date as our functions change over time.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/includes/common/functions.php

    r6554 r6573  
    4141 * @param string $original_link Original Link to be modified
    4242 * @param bool $force Override bbp_get_view_all() check
    43  * @uses current_user_can() To check if the current user can moderate
    44  * @uses add_query_arg() To add 'view' arg to the url
    45  * @uses apply_filters() Calls 'bbp_add_view_all' with the link and original link
    4643 * @return string The link with 'view=all' appended if necessary
    4744 */
     
    6360 *
    6461 * @param string $original_link Original Link to be modified
    65  * @uses current_user_can() To check if the current user can moderate
    66  * @uses remove_query_arg() To remove 'view' arg from the url
    67  * @uses apply_filters() Calls 'bbp_add_view_all' with the link and original link
    6862 * @return string The link with 'view=all' appended if necessary
    6963 */
     
    8276 * @since 2.0.0 bbPress (r3325)
    8377 *
    84  * @uses current_user_can() To check if the current user can moderate
    85  * @uses apply_filters() Calls 'bbp_get_view_all' with the link and original link
    8678 * @return bool Whether current user can and is viewing all
    8779 */
     
    9890 * @since 2.0.0 bbPress (r2628)
    9991 *
    100  * @uses get_query_var() To get the 'paged' value
    10192 * @return int Current page number
    10293 */
     
    148139 * @param array $data Post data
    149140 * @param array $postarr Original post array (includes post id)
    150  * @uses bbp_get_topic_post_type() To get the topic post type
    151  * @uses bbp_get_reply_post_type() To get the reply post type
    152  * @uses bbp_is_topic_anonymous() To check if the topic is by an anonymous user
    153  * @uses bbp_is_reply_anonymous() To check if the reply is by an anonymous user
    154141 * @return array Data
    155142 */
     
    185172 *
    186173 * @param string $post_date_gmt
    187  *
    188  * @uses bbp_allow_content_edit()() To make sure editing is allowed
    189  * @uses get_option() Get the edit lock time
    190  * @uses current_time() Get the current time
    191  * @uses strtotime() Convert strings to time
    192  * @uses apply_filters() Allow output to be manipulated
    193174 *
    194175 * @return bool True if date is past, False if not
     
    291272 *  - count_tags: Count tags? If set to false, empty tags are also not counted
    292273 *  - count_empty_tags: Count empty tags?
    293  * @uses bbp_get_total_users() To count the number of registered users
    294  * @uses bbp_get_forum_post_type() To get the forum post type
    295  * @uses bbp_get_topic_post_type() To get the topic post type
    296  * @uses bbp_get_reply_post_type() To get the reply post type
    297  * @uses wp_count_posts() To count the number of forums, topics and replies
    298  * @uses wp_count_terms() To count the number of topic tags
    299  * @uses current_user_can() To check if the user is capable of doing things
    300  * @uses bbp_number_format_i18n() To format the number
    301  * @uses apply_filters() Calls 'bbp_get_statistics' with the statistics and args
    302274 * @return object Walked forum tree
    303275 */
     
    517489 *
    518490 * @param array $args Optional. If no args are there, then $_POST values are
    519  *                     used.
    520  * @uses apply_filters() Calls 'bbp_pre_anonymous_post_author_name' with the
    521  *                        anonymous user name
    522  * @uses apply_filters() Calls 'bbp_pre_anonymous_post_author_email' with the
    523  *                        anonymous user email
    524  * @uses apply_filters() Calls 'bbp_pre_anonymous_post_author_website' with the
    525  *                        anonymous user website
    526491 * @return bool|array False on errors, values in an array on success
    527492 */
     
    642607 *
    643608 * @param array $post_data Contains information about the comment
    644  * @uses current_user_can() To check if the current user can throttle
    645  * @uses get_meta_sql() To generate the meta database for checking anonymous email
    646  * @uses apply_filters() Calls 'bbp_check_for_duplicate_query' with the
    647  *                        duplicate check query and post data
    648  * @uses wpdb::get_var() To execute our query and get the var back
    649  * @uses get_post_meta() To get the anonymous user email post meta
    650  * @uses do_action() Calls 'bbp_post_duplicate_trigger' with the post data when
    651  *                    it is found that it is a duplicate
    652609 * @return bool True if it is not a duplicate, false if it is
    653610 */
     
    729686 * @param int $author_id Optional. Supply if it's a post by a logged in user.
    730687 *                        Do not supply if supplying $anonymous_data.
    731  *
    732  * @suse bbp_allow_content_throttle() To make sure flood checking is enabled
    733  * @uses get_option() To get the throttle time
    734  * @uses get_transient() To get the last posted transient of the ip
    735  * @uses bbp_get_user_last_posted() To get the last posted time of the user
    736  * @uses current_user_can() To check if the current user can throttle
    737  *
    738688 * @return bool True if there is no flooding, false if there is
    739689 */
     
    785735 * @param string $title The title of the content
    786736 * @param string $content The content being posted
    787  * @uses bbp_is_user_keymaster() Allow keymasters to bypass blacklist
    788  * @uses bbp_current_author_ip() To get current user IP address
    789  * @uses bbp_current_author_ua() To get current user agent
    790737 * @return bool True if test is passed, false if fail
    791738 */
     
    923870 * @param string $title The title of the content
    924871 * @param string $content The content being posted
    925  * @uses bbp_is_user_keymaster() Allow keymasters to bypass blacklist
    926  * @uses bbp_current_author_ip() To get current user IP address
    927  * @uses bbp_current_author_ua() To get current user agent
    928872 * @return bool True if test is passed, false if fail
    929873 */
     
    10791023 *                              sanitized (see {@link bbp_filter_anonymous_post_data()}
    10801024 * @param int $reply_author ID of the topic author ID
    1081  *
    1082  * @uses bbp_is_subscriptions_active() To check if the subscriptions are active
    1083  * @uses bbp_get_reply_id() To validate the reply ID
    1084  * @uses bbp_get_topic_id() To validate the topic ID
    1085  * @uses bbp_get_forum_id() To validate the forum ID
    1086  * @uses bbp_get_reply() To get the reply
    1087  * @uses bbp_is_reply_published() To make sure the reply is published
    1088  * @uses bbp_get_topic_id() To validate the topic ID
    1089  * @uses bbp_get_topic() To get the reply's topic
    1090  * @uses bbp_is_topic_published() To make sure the topic is published
    1091  * @uses bbp_get_reply_author_display_name() To get the reply author's display name
    1092  * @uses do_action() Calls 'bbp_pre_notify_subscribers' with the reply id,
    1093  *                    topic id and user id
    1094  * @uses bbp_get_topic_subscribers() To get the topic subscribers
    1095  * @uses apply_filters() Calls 'bbp_subscription_mail_message' with the
    1096  *                    message, reply id, topic id and user id
    1097  * @uses apply_filters() Calls 'bbp_subscription_mail_title' with the
    1098  *                    topic title, reply id, topic id and user id
    1099  * @uses apply_filters() Calls 'bbp_subscription_mail_headers'
    1100  * @uses get_userdata() To get the user data
    1101  * @uses wp_mail() To send the mail
    1102  * @uses do_action() Calls 'bbp_post_notify_subscribers' with the reply id,
    1103  *                    topic id and user id
    11041025 * @return bool True on success, false on failure
    11051026 */
     
    12501171 *                              sanitized (see {@link bbp_filter_anonymous_post_data()}
    12511172 * @param int $topic_author ID of the topic author ID
    1252  *
    1253  * @uses bbp_is_subscriptions_active() To check if the subscriptions are active
    1254  * @uses bbp_get_topic_id() To validate the topic ID
    1255  * @uses bbp_get_forum_id() To validate the forum ID
    1256  * @uses bbp_is_topic_published() To make sure the topic is published
    1257  * @uses bbp_get_forum_subscribers() To get the forum subscribers
    1258  * @uses bbp_get_topic_author_display_name() To get the topic author's display name
    1259  * @uses do_action() Calls 'bbp_pre_notify_forum_subscribers' with the topic id,
    1260  *                    forum id and user id
    1261  * @uses apply_filters() Calls 'bbp_forum_subscription_mail_message' with the
    1262  *                    message, topic id, forum id and user id
    1263  * @uses apply_filters() Calls 'bbp_forum_subscription_mail_title' with the
    1264  *                    topic title, topic id, forum id and user id
    1265  * @uses apply_filters() Calls 'bbp_forum_subscription_mail_headers'
    1266  * @uses get_userdata() To get the user data
    1267  * @uses wp_mail() To send the mail
    1268  * @uses do_action() Calls 'bbp_post_notify_forum_subscribers' with the topic,
    1269  *                    id, forum id and user id
    12701173 * @return bool True on success, false on failure
    12711174 */
     
    14251328 * @param string $url URL
    14261329 * @param string $redirect_to Where to redirect to?
    1427  * @uses add_query_arg() To add args to the url
    1428  * @uses apply_filters() Calls 'bbp_logout_url' with the url and redirect to
    14291330 * @return string The url
    14301331 */
     
    15531454 * @param int    $parent_id Parent id.
    15541455 * @param string $post_type Post type. Defaults to 'post'.
    1555  * @uses bbp_get_public_status_id() To get the public status id
    1556  * @uses bbp_get_topic_post_type() To get the topic post type
    1557  * @uses bbp_get_closed_status_id() To get the closed status id
    1558  * @uses WP_Query To get get the posts
    1559  * @uses apply_filters() Calls 'bbp_get_public_child_last_id' with the child
    1560  *                        id, parent id and post type
    15611456 * @return int The last active post_id
    15621457 */
     
    16081503 * @param int    $parent_id Parent id.
    16091504 * @param string $post_type Post type. Defaults to 'post'.
    1610  * @uses bbp_get_public_status_id() To get the public status id
    1611  * @uses bbp_get_topic_post_type() To get the topic post type
    1612  * @uses bbp_get_closed_status_id() To get the closed status id
    1613  * @uses WP_Query To get get the posts
    1614  * @uses apply_filters() Calls 'bbp_get_public_child_count' with the child
    1615  *                        count, parent id and post type
    16161505 * @return int The number of children
    16171506 */
     
    16591548 * @param int    $parent_id Parent id.
    16601549 * @param string $post_type Post type. Defaults to 'post'.
    1661  * @uses bbp_get_public_status_id() To get the public status id
    1662  * @uses bbp_get_topic_post_type() To get the topic post type
    1663  * @uses bbp_get_closed_status_id() To get the closed status id
    1664  * @uses WP_Query To get get the posts
    1665  * @uses apply_filters() Calls 'bbp_get_public_child_ids' with the child ids,
    1666  *                        parent id and post type
     1550 *
    16671551 * @return array The array of children
    16681552 */
     
    17091593 * @param int $parent_id  Parent id
    17101594 * @param string $post_type Post type. Defaults to 'post'
    1711  * @uses wp_cache_get() To check if there is a cache of the children
    1712  * @uses bbp_get_public_status_id() To get the public status id
    1713  * @uses bbp_get_private_status_id() To get the private status id
    1714  * @uses bbp_get_hidden_status_id() To get the hidden status id
    1715  * @uses bbp_get_pending_status_id() To get the pending status id
    1716  * @uses bbp_get_closed_status_id() To get the closed status id
    1717  * @uses bbp_get_trash_status_id() To get the trash status id
    1718  * @uses bbp_get_spam_status_id() To get the spam status id
    1719  * @uses bbp_get_forum_post_type() To get the forum post type
    1720  * @uses bbp_get_topic_post_type() To get the topic post type
    1721  * @uses bbp_get_reply_post_type() To get the reply post type
    1722  * @uses wpdb::prepare() To prepare the query
    1723  * @uses wpdb::get_col() To get the result of the query in an array
    1724  * @uses wp_cache_set() To set the cache for future use
    1725  * @uses apply_filters() Calls 'bbp_get_all_child_ids' with the child ids,
    1726  *                        parent id and post type
     1595 *
    17271596 * @return array The array of children
    17281597 */
     
    18201689 * @since 2.1.0 bbPress (r4022)
    18211690 *
    1822  * @uses do_action() Calls 'bbp_check_referer' on $action.
    18231691 * @param string $action Action nonce
    18241692 * @param string $query_arg where to look for nonce in $_REQUEST
     
    21211989 * @since 2.0.0 bbPress (r3304)
    21221990 *
    2123  * @uses get_option() To see if pretty permalinks are enabled
    2124  * @uses get_page_by_path() To see if page exists at path
    2125  *
    21261991 * @param string $path
    21271992 * @return mixed False if no page, Page object if true
     
    21532018 *
    21542019 * @global WP_Query $wp_query
    2155  * @uses WP_Query::set_404()
    21562020 */
    21572021function bbp_set_404() {
Note: See TracChangeset for help on using the changeset viewer.