WordPress.org

Ready to get started?Download WordPress

Plugin Directory

YD WPMU Bloglist Widget

Sidebar widget and template function to display an ordered blog list of subsites (with post count) on a page of the WordPress MU main site.

Where should I ask questions?

http://www.yann.com/en/wp-plugins/yd-wpmu-bloglist-widget

Use comments.

I will answer only on that page so that all users can benefit from the answer. So please come back to see the answer or subscribe to that page's post comments.

Puis-je poser des questions et avoir des docs en français ?

Oui, l'auteur est français. ("but alors... you are French?")

How to display this in the template without using a widget?

Insert this code into your template:

<?php yd_display_wpmu_bloglist() ?>

How to display a drop-down list of blogs?

Since version 2.1.0, you can use this syntax:

<?php yd_wpmubl_dropdown_js(); ?>
<select name="select" id="select" onChange="ddjump(this);">
    <option selected="selected"><?php _e('Please choose an option below:'); ?></option>
    <?php yd_wpmu_bloglist_dropdown( 'show_count=0' ); ?>
</select>

If I don’t want to use the widget, how can I display it in php?

Same answer as above.

What are the function parameters?

All the display parameters can be overloaded in the function call. Here are the available parameters:

  • column_count
  • before_block
  • after_block
  • before_column
  • after_column
  • before_list
  • after_list
  • before_item
  • after_item
  • before_count
  • after_count
  • plural_form
  • alt_text
  • title_text
  • limit
  • order_by
  • order

**new since 2.0.0 **

  • trailing_slash
  • wpml_support
  • only_public
  • skip_archived
  • skip_mature
  • skip_spam
  • skip_deleted
  • to_skip (comma-delimited list of blog IDs that xill not be displayed)

**new since 2.1.0 **

  • show_count (can be set to 0 or false to avoid displaying post count)
  • group_by (needs an option in the blogs' options tables)
  • before_groupby
  • after_groupby

For example, here's how to call the function with a bunch of parameters:

<?php yd_display_wpmu_bloglist( 'column_count=1&before_item=<li><b>&after_item=</b></li>' ) ?>

Since version 2.1.0 you can also pass artguments in an array, like this for example:

<?php yd_display_wpmu_bloglist( 
    true, //echo
    array( 
        'to_skip'     => '1,0',
        'order_by'    => 'domain',
        'group_by'    => 'continent',
        'column_count'    => 3,
        'show_count'  => 0,
        'before_block'    => '<div>',
        'after_block' => '</div>',
        'before_column'   => '<div class="columns coln">',
        'after_column'    => '</div>' 
    )
); ?>

Can I make the function return HTML for further php processing without displaying it?

Yes: just add a first parameter "false". You can add optionnal display customization overload parameters after that.

For example:

<?php $my_html = yd_display_wpmu_bloglist( false, 'column_count=1&before_item=<li><b>&after_item=</b></li>' ) ?>

Can I include the blog list in my blog content?

Yes you can include the list in the content of any page or post by using tis special tag:

[!YDWPMUBL]

Requires: 2.9.1 or higher
Compatible up to: 3.5.2
Last Updated: 2013-2-1
Downloads: 10,995

Ratings

4 stars
4.2 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1
100,1,1 100,1,1 100,1,1 100,1,1
100,3,3 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
100,1,1 67,3,2 100,1,1
67,3,2 100,1,1
100,1,1 100,1,1
100,2,2 100,1,1 100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1 100,1,1
100,1,1
100,1,1
100,1,1 100,1,1
0,1,0