Blogs Loop

NOTE: This will only work with an installation of BuddyPress and WordPress MU or WordPress with multisite enabled.

The site blogs loop can be used to output a list of blogs that have been created on your installation.

Standard Loop Standard Loop

[sourcecode language=”php”]
<?php if ( bp_has_blogs() ) : ?>

<div class="pagination">

<div class="pag-count" id="blog-dir-count">
<?php bp_blogs_pagination_count() ?>
</div>

<div class="pagination-links" id="blog-dir-pag">
<?php bp_blogs_pagination_links() ?>
</div>

</div>

<ul id="blogs-list" class="item-list">
<?php while ( bp_blogs() ) : bp_the_blog(); ?>

<li>
<div class="item-avatar">
<a href="<?php bp_blog_permalink() ?>"><?php bp_blog_avatar(‘type=thumb’) ?></a>
</div>

<div class="item">
<div class="item-title"><a href="<?php bp_blog_permalink() ?>"><?php bp_blog_name() ?></a></div>
<div class="item-meta"><span class="activity"><?php bp_blog_last_active() ?></span></div>

<?php do_action( ‘bp_directory_blogs_item’ ) ?>
</div>

<div class="action">
<div class="generic-button blog-button visit">
<a href="<?php bp_blog_permalink() ?>" class="visit" title="<?php _e( ‘Visit Blog’, ‘buddypress’ ) ?>"><?php _e( ‘Visit Blog’, ‘buddypress’ ) ?></a>
</div>

<div class="meta">
<?php bp_blog_latest_post() ?>
</div>

<?php do_action( ‘bp_directory_blogs_actions’ ) ?>
</div>

<div class="clear"></div>
</li>

<?php endwhile; ?>
</ul>

<?php do_action( ‘bp_after_directory_blogs_list’ ) ?>

<?php bp_blog_hidden_fields() ?>

<?php else: ?>

<div id="message" class="info">
<p><?php _e( ‘Sorry, there were no blogs found.’, ‘buddypress’ ) ?></p>
</div>

<?php endif; ?>

[/sourcecode]

Top ↑

Accepted Parameters Accepted Parameters

The bp_has_blogs() function will accept a number of parameters that will manipulate the data being returned.

  • type optional

    Defines the type of blogs to return.

    • Accepted arguments: active, newest, random
    • Default value: active
  • per_page optional

    The number of blogs to display on a page before they are paginated to the next page.

    • Default value: 10
  • page optional

    The page to return.

    • Default value: 1
  • max optional

    The total number of blogs to return.

    • Default value: false (no limit)
  • user_id optional

    Return only blogs that this user has higher than subscriber access to.

    • Default value: false
  • search_terms optional

    Return only blogs that match these search terms.

    • Default value: false