MasterPress 1.2.8 is now available
It was brought to our attention that MasterPress would give a tonne of warnings and deprecation notices when used with PHP 7.4 – this update addresses those.
MEOW_Term
Extends the WOOF_Term class to include support for MasterPress field sets and incoming post relations.
Example: A few ways (of the many) ways to to obtain a MEOW_Term.
List of Methods
Magic Methods
-
__call( String $name, Array $args )Mixed
Overrides the --call method to also look for incoming posts of type “post_type_name” when attempting to call a method of the form “incoming_[post_type_name_plural_form]”.
-
__get( String $name )Mixed OR WOOF_Silent
Implements the PHP magic method __get called when an unknown property is accessed.
Manipulation
-
update( Boolean $include_sets = true )
Extends the WOOF_Term::update method for updating term data, to also update any modified MasterPress custom field data for this term.Important Note: If you have just created a new term via the WOOF_Taxonomy::create method and you have also updated custom field data, you must use this method to commit the field data if you haven’t already committed the new term to the database, rather than any of the methods MEOW_Field::update, MEOW_FieldSet::update, or MEOW_FieldSetCollection::update. The reason for this is that the new term will not yet have a term_id to attach metadata to, and this method contains special handling to account for this case (it will update the term first before the custom fields). .
Theming
-
f( String $name )MEOW_Field
A synonym for the field method to retrieve a field for this term.
-
field( String $name )MEOW_Field
Retrieves a field in this term with the given name.
-
has( String $name )MEOW_Field OR MEOW_FieldSet OR Boolean
Checks for the existence of a set or a field in this term, and that there are entries or values entered for either.
-
has_field( String $name )MEOW_Field OR Boolean
Checks for the existence of a field and that the field has content entered for this site.
-
has_set( String $name )MEOW_FieldSet OR Boolean
Checks for the existence of a field set of a given name for this term, and if the set has entries in the case of a multi-item set.
-
incoming( Array / String $args = array() )WOOF_Collection of MEOW_Post
Retrieves all posts that are related to this term via of the Related Term field type.
-
query_incoming( Array / String $args = array() )WOOF_Collection of MEOW_Post
Retrieves all posts that are related to the this post by means of the Related Term field type, while also affecting the main query loop in WordPress.
-
s( String $name )MEOW_FieldSet OR WOOF_Silent
A synonym for the MEOW_Term::set to retrieve a field set for this term with the given name. Note: It is generally more concise to make use of the method overloading to retrieve a set, but this method is a fallback when the field name clashes with a known property of the term.
-
set( String $name )MEOW_FieldSet OR WOOF_Silent
Retrieves a field set for this term with the given name. Note: It is more concise to make use of the __get method overloading to retrieve a set, but this method is a fallback when the field name clashes with a known property of the term. .
Posts
-
posts( Arguments $args = array() )WOOF_Collection of MEOW_Post
Overrides the WOOF_Term::posts method to allow posts related to this term via a Related Term field to be included if the “regard field terms” setting is activated.
Taxonomy Terms
-
incoming_terms( String $taxonomy, Arguments $args = array() )WOOF_Collection of
Retrieves all terms that are related to this term via of the Related Term field type.
-
update( Boolean $include_sets = true )
Extends the WOOF_Term::update method for updating term data, to also update any modified MasterPress custom field data for this term.Important Note: If you have just created a new term via the WOOF_Taxonomy::create method and you have also updated custom field data, you must use this method to commit the field data if you haven’t already committed the new term to the database, rather than any of the methods MEOW_Field::update, MEOW_FieldSet::update, or MEOW_FieldSetCollection::update. The reason for this is that the new term will not yet have a term_id to attach metadata to, and this method contains special handling to account for this case (it will update the term first before the custom fields). .
Users
-
incoming_users( $args = array() )WOOF_Collection of MEOW_User
Retrieves all users that are related to this term via of the Related User field type.
-
__call( String $name, Array $args )Mixed
Overrides the --call method to also look for incoming posts of type “post_type_name” when attempting to call a method of the form “incoming_[post_type_name_plural_form]”.
-
__get( String $name )Mixed OR WOOF_Silent
Implements the PHP magic method __get called when an unknown property is accessed.
-
blank()Boolean
An internal method to check if this represents a term that actually exists.
-
f( String $name )MEOW_Field
A synonym for the field method to retrieve a field for this term.
-
field( String $name )MEOW_Field
Retrieves a field in this term with the given name.
-
has( String $name )MEOW_Field OR MEOW_FieldSet OR Boolean
Checks for the existence of a set or a field in this term, and that there are entries or values entered for either.
-
has_field( String $name )MEOW_Field OR Boolean
Checks for the existence of a field and that the field has content entered for this site.
-
has_set( String $name )MEOW_FieldSet OR Boolean
Checks for the existence of a field set of a given name for this term, and if the set has entries in the case of a multi-item set.
-
incoming( Array / String $args = array() )WOOF_Collection of MEOW_Post
Retrieves all posts that are related to this term via of the Related Term field type.
-
incoming_terms( String $taxonomy, Arguments $args = array() )WOOF_Collection of
Retrieves all terms that are related to this term via of the Related Term field type.
-
incoming_users( $args = array() )WOOF_Collection of MEOW_User
Retrieves all users that are related to this term via of the Related User field type.
-
posts( Arguments $args = array() )WOOF_Collection of MEOW_Post
Overrides the WOOF_Term::posts method to allow posts related to this term via a Related Term field to be included if the “regard field terms” setting is activated.
-
query_incoming( Array / String $args = array() )WOOF_Collection of MEOW_Post
Retrieves all posts that are related to the this post by means of the Related Term field type, while also affecting the main query loop in WordPress.
-
s( String $name )MEOW_FieldSet OR WOOF_Silent
A synonym for the MEOW_Term::set to retrieve a field set for this term with the given name. Note: It is generally more concise to make use of the method overloading to retrieve a set, but this method is a fallback when the field name clashes with a known property of the term.
-
set( String $name )MEOW_FieldSet OR WOOF_Silent
Retrieves a field set for this term with the given name. Note: It is more concise to make use of the __get method overloading to retrieve a set, but this method is a fallback when the field name clashes with a known property of the term. .
-
sets()Array
Retrieves the names of all of the available field sets currently available to this object.
-
update( Boolean $include_sets = true )
Extends the WOOF_Term::update method for updating term data, to also update any modified MasterPress custom field data for this term.Important Note: If you have just created a new term via the WOOF_Taxonomy::create method and you have also updated custom field data, you must use this method to commit the field data if you haven’t already committed the new term to the database, rather than any of the methods MEOW_Field::update, MEOW_FieldSet::update, or MEOW_FieldSetCollection::update. The reason for this is that the new term will not yet have a term_id to attach metadata to, and this method contains special handling to account for this case (it will update the term first before the custom fields). .
Base Class Methods
View method list from the base class WOOF_Term.