Filters and Actions (Hooks)
Actions
Hook into an action with add_action(). Example:
function group_is_gone_message( $group_id ) {
echo "Group {$group_id} is gone!";
}
add_action( 'term_group_deleted', 'group_is_gone_message' );| Action name | Arguments | When triggered |
|---|---|---|
| term_group_saved | void | after information about (one or more) term groups was saved |
| term_group_deleted | integer: group ID | after a group has been deleted |
| groups_of_term_saved | integer: term ID integer or array of integers: tag group IDs | after a term’s assignment to groups was saved |
Filters
Hook into a filter with add_filter(). The function should return the modified first argument. Example:
function wrap_as_gift( $html ) {
return "<div class='wrapping_paper'>" . $html . "</div>";
}
add_filter( 'tag_groups_post_terms', 'wrap_as_gift' );| Filter name | Arguments | Filters what |
|---|---|---|
| tag_groups_view_{$view_slug} | string: content (HTML) | filters a string that contains the HTML of a view before output. Find possible view_slugs in the code (in the “view” folders, the part before “.view.php”) |
| tag_groups_post_terms (premium only) | string: content (HTML) | filters a string containing the table of post tags, in TagGroups_Premium_API::post_terms |
| tag_groups_cloud_tag_inner | string: content integer: term ID string: shortcode identifier | filters all tag names in tag clouds |
| tag_groups_cloud_tag_outer | string: content (HTML) integer: term ID string: shortcode identifier | filters all tag names in tag clouds, including the wrapping <span> element |
| tag_groups_cloud_html | string: content (HTML) string: shortcode identifier array: shortcode parameters | filters the complete HTML output of all tag clouds |