Title: Post Type Archive Descriptions
Author: mrwweb
Published: <strong>22. Mai 2015</strong>
Last modified: 20. Oktober 2023

---

Plugins durchsuchen

![](https://ps.w.org/post-type-archive-descriptions/assets/banner-772x250.png?rev
=1165955)

Dieses Plugin **ist nicht mit den jüngsten 3 Hauptversionen von WordPress** getestet
worden. Es wird möglicherweise nicht mehr gewartet oder unterstützt und kann Kompatibilitätsprobleme
haben, wenn es mit neueren Versionen von WordPress verwendet wird.

![](https://ps.w.org/post-type-archive-descriptions/assets/icon.svg?rev=2981804)

# Post Type Archive Descriptions

 Von [mrwweb](https://profiles.wordpress.org/mrwweb/)

[Herunterladen](https://downloads.wordpress.org/plugin/post-type-archive-descriptions.1.5.0.zip)

 * [Details](https://de.wordpress.org/plugins/post-type-archive-descriptions/#description)
 * [Rezensionen](https://de.wordpress.org/plugins/post-type-archive-descriptions/#reviews)
 *  [Installation](https://de.wordpress.org/plugins/post-type-archive-descriptions/#installation)
 * [Entwicklung](https://de.wordpress.org/plugins/post-type-archive-descriptions/#developers)

 [Support](https://wordpress.org/support/plugin/post-type-archive-descriptions/)

## Beschreibung

Enables an editable description to display on post type archive pages. Show the 
description with WordPress’s `the_archive_description()` function that also displays
taxonomy term descriptions. Will work automatically with many themes, including 
most default WordPress themes.

**Translations:** Archive descriptions are translatable via [Polylang](https://wordpress.org/plugins/polylang/),
[WPML (affiliate link)](https://wpml.org/?aid=255503&affiliate_key=8ZIRtAbJbX4x&dr=post-type-archive-descriptions-plugin),
and [qTranslate-X](https://wordpress.org/plugins/qtranslate-x/).

**The Events Calendar:** The archive description is automatically added above the
Events Bar when using the latest templates from [The Events Calendar](https://wordpress.org/plugins/the-events-calendar/).
Filter the location of the description or disable it entirely with the `ptad_tribe_template_before_include`
filter.

#### Other Plugins by MRWweb

 * [MRW Simplified Editor](https://wordpress.org/plugins/mrw-web-design-simple-tinymce/)–
   Get rid of bad and obscure TinyMCE buttons. Move the rest to a single top row.
 * [Post Status Menu Items](https://wordpress.org/plugins/post-status-menu-items/)–
   Adds post status links–e.g. „Draft“ (7)–to post type admin menus.
 * [Hawaiian Characters](https://wordpress.org/plugins/hawaiian-characters/) – Adds
   the correct characters with diacriticals to the WordPress editor Character Map
   for Hawaiian

## 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 in the Admin Bar.

## 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.“
 5. Depending on your theme, you may need to add `the_archive_description()` to your
    templates in order for it to work.

## FAQ

### Is this plugin compatible with WordPress 5.0 / „Gutenberg“?

Yes. The plugin does not directly integrate with the post editor screen so no changes
were required.

Be aware that as of 5 Dec 2019, it [appears the Twenty Nineteen theme will _not_ support post type archive descriptions by default](https://github.com/WordPress/twentynineteen/issues/256).
Unless something changes, you will need to manually add support for them in a child
theme if using Twenty Nineteen. See the next FAQ for how to do that.

### How do I display a custom post type’s description?

Use [`the_archive_description()`](https://developer.wordpress.org/reference/functions/the_archive_description/)
or [`get_the_archive_description()`](https://developer.wordpress.org/reference/functions/get_the_archive_description/).

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

As of v1.3.0 of this plugin, the archive description is automatically added to The
Events Calendar archive pages using the plugin’s latest design.

### Which post types get a description?

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

### How do I set up an editable description for my Blog / Posts?

Since this plugin does not support descriptions for Posts or Pages, I recommend 
a different approach.

First make the blog page (aka the „Page for Posts“) editable with this snippet in`
functions.php` or an `mu-plugin`:

    ```
    add_filter( 'replace_editor', 'ptad_enable_gutenberg_editor_for_blog_page', 10, 2 );
    /**
     * Simulate non-empty content to enable Gutenberg editor on the Blog page
     *
     * @param bool    $replace Whether to replace the editor.
     * @param WP_Post $post    Post object.
     * @return bool
     *
     * @see https://wordpress.stackexchange.com/a/350563/9844
     */
    function ptad_enable_gutenberg_editor_for_blog_page( $replace, $post ) {

        if ( ! $replace && absint( get_option( 'page_for_posts' ) ) === $post->ID && empty( $post->post_content ) ) {
            // This comment will be removed by Gutenberg since it won't parse into block.
            $post->post_content = '<!--non-empty-content-->';
        }

        return $replace;

    }
    ```

Then output that content on the blog page with the `home.php` template:

    ```
    echo '<div class="archive-description blog-description">' . apply_filters( 'the_content', get_the_content( null, false, (int) get_option( 'page_for_posts' ) ) ) . '</div>';
    ```

### Are there filters & actions to modify the plugin?

Yes. Plenty!

Filters:

 * `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_admin_parent` – Change parent page of the Description edit page
 * `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
 * `ptad_tribe_template_before_include` – Modify which The Events Calendar template
   part the description should appear _before_, or `false` to disable automatic 
   output.

Actions:

 * `ptad_before_editor` – Between title and description editor for ALL admin pages.
   Receives `$post_type` arg.
 * `ptad_before_editor_{post_type}` – Between title and description editor for any
   specific post type.
 * `ptad_after_editor` – Immediately below description editor for ALL admin pages.
   Receives `$post_type` arg.
 * `ptad_after_editor_{post_type}` – Immediately below description editor for any
   specific post type.

## Rezensionen

![](https://secure.gravatar.com/avatar/0e7fb415254fa39bd584bf81285b2fe816a98926ac75a2369e52f8457b31891b?
s=60&d=retro&r=g)

### 󠀁[Still works with WP6.3](https://wordpress.org/support/topic/still-works-with-wp6-3/)󠁿

 [meeee2](https://profiles.wordpress.org/majdaly/) 19. Oktober 2023 1 Antwort

I almost didn’t try this plugin because of the notice that it hasn’t been tested
with the latest versions. Glad I did because it works great – does exactly what 
it says and is easy to use 🙂

![](https://secure.gravatar.com/avatar/7361d1340007537f6c441e5be20c41911382de9b2d55ef47bd7e8daaa46ffec1?
s=60&d=retro&r=g)

### 󠀁[Fantastic, saved me a lot of work](https://wordpress.org/support/topic/fantastic-saved-me-a-lot-of-work/)󠁿

 [Christian Saborio](https://profiles.wordpress.org/christian-saborio/) 1. April
2019 1 Antwort

This is such an elegant way to present your users with the option of editing the
text of your archives. I simply installed it and after modifying my theme a bit,
I was up and running. Fantastic idea, thank you and keep up the good work!

![](https://secure.gravatar.com/avatar/e375f8b274badb1c1c5d360299feaba06ec1658a48a3fe983d77ca149b93b15c?
s=60&d=retro&r=g)

### 󠀁[Nice one](https://wordpress.org/support/topic/nice-one-248/)󠁿

 [certainlyakey](https://profiles.wordpress.org/certainlyakey/) 18. Januar 2018

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.

![](https://secure.gravatar.com/avatar/eb3d4ebde3728a2b46f1061572466fa10dc909fa076e1b3dc4bb12fbe96cbeb7?
s=60&d=retro&r=g)

### 󠀁[Great plugin with an intuitive UI.](https://wordpress.org/support/topic/great-plugin-with-an-intuitive-ui/)󠁿

 [arrubakook](https://profiles.wordpress.org/arrubakook/) 19. Juli 2017

This plugin has been very useful to me, thank you for your contribution!

![](https://secure.gravatar.com/avatar/489cf46da18e6a0b2bf75bba10859587ce3820ff9e7a9410915dcdbfe1124ff4?
s=60&d=retro&r=g)

### 󠀁[Fantastic plugin, this should be part of the core!](https://wordpress.org/support/topic/fantastic-plugin-this-should-be-part-of-the-core/)󠁿

 [SiamKreative](https://profiles.wordpress.org/siamkreative/) 3. September 2016 
1 Antwort

Thanks Mark for this awesome plugin! It does exactly what it says. Is it available
on Github? I’d like to contribute.

![](https://secure.gravatar.com/avatar/4fad151b695b1400ff02c4bbcbcdd900b81833a41829bbcfa9b5cefb6be57e25?
s=60&d=retro&r=g)

### 󠀁[Been looking for this feature for a while!](https://wordpress.org/support/topic/been-looking-for-this-feature-for-a-while/)󠁿

 [mikes000](https://profiles.wordpress.org/mikes000/) 3. September 2016

Works exactly as expected. Nicely done!

 [ Alle 6 Rezensionen lesen ](https://wordpress.org/support/plugin/post-type-archive-descriptions/reviews/)

## Mitwirkende und Entwickler

„Post Type Archive Descriptions“ ist Open-Source-Software. Folgende Menschen haben
an diesem Plugin mitgewirkt:

Mitwirkende

 *   [ mrwweb ](https://profiles.wordpress.org/mrwweb/)
 *   [ Tusko Trush ](https://profiles.wordpress.org/tusko-trush/)
 *   [ jcdesign ](https://profiles.wordpress.org/jcdesign/)

„Post Type Archive Descriptions“ wurde in 6 Sprachen übersetzt. Danke an [die Übersetzer](https://translate.wordpress.org/projects/wp-plugins/post-type-archive-descriptions/contributors)
für ihre Mitwirkung.

[Übersetze „Post Type Archive Descriptions“ in deine Sprache.](https://translate.wordpress.org/projects/wp-plugins/post-type-archive-descriptions)

### Interessiert an der Entwicklung?

[Durchstöbere den Code](https://plugins.trac.wordpress.org/browser/post-type-archive-descriptions/),
sieh dir das [SVN-Repository](https://plugins.svn.wordpress.org/post-type-archive-descriptions/)
an oder abonniere das [Entwicklungsprotokoll](https://plugins.trac.wordpress.org/log/post-type-archive-descriptions/)
per [RSS](https://plugins.trac.wordpress.org/log/post-type-archive-descriptions/?limit=100&mode=stop_on_copy&format=rss).

## Änderungsprotokoll

#### 1.5.0 (October 20, 2023)

 * Tested up to 6.3
 * Adjust the hook which the description is inserted on TEC and make it easier to
   filter that hook. props @ethanclevenger91
 * Applies all WordPress coding standards sniffs (with one small exception that 
   I’m stuck on). Props @mgratch

#### 1.4.0 (June 21, 2022)

 * Tested up to 6.0.
 * [Fix] The „Edit Archive“ admin bar button was broken in the last version. It 
   is now fixed
 * [Fix] Prevent error when editing the Description of a post type that contains„-
   description“ in the post type slug. Hilariously edge-casey.
 * [Fix] Restore archive description before events bar component in The Events Calendar
 * [Dev] Minor code reorganization
 * Want a way to edit the blog page? [Leave your feedback!](https://github.com/mrwweb/post-type-archive-descriptions/issues/22)

## Meta

 *  Version **1.5.0**
 *  Zuletzt aktualisiert **vor 2 Jahren**
 *  Aktive Installationen **1.000+**
 *  WordPress-Version ** 4.6 oder höher **
 *  Getestet bis **6.3.8**
 *  Sprachen
 * [Dutch](https://nl.wordpress.org/plugins/post-type-archive-descriptions/), [English (Australia)](https://en-au.wordpress.org/plugins/post-type-archive-descriptions/),
   [English (New Zealand)](https://en-nz.wordpress.org/plugins/post-type-archive-descriptions/),
   [English (US)](https://wordpress.org/plugins/post-type-archive-descriptions/),
   [German](https://de.wordpress.org/plugins/post-type-archive-descriptions/), [Spanish (Chile)](https://cl.wordpress.org/plugins/post-type-archive-descriptions/)
   und [Swedish](https://sv.wordpress.org/plugins/post-type-archive-descriptions/).
 *  [Übersetze in deine Sprache](https://translate.wordpress.org/projects/wp-plugins/post-type-archive-descriptions)
 * Schlagwörter
 * [archives](https://de.wordpress.org/plugins/tags/archives/)[custom post type](https://de.wordpress.org/plugins/tags/custom-post-type/)
   [custom post types](https://de.wordpress.org/plugins/tags/custom-post-types/)
   [post type archive](https://de.wordpress.org/plugins/tags/post-type-archive/)
 *  [Erweiterte Ansicht](https://de.wordpress.org/plugins/post-type-archive-descriptions/advanced/)

## Bewertungen

 5 von 5 Sternen.

 *  [  6 5-Sterne-Rezensionen     ](https://wordpress.org/support/plugin/post-type-archive-descriptions/reviews/?filter=5)
 *  [  0 4-Sterne-Rezensionen     ](https://wordpress.org/support/plugin/post-type-archive-descriptions/reviews/?filter=4)
 *  [  0 3-Sterne-Rezensionen     ](https://wordpress.org/support/plugin/post-type-archive-descriptions/reviews/?filter=3)
 *  [  0 2-Sterne-Rezensionen     ](https://wordpress.org/support/plugin/post-type-archive-descriptions/reviews/?filter=2)
 *  [  0 1-Sterne-Rezensionen     ](https://wordpress.org/support/plugin/post-type-archive-descriptions/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/post-type-archive-descriptions/reviews/#new-post)

[Alle Rezensionen anzeigen](https://wordpress.org/support/plugin/post-type-archive-descriptions/reviews/)

## Mitwirkende

 *   [ mrwweb ](https://profiles.wordpress.org/mrwweb/)
 *   [ Tusko Trush ](https://profiles.wordpress.org/tusko-trush/)
 *   [ jcdesign ](https://profiles.wordpress.org/jcdesign/)

## Support

Möchtest du etwas mitteilen? Brauchst du Unterstützung?

 [Support-Forum anzeigen](https://wordpress.org/support/plugin/post-type-archive-descriptions/)

## Spenden

Möchtest du die Weiterentwicklung dieses Plugins unterstützen?

 [ Für dieses Plugin spenden ](https://www.paypal.me/rootwiley)