Beskrywing
This plugin create a custom post type “Taoxnomy Page” which related to a term.
How It Works
Taxonomy Page will override the 1st page of term archive. You can choose which taxonomy to have a Taxonomy Page.
For example:
- You have decided “category” to have Taxonomy Page.
- Create a Taxonomy Page “Book” for category “Book”.
- Edit the Taxonomy Page in block editor and publish it.
- Now the 1st page of “Book” category
/category/book
will dipslay the contents of the Taxonomy Page “Book”.
Template Structure
You can choose a template for the taxonomy page in editor,
but you can put singular-taxonomy-page.php
template in your theme and there’s no need to choose.
Below is the default template priority.
- singular-taxonomy-page.php
- page.php
- singular.php
- single.php
- index.php
Filter hook rich_taxonomy_include_template
is also available.
Customization
Archive Block
Archive blocks has tempalte structure like below.
template-parts - rich-taxonomy - archive-block-loop.php // Loop of post list. - archive-block-more.php // Link button. - archive-block-toggle.php // Toggle button. - archive-block-wrapper.php // Wrapper of archive.
If the theme has files in the same path, that priors.
Copy the file and customize one as you like.
Styles
To override styles, 4 hooks are available.
rich_taxonomy_block_asset_style
rich_taxonomy_block_asset_editor_style
rich_taxonomy_block_asset_script
rich_taxonomy_block_asset_editor_script
To change looks & feels, rich_taxonomy_block_asset_style
is the best starting point.
// 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/arcvhie-block' === $block_name ) { $handle = 'my-archive-block'; } return $handle; }, 10, 2 );
This style is loaded in both public and editor.
Default Contents
To define the default contents of the taxonomy page, use rich_taxonomy_default_post_object
filter hook.
/** * 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, $contest ) { // 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 );
Installation
From Plugin Directory
- Click install and activate it.
- Select the taxsonomies at the Reading Settings page (Setting > Reading).
From Github
See releases.
Kwel-vrae
-
Where can I get supported?
-
Please create a new ticket on the support forum.
-
How can I contribute?
-
Create a new issue or send pull requests.
Aanbevelings
There are no reviews for this plugin.
Contributors & Developers
“Rich Taxonomy” is oopbron sagteware. Die volgende mense het bygedra tot die ontwikkeling van hierdie uitbreiding:
Contributors“Rich Taxonomy” has been translated into 1 locale. Thank you to the translators for their contributions.
Translate “Rich Taxonomy” 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.2
- Fix bug on template selector.
1.1.1
- Fix a bug that breaks the block widgets screen.
- Update README for clearance of installation. props @megane9988
1.1.0
- Fix the bug for block disappearing.
1.0.9
- Fix a bug in the template selector in the taxonomy page editor.
1.0.0
- First release.