=== Links shortcode ===
Contributors: maartenjs
Donate link: blog.bigcircle.nl
Tags: links, link, shortcode, category, Facebook, Like, Recommend, list of links
Requires at least: 3.0
Tested up to: 3.0.1
Stable tag: 0.7

The plugin provides the shortcode 'links'. This shortcode lists all links having specified characteristics, like a link category, in your post.

== Description ==

The plugin provides the shortcode 'links'. This shortcode displays a list of all links having specified characteristics, for example a link category name in your post. By default it includes a Facebook Like button for every link, but this can be disabled.

The typical format is [links option1="x" option2="y" etc...]

The following options are available:

*   **fblike**: Show the facebook Like button (default '1', to disable set to any value other than '1')
*   **fbrecommend**: Show the Facebook Recommend botton (default '', to enable set to '1')
*   **orderby**: Order the links by (default 'name') 
*   **order**: How to order, ASC or DESC (default 'DESC')
*   **limit**: Limit the number of links shown (default '-1', which means no limit) 
*   **category**: Comma separated list of link category ID's
*   **category_name**: Category name of a catgeory of links to show. Overrides category parameter.
*   **hide_invisible**: Hide links marked as not visible (default '1', yes)
*   **include**: Comma separated list of numeric link IDs to include. If 'include' is used, the category, category_name, and exclude parameters are ignored. 
*   **exclude**: Comma separated list of numeric link IDs to exclude.,
*   **search**: Shows all links matching this search string. It searches url, link name and link description.

Dafault options can be changed on a 'Links Shortcode' page in the Settings menu.

Example: 
> [links category_name="Blogroll"]

The list of links uses the Name, Web Address and Description of your links. The Name will link to the Web Address.

If the Name starts with a date, formatted as: yyyy-mm-dd followed by ':', this date will be still be shown, but excluded from the link.

Please note that the Description has a limited length, but the Wordpress UI does not show this. After saving changes to a Link in the Links Wordpress only saves the first 255 characters. This has nothing to do with this Plugin.

== Installation ==

Just use the "Add New" button in Plugin section of your Wordpress blog's Control panel. To find the plugin there, search for 'Links Shortcode'. 

After installing you can use the shortocde anywhere in your blog as described in the description.

== Frequently Asked Questions ==

No questions asked, at the moment.

== Upgrade Notice ==

No special actions required before upgrading. 

== Screenshots ==

No screenshot at this time

== Changelog ==

= 0.7 =
* A Settings page has been added to set the most common default options.
* Translation support has been added for the Settings page.
* Stylesheet and layout have been improved to better display the links without the Facebook button.

= 0.6 =
* The first stable release at the Wordpress.org plugin repository.