=== Archive Control ===
Contributors: thejester12
Donate link: http://switchthemes.com/archive-control/
Tags:  archive, archive page, archive template, custom post type, post type, featured image, post types, title, order, pagination
Requires at least: 4.1
Tested up to: 4.6.1
Stable tag: 1.2.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Quickly customize your custom post type archives with a separate headline, featured image, and editable content. Modify order and pagination.

== Description ==

If you enjoy using custom post types, and find yourself making the same customizations to the archive (multiple listing) pages associated with them, then this plugin can help you and your site editors.

Upon installing the plugin, you'll be able to set/enable these options for each custom post type that has the "has_archive" setting enabled. If you enable the content textareas, a new settings screen will appear in the menu under that custom post type.

*   **Archive Titles:** If your theme is using the_archive_title() function, then you can modify the your archive titles.
    * Remove Labels (Archive, Category, Tag, etc.) - Sometimes you just want to get rid of the annoying default words.
    * Custom Override - Allow an editor to write something custom for an archive headline.

*   **Archive Featured Image:** You can allow for a custom featured image that applies to an archive page and have it added above the list automatically, or add it yourself via a theme function.

*   **Content Before or After Archive List:** Give your site editors the ability to edit content directly before or after the archive list. You can have it automatically added, or use a theme function to give you more control over their placement (see the "Other Notes" tab).

*   **Archive Order By:** Instead of messing with code to change the order of a custom post type archive, now you can do it in a few clicks.
    * Date Published
    * Title
    * Date Modified
    * Menu Order
    * Random
    * ID
    * Author
    * Post Slug
    * Post Type
    * Comment Count
    * Parent
    * Meta Value
    * Meta Value (Numeric)
    * No Order
*   **Archive Order:** In addition to the order by value, you'll also want to change the order.
    * Ascending
    * Descending

*   **Archive Pagination:** The pagination settings are easy to change without changing code.
    * Show Everything
    * Custom Posts Per Page

The plugin doesn't add any CSS or javascript to the front end. The styling of the archive page is left completely up to you. This plugin should be friendly for power users and developers alike. You can use it entirely without changing theme code, or you can control the placement and functionality more exactly using the provided functions. See the "Other Notes" tab.


== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/archive-control` directory, or install the zipped plugin through the WordPress plugins screen directly.
2. Activate the Archive Control plugin through the 'Plugins' screen in WordPress.
3. Use the Settings->Archive Control screen to configure the settings for each custom post type.
4. Once you have saved your settings, you can edit the titles, textareas, and featured image in the 'Edit Archive Page' submenu for each custom post type.


== Frequently Asked Questions ==

= Why won't my custom post type appear in the Archive Control settings? =

It depends a lot how your custom post type is created. It must be set to "public", and it must have "has_archive" set to true, or a string. Be sure to check those settings first!

= Why can't I customize the archive title? =

The archive title functionality requires that a special function is used to display your archive title: the_archive_title(). If your theme does not use this function, and either hardcodes the title or uses a different function, then this plugin won't be able to help.

= How do you add in the content before/after archives? =

The "Automatic" setting uses the "loop_start" and "loop_end" WordPress hooks to inject the content. If you would rather use the "Manual Function" setting, then we give you the functions the_archive_top_content() and the_archive_bottom_content() to place in your theme as you choose.

= What if I want to change the size of the featured image that is being displayed? =

This cannot be done through the interface (it shows the "large" size by default), but is entirely possible to do by putting functions in your theme files. The functions provided by this theme are listed in the "Other Notes" tab. For example, _the_archive_thumbnail('thumbnail')_ would change the size to a thumbnail. If you want to create a new size you can either send along an array like this: _the_archive_thumbnail(array(500,200))_ or register a new size with the _add_image_size()_ functionality.

= What is a custom post type and how would I make one? =

A custom post type allows you to make the content adding/editing process more specific for different kinds of content. By default it works similarly to a "Post", but can be modified to have different settings and even unique custom fields. To create one you could do it several ways:

* Read about it on the Codex: https://codex.wordpress.org/Post_Types
* Use a plugin to create them: https://wordpress.org/plugins/custom-post-type-ui/
* Use a generator website to create them: https://generatewp.com/post-type/

= What is an archive page? =

An archive page is really just WordPress terminology for a page with a list of multiple pieces of content (posts). By default this content is in date order, with the newest appearing at the top, like a blog, and would be split into pages with 10 posts each. WordPress gives you the ability through code to manipulate this list, changing the order, pagination and other things, but doesn't give you a simple interface for doing so. WordPress also by default does not have any interface for storing content like images and text that are related to a specific archive page. That is the problem that this plugin tries to provide the solution for.


== Screenshots ==

1. An example of a custom post type archive page.
2. Settings for each custom post type that has an archive.
3. Give your client the ability to edit archive headlines, a featured image, and content before and after the list.

== Changelog ==

= 1.2.1 =
* SVN issue fix
= 1.2.0 =
* Fixed a bug that wouldn't allow archive featured image functionality unless content before or after was also enabled.
* Introduced basic Taxonomy archive modifications
* Changed the database structure to allow for separation between custom post types and custom taxonomies
= 1.1.1 =
* Added a "View Archive Page" link to the edit page
* Added a "Edit Archive Page" link to the admin menu when viewing archive
= 1.1.0 =
* Added Archive Featured Image functionality
* Allowed more customization with functions for developers
= 1.0.0 =
* Initial Version

== Upgrade Notice ==

= 1.2.1 =
SVN issue fix

= 1.2.0 =
Fixed a few bugs and introduced basic taxonomy archive modifications

= 1.1.1 =
Added View and Edit buttons where they would be helpful

= 1.1.0 =
Added Archive Featured Image functionality and functions for developers

= 1.0.0 =
Initial Version

== Functions Provided by the Plugin ==

**the_archive_top_content( _boolean_ $html = true)**
> Displays the _top_ archive content on an archive page. Additional html markup can be removed by setting false.

**archive_top_content( _boolean_ $html = true, _string_ $post_type = null)**
> Displays the _top_ archive content for any post type anywhere on the site. Additional html markup can be removed by setting false. Post type is automatic if on an archive page.

**get_archive_top_content( _string_ $post_type = null)**
> Returns the _top_ archive content for any post type anywhere on the site. Post type is automatic if on an archive page.

**the_archive_bottom_content( _boolean_ $html = true)**
> Displays the _bottom_ archive content on an archive page. Additional html markup can be removed by setting false.

**archive_bottom_content( _boolean_ $html = true, _string_ $post_type = null)**
> Displays the _bottom_ archive content for any post type anywhere on the site. Additional html markup can be removed by setting false. Post type is automatic if on an archive page.

**get_archive_bottom_content( _string_ $post_type = null)**
> Returns the _top_ archive content for any post type anywhere on the site. Post type is automatic if on an archive page.

**the_archive_thumbnail( _string_ $size = 'large', _string_ $post_type = null)**
> Display the archive thumbnail. Default size is large but first parameter can set any valid image size, or an array of width and height values in pixels (in that order). Post type is automatic if on an archive page.

**get_archive_thumbnail_src( _string_ $size = 'large', _string_ $post_type = null)**
> Returns the archive image url source. Default size is large but first parameter can set any valid image size, or an array of width and height values in pixels (in that order). Post type is automatic if on an archive page.

**get_archive_thumbnail_id( _string_ $post_type = null)**
> Returns the archive thumbnail id. if you want to use other common WordPress attachment functions to retrieve data about the image. Post type is automatic if on an archive page.