Shiba

Adventures in WordPress

You are here: Home / WordPress Programming / Add Tags and Categories to Your WordPress Page

Add Tags and Categories to Your WordPress Page

by 62 Comments

Currently, we cannot add tags and categories to our WordPress pages.

Why add tags to pages?

Tags are very useful. They can be applied in a variety of non-standard, but powerful ways to enhance our blogs.

I use tags to filter out file loads and certain types of plugin operations. For example, I only run the wp-syntax plugin functions on pages that actually contain code. Similarly, we can use tags to load in special galleries for particular pages, or restrict a given plugin to a specified group of posts.

This allows us to optimize our WordPress blog and increase page speed.

Tags and categories are also used by plugins to identify related posts (for example the YARPP plugin). Adding tags to pages will presumably help the plugin return better results for both related posts and pages.

How to Add Tags and Categories to WordPress Pages

We can add tags to our WordPress pages by simply using the add_meta_box command as follows –

// Add to the admin_init hook of your theme functions.php file
add_meta_box(	'tagsdiv-post_tag', __('Page Tags'), 'post_tags_meta_box', 
		'page', 'side', 'low');

Argument 1 must be set to tagsdiv-post_tag because this name is used in other WordPress functions to ensure that the metabox operates correctly and the proper tag values get saved with the page.

Argument 3 must be set to post_tags_meta_box because this is the native WordPress function used to render the tag metabox.

Similarly, we can use the same add_meta_box command to add a category metabox to our WordPress page.

add_meta_box(	'categorydiv', __('Categories'), 'post_categories_meta_box', 
		'page', 'side', 'core');

Added Tag and Category Metabox to our WordPress Page.
Added Tag and Category Metabox to our WordPress Page.

Saving Tags and Categories for WordPress Pages

You will quickly notice that when you update your WordPress page, the category does not get saved.

This is because the WordPress system does a check with the is_object_in_taxonomy function to see if categories can actually be assigned to pages.

To properly save our tag and category data, we want to properly register our WordPress pages to the post_tag and category taxonomies. We can do this with the register_taxonomy_for_object_type function.

// Add to the admin_init hook of your theme functions.php file

// Add tag metabox to page 
add_meta_box(    'tagsdiv-post_tag', __('Page Tags'), 'post_tags_meta_box', 
                'page', 'side', 'low');
register_taxonomy_for_object_type('post_tag', 'page');

// Add category metabox to page 
add_meta_box(    'categorydiv', __('Categories'), 'post_categories_meta_box', 
                'page', 'side', 'core');
register_taxonomy_for_object_type('category', 'page');

Success! Once we do this, our categories get saved with our pages.

Note – As pointed out by XYDAC metaboxes automatically get added as part of the register_taxonomy_for_object_type function. Therefore, we can streamline our code and remove the add_meta_box commands.

// Add to the admin_init hook of your theme functions.php file
register_taxonomy_for_object_type('post_tag', 'page');
register_taxonomy_for_object_type('category', 'page');

Categories are now properly attached to your WordPress page.
Categories are now properly attached to your WordPress page.

How to Retrieve Both Posts and Pages for Tag and Category Links

Now that we have set up tags and categories for WordPress pages, we may want our tag and category blog links to also retrieve those pages.

To do this, we can hook into the WordPress request filter.

// Add to the init hook of your theme functions.php file
add_filter('request', 'my_expanded_request');  

function my_expanded_request($q) {
	if (isset($q['tag']) || isset($q['category_name'])) 
                $q['post_type'] = array('post', 'page');
	return $q;
}

We Are Done!

Enjoy your new expanded WordPress pages.

Leave a Reply

Your email address will not be published.

Comments

  1. Hi,

    Could someone tell me how do i retrieve all tags that are posted while adding pages?

    Thanks,
    Harpinder

    Reply

      • Hi

        Any chance you could elaborate on how to display on a page the Category ID’s that have been selected.

        I’ve looked at the codex and I just don’t get it 🙁

        I can’t get wp_get_object_terms to return me anything, the other stuff sets and saves brilliantly though….

        Half way there 🙁

      • Here’s an example on retrieving the tags attached to a page (in my case $work): — the good example —

        foreach($works as $work){
      $tags = wp_get_object_terms($work->ID, 'post_tag');
      if(!empty($tags)){
            if(!is_wp_error( $tags )){
                  foreach($tags as $tag){
                        echo get_term_link($tag->slug, 'post_tag');  // the link
                        echo $tag->name;  // the name
                  }
            }
      }
}

      • I’m also having trouble finding the admin_init hook. Can you have a look at my function.php file I have shared as google doc under my website field in this form and let me know where to put it. Thanks

      • That admin_init hook could also be in any of the included files. Or if there isn’t an admin_init hook, then you can add one using the add_action function.

  4. Great article – very helpful. I can now get my pages to display its tags, but not its categories – is there any reason category template tags (ie the_category() wouldn’t work with this solution?

    Thanks!

    Reply

    • That will depend on the plugin and whether it checks for taxonomy relationships with various custom post types. It is best to ask the plugin developer.

      Reply

  6. Shiba, thanks for sharing this– I’ve been looking for a plug-in that does this but couldn’t get one. I am still having a slight issue, hoping someone could help: I added the two lines register_taxonomy of code in the initialization function. This made the Category and Tag boxes show on my page edit screen, however the categories don’t seem to paste. What am I doing wrong?

    Thanks in advance!

    Reply

      • I’m pretty sure I’ve tried this before and it would work, but now my categories don’t seem to save.

        add_meta_box( 'tagsdiv-post_tag',	__('Page Tags'),	'post_tags_meta_box',		'page',	'side',	'low');
register_taxonomy_for_object_type('post_tag', 'page');

add_meta_box( 'categorydiv',		__('Categories'),	'post_categories_meta_box',	'page',	'side',	'core');
register_taxonomy_for_object_type('category', 'page');

        The tags save just fine.
        Any ideas?

      • It saves categories and tags for pages.But when you want to display it in loop you have to add ‘post_type’ => ‘page’ with quotes under query_post array.If you don’t do that wordpress thinks user wants posts in a category not pages.

  7. I used ‘taxonomies’ => array(‘category’), to get the categories meta box on my custom post page, for some reason the categories do not seem to be updating (when I erase a category it is still there as an option on my custom post page). Do you know why? This is the code I used:

    add_action('init', 'product_register');

	function product_register() {
    	$args = array(
        	'label' => __('Products'),
        	'singular_label' => __('Product'),
        	'public' => true,
        	'show_ui' => true,
        	'capability_type' => 'post',
        	'hierarchical' => false,
        	'rewrite' => false,
			'taxonomies' => array( 'category'),
        	'supports' => array('title', 'editor', 'thumbnail')
        );

    	register_post_type('product' , $args);
		
	}
    Reply

  9. Hey i think after using register_taxonomy_for_object_type(), WordPress automatically creates respective Meta-box,so why do you need to add them.

    We can use only register_taxonomy_for_object_type(),and that should be all, adding the request filter was important as WordPress doesn’t automatically links pages to categories in WP 3.0
    Nice Work 🙂

    Reply