Fumiki Takahashi

TAROSKY INC.

Mark Walters

megane9988

<ul>
<li>Replace term archive pages with custom Taxonomy Pages (CPT).</li>
<li>Use the block editor to design archive landing pages.</li>
<li>Includes a Taxonomy Archive Block to display posts.</li>
<li>Fully customizable via templates and filter hooks.</li>
</ul>
<h4>How It Works</h4>
The Taxonomy Page will override the first page of a term archive. In Settings you can choose which taxonomies should have the option to create a Taxonomy Page.
For example, to create a Taxonomy Page for the News category:
<ol>
<li>In Settings → Reading select <code>Category</code>.</li>
<li>Go to Posts → Categories, hover over “News” and click Taxonomy Page.</li>
<li>Edit the Taxonomy Page in the block editor and publish it.</li>
<li>View the page at <code>/category/news</code> (assuming your permalink structure is set to “Post name”).</li>
</ol>
<h4>Taxonomy Archive Block</h4>
When editing a Taxonomy Page in the block editor, you also have access to the Taxonomy Archive Block. This block displays an overview of every post in the term archive. A number of options allow you to alter its behavior:
<ul>
<li>
Number of Posts 
Sets the maximum number of posts displayed in the overview.
</li>
<li>
Toggle Button Text 
Sets the text for the toggle button. This button appears when the total number of posts exceeds the number set in “Number of Posts”.
</li>
<li>
Archive Button Text 
Sets the text for the archive button. This button links to the second page of the term archive. It will be displayed when the amount of posts exceeds <code>Blog pages show at most</code> in Settings → Reading.
</li>
</ul>
<h4>Template Structure</h4>
You can choose a template for the Taxonomy Page in the block editor. Alternatively, you can create your own template, by adding <code>singular-taxonomy-page.php</code> to your theme’s templates, or using the filter hook <code>rich_taxonomy_include_template</code>.
The default template hierarchy, from highest to lowest priority, is as follows:
<ol>
<li><code>singular-taxonomy-page.php</code></li>
<li><code>page.php</code></li>
<li><code>single.php</code></li>
<li><code>singular.php</code></li>
<li><code>index.php</code></li>
</ol>
<h4>Customization</h4>
Template Override: Taxonomy Archive Block
To override the layout of the Taxonomy Archive Block, copy these files into your theme under:
<pre>template-parts/rich-taxonomy/</pre>
Files:
<ul>
<li><code>archive-block-loop.php</code> – Loop of post list</li>
<li><code>archive-block-more.php</code> – Archive button</li>
<li><code>archive-block-toggle.php</code> – Toggle button</li>
<li>
<code>archive-block-wrapper.php</code> – Wrapper of archive
Styles and Scripts
</li>
</ul>
You can override the plugin’s styles and scripts using these hooks:
<ol>
<li><code>rich_taxonomy_block_asset_style</code></li>
<li><code>rich_taxonomy_block_asset_editor_style</code></li>
<li><code>rich_taxonomy_block_asset_script</code></li>
<li><code>rich_taxonomy_block_asset_editor_script</code></li>
</ol>
To change the look & feel, <code>rich_taxonomy_block_asset_style</code> is the best starting point.
Example: Override Style
<pre>// Register style.
add_action( 'init', function() {
 wp_registeR_style( 'my-archive-block', $url, $deps, $version );
} );

// Override handle.
add_filter( 'rich_taxonomy_block_asset_style', function( $handle, $block_name ) {
 if ( 'rich-taxonomy/archive-block' === $block_name ) {
 $handle = 'my-archive-block';
 }
 return $handle;
}, 10, 2 );</pre>
<blockquote>
This style will load on both the front-end and block editor.
</blockquote>
Default Contents
To define the default content of the Taxonomy Page, use the <code>rich_taxonomy_default_post_object</code> filter hook.
Example: Define Default Content
<pre>/**
 * Filter default post object.
 *
 * @param array $args Post object passed to wp_insert_post().
 * @param WP_Term $term Term object assigned to this post.
 * @param string $context Currently only 'api' is supported.
 */ 
add_filter( 'rich_taxonomy_default_post_object', function( $args, $term, $context ) {
 // If specific taxonomy, enter default content.
 if ( 'category' === $term->taxonomy ) {
 // Post body.
 $args['post_content'] = 'Here comes default content.';
 // Publish immediately.
 $args['post_status'] = 'publish';
 }
 return $args;
}, 10, 3 );</pre>

Rich Taxonomy

A WordPress plugin that enhances taxonomy archives by replacing them with custom Taxonomy Pages.   > Note: This plugin works with both classic them …

Rich Taxonomy vs Beautiful taxonomy filters