Rich Taxonomy

Template Structure

You can choose a template for the Taxonomy Page in the block editor. Alternatively, you can create your own template, by adding singular-taxonomy-page.php to your theme’s templates, or using the filter hook rich_taxonomy_include_template .

The default template hierarchy, from highest to lowest priority, is as follows:

1. 05singular-taxonomy-page.php
2. 06page.php
3. 07single.php
4. 08singular.php
5. 09index.php

Customization

Template Override: Taxonomy Archive Block

To override the layout of the Taxonomy Archive Block, copy these files into your theme under:

template-parts/rich-taxonomy/

Files:

• archive-block-loop.php – Loop of post list
• archive-block-more.php – Archive button
• archive-block-toggle.php – Toggle button
• archive-block-wrapper.php – Wrapper of archive Styles and Scripts

You can override the plugin’s styles and scripts using these hooks:

1. 10rich_taxonomy_block_asset_style
2. 11rich_taxonomy_block_asset_editor_style
3. 12rich_taxonomy_block_asset_script
4. 13rich_taxonomy_block_asset_editor_script

To change the look & feel, rich_taxonomy_block_asset_style is the best starting point.

Example: Override Style

// 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 );

This style will load on both the front-end and block editor.

Default Contents

To define the default content of the Taxonomy Page, use the rich_taxonomy_default_post_object filter hook.

Example: Define Default Content

/** * 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 );