=== Plugin Name ===
Contributors: spacemanspud
Donate link: http://bozell.com/
Tags: custom post types, mod_rewrite, archives, templates
Requires at least: 3.0
Tested up to: 3.0.1
Stable tag: 1.0

Custom Post Archive creates a fully featured set of archive pages for each post type using a robust back-end and native templating functionality.

== Description ==

For each custom post type, if you click active and enter a slug-name, this plugin will create:
	
* An archive page
* Date archives
* Author archives
* Category archives
* RSS Feeds

This plug-in also provides additional features to fully integrate your custom post types, including:

* Adds a menu option to the new menu section created in WordPress 3 (for themes that support it)
* Combined archives (http://www.mysite.com/type1+type2/)
* Option to add post types to default blog
* Option to add post types to default RSS feed
* Adds post type support to wp_get_archives function
* Adds multiple global functions and filters for working with custom post types (see Functions and Filters or Plugin Help for details)
* Automatically displays the associated post type on custom taxonomy archives
* Extends upon the WordPress templating, allowing for flexibility by theme authors (see FAQ or Plugin Help for details)
* Automatically flushes the rewrite cache after modifications are detected
* Automatically adds a "blog-{post_type}" type class to the body of the created archives (for themes that implement body_class())

For help and support, help has been built into the plug-in page's contextual help section; be sure to check the FAQ and the plug-in forums if that doesn't do it.

If there are any other features you'd like to see, I'm all ears. Feel free to send a message, or hit the forums! 

== Installation ==

1. Upload the `custom-post-archives/` folder to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Configure the post types you would like archives for on the settings page

== Frequently Asked Questions ==

= How do I format the newly created Archive Pages? =

This plugin implements an extension of the [WordPress templating framework](http://codex.wordpress.org/Template_Hierarchy).
In descending order, each custom archive will look for these files in your template directory:

* date-{post-type}.php (Only if is_date())
* author-{post-type}.php (Only if is_author())
* archive-{post-type}.php (Only if is_custom_archive({post-type}))
* archive-custom.php (Only if is_custom_archive())
* archive.php
* index.php

In each of the above examples, {post-type} is replaced by the custom post type name, 
or an alphabetically sorted list of post types separated by a `_`, for pages where multiple post types are shown.

= How can I format the page title on the custom archive page? =

Custom Post Archives implements the `wp_title` filter to format the page title. If you'd like to change that formatting you can place
a variation of the following code into your `functions.php` file in your template directory.

`<?php
// Format Page title for custom archives
function custom_archive_wp_title($title, $sep, $seplocation)
{
	if(!is_custom_archive()) return $title;
	
	$label = get_custom_archive_label();
	
	if($label)
		$title = ($seplocation == 'right')
			? "$label $sep "
			: " $sep $label";
	
	return $title;
}
add_filter('wp_title','custom_archive_wp_title',10,3);
?>`

== Screenshots ==

1. The Settings Screen in the Administration

== Changelog ==

= 1.0 =
* Initial public release onto WordPress.org

== Upgrade Notice ==

= 1.0 =
Initial public download.

== Functions and Filters ==

The following function and filters are created by this plug-in. For more detailed descriptions, check the Help section built into the settings page.

**Functions**

`is_custom_archive({$post_type = false});`

`get_custom_archive_url($post_type);`
`get_custom_archive_label({$post_type = false});`
`get_custom_archive_link($post_type);`


The following functions are for advanced users. Each overrides the settings for the corresponding post_type in the plugin settings.

`add_custom_archive($post_type,$slug,{$in_default = false,$in_rss = false});`
`remove_custom_archive($post_type);`
`add_to_default_archive($post_type);`
`remove_from_default_archive($post_type);`
`reset_custom_archive_to_default($post_type);`


**Filters**

`cpa_rewrite_label`
Allows you to format the label returned by get_custom_archive_label().

`cpa_templates`
Allows you to provide or alter the list of templates Custom Post Archives searches for.