YD WPMU Bloglist Widget

1. 

   An example of the WPMU Bloglist Widget Plugin in action (2-columns blog list block)

2. 

   The settings/options page (english version)

3. 

   La page de réglages/options (version fançaise)

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]

2.1.1

• Indonesian translation by Syamsul Alam

2.1.0

• New features and improvements:
• Ability to build drop-down blog menu easily
• Ability to sort by domain
• Filter hook for external processing of the list by other plugins
• show_count = false parameter
• Regular wp-style arguments parsing (now allows using array of arguments)
• Ukrainian translation by Mikalay @ webhostinggeeks.com

2.0.0

• WPML language support
• Place longer column first
• Backlink disabled by default
• Use POST for form submission
• Blog selection options
• Blog exclude list option
• New YD Logo

1.0.2

• Bugfix: order by post count
• German translation by Rian Kramer @ Pangaea http://www.pangaea.nl

1.0.1

• Bugfix: settings update

1.0.0

• Considered stable, no complaint after more than 500 downloads
• Added Dutch version, translation credits go to Andre @ http://www.fethiyehotels.com
• Activated “linkbackware” mode by default
• Donate section in the settings page
• Improved settings page design
• Added settings page link in the short description
• (slightly) Revised documentation page

0.2.2

• Bugfix: Plural form was not saved (2010-04-22) (thanks to Thomas@Wellcom for noticing)
• Bugfix: html_entities_decode would cause utf-8 nightmare ans crash in options encoding (thanks TB again!)

0.2.1

• Bugfix: “Duplicate link” issue with sub-domain installations (2010-04-22)

0.2.0

• Bugfix: Alphabetical order was case-sensitive (2010-04-21) (thanks to TB@Wellcom for reporting)
• New feature: trailing slash option
• Compatibility: WP 2.9.2 & WPMU 2.9.2

0.1.1

• Corrected order-by and limit features which were non-functional (thanks to Luis @ Arume for reporting)
• Made non-xhtml compliant ‘alt’ parameter optional (thanks to Luis @ Arume for reporting)
• Completed translation file (thanks to Arume again)
• Added Spanish and Galician translation files (credits Arume)
• Completed doc + readme file