Skip to:
Content

BuddyPress.org

Changeset 7429


Ignore:
Timestamp:
10/15/2013 03:07:46 AM (10 years ago)
Author:
boonebgorges
Message:

Improve inline docs in bp-blogs-template.php

See #5022

File:
1 edited

Legend:

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

    r7345 r7429  
    22
    33/**
    4  * BuddyPress Blogs Template Tags
     4 * BuddyPress Blogs Template Tags.
    55 *
    66 * @package BuddyPress
     
    1212
    1313/**
    14  * Output the blogs component slug
    15  *
    16  * @package BuddyPress
    17  * @subpackage BlogsTemplate
     14 * Output the blogs component slug.
     15 *
    1816 * @since BuddyPress (1.5)
    1917 *
     
    2422}
    2523    /**
    26      * Return the blogs component slug
    27      *
    28      * @package BuddyPress
    29      * @subpackage BlogsTemplate
     24     * Return the blogs component slug.
     25     *
    3026     * @since BuddyPress (1.5)
     27     *
     28     * @return string The 'blogs' slug.
    3129     */
    3230    function bp_get_blogs_slug() {
     
    3533
    3634/**
    37  * Output the blogs component root slug
    38  *
    39  * @package BuddyPress
    40  * @subpackage BlogsTemplate
     35 * Output the blogs component root slug.
     36 *
    4137 * @since BuddyPress (1.5)
    4238 *
     
    4743}
    4844    /**
    49      * Return the blogs component root slug
    50      *
    51      * @package BuddyPress
    52      * @subpackage BlogsTemplate
     45     * Return the blogs component root slug.
     46     *
    5347     * @since BuddyPress (1.5)
     48     *
     49     * @return string The 'blogs' root slug.
    5450     */
    5551    function bp_get_blogs_root_slug() {
     
    5854
    5955/**
    60  * Output blog directory permalink
    61  *
    62  * @package BuddyPress
    63  * @subpackage BlogsTemplate
     56 * Output blog directory permalink.
     57 *
    6458 * @since BuddyPress (1.5)
     59 *
    6560 * @uses bp_get_blogs_directory_permalink()
    6661 */
     
    6964}
    7065    /**
    71      * Return blog directory permalink
    72      *
    73      * @package BuddyPress
    74      * @subpackage BlogsTemplate
     66     * Return blog directory permalink.
     67     *
    7568     * @since BuddyPress (1.5)
     69     *
    7670     * @uses apply_filters()
    77      * @uses traisingslashit()
     71     * @uses trailingslashit()
    7872     * @uses bp_get_root_domain()
    7973     * @uses bp_get_blogs_root_slug()
    80      * @return string
     74     * @return string The URL of the Blogs directory.
    8175     */
    8276    function bp_get_blogs_directory_permalink() {
     
    8478    }
    8579
    86 /**********************************************************************
    87  * Blog listing template class.
    88  */
    89 
     80/**
     81 * The main blog template loop class.
     82 *
     83 * Responsible for loading a group of blogs into a loop for display.
     84 */
    9085class BP_Blogs_Template {
     86    /**
     87     * The loop iterator.
     88     *
     89     * @access public
     90     * @var int
     91     */
    9192    var $current_blog = -1;
     93
     94    /**
     95     * The number of blogs returned by the paged query.
     96     *
     97     * @access public
     98     * @var int
     99     */
    92100    var $blog_count;
     101
     102    /**
     103     * Array of blogs located by the query..
     104     *
     105     * @access public
     106     * @var array
     107     */
    93108    var $blogs;
     109
     110    /**
     111     * The blog object currently being iterated on.
     112     *
     113     * @access public
     114     * @var object
     115     */
    94116    var $blog;
    95117
     118    /**
     119     * A flag for whether the loop is currently being iterated.
     120     *
     121     * @access public
     122     * @var bool
     123     */
    96124    var $in_the_loop;
    97125
     126    /**
     127     * The page number being requested.
     128     *
     129     * @access public
     130     * @var public
     131     */
    98132    var $pag_page;
     133
     134    /**
     135     * The number of items being requested per page.
     136     *
     137     * @access public
     138     * @var public
     139     */
    99140    var $pag_num;
     141
     142    /**
     143     * An HTML string containing pagination links.
     144     *
     145     * @access public
     146     * @var string
     147     */
    100148    var $pag_links;
     149
     150    /**
     151     * The total number of blogs matching the query parameters.
     152     *
     153     * @access public
     154     * @var int
     155     */
    101156    var $total_blog_count;
    102157
     158    /**
     159     * Constructor method.
     160     *
     161     * @see BP_Blogs_Blog::get() for a description of parameters.
     162     *
     163     * @param string $type See {@link BP_Blogs_Blog::get()}.
     164     * @param string $page See {@link BP_Blogs_Blog::get()}.
     165     * @param string $per_page See {@link BP_Blogs_Blog::get()}.
     166     * @param string $max See {@link BP_Blogs_Blog::get()}.
     167     * @param string $user_id See {@link BP_Blogs_Blog::get()}.
     168     * @param string $search_terms See {@link BP_Blogs_Blog::get()}.
     169     * @param string $page_arg The string used as a query parameter in
     170     *        pagination links. Default: 'bpage'.
     171     */
    103172    function __construct( $type, $page, $per_page, $max, $user_id, $search_terms, $page_arg = 'bpage' ) {
    104173
     
    141210    }
    142211
     212    /**
     213     * Whether there are blogs available in the loop.
     214     *
     215     * @see bp_has_blogs()
     216     *
     217     * @return bool True if there are items in the loop, otherwise false.
     218     */
    143219    function has_blogs() {
    144220        if ( $this->blog_count )
     
    148224    }
    149225
     226    /**
     227     * Set up the next blog and iterate index.
     228     *
     229     * @return object The next blog to iterate over.
     230     */
    150231    function next_blog() {
    151232        $this->current_blog++;
     
    155236    }
    156237
     238    /**
     239     * Rewind the blogs and reset blog index.
     240     */
    157241    function rewind_blogs() {
    158242        $this->current_blog = -1;
     
    162246    }
    163247
     248    /**
     249     * Whether there are blogs left in the loop to iterate over.
     250     *
     251     * This method is used by {@link bp_blogs()} as part of the while loop
     252     * that controls iteration inside the blogs loop, eg:
     253     *     while ( bp_blogs() ) { ...
     254     *
     255     * @see bp_blogs()
     256     *
     257     * @return bool True if there are more blogs to show, otherwise false.
     258     */
    164259    function blogs() {
    165260        if ( $this->current_blog + 1 < $this->blog_count ) {
     
    175270    }
    176271
     272    /**
     273     * Set up the current blog inside the loop.
     274     *
     275     * Used by {@link bp_the_blog()} to set up the current blog data while
     276     * looping, so that template tags used during that iteration make
     277     * reference to the current blog.
     278     *
     279     * @see bp_the_blog()
     280     */
    177281    function the_blog() {
    178282
     
    185289}
    186290
     291/**
     292 * Rewind the blogs and reset blog index.
     293 */
    187294function bp_rewind_blogs() {
    188295    global $blogs_template;
     
    191298}
    192299
     300/**
     301 * Initialize the activity loop.
     302 *
     303 * Based on the $args passed, bp_has_blogs() populates the $blogs_template
     304 * global, enabling the use of BuddyPress templates and template functions to
     305 * display a list of activity items.
     306 *
     307 * @global object $blogs_template {@link BP_Blogs_Template}
     308 *
     309 * @param array $args {
     310 *     Arguments for limiting the contents of the blogs loop. Most arguments
     311 *     are in the same format as {@link BP_Blogs_Blog::get()}. However, because
     312 *     the format of the arguments accepted here differs in a number of ways,
     313 *     and because bp_has_blogs() determines some default arguments in a
     314 *     dynamic fashion, we list all accepted arguments here as well.
     315 *
     316 *     Arguments can be passed as an associative array, or as a URL query
     317 *     string (eg, 'user_id=4&per_page=3').
     318 *
     319 *     @type int $page Which page of results to fetch. Using page=1 without
     320 *           per_page will result in no pagination. Default: 1.
     321 *     @type int|bool $per_page Number of results per page. Default: 20.
     322 *     @type string $page_arg The string used as a query parameter in
     323 *           pagination links. Default: 'bpage'.
     324 *     @type int|bool $max Maximum number of results to return.
     325 *           Default: false (unlimited).
     326 *     @type string $type The order in which results should be fetched.
     327         'active', 'alphabetical', 'newest', or 'random'.
     328 *     @type string $sort 'ASC' or 'DESC'. Default: 'DESC'.
     329 *     @type string $search_terms Limit results by a search term. Default: null.
     330 *     @type int $user_id The ID of the user whose blogs should be retrieved.
     331 *           When viewing a user profile page, 'user_id' defaults to the ID of
     332 *           the displayed user. Otherwise the default is false.
     333 * }
     334 * @return bool Returns true when blogs are found, otherwise false.
     335 */
    193336function bp_has_blogs( $args = '' ) {
    194337    global $blogs_template;
     
    239382}
    240383
     384/**
     385 * Determine if there are still blogs left in the loop.
     386 *
     387 * @global object $blogs_template {@link BP_Blogs_Template}
     388 *
     389 * @return bool Returns true when blogs are found.
     390 */
    241391function bp_blogs() {
    242392    global $blogs_template;
     
    245395}
    246396
     397/**
     398 * Get the current blog object in the loop.
     399 *
     400 * @global object $blogs_template {@link BP_Blogs_Template}
     401 *
     402 * @return object The current blog within the loop.
     403 */
    247404function bp_the_blog() {
    248405    global $blogs_template;
     
    251408}
    252409
     410/**
     411 * Output the blogs pagination count.
     412 *
     413 * @global object $blogs_template {@link BP_Blogs_Template}
     414 */
    253415function bp_blogs_pagination_count() {
    254416    global $blogs_template;
     
    262424}
    263425
     426/**
     427 * Output the blogs pagination links.
     428 */
    264429function bp_blogs_pagination_links() {
    265430    echo bp_get_blogs_pagination_links();
    266431}
     432    /**
     433     * Return the blogs pagination links.
     434     *
     435     * @global object $blogs_template {@link BP_Blogs_Template}
     436     *
     437     * @return string HTML pagination links.
     438     */
    267439    function bp_get_blogs_pagination_links() {
    268440        global $blogs_template;
     
    271443    }
    272444
     445/**
     446 * Output a blog's avatar.
     447 *
     448 * @see bp_get_blog_avatar() for description of arguments.
     449 *
     450 * @param array $args See {@link bp_get_blog_avatar()}.
     451 */
    273452function bp_blog_avatar( $args = '' ) {
    274453    echo bp_get_blog_avatar( $args );
    275454}
     455    /**
     456     * Get a blog's avatar.
     457     *
     458     * At the moment, blog avatars are simply the user avatars of the blog
     459     * admin. Filter 'bp_get_blog_avatar_' . $blog_id to customize.
     460     *
     461     * @see bp_core_fetch_avatar() For a description of arguments and
     462     *      return values.
     463     *
     464     * @param array $args  {
     465     *     Arguments are listed here with an explanation of their defaults.
     466     *     For more information about the arguments, see
     467     *     {@link bp_core_fetch_avatar()}.
     468     *     @type string $alt Default: 'Profile picture of site author
     469     *           [user name]'.
     470     *     @type string $class Default: 'avatar'.
     471     *     @type string $type Default: 'full'.
     472     *     @type int|bool $width Default: false.
     473     *     @type int|bool $height Default: false.
     474     *     @type bool $id Currently unused.
     475     *     @type bool $no_grav Default: false.
     476     * }
     477     * @return string User avatar string.
     478     */
    276479    function bp_get_blog_avatar( $args = '' ) {
    277480        global $blogs_template;
     
    322525    }
    323526
     527/**
     528 * Output the name of the current blog in the loop.
     529 */
    324530function bp_blog_name() {
    325531    echo bp_get_blog_name();
    326532}
     533    /**
     534     * Return the name of the current blog in the loop.
     535     *
     536     * @return string The name of the current blog in the loop.
     537     */
    327538    function bp_get_blog_name() {
    328539        global $blogs_template;
     
    332543
    333544/**
    334  * Outputs the blog ID
     545 * Output the ID of the current blog in the loop.
    335546 *
    336547 * @since BuddyPress (1.7)
     
    340551}
    341552    /**
    342      * Returns the blog ID
    343      *
    344      * @return int
     553     * Return the ID of the current blog in the loop.
     554     *
    345555     * @since BuddyPress (1.7)
     556     *
     557     * @return int ID of the current blog in the loop.
    346558     */
    347559    function bp_get_blog_id() {
     
    351563    }
    352564
     565/**
     566 * Output the description of the current blog in the loop.
     567 */
    353568function bp_blog_description() {
    354569    echo apply_filters( 'bp_blog_description', bp_get_blog_description() );
    355570}
     571    /**
     572     * Return the description of the current blog in the loop.
     573     *
     574     * @return string Description of the current blog in the loop.
     575     */
    356576    function bp_get_blog_description() {
    357577        global $blogs_template;
     
    360580    }
    361581
    362 
    363 /**
    364  * Output the row class of a site
     582/**
     583 * Output the row class of the current blog in the loop.
    365584 *
    366585 * @since BuddyPress (1.7)
     
    370589}
    371590    /**
    372      * Return the row class of a site
     591     * Return the row class of the current blog in the loop.
     592     *
     593     * @since BuddyPress (1.7)
    373594     *
    374595     * @global BP_Blogs_Template $blogs_template
    375      * @return string Row class of the site
    376      * @since BuddyPress (1.7)
     596     *
     597     * @return string Row class of the site.
    377598     */
    378599    function bp_get_blog_class() {
     
    395616    }
    396617
     618/**
     619 * Output the last active date of the current blog in the loop.
     620 */
    397621function bp_blog_last_active() {
    398622    echo bp_get_blog_last_active();
    399623}
     624    /**
     625     * Return the last active date of the current blog in the loop.
     626     *
     627     * @return string Last active date.
     628     */
    400629    function bp_get_blog_last_active() {
    401630        global $blogs_template;
     
    404633    }
    405634
     635/**
     636 * Output the latest post from the current blog in the loop.
     637 */
    406638function bp_blog_latest_post() {
    407639    echo bp_get_blog_latest_post();
    408640}
     641    /**
     642     * Return the latest post from the current blog in the loop.
     643     *
     644     * @return string $retval String of the form 'Latest Post: [link to post]'.
     645     */
    409646    function bp_get_blog_latest_post() {
    410647        global $blogs_template;
     
    419656
    420657/**
    421  * Prints this site's latest article's title
     658 * Output the title of the latest post on the current blog in the loop.
    422659 *
    423660 * @since BuddyPress (1.7)
     
    429666}
    430667    /**
    431      * Returns this site's latest article's title
     668     * Return the title of the latest post on the current blog in the loop.
    432669     *
    433670     * @since BuddyPress (1.7)
    434671     *
    435672     * @global BP_Blogs_Template
    436      * @return string
     673     *
     674     * @return string Post title.
    437675     */
    438676    function bp_get_blog_latest_post_title() {
     
    448686
    449687/**
    450  * Prints this site's latest article's permalink
     688 * Output the permalink of the latest post on the current blog in the loop.
     689 *
     690 * @since BuddyPress (1.7)
    451691 *
    452692 * @see bp_get_blog_latest_post_title()
    453  * @since BuddyPress (1.7)
    454693 */
    455694function bp_blog_latest_post_permalink() {
     
    457696}
    458697    /**
    459      * Returns this site's latest article's permalink
     698     * Return the permalink of the latest post on the current blog in the loop.
     699     *
     700     * @since BuddyPress (1.7)
    460701     *
    461702     * @global BP_Blogs_Template
    462      * @return string
    463      * @since BuddyPress (1.7)
     703     *
     704     * @return string URL of the blog's latest post.
    464705     */
    465706    function bp_get_blog_latest_post_permalink() {
     
    475716
    476717/**
    477  * Prints this site's latest article's content
     718 * Output the content of the latest post on the current blog in the loop.
    478719 *
    479720 * @since BuddyPress (1.7)
     
    485726}
    486727    /**
    487      * Returns this site's latest article's content
     728     * Return the content of the latest post on the current blog in the loop.
    488729     *
    489730     * @since BuddyPress (1.7)
    490731     *
    491732     * @global BP_Blogs_Template
    492      * @return string
     733     *
     734     * @return string Content of the blog's latest post.
    493735     */
    494736    function bp_get_blog_latest_post_content() {
     
    504746
    505747/**
    506  * Prints this site's latest article's featured image
     748 * Output the featured image of the latest post on the current blog in the loop.
    507749 *
    508750 * @since BuddyPress (1.7)
    509751 *
    510  * @param string $size Image version to return. Either "thumbnail", "medium", "large", "post-thumbnail".
    511  * @see bp_get_blog_latest_post_content()
     752 * @see bp_get_blog_latest_post_content() For description of parameters.
     753 *
     754 * @param string $size See {@link bp_get_blog_latest_post_featured_image()}.
    512755 */
    513756function bp_blog_latest_post_featured_image( $size = 'thumbnail' ) {
     
    515758}
    516759    /**
    517      * Returns this site's latest article's featured image
     760     * Return the featured image of the latest post on the current blog in the loop.
    518761     *
    519762     * @since BuddyPress (1.7)
    520763     *
    521764     * @global BP_Blogs_Template
    522      * @param string $size Image version to return. Either "thumbnail", "medium", "large", "post-thumbnail".
    523      * @return string
     765     *
     766     * @param string $size Image version to return. 'thumbnail', 'medium',
     767     *        'large', or 'post-thumbnail'. Default: 'thumbnail'.
     768     * @return string URL of the image.
    524769     */
    525770    function bp_get_blog_latest_post_featured_image( $size = 'thumbnail' ) {
     
    537782 * Does the latest blog post have a featured image?
    538783 *
    539  * @param string $size Image version to check for. Either "thumbnail", "medium", "large", "post-thumbnail".
    540  * @return bool
    541784 * @since BuddyPress (1.7)
     785 *
     786 * @param string $size Image version to return. 'thumbnail', 'medium', 'large',
     787 *        or 'post-thumbnail'. Default: 'thumbnail'.
     788 * @return bool True if the latest blog post from the current blog has a
     789 *         featured image of the given size.
    542790 */
    543791function bp_blog_latest_post_has_featured_image( $thumbnail = 'thumbnail' ) {
     
    547795}
    548796
     797/**
     798 * Output hidden fields to help with form submissions in Sites directory.
     799 *
     800 * This function detects whether 's', 'letter', or 'blogs_search' requests are
     801 * currently being made (as in a URL parameter), and creates corresponding
     802 * hidden fields.
     803 */
    549804function bp_blog_hidden_fields() {
    550805    if ( isset( $_REQUEST['s'] ) )
     
    558813}
    559814
     815/**
     816 * Output the total number of blogs on the site.
     817 */
    560818function bp_total_blog_count() {
    561819    echo bp_get_total_blog_count();
    562820}
     821    /**
     822     * Return the total number of blogs on the site.
     823     *
     824     * @return int Total number of blogs.
     825     */
    563826    function bp_get_total_blog_count() {
    564827        return apply_filters( 'bp_get_total_blog_count', bp_blogs_total_blogs() );
     
    566829    add_filter( 'bp_get_total_blog_count', 'bp_core_number_format' );
    567830
     831/**
     832 * Output the total number of blogs for a given user.
     833 *
     834 * @param int $user_id ID of the user.
     835 */
    568836function bp_total_blog_count_for_user( $user_id = 0 ) {
    569837    echo bp_get_total_blog_count_for_user( $user_id );
    570838}
     839    /**
     840     * Return the total number of blogs for a given user.
     841     *
     842     * @param int $user_id ID of the user.
     843     * @return int Total number of blogs for the user.
     844     */
    571845    function bp_get_total_blog_count_for_user( $user_id = 0 ) {
    572846        return apply_filters( 'bp_get_total_blog_count_for_user', bp_blogs_total_blogs_for_user( $user_id ) );
     
    575849
    576850
    577 /* Blog registration template tags */
    578 
     851/** Blog Registration ********************************************************/
     852
     853/**
     854 * Checks whether blog creation is enabled.
     855 *
     856 * Returns true when blog creation is enabled for logged-in users only, or
     857 * when it's enabled for new registrations.
     858 *
     859 * @return bool True if blog registration is enabled.
     860 */
    579861function bp_blog_signup_enabled() {
    580862    global $bp;
     
    590872}
    591873
     874/**
     875 * Output the wrapper markup for the blog signup form.
     876 *
     877 * @param string $blogname Optional. The default blog name (path or domain).
     878 * @param string $blog_title Optional. The default blog title.
     879 * @param string|WP_Error Optional. The WP_Error object returned by a previous
     880 *        submission attempt.
     881 */
    592882function bp_show_blog_signup_form($blogname = '', $blog_title = '', $errors = '') {
    593883    global $current_user;
     
    630920}
    631921
     922/**
     923 * Output the input fields for the blog creation form.
     924 *
     925 * @param string $blogname Optional. The default blog name (path or domain).
     926 * @param string $blog_title Optional. The default blog title.
     927 * @param string|WP_Error Optional. The WP_Error object returned by a previous
     928 *        submission attempt.
     929 */
    632930function bp_blogs_signup_blog( $blogname = '', $blog_title = '', $errors = '' ) {
    633931    global $current_site;
     
    694992
    695993/**
    696  * Echo the value of bp_blogs_get_subdomain_base()
     994 * Output the base URL for subdomain installations of WordPress Multisite.
    697995 *
    698996 * @since BuddyPress (1.6)
     
    7021000}
    7031001    /**
    704      * Return the base URL to be displayed when a user chooses an address for a new blog, on
    705      * a subdomain installation of WordPress MS
     1002     * Return the base URL for subdomain installations of WordPress Multisite.
    7061003     *
    7071004     * @since BuddyPress (1.6)
    708      * @return string The base URL - eg, 'example.com' for site_url() example.com or www.example.com
     1005     *
     1006     * @return string The base URL - eg, 'example.com' for site_url() example.com or www.example.com.
    7091007     */
    7101008    function bp_blogs_get_subdomain_base() {
     
    7141012    }
    7151013
     1014/**
     1015 * Process a blog registration submission.
     1016 *
     1017 * Passes submitted values to {@link wpmu_create_blog()}.
     1018 *
     1019 * @return bool True on success, false on failure.
     1020 */
    7161021function bp_blogs_validate_blog_signup() {
    7171022    global $wpdb, $current_user, $blogname, $blog_title, $errors, $domain, $path, $current_site;
     
    7481053}
    7491054
     1055/**
     1056 * Validate a blog creation submission.
     1057 *
     1058 * Essentially, a wrapper for {@link wpmu_validate_blog_signup()}.
     1059 *
     1060 * @return array Contains the new site data and error messages.
     1061 */
    7501062function bp_blogs_validate_blog_form() {
    7511063    $user = '';
     
    7561068}
    7571069
     1070/**
     1071 * Display a message after successful blog registration.
     1072 *
     1073 * @param string $domain The new blog's domain.
     1074 * @param string $path The new blog's path.
     1075 * @param string $blog_title The new blog's title.
     1076 * @param string $user_name The user name of the user who created the blog. Unused.
     1077 * @param string $user_email The email of the user who created the blog. Unused.
     1078 * @param string|array $meta Meta values associated with the new blog. Unused.
     1079 */
    7581080function bp_blogs_confirm_blog_signup( $domain, $path, $blog_title, $user_name, $user_email = '', $meta = '' ) {
    7591081    $protocol = is_ssl() ? 'https://' : 'http://';
     
    7691091}
    7701092
     1093/**
     1094 * Output a "Create a Site" link for users viewing their own profiles.
     1095 */
    7711096function bp_create_blog_link() {
    7721097    if ( bp_is_my_profile() )
     
    7741099}
    7751100
     1101/**
     1102 * Output navigation tabs for a user Blogs page.
     1103 *
     1104 * Currently unused by BuddyPress.
     1105 */
    7761106function bp_blogs_blog_tabs() {
    7771107
     
    7931123
    7941124/**
    795  * Echoes the blog directory search form
     1125 * Output the blog directory search form.
    7961126 */
    7971127function bp_directory_blogs_search_form() {
     
    8081138
    8091139/**
    810  * bp_blogs_visit_blog_button()
    811  *
    812  * Output button for visiting a blog in a loop
    813  *
    814  * @param array $args Custom button properties
     1140 * Output button for visiting a blog in a loop.
     1141 *
     1142 * @see bp_get_blogs_visit_blog_button() for description of arguments.
     1143 *
     1144 * @param array $args See {@link bp_get_blogs_visit_blog_button()}.
    8151145 */
    8161146function bp_blogs_visit_blog_button( $args = '' ) {
     
    8181148}
    8191149    /**
    820      * bp_get_blogs_visit_blog_button()
    821      *
    822      * Return button for visiting a blog in a loop
    823      *
    824      * @param array $args Custom button properties
    825      * @return string
     1150     * Return button for visiting a blog in a loop.
     1151     *
     1152     * @see BP_Button for a complete description of arguments and return
     1153     *      value.
     1154     *
     1155     * @param array $args {
     1156     *     Arguments are listed below, with their default values. For a
     1157     *     complete description of arguments, see {@link BP_Button}.
     1158     *     @type string $id Default: 'visit_blog'.
     1159     *     @type string $component Default: 'blogs'.
     1160     *     @type bool $must_be_logged_in Default: false.
     1161     *     @type bool $block_self Default: false.
     1162     *     @type string $wrapper_class Default: 'blog-button visit'.
     1163     *     @type string $link_href Permalink of the current blog in the loop.
     1164     *     @type string $link_class Default: 'blog-button visit'.
     1165     *     @type string $link_text Default: 'Visit Site'.
     1166     *     @type string $link_title Default: 'Visit Site'.
     1167     * }
     1168     * @return string The HTML for the Visit button.
    8261169     */
    8271170    function bp_get_blogs_visit_blog_button( $args = '' ) {
Note: See TracChangeset for help on using the changeset viewer.