Skip to:
Content

BuddyPress.org

Changeset 7405


Ignore:
Timestamp:
10/10/2013 01:33:46 PM (11 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.