Download the PHP package tfrommen/meta-taxonomy without Composer
On this page you can find all versions of the php package tfrommen/meta-taxonomy. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tfrommen/meta-taxonomy
More information about tfrommen/meta-taxonomy
Files in tfrommen/meta-taxonomy
Package meta-taxonomy
Short Description This plugin registers a taxonomy that provides a high-performance means to query posts in a somewhat meta-based way.
License GPL-3.0
Homepage https://github.com/tfrommen/meta-taxonomy
Informations about the package meta-taxonomy
Meta Taxonomy
Have you ever wanted to query posts based on the condition that a specific meta is set or equal to a given value, but then you heard/learnt how inefficient a (complex) meta query actually is?
This is exactly when Meta Taxonomy kicks in.
Disclaimer: This plugin is not intended to replace the post meta API in general. There are (a lot of) cases where using a post meta makes much more sense than using a term, or where using a term is simply impossible.
Installation
- Download ZIP.
- Upload contents to the
/wp-content/plugins
directory on your web server. - Activate the plugin through the Plugins menu in WordPress.
- Be impressed by how fast your meta-tax queries can get, compared to ordinary meta queries.
Usage
To be honest, this plugin is no big deal. It just provides you with a one-click solution for using high-performance taxonomy-based meta-like queries. Once the plugin is activated, you can assign terms of the new meta taxonomy to your posts, and then query the posts in a highly efficient way (compared to meta queries).
Filters
In order to customize certain aspects of the plugin, it provides you with several filters. For each of these, a short description as well as a code example on how to alter the default behavior is given below. Just put the according code snippet in your theme's functions.php
file or your customization plugin, or to some other appropriate place.
meta_taxonomy_args
If you want to alter a specific taxonomy argument but you can't find a fitting filter, there's meta_taxonomy_args
, which provides you with the complete args array.
meta_taxonomy_capabilities
This filter provides you with the the capabilities required for the four taxonomy-specific actions manage_terms
, edit_terms
, delete_terms
and assign_terms
.
meta_taxonomy_description
If you want to alter the taxonomy description, feel free to do it via this filter.
meta_taxonomy_labels
In case you don't like the labels, easily adapt them to your liking.
meta_taxonomy_name
Yes, you can also alter the taxonomy name (slug).
meta_taxonomy_object_type
By default, the meta taxonomy is registered for default posts (i.e., post type post
) only. If you would like add other custom post types, do this by using this filter. You can either return a single post type slug, or an array of them.
Functions
In order to make use of a specific functionality, there may be a function already. To prevent any incompatibility, all global plugin functions are pluggable. In the rare case where you already have a function within the global namespace with a plugin function's name, you would have to set up such a function by yourself. In principle, this is just a copy of what you can find in the functions.php
file of this plugin.
has_meta_term
If you want to check wether a specific post has a specific meta term, you can do this by means of the plugin's has_meta_term
function.
Contribution
If you have a feature request, or if you have developed the feature already, please feel free to use the Issues and/or Pull Requests section.
Of course, you can also provide me with translations if you would like to use the plugin in another not yet included language.
Changelog
Changelog