=== Articles ===
Contributors: crowdfavorite, alexkingorg
Donate link: http://crowdfavorite.com/donate/
Tags: articles, featured posts, highlight, best
Requires at least: 3.0
Tested up to: 3.0.1
Stable tag: 1.4

The Articles plugin allows you to display a list of posts you wish to feature/highlight.

== Description ==

Links:

- [Articles plugin in action](http://www.alexking.org/articles).
- [Wordpress.org Articles forum topics](http://wordpress.org/tags/articles?forum_id=10).
- [Articles plugin page at Crowd Favorite](http://crowdfavorite.com/wordpress/plugins/articles/).
- [Articles Plugin forums at Crowd Favorite](http://crowdfavorite.com/forums/forum/articles).
- [WordPress Help Center Articles support](http://wphelpcenter.com/plugins/articles/).

Articles will allow you to create a list of posts you wish to feature and highlight without any customization to your theme. Articles also has the ability to group articles with a list name to customize what is displayed.

== Installation ==

1. Put the 'articles' directory into your wp-content/plugins/ directory.
2. Go to the Plugins page in your WordPress Administration area and click 'Activate' for Articles.
3. On the right hand side of the New/Edit post page you can add a post as an article and give it a list.

== Frequently Asked Questions ==

= How do I add a post or a page to my Articles list? =

On the side of your edit post page, you can click the radio button to include that post in your articles list. 

= How do I display the Articles list? =

There are two methods for showing the articles list.

Using the shortcode `[articles]` on any post or page will generate a list of articles.
If you have supplied lists for your articles you can display only articles of a specific list using the following: `[article list="list name"]`

You can also add a template tag to your theme to show your articles list:

`<?php if (function_exists('aka_show_articles')) { aka_show_articles(); } ?>`

or to display only from certain article list:

`<?php if (function_exists('aka_show_articles')) { aka_show_articles("list name"); } ?>`

= What is the custom field name? =

By default, Articles uses '_ak_article' as the custom field name. You can change this by changing the following line at the top of the plugin (in the plugin code):

`define('AKA_META_KEY', '_ak_article');`

If you have used the default or another custom field name, you'll need to upgrade your data to your new custom field name. The plugin does not do this for you.

= Will the old token method ###articles### still work? =

Yes, but it does not support the new list feature and it is better to replace your ###articles### token with the new shortcode.

= Anything else? =

That about does it - enjoy!

== Screenshots ==

1. Articles plugin in action.
2. The Articles meta box.

== Changelog ==

= 1.4 =
- New : Changelog
- New : Ability to give a list name to an Article
- New : Shortcode to replace deprecated token method
- Changed : 2-Column display relies on number of Categories instead of number of Articles
- Changed : Unified options page
- Changed : Plugin Flow
- Changed : Using `add_meta_box` instead of creating one
- Changed : The token method ###articles### is now deprecated in favor of shortcode
- Bugfix : Displaying articles improperly for some installations


= 1.3 =
- New : Upgrade function
- New : Custom field for articles plugin
- New : Template tag for integration
- Changed : Now a radio button UI instead of manually adding meta information
- Changed : Text domain is now the plugin slug

= 1.2 =
- New : WP 2.3 support
- Changed : Remove token in `the_excerpt`

= 1.1 =
- New : Added check for token in the_content
- Changed : Custom category SQL query for getting specific categories instead of get_categories
- Changed : Restructured printing of the articles

= 1.0 =
- New : The first version

== Upgrade Notice ==

= 1.3 =
- Use the upgrade button on the settings page to upgrade. This will update your meta information with a namespaced key.