=== Plugin Name ===
Contributors: philipjohn
Donate link: http://philipjohn.co.uk/
Tags: author, bio, biography, user description, author description, shortcode, author-bio-shortcode
Requires at least: 3.5
Tested up to: 3.5
Stable tag: trunk

Provides the [author_bio] shortcode for embedding the bio of an author anywhere in the post/page content.

== Description ==

This plugin allows you to enter [author_bio] anywhere within the content of a post or page to display the biography of the author of that post or page.

The output now contains HTML, which can be customised very easily with extra parameters - see Usage for a how-to - to sit around the bio, as defined in /wp-admin/profile.php.

By default the shortcode produces the author of that post or page. However, extra parameters enable you to specify a different user whose bio you want to print out - see usage instructions.

Feature requests welcomed with open arms!

== Installation ==

Simple install in /wp-content/plugins like any other!

== Usage ==

Simply place [author_bio] anywhere within your post/page content.

Additionally, you can pass one of the following attributes to specify a different user;
*   id - accepts the user ID
*   username - accepts the username
*   email - accepts the user e-mail address

For example;
`[author_bio]
[author_bio id="4"]
[author_bio username="admin"]
[author_bio email="user@example.com"]`

You can also have the author's avatar added, by using the avatar parameter like so;
`[author_bio avatar="yes"]`
Warning: if you don't want the avatar, do not change the above to "no" as it will not work, simply change back to `[author_bio]` alone.

You can also customise the HTML output which defaults to;
`<div class="author-bio-shortcode">
	<div class="avatar">
		<img .. />
	</div>
	<div class="bio">
		<p> ... the author bio ... </p>
	</div>
</div>`

There are 7 parameters that describe the HTML above;
* 'container_element' defaults to 'div' and creates the first div in the example above
* 'container_class' defaults to 'author_bio_shortcode' as seen above
* 'avatar_container_element' defaults to 'div' and creates the element that surrounds the avatar image
* 'avatar_container_class' defaults to 'avatar' and adds itself to the 'avatar_container_element'
* 'bio_container_element' defaults to 'div' and wraps the bio text
* 'bio_container_class' defaults to 'bio' and is used in the bio container element
* 'bio_paragraph' defaults to true and decides whether to put the bio text into a Paragrah tag. Note, only a value of zero (0) will change it, e.g. `bio_paragraph=0`

Here is an example using all the HTML parameters to re-create the above example code;
`[author_bio container_element="div" container_class="author-bio-shortcode" avatar_container_element="div" avatar_container_class="avatar" bio_container_element="div" bio_container_class="bio" bio_paragraph="true"]`

This example shows how to remove the P tag from around the bio text;
`[author_bio bio_paragraph=0]`

== Changelog ==

= 1.0 =
* First commit

= 1.2 =
* Ensured compatibility with WordPress v3.2.1
* Added PHPDoc commenting
* New activation function to check version number
* Now using more obscure function naming
* Added extra options for specifying the user

= 1.2.1 =
* Tidied up PHP Notices (kudos to <a href="http://www.leewillis.co.uk/">Lee Willis</a> for pointing that out!)

= 2.0 =
* Added ability to include the author's avatar alongside the bio
* Added HTML to provide for easier styling
* Added additional parameters to change the default HTML output