Skip to:
Content

BuddyPress.org

Changeset 7405


Ignore:
Timestamp:
10/10/2013 01:33:46 PM (13 years ago)
Author:
boonebgorges
Message:

Improve inline docs in bp-activity-template.php.

See #5022

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/bp-activity/bp-activity-template.php

    r7228 r7405  
    22
    33/**
    4  * BuddyPress Activity Template Functions
     4 * BuddyPress Activity Template Functions.
    55 *
    66 * @package BuddyPress
     
    1212
    1313/**
    14  * Output the activity component slug
     14 * Output the activity component slug.
    1515 *
    1616 * @since BuddyPress (1.5)
     
    2222}
    2323        /**
    24          * Return the activity component slug
     24         * Return the activity component slug.
    2525         *
    2626         * @since BuddyPress (1.5)
    2727         *
    28          * @global object $bp BuddyPress global settings
    29          * @uses apply_filters() To call the 'bp_get_activity_slug' hook
     28         * @global object $bp BuddyPress global settings.
     29         * @uses apply_filters() To call the 'bp_get_activity_slug' hook.
     30         *
     31         * @return string The activity component slug.
    3032         */
    3133        function bp_get_activity_slug() {
     
    3537
    3638/**
    37  * Output the activity component root slug
     39 * Output the activity component root slug.
    3840 *
    3941 * @since BuddyPress (1.5)
     
    4547}
    4648        /**
    47          * Return the activity component root slug
     49         * Return the activity component root slug.
    4850         *
    4951         * @since BuddyPress (1.5)
    5052         *
    51          * @global object $bp BuddyPress global settings
    52          * @uses apply_filters() To call the 'bp_get_activity_root_slug' hook
     53         * @global object $bp BuddyPress global settings.
     54         * @uses apply_filters() To call the 'bp_get_activity_root_slug' hook.
     55         *
     56         * @return string The activity component root slug.
    5357         */
    5458        function bp_get_activity_root_slug() {
     
    5862
    5963/**
    60  * Output member directory permalink
     64 * Output activity directory permalink.
    6165 *
    6266 * @since BuddyPress (1.5)
     
    6872}
    6973        /**
    70          * Return member directory permalink
     74         * Return activity directory permalink
    7175         *
    7276         * @since BuddyPress (1.5)
     
    7579         * @uses bp_get_root_domain()
    7680         * @uses bp_get_activity_root_slug()
    77          * @uses apply_filters() To call the 'bp_get_activity_directory_permalink' hook
    78          *
    79          * @return string Activity directory permalink
     81         * @uses apply_filters() To call the 'bp_get_activity_directory_permalink' hook.
     82         *
     83         * @return string Activity directory permalink.
    8084         */
    8185        function bp_get_activity_directory_permalink() {
     
    8488
    8589/**
    86  * The main activity template loop
    87  *
    88  * This is responsible for loading a group of activity items and displaying them
     90 * The main activity template loop class.
     91 *
     92 * This is responsible for loading a group of activity items and displaying them.
    8993 *
    9094 * @since BuddyPress (1.0)
     
    106110
    107111        /**
    108          * Constructor method
    109          *
    110          * See definition of $defaults below, as well as $defaults in bp_has_activities(), for
    111          * description of $args array
    112          *
    113          * @param array $args
     112         * Constructor method.
     113         *
     114         * The arguments passed to this class constructor are of the same
     115         * format as {@link BP_Activity_Activity::get()}.
     116         *
     117         * @see BP_Activity_Activity::get() for a description of the argument
     118         *      structure, as well as default values.
     119         *
     120         * @param array $args {
     121         *     Array of arguments. Supports all arguments from
     122         *     BP_Activity_Activity::get(), as well as 'page_arg' and
     123         *     'include'. Default values for 'per_page' and 'display_comments'
     124         *     differ from the originating function, and are described below.
     125         *     @type string $page_arg The string used as a query parameter in
     126         *           pagination links. Default: 'acpage'.
     127         *     @type array|bool $include Pass an array of activity IDs to
     128         *           retrieve only those items, or false to noop the 'include'
     129         *           parameter. 'include' differs from 'in' in that 'in' forms
     130         *           an IN clause that works in conjunction with other filters
     131         *           passed to the function, while 'include' is interpreted as
     132         *           an exact list of items to retrieve, which skips all other
     133         *           filter-related parameters. Default: false.
     134         *     @type int|bool $per_page Default: 20.
     135         *     @type string|bool $display_comments Default: 'threaded'.
     136         * }
    114137         */
    115138        function __construct( $args ) {
     
    226249        }
    227250
     251        /**
     252         * Whether there are activity items available in the loop.
     253         *
     254         * @see bp_has_activities()
     255         *
     256         * @return bool True if there are items in the loop, otherwise false.
     257         */
    228258        function has_activities() {
    229259                if ( $this->activity_count )
     
    233263        }
    234264
     265        /**
     266         * Set up the next activity item and iterate index.
     267         *
     268         * @return object The next activity item to iterate over.
     269         */
    235270        function next_activity() {
    236271                $this->current_activity++;
     
    240275        }
    241276
     277        /**
     278         * Rewind the posts and reset post index.
     279         */
    242280        function rewind_activities() {
    243281                $this->current_activity = -1;
     
    247285        }
    248286
     287        /**
     288         * Whether there are activity items left in the loop to iterate over.
     289         *
     290         * This method is used by {@link bp_activities()} as part of the while loop
     291         * that controls iteration inside the activities loop, eg:
     292         *     while ( bp_activities() ) { ...
     293         *
     294         * @see bp_activities()
     295         *
     296         * @return bool True if there are more activity items to show,
     297         *              otherwise false.
     298         */
    249299        function user_activities() {
    250300                if ( $this->current_activity + 1 < $this->activity_count ) {
     
    260310        }
    261311
     312        /**
     313         * Set up the current activity item inside the loop.
     314         *
     315         * Used by {@link bp_the_activity()} to set up the current activity item
     316         * data while looping, so that template tags used during that iteration
     317         * make reference to the current activity item.
     318         *
     319         * @see bp_the_activity()
     320         */
    262321        function the_activity() {
    263322
     
    274333
    275334/**
    276  * Initializes the activity loop.
    277  *
    278  * Based on the $args passed, bp_has_activities() populates the $activities_template global.
     335 * Initialize the activity loop.
     336 *
     337 * Based on the $args passed, bp_has_activities() populates the
     338 * $activities_template global, enabling the use of BuddyPress templates and
     339 * template functions to display a list of activity items.
    279340 *
    280341 * @since BuddyPress (1.0)
    281342 *
    282  * @param array $args Arguments for limiting the contents of the activity loop. Can be passed as an associative array or as a URL argument string
    283  *
    284343 * @global object $activities_template {@link BP_Activity_Template}
    285  * @global object $bp BuddyPress global settings
     344 * @global object $bp BuddyPress global settings.
    286345 * @uses groups_is_user_member()
    287346 * @uses bp_current_action()
     
    294353 * @uses groups_get_user_groups()
    295354 * @uses bp_activity_get_user_favorites()
    296  * @uses apply_filters() To call the 'bp_has_activities' hook
    297  *
    298  * @return bool Returns true when activities are found
     355 * @uses apply_filters() To call the 'bp_has_activities' hook.
     356 *
     357 * @param array $args {
     358 *     Arguments for limiting the contents of the activity loop. Most
     359 *     arguments are in the same format as {@link BP_Activity_Activity::get()}.
     360 *     However, because the format of the arguments accepted here differs in
     361 *     a number of ways, and because bp_has_activities() determines some
     362 *     default arguments in a dynamic fashion, we list all accepted arguments
     363 *     here as well.
     364 *
     365 *     Arguments can be passed as an associative array, or as a URL query
     366 *     string (eg, 'user_id=4&display_comments=threaded').
     367 *
     368 *     @type int $page Which page of results to fetch. Using page=1 without
     369 *           per_page will result in no pagination. Default: 1.
     370 *     @type int|bool $per_page Number of results per page. Default: 20.
     371 *     @type string $page_arg The string used as a query parameter in
     372 *           pagination links. Default: 'acpage'.
     373 *     @type int|bool $max Maximum number of results to return.
     374 *           Default: false (unlimited).
     375 *     @type string $sort 'ASC' or 'DESC'. Default: 'DESC'.
     376 *     @type array|bool $exclude Array of activity IDs to exclude. Default: false.
     377 *     @type array|bool $in Array of IDs to limit query by (IN). 'in' is
     378 *           intended to be used in conjunction with other filter parameters.
     379 *           Default: false.
     380 *     @type array|bool $include Array of exact activity IDs to query.
     381 *           Providing an 'include' array will override all other filters
     382 *           passed in the argument array. When viewing a the permalink page
     383 *           for a single activity item, this value defaults to the ID of that
     384 *           item. Otherwise the default is false.
     385 *     @type array $meta_query Limit by activitymeta by passing an array of
     386 *           meta_query conditions. See {@link WP_Meta_Query::queries} for a
     387 *           description of the syntax.
     388 *     @type string $search_terms Limit results by a search term. Default: false.
     389 *     @type string|bool $scope Use one of BuddyPress's pre-built filters. In
     390 *           each case, the term 'current user' refers to the displayed user
     391 *           when looking at a user profile, and otherwise to the logged-in user.
     392 *             - 'just-me' retrieves items belonging only to the logged-in user;
     393 *               this is equivalent to passing a 'user_id' argument
     394 *             - 'friends' retrieves items belonging to the friends of the
     395 *               current user
     396 *             - 'groups' retrieves items associated with the groups to which
     397 *               the current user belongs
     398 *             - 'favorites' retrieves the current user's favorited activity
     399 *               items
     400 *             - 'mentions' retrieves activity items where the current user has
     401 *               received an @-mention
     402 *           The default value of 'scope' is set to one of the above if that
     403 *           value appears in the appropriate place in the URL; eg, 'scope' will
     404 *           be 'groups' when visiting http://example.com/members/joe/activity/groups/.
     405 *           Otherwise defaults to false.
     406 *     @type int|array|bool $user_id The ID(s) of user(s) whose activity should
     407 *           be fetched. Pass a single ID or an array of IDs. When viewing a
     408 *           user profile page (but not that user's activity subpages, ie My
     409 *           Friends, My Groups, etc), 'user_id' defaults to the ID of the
     410 *           displayed user. Otherwise the default is false.
     411 *     @type string|array|bool $object Filters by the `component` column in the
     412 *           database, which is generally the component ID in the case of
     413 *           BuddyPress components, or the plugin slug in the case of plugins.
     414 *           For example, 'groups' will limit results to those that are
     415 *           associated with the BP Groups component. Accepts a single
     416 *           component string, or an array of multiple components. Defaults to
     417 *           'groups' when viewing the page of a single group, the My Groups
     418 *           activity filter, or the Activity > Groups filter of a user profile.
     419 *           Otherwise defaults to false.
     420 *     @type string|array|bool $action Filters by the `type` column in the
     421 *           database, which is a string categorizing the activity item (eg,
     422 *           'new_blog_post', 'created_group'). Accepts a single type string,
     423 *           or an array of multiple types. Defaults to false.
     424 *     @type int|array|bool $primary_id Filters by the `item_id` column in the
     425 *           database. The meaning of 'primary_id' differs between components/
     426 *           types; for example, in the case of 'created_group', 'primary_id'
     427 *           is the ID of the group. Accepts a single ID, or an array of
     428 *           multiple IDs. When viewing a single group, defaults to the current
     429 *           group ID. When viewing a user's Groups stream page, defaults to
     430 *           the IDs of the user's groups. Otherwise defaults to false.
     431 *     @type int|array|bool $secondary_id Filters by the `secondary_item_id`
     432 *           column in the database. The meaning of 'secondary_id' differs
     433 *           between components/types. Accepts a single ID, or an array of
     434 *           multiple IDs. Defaults to false.
     435 *     @type string|bool $display_comments How to handle activity comments.
     436 *           Possible values:
     437 *             - 'threaded' - comments appear in a threaded tree, under their
     438 *               parent items
     439 *             - 'stream' - the activity stream is presented in a flat manner,
     440 *               with comments sorted in chronological order alongside other
     441 *               activity items
     442 *             - false - don't fetch activity comments at all
     443 *           Default: 'threaded'.
     444 *     @type bool $show_hidden Whether to show items marked hide_sitewide.
     445 *           Defaults to false, except in the following cases:
     446 *             - User is viewing his own activity stream
     447 *             - User is viewing the activity stream of a non-public group of
     448 *               which he is a member
     449 *     @type bool $show_hidden Normally defaults to false, except when:
     450 *             - a user is viewing his own activity stream
     451 *             - a user is viewing the activity stream of a non-public group of
     452 *               which he is a member
     453 *     @type string|bool $spam Spam status. 'ham_only', 'spam_only', or false
     454 *           to show all activity regardless of spam status. Default: 'ham_only'.
     455 * }
     456 * @return bool Returns true when activities are found, otherwise false.
    299457 */
    300458function bp_has_activities( $args = '' ) {
     
    475633
    476634/**
    477  * Determines if there are still activities left in the loop.
     635 * Determine if there are still activities left in the loop.
    478636 *
    479637 * @since BuddyPress (1.0)
     
    482640 * @uses BP_Activity_Template::user_activities() {@link BP_Activity_Template::user_activities()}
    483641 *
    484  * @return bool Returns true when activities are found
     642 * @return bool Returns true when activities are found.
    485643 */
    486644function bp_activities() {
     
    490648
    491649/**
    492  * Gets the current activity object in the loop
     650 * Get the current activity object in the loop.
    493651 *
    494652 * @since BuddyPress (1.0)
     
    497655 * @uses BP_Activity_Template::the_activity() {@link BP_Activity_Template::the_activity()}
    498656 *
    499  * @return object The current activity within the loop
     657 * @return object The current activity within the loop.
    500658 */
    501659function bp_the_activity() {
     
    505663
    506664/**
    507  * Outputs the activity pagination count
     665 * Output the activity pagination count.
    508666 *
    509667 * @since BuddyPress (1.0)
     
    517675
    518676        /**
    519          * Returns the activity pagination count
     677         * Return the activity pagination count.
    520678         *
    521679         * @since BuddyPress (1.2)
     
    524682         * @uses bp_core_number_format()
    525683         *
    526          * @return string The pagination text
     684         * @return string The pagination text.
    527685         */
    528686        function bp_get_activity_pagination_count() {
     
    538696
    539697/**
    540  * Outputs the activity pagination links
     698 * Output the activity pagination links.
    541699 *
    542700 * @since BuddyPress (1.0)
     
    549707
    550708        /**
    551          * Outputs the activity pagination links
     709         * Return the activity pagination links.
    552710         *
    553711         * @since BuddyPress (1.0)
    554712         *
    555713         * @global object $activities_template {@link BP_Activity_Template}
    556          * @uses apply_filters() To call the 'bp_get_activity_pagination_links' hook
    557          *
    558          * @return string The pagination links
     714         * @uses apply_filters() To call the 'bp_get_activity_pagination_links' hook.
     715         *
     716         * @return string The pagination links.
    559717         */
    560718        function bp_get_activity_pagination_links() {
     
    565723
    566724/**
    567  * Returns true when there are more activity items to be shown than currently appear
     725 * Return true when there are more activity items to be shown than currently appear.
    568726 *
    569727 * @since BuddyPress (1.5)
    570728 *
    571729 * @global object $activities_template {@link BP_Activity_Template}
    572  * @uses apply_filters() To call the 'bp_activity_has_more_items' hook
    573  *
    574  * @return bool $has_more_items True if more items, false if not
     730 * @uses apply_filters() To call the 'bp_activity_has_more_items' hook.
     731 *
     732 * @return bool $has_more_items True if more items, false if not.
    575733 */
    576734function bp_activity_has_more_items() {
     
    584742
    585743/**
    586  * Outputs the activity count
     744 * Output the activity count.
    587745 *
    588746 * @since BuddyPress (1.2)
     
    595753
    596754        /**
    597          * Returns the activity count
    598          *
    599          * @since BuddyPress (1.2)
    600          *
    601          * @global object $activities_template {@link BP_Activity_Template}
    602          * @uses apply_filters() To call the 'bp_get_activity_count' hook
    603          *
    604          * @return int The activity count
     755         * Return the activity count.
     756         *
     757         * @since BuddyPress (1.2)
     758         *
     759         * @global object $activities_template {@link BP_Activity_Template}
     760         * @uses apply_filters() To call the 'bp_get_activity_count' hook.
     761         *
     762         * @return int The activity count.
    605763         */
    606764        function bp_get_activity_count() {
     
    611769
    612770/**
    613  * Outputs the number of activities per page
     771 * Output the number of activities per page.
    614772 *
    615773 * @since BuddyPress (1.2)
     
    622780
    623781        /**
    624          * Returns the number of activities per page
    625          *
    626          * @since BuddyPress (1.2)
    627          *
    628          * @global object $activities_template {@link BP_Activity_Template}
    629          * @uses apply_filters() To call the 'bp_get_activity_per_page' hook
    630          *
    631          * @return int The activities per page
     782         * Return the number of activities per page.
     783         *
     784         * @since BuddyPress (1.2)
     785         *
     786         * @global object $activities_template {@link BP_Activity_Template}
     787         * @uses apply_filters() To call the 'bp_get_activity_per_page' hook.
     788         *
     789         * @return int The activities per page.
    632790         */
    633791        function bp_get_activity_per_page() {
     
    638796
    639797/**
    640  * Outputs the activities title
     798 * Output the activities title.
    641799 *
    642800 * @since BuddyPress (1.0)
    643801 *
    644802 * @uses bp_get_activities_title()
     803 * @todo Deprecate.
    645804 */
    646805function bp_activities_title() {
     
    649808
    650809        /**
    651          * Returns the activities title
     810         * Return the activities title.
    652811         *
    653812         * @since BuddyPress (1.0)
    654813         *
    655814         * @global string $bp_activity_title
    656          * @uses apply_filters() To call the 'bp_get_activities_title' hook
    657          *
    658          * @return int The activities title
     815         * @uses apply_filters() To call the 'bp_get_activities_title' hook.
     816         * @todo Deprecate.
     817         *
     818         * @return int The activities title.
    659819         */
    660820        function bp_get_activities_title() {
     
    670830 *
    671831 * @uses bp_get_activities_no_activity()
     832 * @todo Deprecate.
    672833 */
    673834function bp_activities_no_activity() {
     
    682843         * @global string $bp_activity_no_activity
    683844         * @uses apply_filters() To call the 'bp_get_activities_no_activity' hook
     845         * @todo Deprecate.
    684846         *
    685847         * @return string
     
    692854
    693855/**
    694  * Outputs the activity id
     856 * Output the activity ID.
    695857 *
    696858 * @since BuddyPress (1.2)
     
    703865
    704866        /**
    705          * Returns the activity id
    706          *
    707          * @since BuddyPress (1.2)
    708          *
    709          * @global object $activities_template {@link BP_Activity_Template}
    710          * @uses apply_filters() To call the 'bp_get_activity_id' hook
    711          *
    712          * @return int The activity id
     867         * Return the activity ID.
     868         *
     869         * @since BuddyPress (1.2)
     870         *
     871         * @global object $activities_template {@link BP_Activity_Template}
     872         * @uses apply_filters() To call the 'bp_get_activity_id' hook.
     873         *
     874         * @return int The activity ID.
    713875         */
    714876        function bp_get_activity_id() {
     
    718880
    719881/**
    720  * Outputs the activity item id
     882 * Output the activity item ID.
    721883 *
    722884 * @since BuddyPress (1.2)
     
    729891
    730892        /**
    731          * Returns the activity item id
    732          *
    733          * @since BuddyPress (1.2)
    734          *
    735          * @global object $activities_template {@link BP_Activity_Template}
    736          * @uses apply_filters() To call the 'bp_get_activity_item_id' hook
    737          *
    738          * @return int The activity item id
     893         * Return the activity item ID.
     894         *
     895         * @since BuddyPress (1.2)
     896         *
     897         * @global object $activities_template {@link BP_Activity_Template}
     898         * @uses apply_filters() To call the 'bp_get_activity_item_id' hook.
     899         *
     900         * @return int The activity item ID.
    739901         */
    740902        function bp_get_activity_item_id() {
     
    744906
    745907/**
    746  * Outputs the activity secondary item id
     908 * Output the activity secondary item ID.
    747909 *
    748910 * @since BuddyPress (1.2)
     
    755917
    756918        /**
    757          * Returns the activity secondary item id
    758          *
    759          * @since BuddyPress (1.2)
    760          *
    761          * @global object $activities_template {@link BP_Activity_Template}
    762          * @uses apply_filters() To call the 'bp_get_activity_secondary_item_id' hook
    763          *
    764          * @return int The activity secondary item id
     919         * Return the activity secondary item ID.
     920         *
     921         * @since BuddyPress (1.2)
     922         *
     923         * @global object $activities_template {@link BP_Activity_Template}
     924         * @uses apply_filters() To call the 'bp_get_activity_secondary_item_id' hook.
     925         *
     926         * @return int The activity secondary item ID.
    765927         */
    766928        function bp_get_activity_secondary_item_id() {
     
    770932
    771933/**
    772  * Outputs the date the activity was recorded
     934 * Output the date the activity was recorded.
    773935 *
    774936 * @since BuddyPress (1.2)
     
    781943
    782944        /**
    783          * Returns the date the activity was recorded
    784          *
    785          * @since BuddyPress (1.2)
    786          *
    787          * @global object $activities_template {@link BP_Activity_Template}
    788          * @uses apply_filters() To call the 'bp_get_activity_date_recorded' hook
    789          *
    790          * @return string The date the activity was recorded
     945         * Return the date the activity was recorded.
     946         *
     947         * @since BuddyPress (1.2)
     948         *
     949         * @global object $activities_template {@link BP_Activity_Template}
     950         * @uses apply_filters() To call the 'bp_get_activity_date_recorded' hook.
     951         *
     952         * @return string The date the activity was recorded.
    791953         */
    792954        function bp_get_activity_date_recorded() {
     
    796958
    797959/**
    798  * Outputs the activity object name
     960 * Output the activity object name.
    799961 *
    800962 * @since BuddyPress (1.2)
     
    807969
    808970        /**
    809          * Returns the activity object name
    810          *
    811          * @since BuddyPress (1.2)
    812          *
    813          * @global object $activities_template {@link BP_Activity_Template}
    814          * @uses apply_filters() To call the 'bp_get_activity_object_name' hook
    815          *
    816          * @return string The activity object name
     971         * Return the activity object name.
     972         *
     973         * @since BuddyPress (1.2)
     974         *
     975         * @global object $activities_template {@link BP_Activity_Template}
     976         * @uses apply_filters() To call the 'bp_get_activity_object_name' hook.
     977         *
     978         * @return string The activity object name.
    817979         */
    818980        function bp_get_activity_object_name() {
     
    822984
    823985/**
    824  * Outputs the activity type
     986 * Output the activity type.
    825987 *
    826988 * @since BuddyPress (1.2)
     
    833995
    834996        /**
    835          * Returns the activity type
    836          *
    837          * @since BuddyPress (1.2)
    838          *
    839          * @global object $activities_template {@link BP_Activity_Template}
    840          * @uses apply_filters() To call the 'bp_get_activity_type' hook
    841          *
    842          * @return string The activity type
     997         * Return the activity type.
     998         *
     999         * @since BuddyPress (1.2)
     1000         *
     1001         * @global object $activities_template {@link BP_Activity_Template}
     1002         * @uses apply_filters() To call the 'bp_get_activity_type' hook.
     1003         *
     1004         * @return string The activity type.
    8431005         */
    8441006        function bp_get_activity_type() {
     
    8481010
    8491011        /**
    850          * Outputs the activity action name
    851          *
    852          * Just a wrapper for bp_activity_type()
     1012         * Output the activity action name.
     1013         *
     1014         * Just a wrapper for bp_activity_type().
    8531015         *
    8541016         * @since BuddyPress (1.2)
     
    8631025
    8641026        /**
    865          * Returns the activity type
    866          *
    867          * Just a wrapper for bp_get_activity_type()
     1027         * Return the activity type.
     1028         *
     1029         * Just a wrapper for bp_get_activity_type().
    8681030         *
    8691031         * @since BuddyPress (1.2)
    8701032         * @deprecated BuddyPress (1.5)
    8711033         *
    872          * @todo Properly deprecate in favor of bp_get_activity_type()
     1034         * @todo Properly deprecate in favor of bp_get_activity_type().
    8731035         *
    8741036         * @uses bp_get_activity_type()
    8751037         *
    876          * @return string The activity type
     1038         * @return string The activity type.
    8771039         */
    8781040        function bp_get_activity_action_name() { return bp_get_activity_type(); }
    8791041
    8801042/**
    881  * Outputs the activity user id
     1043 * Output the activity user ID.
    8821044 *
    8831045 * @since BuddyPress (1.1)
     
    8901052
    8911053        /**
    892          * Returns the activity user id
     1054         * Return the activity user ID.
    8931055         *
    8941056         * @since BuddyPress (1.1)
    8951057         *
    8961058         * @global object $activities_template {@link BP_Activity_Template}
    897          * @uses apply_filters() To call the 'bp_get_activity_user_id' hook
    898          *
    899          * @return int The activity user id
     1059         * @uses apply_filters() To call the 'bp_get_activity_user_id' hook.
     1060         *
     1061         * @return int The activity user ID.
    9001062         */
    9011063        function bp_get_activity_user_id() {
     
    9051067
    9061068/**
    907  * Outputs the activity user link
     1069 * Output the activity user link.
    9081070 *
    9091071 * @since BuddyPress (1.2)
     
    9161078
    9171079        /**
    918          * Returns the activity user link
     1080         * Return the activity user link.
    9191081         *
    9201082         * @since BuddyPress (1.2)
     
    9221084         * @global object $activities_template {@link BP_Activity_Template}
    9231085         * @uses bp_core_get_user_domain()
    924          * @uses apply_filters() To call the 'bp_get_activity_user_link' hook
    925          *
    926          * @return string $link The activity user link
     1086         * @uses apply_filters() To call the 'bp_get_activity_user_link' hook.
     1087         *
     1088         * @return string $link The activity user link.
    9271089         */
    9281090        function bp_get_activity_user_link() {
     
    9381100
    9391101/**
    940  * Output the avatar of the user that performed the action
     1102 * Output the avatar of the user that performed the action.
    9411103 *
    9421104 * @since BuddyPress (1.1)
    9431105 *
    944  * @param array $args
    945  *
     1106 * @see bp_get_activity_avatar() for description of arguments.
    9461107 * @uses bp_get_activity_avatar()
     1108 *
     1109 * @param array $args See {@link bp_get_activity_avatar()} for description.
    9471110 */
    9481111function bp_activity_avatar( $args = '' ) {
     
    9501113}
    9511114        /**
    952          * Return the avatar of the user that performed the action
     1115         * Return the avatar of the user that performed the action.
    9531116         *
    9541117         * @since BuddyPress (1.1)
    9551118         *
    956          * @param array $args optional
    957          *
     1119         * @see bp_core_fetch_avatar() For a description of the arguments.
    9581120         * @global object $activities_template {@link BP_Activity_Template}
    9591121         * @global object $bp BuddyPress global settings
     
    9651127         * @uses apply_filters() To call the 'bp_get_activity_avatar' hook
    9661128         *
    967          * @return string User avatar
     1129         * @param array $args  {
     1130         *     Arguments are listed here with an explanation of their defaults.
     1131         *     For more information about the arguments, see
     1132         *     {@link bp_core_fetch_avatar()}.
     1133         *     @type string $alt Default: 'Profile picture of [user name]' if
     1134         *           activity user name is available, otherwise 'Profile picture'.
     1135         *     @type string $class Default: 'avatar'.
     1136         *     @type string|bool $email Default: Email of the activity's
     1137         *           associated user, if available. Otherwise false.
     1138         *     @type string $type Default: 'full' when viewing a single activity
     1139         *           permalink page, otherwise 'thumb'.
     1140         *     @type int|bool $user_id Default: ID of the activity's user.
     1141         * }
     1142         * @return string User avatar string.
    9681143         */
    9691144        function bp_get_activity_avatar( $args = '' ) {
     
    10351210
    10361211/**
    1037  * Output the avatar of the object that action was performed on
    1038  *
    1039  * @since BuddyPress (1.2)
    1040  *
    1041  * @param array $args optional
    1042  *
     1212 * Output the avatar of the object that action was performed on.
     1213 *
     1214 * @since BuddyPress (1.2)
     1215 *
     1216 * @see bp_get_activity_secondary_avatar() for description of arguments.
    10431217 * @uses bp_get_activity_secondary_avatar()
     1218 *
     1219 * @param array $args See {@link bp_get_activity_secondary_avatar} for description.
    10441220 */
    10451221function bp_activity_secondary_avatar( $args = '' ) {
     
    10521228         * @since BuddyPress (1.2)
    10531229         *
    1054          * @param array $args optional
    1055          *
     1230         * @see bp_core_fetch_avatar() for description of arguments.
    10561231         * @global object $activities_template {@link BP_Activity_Template}
    10571232         * @uses wp_parse_args()
    10581233         * @uses get_blog_option()
    1059          * @uses apply_filters() To call the 'bp_get_activity_secondary_avatar_object_' . $activities_template->activity->component hook
    1060          * @uses apply_filters() To call the 'bp_get_activity_secondary_avatar_item_id' hook
     1234         * @uses apply_filters() To call the 'bp_get_activity_secondary_avatar_object_' . $activities_template->activity->component hook.
     1235         * @uses apply_filters() To call the 'bp_get_activity_secondary_avatar_item_id' hook.
    10611236         * @uses bp_core_fetch_avatar()
    1062          * @uses apply_filters() To call the 'bp_get_activity_secondary_avatar' hook
    1063          *
     1237         * @uses apply_filters() To call the 'bp_get_activity_secondary_avatar' hook.
     1238         *
     1239         * @param array $args  {
     1240         *     For a complete description of arguments, see {@link bp_core_fetch_avatar()}.
     1241         *     @type string $alt Default value varies based on current activity
     1242         *           item component.
     1243         *     @type string $type Default: 'full' when viewing a single activity
     1244         *           permalink page, otherwise 'thumb'.
     1245         *     @type string $class Default: 'avatar'.
     1246         *     @type string|bool $email Default: email of the activity's user.
     1247         *     @type int|bool $user_id Default: ID of the activity's user.
     1248         * }
    10641249         * @return string The secondary avatar
    10651250         */
     
    11921377         * @uses apply_filters_ref_array() To call the 'bp_get_activity_action_pre_meta' hook
    11931378         * @uses bp_insert_activity_meta()
    1194          * @uses apply_filters_ref_array() To call the 'bp_get_activity_action' hook
    1195          *
    1196          * @return string The activity action
     1379         * @uses apply_filters_ref_array() To call the 'bp_get_activity_action' hook.
     1380         *
     1381         * @param array $args {
     1382         *     @type bool $no_timestamp Whether to exclude the timestamp.
     1383         * }
     1384         * @return string The activity action.
    11971385         */
    11981386        function bp_get_activity_action( $args = array() ) {
     
    12331421         * @global object $activities_template {@link BP_Activity_Template}
    12341422         * @uses bp_insert_activity_meta()
    1235          * @uses apply_filters_ref_array() To call the 'bp_get_activity_content_body' hook
    1236          *
    1237          * @return string The activity content body
     1423         * @uses apply_filters_ref_array() To call the 'bp_get_activity_content_body' hook.
     1424         *
     1425         * @return string The activity content body.
    12381426         */
    12391427        function bp_get_activity_content_body() {
     
    12541442 * @global object $activities_template {@link BP_Activity_Template}
    12551443 *
    1256  * @return bool True if activity has content, false otherwise
     1444 * @return bool True if activity has content, false otherwise.
    12571445 */
    12581446function bp_activity_has_content() {
     
    12661454
    12671455/**
    1268  * Output the activity content
     1456 * Output the activity content.
    12691457 *
    12701458 * @since BuddyPress (1.0)
    12711459 * @deprecated BuddyPress (1.5)
    12721460 *
    1273  * @todo properly deprecate this function
     1461 * @todo properly deprecate this function.
    12741462 *
    12751463 * @uses bp_get_activity_content()
     
    12801468
    12811469        /**
    1282          * Return the activity content
     1470         * Return the activity content.
    12831471         *
    12841472         * @since BuddyPress (1.0)
    12851473         * @deprecated BuddyPress (1.5)
    12861474         *
    1287          * @todo properly deprecate this function
     1475         * @todo properly deprecate this function.
    12881476         *
    12891477         * @uses bp_get_activity_action()
    12901478         * @uses bp_get_activity_content_body()
    1291          * @uses apply_filters() To call the 'bp_get_activity_content' hook
    1292          *
    1293          * @return string The activity content
     1479         * @uses apply_filters() To call the 'bp_get_activity_content' hook.
     1480         *
     1481         * @return string The activity content.
    12941482         */
    12951483        function bp_get_activity_content() {
     
    13061494
    13071495/**
    1308  * Insert activity meta
    1309  *
    1310  * @since BuddyPress (1.2)
    1311  *
    1312  * @param string $content
     1496 * Attach metadata about an activity item to the activity content.
     1497 *
     1498 * This metadata includes the time since the item was posted (which will appear
     1499 * as a link to the item's permalink).
     1500 *
     1501 * @since BuddyPress (1.2)
    13131502 *
    13141503 * @global object $activities_template {@link BP_Activity_Template}
    13151504 * @uses bp_core_time_since()
    1316  * @uses apply_filters_ref_array() To call the 'bp_activity_time_since' hook
     1505 * @uses apply_filters_ref_array() To call the 'bp_activity_time_since' hook.
    13171506 * @uses bp_is_single_activity()
    13181507 * @uses bp_activity_get_permalink()
    13191508 * @uses esc_attr__()
    1320  * @uses apply_filters_ref_array() To call the 'bp_activity_permalink' hook
    1321  * @uses apply_filters() To call the 'bp_insert_activity_meta' hook
    1322  *
    1323  * @return string The activity content
     1509 * @uses apply_filters_ref_array() To call the 'bp_activity_permalink' hook.
     1510 * @uses apply_filters() To call the 'bp_insert_activity_meta' hook.
     1511 *
     1512 * @param string $content The activity content.
     1513 * @return string The activity content with the metadata string attached.
    13241514 */
    13251515function bp_insert_activity_meta( $content ) {
     
    13421532
    13431533/**
    1344  * Determine if the current user can delete an activity item
    1345  *
    1346  * @since BuddyPress (1.2)
    1347  *
    1348  * @param object $activity Optional
     1534 * Determine if the current user can delete an activity item.
     1535 *
     1536 * @since BuddyPress (1.2)
    13491537 *
    13501538 * @global object $activities_template {@link BP_Activity_Template}
    13511539 * @uses apply_filters() To call the 'bp_activity_user_can_delete' hook
    13521540 *
    1353  * @return bool True if can delete, false otherwise
     1541 * @param object $activity Optional. Falls back on the current item in the loop.
     1542 * @return bool True if can delete, false otherwise.
    13541543 */
    13551544function bp_activity_user_can_delete( $activity = false ) {
     
    13771566
    13781567/**
    1379  * Output the activity parent content
    1380  *
    1381  * @since BuddyPress (1.2)
    1382  *
    1383  * @param array $args Optional
    1384  *
     1568 * Output the activity parent content.
     1569 *
     1570 * @since BuddyPress (1.2)
     1571 *
     1572 * @see bp_get_activity_parent_content() for a description of arguments.
    13851573 * @uses bp_get_activity_parent_content()
     1574 *
     1575 * @param array $args See {@link bp_get_activity_parent_content} for description.
    13861576 */
    13871577function bp_activity_parent_content( $args = '' ) {
     
    13901580
    13911581        /**
    1392          * Return the activity content
    1393          *
    1394          * @since BuddyPress (1.2)
    1395          *
    1396          * @param array $args Optional
     1582         * Return the activity content.
     1583         *
     1584         * @since BuddyPress (1.2)
    13971585         *
    13981586         * @global object $activities_template {@link BP_Activity_Template}
    13991587         * @uses wp_parse_args()
    1400          * @uses apply_filters() To call the 'bp_get_activity_parent_content' hook
    1401          *
     1588         * @uses apply_filters() To call the 'bp_get_activity_parent_content' hook.
     1589         *
     1590         * @param array $args {
     1591         *     Array of optional arguments.
     1592         *     @deprecated bool $hide_user No longer used.
     1593         * }
    14021594         * @return mixed False on failure, otherwise the activity parent content
    14031595         */
     
    14411633
    14421634/**
    1443  * Output the parent activity's user ID
     1635 * Output the parent activity's user ID.
    14441636 *
    14451637 * @since BuddyPress (1.7)
     
    14501642
    14511643        /**
    1452          * Return the parent activity's user ID
     1644         * Return the parent activity's user ID.
     1645         *
     1646         * @since BuddyPress (1.7)
    14531647         *
    14541648         * @global BP_Activity_Template $activities_template
    1455          * @return bool|int False if parent activity can't be found, otherwise returns the parent activity's user ID
    1456          * @since BuddyPress (1.7)
     1649         *
     1650         * @return bool|int False if parent activity can't be found, otherwise
     1651         *         the parent activity's user ID.
    14571652         */
    14581653        function bp_get_activity_parent_user_id() {
     
    14811676
    14821677/**
    1483  * Output whether or not the current activity is in a current user's favorites
     1678 * Output whether or not the current activity is in a current user's favorites.
    14841679 *
    14851680 * @since BuddyPress (1.2)
     
    14921687
    14931688        /**
    1494          * Return whether or not the current activity is in a current user's favorites
    1495          *
    1496          * @since BuddyPress (1.2)
    1497          *
    1498          * @global object $activities_template {@link BP_Activity_Template}
    1499          * @uses apply_filters() To call the 'bp_get_activity_is_favorite' hook
    1500          *
    1501          * @return bool True if user favorite, false otherwise
     1689         * Return whether the current activity is in a current user's favorites.
     1690         *
     1691         * @since BuddyPress (1.2)
     1692         *
     1693         * @global object $activities_template {@link BP_Activity_Template}
     1694         * @uses apply_filters() To call the 'bp_get_activity_is_favorite' hook.
     1695         *
     1696         * @return bool True if user favorite, false otherwise.
    15021697         */
    15031698        function bp_get_activity_is_favorite() {
     
    15081703
    15091704/**
    1510  * Echoes the comment markup for an activity item
     1705 * Output the comment markup for an activity item.
    15111706 *
    15121707 * @since BuddyPress (1.2)
     
    15211716
    15221717        /**
    1523          * Gets the comment markup for an activity item
     1718         * Get the comment markup for an activity item.
    15241719         *
    15251720         * @since BuddyPress (1.2)
     
    15911786
    15921787/**
    1593  * Utility function that returns the comment currently being recursed
     1788 * Utility function that returns the comment currently being recursed.
    15941789 *
    15951790 * @since BuddyPress (1.5)
    15961791 *
    15971792 * @global object $activities_template {@link BP_Activity_Template}
    1598  * @uses apply_filters() To call the 'bp_activity_current_comment' hook
    1599  *
    1600  * @return object|bool $current_comment The activity comment currently being displayed. False on failure
     1793 * @uses apply_filters() To call the 'bp_activity_current_comment' hook.
     1794 *
     1795 * @return object|bool $current_comment The activity comment currently being
     1796 *         displayed. False on failure.
    16011797 */
    16021798function bp_activity_current_comment() {
     
    16101806
    16111807/**
    1612  * Echoes the id of the activity comment currently being displayed
     1808 * Output the ID of the activity comment currently being displayed.
    16131809 *
    16141810 * @since BuddyPress (1.5)
     
    16211817
    16221818        /**
    1623          * Gets the id of the activity comment currently being displayed
     1819         * Return the ID of the activity comment currently being displayed.
    16241820         *
    16251821         * @since BuddyPress (1.5)
    16261822         *
    16271823         * @global object $activities_template {@link BP_Activity_Template}
    1628          * @uses apply_filters() To call the 'bp_activity_comment_id' hook
    1629          *
    1630          * @return int $comment_id The id of the activity comment currently being displayed
     1824         * @uses apply_filters() To call the 'bp_activity_comment_id' hook.
     1825         *
     1826         * @return int|bool $comment_id The ID of the activity comment
     1827         *         currently being displayed, false if none is found.
    16311828         */
    16321829        function bp_get_activity_comment_id() {
     
    16391836
    16401837/**
    1641  * Echoes the user_id of the author of the activity comment currently being displayed
     1838 * Output the ID of the author of the activity comment currently being displayed.
    16421839 *
    16431840 * @since BuddyPress (1.5)
     
    16501847
    16511848        /**
    1652          * Gets the user_id of the author of the activity comment currently being displayed
     1849         * Return the ID of the author of the activity comment currently being displayed.
    16531850         *
    16541851         * @since BuddyPress (1.5)
    16551852         *
    16561853         * @global object $activities_template {@link BP_Activity_Template}
    1657          * @uses apply_filters() To call the 'bp_activity_comment_user_id' hook
    1658          *
    1659          * @return int|bool $user_id The user_id of the author of the displayed activity comment. False on failure
     1854         * @uses apply_filters() To call the 'bp_activity_comment_user_id' hook.
     1855         *
     1856         * @return int|bool $user_id The user_id of the author of the displayed
     1857         *         activity comment. False on failure.
    16601858         */
    16611859        function bp_get_activity_comment_user_id() {
     
    16681866
    16691867/**
    1670  * Echoes the author link for the activity comment currently being displayed
     1868 * Output the author link for the activity comment currently being displayed.
    16711869 *
    16721870 * @since BuddyPress (1.5)
     
    16791877
    16801878        /**
    1681          * Gets the author link for the activity comment currently being displayed
     1879         * Return the author link for the activity comment currently being displayed.
    16821880         *
    16831881         * @since BuddyPress (1.5)
     
    16871885         * @uses apply_filters() To call the 'bp_activity_comment_user_link' hook
    16881886         *
    1689          * @return string $user_link The URL of the activity comment author's profile
     1887         * @return string $user_link The URL of the activity comment author's profile.
    16901888         */
    16911889        function bp_get_activity_comment_user_link() {
     
    16961894
    16971895/**
    1698  * Echoes the author name for the activity comment currently being displayed
     1896 * Output the author name for the activity comment currently being displayed.
    16991897 *
    17001898 * @since BuddyPress (1.5)
     
    17071905
    17081906        /**
    1709          * Gets the author name for the activity comment currently being displayed
    1710          *
    1711          * The use of the bp_acomment_name filter is deprecated. Please use bp_activity_comment_name
     1907         * Return the author name for the activity comment currently being displayed.
     1908         *
     1909         * The use of the 'bp_acomment_name' filter is deprecated. Please use
     1910         * 'bp_activity_comment_name'.
    17121911         *
    17131912         * @since BuddyPress (1.5)
    17141913         *
    17151914         * @global object $activities_template {@link BP_Activity_Template}
    1716          * @uses apply_filters() To call the 'bp_acomment_name' hook
    1717          * @uses apply_filters() To call the 'bp_activity_comment_name' hook
    1718          *
    1719          * @return string $name The full name of the activity comment author
     1915         * @uses apply_filters() To call the 'bp_acomment_name' hook.
     1916         * @uses apply_filters() To call the 'bp_activity_comment_name' hook.
     1917         *
     1918         * @return string $name The full name of the activity comment author.
    17201919         */
    17211920        function bp_get_activity_comment_name() {
     
    17311930
    17321931/**
    1733  * Echoes the date_recorded of the activity comment currently being displayed
     1932 * Output the date_recorded of the activity comment currently being displayed.
    17341933 *
    17351934 * @since BuddyPress (1.5)
     
    17421941
    17431942        /**
    1744          * Gets the date_recorded for the activity comment currently being displayed
     1943         * Return the date_recorded for the activity comment currently being displayed.
    17451944         *
    17461945         * @since BuddyPress (1.5)
     
    17501949         * @uses apply_filters() To call the 'bp_activity_comment_date_recorded' hook
    17511950         *
    1752          * @return string|bool $date_recorded Time since the activity was recorded, of the form "%s ago". False on failure
     1951         * @return string|bool $date_recorded Time since the activity was recorded,
     1952         *         in the form "%s ago". False on failure.
    17531953         */
    17541954        function bp_get_activity_comment_date_recorded() {
     
    17641964
    17651965/**
    1766  * Echoes the 'delete' URL for the activity comment currently being displayed
     1966 * Output the 'delete' URL for the activity comment currently being displayed.
    17671967 *
    17681968 * @since BuddyPress (1.5)
     
    17831983         * @uses bp_get_activity_slug()
    17841984         * @uses bp_get_activity_comment_id()
    1785          * @uses apply_filters() To call the 'bp_activity_comment_delete_link' hook
    1786          *
    1787          * @return string $link The nonced URL for deleting the current activity comment
     1985         * @uses apply_filters() To call the 'bp_activity_comment_delete_link' hook.
     1986         *
     1987         * @return string $link The nonced URL for deleting the current
     1988         *         activity comment.
    17881989         */
    17891990        function bp_get_activity_comment_delete_link() {
     
    17941995
    17951996/**
    1796  * Echoes the content of the activity comment currently being displayed
     1997 * Output the content of the activity comment currently being displayed.
    17971998 *
    17981999 * @since BuddyPress (1.5)
     
    18052006
    18062007        /**
    1807          * Gets the content of the activity comment currently being displayed
    1808          *
    1809          * The content is run through two filters. bp_get_activity_content will apply all filters
    1810          * applied to activity items in general. Use bp_activity_comment_content to modify the
    1811          * content of activity comments only.
     2008         * Return the content of the activity comment currently being displayed.
     2009         *
     2010         * The content is run through two filters. 'bp_get_activity_content'
     2011         * will apply all filters applied to activity items in general. Use
     2012         * 'bp_activity_comment_content' to modify the content of activity
     2013         * comments only.
    18122014         *
    18132015         * @since BuddyPress (1.5)
    18142016         *
    18152017         * @global object $activities_template {@link BP_Activity_Template}
    1816          * @uses apply_filters() To call the 'bp_get_activity_content' hook
    1817          * @uses apply_filters() To call the 'bp_activity_comment_content' hook
    1818          *
    1819          * @return string $content The content of the current activity comment
     2018         * @uses apply_filters() To call the 'bp_get_activity_content' hook.
     2019         * @uses apply_filters() To call the 'bp_activity_comment_content' hook.
     2020         *
     2021         * @return string $content The content of the current activity comment.
    18202022         */
    18212023        function bp_get_activity_comment_content() {
     
    18282030
    18292031/**
    1830  * Echoes the activity comment count
     2032 * Output the activity comment count.
    18312033 *
    18322034 * @since BuddyPress (1.2)
     
    18392041
    18402042        /**
    1841          * Gets the content of the activity comment currently being displayed
    1842          *
    1843          * The content is run through two filters. bp_get_activity_content will apply all filters
    1844          * applied to activity items in general. Use bp_activity_comment_content to modify the
    1845          * content of activity comments only.
    1846          *
    1847          * @since BuddyPress (1.2)
    1848          *
     2043         * Return the content of the activity comment currently being displayed.
     2044         *
     2045         * The content is run through two filters. 'bp_get_activity_content'
     2046         * will apply all filters applied to activity items in general. Use
     2047         * 'bp_activity_comment_content' to modify the content of activity
     2048         * comments only.
     2049         *
     2050         * @since BuddyPress (1.2)
     2051         *
     2052         * @global object $activities_template {@link BP_Activity_Template}
     2053         * @uses bp_activity_recurse_comment_count()
     2054         * @uses apply_filters() To call the 'bp_activity_get_comment_count' hook.
    18492055         * @todo deprecate $args
    18502056         *
    1851          * @global object $activities_template {@link BP_Activity_Template}
    1852          * @uses bp_activity_recurse_comment_count()
    1853          * @uses apply_filters() To call the 'bp_activity_get_comment_count' hook
    1854          *
    1855          * @return int $count The activity comment count. Defaults to zero
     2057         * @param array $args Deprecated.
     2058         * @return int $count The activity comment count.
    18562059         */
    18572060        function bp_activity_get_comment_count( $args = '' ) {
     
    18672070
    18682071                /**
    1869                  * Gets the content of the activity comment currently being displayed
     2072                 * Return the content of the activity comment currently being displayed.
    18702073                 *
    1871                  * The content is run through two filters. bp_get_activity_content will apply all filters
    1872                  * applied to activity items in general. Use bp_activity_comment_content to modify the
    1873                  * content of activity comments only.
     2074                 * The content is run through two filters. 'bp_get_activity_content'
     2075                 * will apply all filters applied to activity items in general.
     2076                 * Use bp_activity_comment_content to modify the content of
     2077                 * activity comments only.
    18742078                 *
    18752079                 * @since BuddyPress (1.2)
    18762080                 *
     2081                 * @uses bp_activity_recurse_comment_count()
     2082                 * @uses apply_filters() To call the 'bp_activity_get_comment_count' hook
    18772083                 * @todo investigate why bp_activity_recurse_comment_count() is used while being declared
    18782084                 *
    1879                  * @param object $comment Activity comments object
    1880                  *
    1881                  * @uses bp_activity_recurse_comment_count()
    1882                  * @uses apply_filters() To call the 'bp_activity_get_comment_count' hook
    1883                  *
     2085                 * @param object $comment Activity comment object.
     2086                 * @param int $count The current iteration count.
    18842087                 * @return int $count The activity comment count.
    18852088                 */
     
    18982101
    18992102/**
    1900  * Echoes the activity comment link
     2103 * Output the activity comment link.
    19012104 *
    19022105 * @since BuddyPress (1.2)
     
    19092112
    19102113        /**
    1911          * Gets the activity comment link
    1912          *
    1913          * @since BuddyPress (1.2)
    1914          *
    1915          * @global object $activities_template {@link BP_Activity_Template}
    1916          * @uses apply_filters() To call the 'bp_get_activity_comment_link' hook
    1917          *
    1918          * @return string The activity comment link
     2114         * Return the activity comment link.
     2115         *
     2116         * @since BuddyPress (1.2)
     2117         *
     2118         * @global object $activities_template {@link BP_Activity_Template}
     2119         * @uses apply_filters() To call the 'bp_get_activity_comment_link' hook.
     2120         *
     2121         * @return string The activity comment link.
    19192122         */
    19202123        function bp_get_activity_comment_link() {
     
    19242127
    19252128/**
    1926  * Echoes the activity comment form no javascript display CSS
     2129 * Output the activity comment form no javascript display CSS.
    19272130 *
    19282131 * @since BuddyPress (1.2)
     
    19352138
    19362139        /**
    1937          * Gets the activity comment form no javascript display CSS
    1938          *
    1939          * @since BuddyPress (1.2)
    1940          *
    1941          * @global object $activities_template {@link BP_Activity_Template}
    1942          *
    1943          * @return string|bool The activity comment form no javascript display CSS. False on failure
     2140         * Return the activity comment form no javascript display CSS.
     2141         *
     2142         * @since BuddyPress (1.2)
     2143         *
     2144         * @global object $activities_template {@link BP_Activity_Template}
     2145         *
     2146         * @return string|bool The activity comment form no javascript
     2147         *         display CSS. False on failure
    19442148         */
    19452149        function bp_get_activity_comment_form_nojs_display() {
     
    19522156
    19532157/**
    1954  * Echoes the activity comment form action
     2158 * Output the activity comment form action.
    19552159 *
    19562160 * @since BuddyPress (1.2)
     
    19632167
    19642168        /**
    1965          * Gets the activity comment form action
     2169         * Return the activity comment form action.
    19662170         *
    19672171         * @since BuddyPress (1.2)
     
    19692173         * @uses home_url()
    19702174         * @uses bp_get_activity_root_slug()
    1971          * @uses apply_filters() To call the 'bp_get_activity_comment_form_action' hook
    1972          *
    1973          * @return string The activity comment form action
     2175         * @uses apply_filters() To call the 'bp_get_activity_comment_form_action' hook.
     2176         *
     2177         * @return string The activity comment form action.
    19742178         */
    19752179        function bp_get_activity_comment_form_action() {
     
    19782182
    19792183/**
    1980  * Echoes the activity permalink id
     2184 * Output the activity permalink ID.
    19812185 *
    19822186 * @since BuddyPress (1.2)
     
    19892193
    19902194        /**
    1991          * Gets the activity permalink id
    1992          *
    1993          * @since BuddyPress (1.2)
    1994          *
    1995          * @uses apply_filters() To call the 'bp_get_activity_permalink_id' hook
    1996          *
    1997          * @return string The activity permalink id
     2195         * Return the activity permalink ID.
     2196         *
     2197         * @since BuddyPress (1.2)
     2198         *
     2199         * @uses apply_filters() To call the 'bp_get_activity_permalink_id' hook.
     2200         *
     2201         * @return string The activity permalink ID.
    19982202         */
    19992203        function bp_get_activity_permalink_id() {
     
    20022206
    20032207/**
    2004  * Echoes the activity thread permalink
     2208 * Output the activity thread permalink.
    20052209 *
    20062210 * @since BuddyPress (1.2)
     
    20132217
    20142218        /**
    2015          * Gets the activity thread permalink
     2219         * Return the activity thread permalink.
    20162220         *
    20172221         * @since BuddyPress (1.2)
    20182222         *
    20192223         * @uses bp_activity_get_permalink()
    2020          * @uses apply_filters() To call the 'bp_get_activity_thread_permalink' hook
    2021          *
    2022          * @return string $link The activity thread permalink
     2224         * @uses apply_filters() To call the 'bp_get_activity_thread_permalink' hook.
     2225         *
     2226         * @return string $link The activity thread permalink.
    20232227         */
    20242228        function bp_get_activity_thread_permalink() {
     
    20312235
    20322236/**
    2033  * Echoes the activity comment permalink
     2237 * Output the activity comment permalink.
    20342238 *
    20352239 * @since BuddyPress (1.8)
     
    20412245}
    20422246        /**
    2043          * Gets the activity comment permalink
     2247         * Return the activity comment permalink.
    20442248         *
    20452249         * @since BuddyPress (1.8)
    20462250         *
    20472251         * @uses bp_activity_get_permalink()
    2048          * @uses apply_filters() To call the 'bp_get_activity_comment_permalink' hook
    2049          *
    2050          * @return string $link The activity comment permalink
     2252         * @uses apply_filters() To call the 'bp_get_activity_comment_permalink' hook.
     2253         *
     2254         * @return string $link The activity comment permalink.
    20512255         */
    20522256        function bp_get_activity_comment_permalink() {
     
    20592263
    20602264/**
    2061  * Echoes the activity favorite link
     2265 * Output the activity favorite link.
    20622266 *
    20632267 * @since BuddyPress (1.2)
     
    20702274
    20712275        /**
    2072          * Gets the activity favorite link
     2276         * Return the activity favorite link.
    20732277         *
    20742278         * @since BuddyPress (1.2)
     
    20802284         * @uses apply_filters() To call the 'bp_get_activity_favorite_link' hook
    20812285         *
    2082          * @return string The activity favorite link
     2286         * @return string The activity favorite link.
    20832287         */
    20842288        function bp_get_activity_favorite_link() {
     
    20882292
    20892293/**
    2090  * Echoes the activity unfavorite link
     2294 * Output the activity unfavorite link.
    20912295 *
    20922296 * @since BuddyPress (1.2)
     
    20992303
    21002304        /**
    2101          * Gets the activity unfavorite link
     2305         * Return the activity unfavorite link.
    21022306         *
    21032307         * @since BuddyPress (1.2)
     
    21072311         * @uses home_url()
    21082312         * @uses bp_get_activity_root_slug()
    2109          * @uses apply_filters() To call the 'bp_get_activity_unfavorite_link' hook
    2110          *
    2111          * @return string The activity unfavorite link
     2313         * @uses apply_filters() To call the 'bp_get_activity_unfavorite_link' hook.
     2314         *
     2315         * @return string The activity unfavorite link.
    21122316         */
    21132317        function bp_get_activity_unfavorite_link() {
     
    21172321
    21182322/**
    2119  * Echoes the activity CSS class
     2323 * Output the activity CSS class.
    21202324 *
    21212325 * @since BuddyPress (1.0)
     
    21282332
    21292333        /**
    2130          * Gets the activity CSS class
     2334         * Return the current activity item's CSS class.
    21312335         *
    21322336         * @since BuddyPress (1.0)
    21332337         *
    21342338         * @global object $activities_template {@link BP_Activity_Template}
    2135          * @uses apply_filters() To call the 'bp_activity_mini_activity_types' hook
     2339         * @uses apply_filters() To call the 'bp_activity_mini_activity_types' hook.
    21362340         * @uses bp_activity_get_comment_count()
    21372341         * @uses bp_activity_can_comment()
    2138          * @uses apply_filters() To call the 'bp_get_activity_css_class' hook
    2139          *
    2140          * @return string The activity css class
     2342         * @uses apply_filters() To call the 'bp_get_activity_css_class' hook.
     2343         *
     2344         * @return string The activity item's CSS class.
    21412345         */
    21422346        function bp_get_activity_css_class() {
     
    21642368
    21652369/**
    2166  * Display the activity delete link.
     2370 * Output the activity delete link.
    21672371 *
    21682372 * @since BuddyPress (1.1)
     
    21872391         * @uses wp_get_referer()
    21882392         * @uses wp_nonce_url()
    2189          * @uses apply_filters() To call the 'bp_get_activity_delete_link' hook
    2190          *
    2191          * @return string $link Activity delete link. Contains $redirect_to arg if on single activity page.
     2393         * @uses apply_filters() To call the 'bp_get_activity_delete_link' hook.
     2394         *
     2395         * @return string $link Activity delete link. Contains $redirect_to arg
     2396         *         if on single activity page.
    21922397         */
    21932398        function bp_get_activity_delete_link() {
     
    22082413
    22092414/**
    2210  * Display the activity latest update link.
    2211  *
    2212  * @since BuddyPress (1.2)
    2213  *
    2214  * @param int $user_id Defaults to 0
    2215  *
     2415 * Output the activity latest update link.
     2416 *
     2417 * @since BuddyPress (1.2)
     2418 *
     2419 * @see bp_get_activity_latest_update() for description of parameters.
    22162420 * @uses bp_get_activity_latest_update()
     2421 *
     2422 * @param int $user_id See {@link bp_get_activity_latest_update()} for description.
    22172423 */
    22182424function bp_activity_latest_update( $user_id = 0 ) {
     
    22242430         *
    22252431         * @since BuddyPress (1.2)
    2226          *
    2227          * @param int $user_id Defaults to 0
    22282432         *
    22292433         * @uses bp_is_user_inactive()
     
    22362440         * @uses apply_filters() To call the 'bp_get_activity_latest_update' hook
    22372441         *
    2238          * @return string|bool $latest_update The activity latest update link. False on failure
     2442         * @param int $user_id If empty, will fall back on displayed user.
     2443         * @return string|bool $latest_update The activity latest update link.
     2444         *         False on failure
    22392445         */
    22402446        function bp_get_activity_latest_update( $user_id = 0 ) {
     
    22562462
    22572463/**
    2258  * Display the activity filter links.
     2464 * Output the activity filter links.
    22592465 *
    22602466 * @since BuddyPress (1.1)
    22612467 *
    2262  * @param array $args Defaults to false
    2263  *
     2468 * @see bp_get_activity_filter_links() for description of parameters.
    22642469 * @uses bp_get_activity_filter_links()
     2470 *
     2471 * @param array $args See {@link bp_get_activity_filter_links()} for description.
    22652472 */
    22662473function bp_activity_filter_links( $args = false ) {
     
    22722479         *
    22732480         * @since BuddyPress (1.1)
    2274          *
    2275          * @param array $args Defaults to false
    22762481         *
    22772482         * @uses wp_parse_args()
     
    22802485         * @uses add_query_arg()
    22812486         * @uses remove_query_arg()
    2282          * @uses apply_filters() To call the 'bp_get_activity_filter_link_href' hook
    2283          * @uses apply_filters() To call the 'bp_get_activity_filter_links' hook
    2284          *
    2285          * @return string|bool $component_links The activity filter links. False on failure
     2487         * @uses apply_filters() To call the 'bp_get_activity_filter_link_href' hook.
     2488         * @uses apply_filters() To call the 'bp_get_activity_filter_links' hook.
     2489         *
     2490         * @param array $args {
     2491         *     @type string $style The type of markup to use for the links.
     2492         *           'list', 'paragraph', or 'span'. Default: 'list'.
     2493         * }
     2494         * @return string|bool $component_links The activity filter links.
     2495         *         False on failure.
    22862496         */
    22872497        function bp_get_activity_filter_links( $args = false ) {
     
    23502560
    23512561/**
    2352  * Determine if a comment can be made on an activity item
     2562 * Determine if a comment can be made on an activity item.
    23532563 *
    23542564 * @since BuddyPress (1.2)
     
    23562566 * @global object $activities_template {@link BP_Activity_Template}
    23572567 * @uses bp_get_activity_action_name()
    2358  * @uses apply_filters() To call the 'bp_activity_can_comment' hook
    2359  *
    2360  * @return bool $can_comment Defaults to true
     2568 * @uses apply_filters() To call the 'bp_activity_can_comment' hook.
     2569 *
     2570 * @return bool $can_comment True if item can receive comments.
    23612571 */
    23622572function bp_activity_can_comment() {
     
    23772587
    23782588/**
    2379  * Determine if a comment can be made on an activity reply item
     2589 * Determine if a comment can be made on an activity reply item.
     2590 *
     2591 * Defaults to true, but can be modified by plugins.
    23802592 *
    23812593 * @since BuddyPress (1.5)
    23822594 *
    2383  * @param object $comment Activity comment
    2384  *
    23852595 * @uses apply_filters() To call the 'bp_activity_can_comment_reply' hook
    23862596 *
    2387  * @return bool $can_comment Defaults to true
     2597 * @param object $comment Activity comment.
     2598 * @return bool $can_comment True if comment can receive comments.
    23882599 */
    23892600function bp_activity_can_comment_reply( $comment ) {
     
    23942605
    23952606/**
    2396  * Determine if an favorites are allowed
     2607 * Determine if an favorites are allowed.
     2608 *
     2609 * Defaults to true, but can be modified by plugins.
    23972610 *
    23982611 * @since BuddyPress (1.5)
    23992612 *
    2400  * @uses apply_filters() To call the 'bp_activity_can_favorite' hook
    2401  *
    2402  * @return bool $can_favorite Defaults to true
     2613 * @uses apply_filters() To call the 'bp_activity_can_favorite' hook.
     2614 *
     2615 * @return bool $can_favorite True if comment can receive comments.
    24032616 */
    24042617function bp_activity_can_favorite() {
     
    24092622
    24102623/**
    2411  * Echoes the total favorite count for a specified user
    2412  *
    2413  * @since BuddyPress (1.2)
    2414  *
    2415  * @param int $user_id Defaults to 0
    2416  *
     2624 * Output the total favorite count for a specified user.
     2625 *
     2626 * @since BuddyPress (1.2)
     2627 *
     2628 * @see bp_get_total_favorite_count_for_user() for description of parameters.
    24172629 * @uses bp_get_total_favorite_count_for_user()
     2630 *
     2631 * @param int $user_id See {@link bp_get_total_favorite_count_for_user()}.
    24182632 */
    24192633function bp_total_favorite_count_for_user( $user_id = 0 ) {
     
    24222636
    24232637        /**
    2424          * Returns the total favorite count for a specified user
    2425          *
    2426          * @since BuddyPress (1.2)
    2427          *
    2428          * @param int $user_id Defaults to 0
     2638         * Return the total favorite count for a specified user.
     2639         *
     2640         * @since BuddyPress (1.2)
    24292641         *
    24302642         * @uses bp_activity_total_favorites_for_user()
    24312643         * @uses apply_filters() To call the 'bp_get_total_favorite_count_for_user' hook
    24322644         *
    2433          * @return int The total favorite count for a specified user
     2645         * @param int $user_id ID of user being queried. Default: displayed user ID.
     2646         * @return int The total favorite count for the specified user.
    24342647         */
    24352648        function bp_get_total_favorite_count_for_user( $user_id = 0 ) {
     
    24422655
    24432656/**
    2444  * Echoes the total mention count for a specified user
    2445  *
    2446  * @since BuddyPress (1.2)
    2447  *
    2448  * @param int $user_id Defaults to 0
    2449  *
     2657 * Output the total mention count for a specified user.
     2658 *
     2659 * @since BuddyPress (1.2)
     2660 *
     2661 * @see bp_get_total_mention_count_for_user() for description of parameters.
    24502662 * @uses bp_get_total_favorite_count_for_user()
     2663 *
     2664 * @param int $user_id See {@link bp_get_total_mention_count_for_user()}.
    24512665 */
    24522666function bp_total_mention_count_for_user( $user_id = 0 ) {
     
    24552669
    24562670        /**
    2457          * Returns the total mention count for a specified user
    2458          *
    2459          * @since BuddyPress (1.2)
    2460          *
    2461          * @param int $user_id Defaults to 0
     2671         * Return the total mention count for a specified user.
     2672         *
     2673         * @since BuddyPress (1.2)
     2674         *
    24622675         * @uses bp_get_user_meta()
    2463          * @uses apply_filters() To call the 'bp_get_total_mention_count_for_user' hook
    2464          * @return int The total mention count for a specified user
     2676         * @uses apply_filters() To call the 'bp_get_total_mention_count_for_user' hook.
     2677         *
     2678         * @param int $user_id ID of user being queried. Default: displayed user ID.
     2679         * @return int The total mention count for the specified user.
    24652680         */
    24662681        function bp_get_total_mention_count_for_user( $user_id = 0 ) {
     
    24732688
    24742689/**
    2475  * Echoes the public message link for displayed user
     2690 * Output the public message link for displayed user.
    24762691 *
    24772692 * @since BuddyPress (1.2)
     
    24842699
    24852700        /**
    2486          * Returns the public message link for displayed user
     2701         * Return the public message link for the displayed user.
    24872702         *
    24882703         * @since BuddyPress (1.2)
     
    24972712         * @uses apply_filters() To call the 'bp_get_send_public_message_link' hook
    24982713         *
    2499          * @return string The public message link for displayed user
     2714         * @return string The public message link for the displayed user.
    25002715         */
    25012716        function bp_get_send_public_message_link() {
     
    25092724
    25102725/**
    2511  * Echoes the mentioned user display name
    2512  *
    2513  * @since BuddyPress (1.2)
    2514  *
    2515  * @param int|string User id or username
    2516  *
     2726 * Output the mentioned user display name.
     2727 *
     2728 * @since BuddyPress (1.2)
     2729 *
     2730 * @see bp_get_mentioned_user_display_name() for description of parameters.
    25172731 * @uses bp_get_mentioned_user_display_name()
     2732 *
     2733 * @param int|string $user_id_or_username See {@link bp_get_mentioned_user_display_name()}.
    25182734 */
    25192735function bp_mentioned_user_display_name( $user_id_or_username ) {
     
    25262742         * @since BuddyPress (1.2)
    25272743         *
    2528          * @param int|string User id or username
    2529          *
    25302744         * @uses bp_core_get_user_displayname()
    2531          * @uses apply_filters() To call the 'bp_get_mentioned_user_display_name' hook
    2532          *
    2533          * @return string The mentioned user display name
     2745         * @uses apply_filters() To call the 'bp_get_mentioned_user_display_name' hook.
     2746         *
     2747         * @param int|string User ID or username.
     2748         * @return string The mentioned user's display name.
    25342749         */
    25352750        function bp_get_mentioned_user_display_name( $user_id_or_username ) {
     
    25412756
    25422757/**
    2543  * Output button for sending a public message
    2544  *
    2545  * @since BuddyPress (1.2)
    2546  *
    2547  * @param array $args Optional
    2548  *
     2758 * Output button for sending a public message (an @-mention).
     2759 *
     2760 * @since BuddyPress (1.2)
     2761 *
     2762 * @see bp_get_send_public_message_button() for description of parameters.
    25492763 * @uses bp_get_send_public_message_button()
     2764 *
     2765 * @param array $args See {@link bp_get_send_public_message_button()}.
    25502766 */
    25512767function bp_send_public_message_button( $args = '' ) {
     
    25542770
    25552771        /**
    2556          * Return button for sending a public message
    2557          *
    2558          * @since BuddyPress (1.2)
    2559          *
    2560          * @param array $args Optional
     2772         * Return button for sending a public message (an @-mention).
     2773         *
     2774         * @since BuddyPress (1.2)
    25612775         *
    25622776         * @uses bp_get_send_public_message_link()
    25632777         * @uses wp_parse_args()
    25642778         * @uses bp_get_button()
    2565          * @uses apply_filters() To call the 'bp_get_send_public_message_button' hook
    2566          *
    2567          * @return string The button for sending a public message
     2779         * @uses apply_filters() To call the 'bp_get_send_public_message_button' hook.
     2780         *
     2781         * @param array $args {
     2782         *     All arguments are optional. See {@link BP_Button} for complete
     2783         *     descriptions.
     2784         *     @type string $id Default: 'public_message'.
     2785         *     @type string $component Default: 'activity'.
     2786         *     @type bool $must_be_logged_in Default: true.
     2787         *     @type bool $block_self Default: true.
     2788         *     @type string $wrapper_id Default: 'post-mention'.
     2789         *     @type string $link_href Default: the public message link for
     2790         *           the current member in the loop.
     2791         *     @type string $link_title Default: 'Send a public message on your
     2792         *           activity stream.'.
     2793         *     @type string $link_text Default: 'Public Message'.
     2794         *     @type string $link_class Default: 'activity-button mention'.
     2795         * }
     2796         * @return string The button for sending a public message.
    25682797         */
    25692798        function bp_get_send_public_message_button( $args = '' ) {
     
    25872816
    25882817/**
    2589  * Outputs the activity post form action
     2818 * Output the activity post form action.
    25902819 *
    25912820 * @since BuddyPress (1.2)
     
    25982827
    25992828        /**
    2600          * Returns the activity post form action
     2829         * Return the activity post form action.
    26012830         *
    26022831         * @since BuddyPress (1.2)
     
    26042833         * @uses home_url()
    26052834         * @uses bp_get_activity_root_slug()
    2606          * @uses apply_filters() To call the 'bp_get_activity_post_form_action' hook
    2607          *
    2608          * @return string The activity post form action
     2835         * @uses apply_filters() To call the 'bp_get_activity_post_form_action' hook.
     2836         *
     2837         * @return string The activity post form action.
    26092838         */
    26102839        function bp_get_activity_post_form_action() {
     
    26132842
    26142843/**
    2615  * Looks at all the activity comments on the current activity item, and prints the comments' authors's avatar wrapped in <LI> tags.
     2844 * Echo a list of linked avatars of users who have commented on the current activity item.
    26162845 *
    26172846 * Use this function to easily output activity comment authors' avatars.
    26182847 *
    2619  * @param array $args See {@link bp_core_fetch_avatar} for accepted values
     2848 * Avatars are wrapped in <li> elements, but you've got to provide your own
     2849 * <ul> or <ol> wrapper markup.
     2850 *
    26202851 * @since BuddyPress (1.7)
     2852 *
     2853 * @see bp_core_fetch_avatar() for a description of arguments.
     2854 *
     2855 * @param array $args See {@link bp_core_fetch_avatar()}.
    26212856 */
    26222857function bp_activity_comments_user_avatars( $args = array() ) {
     
    26462881
    26472882/**
    2648  * Returns the user IDs of everyone who's written an activity comment on the current activity item.
    2649  *
    2650  * @return bool|array Returns false if there is no current activity items
     2883 * Return the IDs of every user who's left a comment on the current activity item.
     2884 *
    26512885 * @since BuddyPress (1.7)
     2886 *
     2887 * @return bool|array An array of IDs, or false if none are found.
    26522888 */
    26532889function bp_activity_get_comments_user_ids() {
     
    26622898         * Recurse through all activity comments and collect the IDs of the users who wrote them.
    26632899         *
    2664          * @param array $comments Array of {@link BP_Activity_Activity} items
    2665          * @return array Array of user IDs
    26662900         * @since BuddyPress (1.7)
     2901         *
     2902         * @param array $comments Array of {@link BP_Activity_Activity} items.
     2903         * @return array Array of user IDs.
    26672904         */
    26682905        function bp_activity_recurse_comments_user_ids( array $comments ) {
     
    26862923
    26872924/**
    2688  * Renders a list of all the registered activity types for use in a <select> element, or as <input type="checkbox">.
    2689  *
    2690  * @param string $output Optional. Either 'select' or 'checkbox'. Defaults to select.
    2691  * @param string|array $args Optional extra arguments:
    2692  *  checkbox_name - Used when type=checkbox. Sets the item's name property.
    2693  *  selected      - Array of strings of activity types to mark as selected/checked.
     2925 * Echo a list of all registered activity types for use in dropdowns or checkbox lists.
     2926 *
    26942927 * @since BuddyPress (1.7)
     2928 *
     2929 * @param string $output Optional. Either 'select' or 'checkbox'. Default: 'select'.
     2930 * @param array $args {
     2931 *     Optional extra arguments.
     2932 *     @type string $checkbox_name When returning checkboxes, sets the 'name'
     2933 *           attribute.
     2934 *     @type array|string $selected A list of types that should be checked/
     2935 *           selected.
     2936 * }
    26952937 */
    26962938function bp_activity_types_list( $output = 'select', $args = '' ) {
     
    27302972
    27312973/**
    2732  * Outputs the sitewide activity feed link
     2974 * Output the sitewide activity feed link.
    27332975 *
    27342976 * @since BuddyPress (1.0)
     
    27412983
    27422984        /**
    2743          * Returns the sitewide activity feed link
     2985         * Returns the sitewide activity feed link.
    27442986         *
    27452987         * @since BuddyPress (1.0)
     
    27472989         * @uses home_url()
    27482990         * @uses bp_get_activity_root_slug()
    2749          * @uses apply_filters() To call the 'bp_get_sitewide_activity_feed_link' hook
    2750          *
    2751          * @return string The sitewide activity feed link
     2991         * @uses apply_filters() To call the 'bp_get_sitewide_activity_feed_link' hook.
     2992         *
     2993         * @return string The sitewide activity feed link.
    27522994         */
    27532995        function bp_get_sitewide_activity_feed_link() {
     
    27562998
    27572999/**
    2758  * Outputs the member activity feed link
     3000 * Output the member activity feed link.
    27593001 *
    27603002 * @since BuddyPress (1.2)
     
    27673009
    27683010/**
    2769  * Outputs the member activity feed link
     3011 * Output the member activity feed link.
    27703012 *
    27713013 * @since BuddyPress (1.0)
    27723014 * @deprecated BuddyPress (1.2)
    27733015 *
    2774  * @todo properly deprecated in favor of bp_member_activity_feed_link()
     3016 * @todo properly deprecate in favor of bp_member_activity_feed_link().
    27753017 *
    27763018 * @uses bp_get_member_activity_feed_link()
     
    27793021
    27803022        /**
    2781          * Returns the member activity feed link
     3023         * Return the member activity feed link.
    27823024         *
    27833025         * @since BuddyPress (1.2)
     
    27903032         * @uses bp_get_friends_slug()
    27913033         * @uses bp_get_groups_slug()
    2792          * @uses apply_filters() To call the 'bp_get_activities_member_rss_link' hook
    2793          *
    2794          * @return string $link The member activity feed link
     3034         * @uses apply_filters() To call the 'bp_get_activities_member_rss_link' hook.
     3035         *
     3036         * @return string $link The member activity feed link.
    27953037         */
    27963038        function bp_get_member_activity_feed_link() {
     
    28133055
    28143056        /**
    2815          * Returns the member activity feed link
     3057         * Return the member activity feed link.
    28163058         *
    28173059         * @since BuddyPress (1.0)
    28183060         * @deprecated BuddyPress (1.2)
    28193061         *
    2820          * @todo properly deprecated in favor of bp_get_member_activity_feed_link()
     3062         * @todo properly deprecate in favor of bp_get_member_activity_feed_link().
    28213063         *
    28223064         * @uses bp_get_member_activity_feed_link()
    28233065         *
    2824          * @return string The member activity feed link
     3066         * @return string The member activity feed link.
    28253067         */
    28263068        function bp_get_activities_member_rss_link() { return bp_get_member_activity_feed_link(); }
     
    28303072
    28313073/**
    2832  * Outputs the activity feed item guid
     3074 * Outputs the activity feed item guid.
    28333075 *
    28343076 * @since BuddyPress (1.0)
     
    28413083
    28423084        /**
    2843          * Returns the activity feed item guid
    2844          *
    2845          * @since BuddyPress (1.2)
    2846          *
    2847          * @global object $activities_template {@link BP_Activity_Template}
    2848          * @uses apply_filters() To call the 'bp_get_activity_feed_item_guid' hook
    2849          *
    2850          * @return string The activity feed item guid
     3085         * Returns the activity feed item guid.
     3086         *
     3087         * @since BuddyPress (1.2)
     3088         *
     3089         * @global object $activities_template {@link BP_Activity_Template}
     3090         * @uses apply_filters() To call the 'bp_get_activity_feed_item_guid' hook.
     3091         *
     3092         * @return string The activity feed item guid.
    28513093         */
    28523094        function bp_get_activity_feed_item_guid() {
     
    28573099
    28583100/**
    2859  * Outputs the activity feed item title
     3101 * Output the activity feed item title.
    28603102 *
    28613103 * @since BuddyPress (1.0)
     
    28683110
    28693111        /**
    2870          * Returns the activity feed item title
     3112         * Return the activity feed item title.
    28713113         *
    28723114         * @since BuddyPress (1.0)
     
    28763118         * @uses convert_chars()
    28773119         * @uses bp_create_excerpt()
    2878          * @uses apply_filters() To call the 'bp_get_activity_feed_item_title' hook
    2879          *
    2880          * @return string $title The activity feed item title
     3120         * @uses apply_filters() To call the 'bp_get_activity_feed_item_title' hook.
     3121         *
     3122         * @return string $title The activity feed item title.
    28813123         */
    28823124        function bp_get_activity_feed_item_title() {
     
    29013143
    29023144/**
    2903  * Outputs the activity feed item link
     3145 * Output the activity feed item link
    29043146 *
    29053147 * @since BuddyPress (1.0)
     
    29123154
    29133155        /**
    2914          * Returns the activity feed item link
     3156         * Return the activity feed item link
    29153157         *
    29163158         * @since BuddyPress (1.0)
    29173159         *
    29183160         * @global object $activities_template {@link BP_Activity_Template}
    2919          * @uses apply_filters() To call the 'bp_get_activity_feed_item_link' hook
    2920          *
    2921          * @return string The activity feed item link
     3161         * @uses apply_filters() To call the 'bp_get_activity_feed_item_link' hook.
     3162         *
     3163         * @return string The activity feed item link.
    29223164         */
    29233165        function bp_get_activity_feed_item_link() {
     
    29283170
    29293171/**
    2930  * Outputs the activity feed item date
     3172 * Output the activity feed item date.
    29313173 *
    29323174 * @since BuddyPress (1.0)
     
    29393181
    29403182        /**
    2941          * Returns the activity feed item date
     3183         * Return the activity feed item date.
    29423184         *
    29433185         * @since BuddyPress (1.0)
    29443186         *
    29453187         * @global object $activities_template {@link BP_Activity_Template}
    2946          * @uses apply_filters() To call the 'bp_get_activity_feed_item_date' hook
    2947          *
    2948          * @return string The activity feed item date
     3188         * @uses apply_filters() To call the 'bp_get_activity_feed_item_date' hook.
     3189         *
     3190         * @return string The activity feed item date.
    29493191         */
    29503192        function bp_get_activity_feed_item_date() {
     
    29553197
    29563198/**
    2957  * Outputs the activity feed item description
     3199 * Output the activity feed item description.
    29583200 *
    29593201 * @since BuddyPress (1.0)
     
    29663208
    29673209        /**
    2968          * Returns the activity feed item description
     3210         * Return the activity feed item description.
    29693211         *
    29703212         * @since BuddyPress (1.0)
     
    29733215         * @uses ent2ncr()
    29743216         * @uses convert_chars()
    2975          * @uses apply_filters() To call the 'bp_get_activity_feed_item_description' hook
    2976          *
    2977          * @return string The activity feed item description
     3217         * @uses apply_filters() To call the 'bp_get_activity_feed_item_description' hook.
     3218         *
     3219         * @return string The activity feed item description.
    29783220         */
    29793221        function bp_get_activity_feed_item_description() {
     
    29883230
    29893231/**
    2990  * Template tag so we can hook activity feed to <head>
     3232 * Template tag so we can hook activity feed to <head>.
    29913233 *
    29923234 * @since BuddyPress (1.5)
Note: See TracChangeset for help on using the changeset viewer.