About this plugin
Custom Post Archives bridges the gap between creating Custom Post Types in WordPress 3, and actually displaying those posts. With this plugin, you have
the option of displaying a completely seperate blog-like section for each post type, complete with all the features you expect to see with WordPress.
For each custom post type, if you click “active” and enter a slug-name, this plugin will let you display post-type specific:
- Archives
- Date archives
- Author archives
- Category archives
- RSS Feeds
This plug-in also provides many 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!
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.