=== Plugin Name ===
Contributors: alxgrlk
Tags: lists, listicle, shortcode, SEO, post, posts, page, paginate, pageviews, links, admin, plugin
Requires at least: 3.0.1
Tested up to: 3.5.1
Stable tag: 0.3
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Listicle plugin, lets you create paginated lists where every item in a bulleted list generates a post

== Description ==
Add multiple posts that can be viewed as a slide show using next / previous buttons out of a single list while editing only one post in your admin panel.  This lets you generate listicles (http://en.wikipedia.org/wiki/Listicle).  "In journalism and blogging, a listicle is a short-form of writing that uses a list as its thematic structure, but is fleshed out with sufficient verbiage to be published as an article. A typical listicle will prominently feature a cardinal number in its title, such as "10 Ways to Warm Up Your Bedroom in Winter",[1] or "25 Hairstyles of the Last Hundred Years",[2] with subsequent subheadings within the text itself reflecting this schema. The word is a portmanteau derived from list and article."   


Features:

* Create lists on the fly, each list item with its own navigation
* SEO-friendly pages for each list item
* Manage multiple posts from within a single post
* Generate better page views using lists
* Promote your listicles and list items individually on all your favorite social sites and on listicle.us 

== Installation ==

1. Upload the listicle directory to your `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. From within a post or page, add a listicle using the shortcode [listicle][/listicle]  
1. Don't forget to to tease your listicles at listicle.us
1. You can style components of your listicle using the css file included with the plugin as a baseline. 
 
A sample shortcode with all its features:

	[listicle name="sample listicle for readme"]

		<em>This is the excerpt that will be used to tease the first item in the list from the post you are currently editing.  The post within which you are placing this listicle will show this excerpt.  This is the "italics" tag. You can generate this using the WordPress WYSIWYG "tinyMCE" by clicking the "i" in the editor.  Or, in HTML view you probably know what to do.  There should only be one.       </em>
		
		<li><strong>The text inside the strong / bold tags become the headline of the post generated by listicle.</strong>  The text inside the list item, also available from the WYSIWYG becomes the content of the list item post.  If there is no headline specified using the "b" tag</li>
		
		<li><b>bold and strong should be interchangeable</b> If there is no strong tag listicle will use the name attribute from the listicle shortcode to generate a numbered sequence of titles for the list item posts.  For example, this list item would be titled: sample listice for readme - 2.  Note: Semantically, strong is the preferred option.</li>
		
		<li>Listicle will generate list item "listicle" posts for each list item.  You can have as few as one. You can delete listicles by removing the list item from the list and publishing the post.</li>


	[/listicle]
 
 
== Frequently Asked Questions ==

= Getting Errors =

* A shortcode must have a name attribute.  The name attribute must be unique.
* The shortcode must be closed, ie: it will not work if it does not have a [/listicle]
* The list items  

= What is listicle tease =
In order to help promote your site you can pimp your list at listicle.us.  In your admin go to tools > listicle tease.  Select a category from the subject pulldown and a list by selecting the post that houses it and "list it".  Listicle.us creates links back to your teaser page (the post that houses the listicle) so users go to your site to read the list. 


== Screenshots ==
1. screenshot-1.jpg
2. screenshot-2.jpg
3. screenshot-3.jpg
4. screenshot-4.jpg


== Changelog ==


= 0.1 =
This version is beta.  Feedback greatly appreciated.

= 0.2 =
Minor fix to get versioning synched.

= 0.3 =
Allow bold tags and strong tags to be used interchangeably

== Upgrade Notice ==

= 0.3 =
Upgrade to 0.3 in order to use bold or strong, otherwise strong is required