Post Type Archive Descriptions

Description

Enables an editable description for a post type to display at the top of the post type archive page. Works just like a taxonomy term description.

Automatically works for any theme that uses the_archive_description() (added in WordPress 4.1) like Twenty Fifteen, Twenty Sixteen, Twenty Seventeen or recent _s-based themes.

Also comes with a specific template tag—ptad_the_post_type_description() and ptad_get_post_type_description()—for other themes.

Other Plugins by MRWweb

Screenshots

  • The editing interface for writing a post type archive description. This plugin adds the "Archive Description" link in the left menu, the "View Books Archive" link in the admin bar, and, of course, the field to save the description.

  • The post type archive description displayed (automatically!) in the Twenty Fifteen theme. The plugin also adds the "Edit Books Description" link.

Installation

  1. From your WordPress site’s dashboard, go to Plugins > Add New.
  2. Search for “Post Type Archive Descriptions.”
  3. Click “Install.”
  4. Click “Activate.”

FAQ

Installation Instructions
  1. From your WordPress site’s dashboard, go to Plugins > Add New.
  2. Search for “Post Type Archive Descriptions.”
  3. Click “Install.”
  4. Click “Activate.”
How do I display a custom post type’s description?

In WordPress 4.1, the_archive_description() and get_the_archive_description() were introduced. As long as your theme supports those functions, you don’t have to do anything!

Older themes can use ptad_get_post_type_description() or ptad_the_post_type_description() to return or echo a post type description. Both functions take an optional $post_type slug argument to return a specific post type. However, that is unnecesarry on a page that returns true for is_post_type_archive()`.

Chances are you want this in the archive-{post_type_slug}.php or archive.php template files.

Which post types get a description?

By default, any custom post type (not Posts or Pages) that was registered with 'has_archive' => true. There is a filter (see below) to add support for any post type.

Are there filters to modify the plugin?

Glad you asked. Yes. Plenty!

  • ptad_post_types – specify the post types with a description (default is all non-built_in post types where has_archive is true)
  • ptad_admin_title – Modify admin page title
  • ptad_menu_label – Modify the menu item label in the admin
  • ptad_description_capability – Set capability of who can edit descriptions. Default: edit_posts
  • ptad_edit_description_link – Modify admin bar link to edit the description
  • ptad_view_archive_link – Modify admin bar link to view the post type archive

Reviews

Nice one

A useful and well implemented plugin. If you’re going to use any other post-type global fields it’s better to replace this plugin with a custom field and put all of those on a single options page, but otherwise it does its job well.

Read all 4 reviews

Contributors & Developers

“Post Type Archive Descriptions” is open source software. The following people have contributed to this plugin.

Contributors

“Post Type Archive Descriptions” has been translated into 2 locales. Thank you to the translators for their contributions.

Translate “Post Type Archive Descriptions” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

= 1.1.4 (August 13, 2018)
* [Fix] Fully restrict access to Post Type Description edit screen when ptad_description_capability filter is used. Props @deucecreative
* Bump requires version to 4.6 and remove load_plugin_textdomain usage

1.1.3 (May 31, 2018)

  • [Fix] Remove deprecated screen icon notice on Archive Description edit screen
  • Bump tested up to version

1.1.2 (April 25, 2017)

  • [Fix] Only show “Edit Description” admin bar link if user has correct permissions
  • [Docs] Clarify one function’s inline documentation

1.1.1 (April 18, 2016)

  • [Fix] Typo resulted in error and broken qTranslate-X support.

1.1.0 (March 30, 2016)

  • [New] New ptad_wp_editor_settings filter to modify Post Type Description TinyMCE settings. Thank you @katanyan.
  • [New] Support for qTranslate-X. Thank you to @Tusko on GitHub.

1.0.0 (May 14, 2015)