Meta Boxes

1. # About Meta Boxes
2. # Adding a Meta Box
3. # Dashboard: Meta Box
4. # Comments: Meta Box
5. # Post Types: Meta Box
6. # Example 1: using addScreen() and addPostType()
7. # Example 2: using apply()
8. # Page Template: Meta Box
9. # Debug mode
10. # Adding content
11. # Example 1: Using a callback
12. # Example 2: Using debug function
13. # Label
14. # Setting and Getting the ID
15. # Arguments
16. # Priority
17. # Context

#About Meta Boxes

Meta boxes are the movable boxes you see on the dashboard or when editing a post. If you have the TypeRocket SEO plugin enabled you will see that it creates a meta box for you to add extra information about your content.

#Adding a Meta Box

To create a meta box with TypeRocket use the tr_meta_box() function.

When you create a meta box be sure you are not using any of the names used by post type supports.

<?php // functions.php

$box = tr_meta_box('Author Details');

#Dashboard: Meta Box

To add a meta box to the dashboard use the addScreen() method on the newly created meta box.

$box->addScreen('dashboard');

#Comments: Meta Box

To add a meta box to a comment use addScreen() as well.

$box->addScreen('comment');

#Post Types: Meta Box

To add a meta box to a post type you can use addScreen(), addPostType() or the apply() method.

#Example 1: using addScreen() and addPostType()

Pass in the post type's name/ID when you use add screen.

Take a look at adding a meta box to both a custom post type created by TypeRocket and the WordPress posts post type.

$book = tr_post_type('Book');
$box = tr_meta_box('Author Details');
$box->addPostType( $book->getId() );
$box->addScreen( 'post' );

#Example 2: using apply()

If you use apply() pass the TypeRocket post type object.

$book = tr_post_type('Book');
$box = tr_meta_box('Author Details');
$box->apply( $book );

#Page Template: Meta Box

You can also add a meta box to a specific page template:

tr_meta_box('Box')->addScreen('front_page');
tr_meta_box('Box')->addScreen('posts_page');
tr_meta_box('Box')->addScreen('page-example.php');

#Debug mode

Once you have added a meta box to a screen or post type you can start adding content to it. If you have debug mode turned on, TypeRocket will tell what function needs to be created for the meta box content.

#Adding content

To add content to a meta box you can use the function debug mode gives you. You can also provide a callback.

To specify a callback use the setCallback() method.

#Example 1: Using a callback

$box = tr_meta_box('Author Details');

$box->setCallback(function() {
    echo '<p>My callback.</p>';
});

#Example 2: Using debug function

tr_meta_box('Author Details');

function add_meta_content_author_details() {
    echo '<p>My callback.</p>';
}

#Label

If you want to set the label used by the meta box you need the method setLabel(). You can get the label with getLabel().

$box->setLabel('Book Author Details');

#Setting and Getting the ID

When instance a meta box TypeRocket automatically creates the ID for you.

The ID is used to specify the name that WordPress associates with your meta box. It is also registered under the ID. When you register "Author Details" with TypeRocket the id is set to "author_details".

You can change the ID using the setId() method.

$box->setId('author_details_box');

Get the ID

$boxId = $box->getId();

#Arguments

There are five methods of dealing with arguments. Arguments the extra data you can use in the callback by accessing the meta box object passed into it.

These methods are: getArguments(), setArguments(), getArgument(), setArgument() and removeArgument().

1. getArguments() returns the full array of arguments.
2. setArguments() takes an array of arguments.
3. getArgument() return an argument by its key.
4. setArgument() sets an argument by a key.
5. removeArgument() removes an argument by its key.

Take a look at using all the methods without affecting the already set values.

$args = $box->getArguments();
$args = array_merge( $args, array( 'yourArg' => true ) );
$box->setArguments( $args );
$public = $box->getArgument( 'yourArg' );
$box->removeArgument( 'yourArg' );
$box->setArgument( 'yourArg', $public );

#Priority

To set the meta box priority use the setPriority() method. You can also get the priority with getPriority().

There are four options for priority high, core, default or low.

#Context

To set the context or the meta box use setContext(). You can get the context with getContext().

There are three options for the context normal, advanced, or side.