Documentation

Documentation > Containers > Post Meta

Post Meta

Custom Field containers are used to extend the post edit screens with additional fields. Field data is stored separately for each post as post meta (see add_post_meta).

Container position

More information about the position options can be found in the add_meta_box() function.

Context

The part of the page where the container should be shown ('normal' (default), 'advanced', 'side' or 'carbon_fields_after_title')

->set_context( 'normal' )

Priority

The priority within the context where the container should show ('high' (default), 'core', 'default' or 'low')

->set_priority( 'high' )

Accessing field values

To access field values you need to use the function carbon_get_post_meta( $id, $name ), where:

Parameter Description
$id Post ID where your value was entered.
$name The field name pattern of the field to be retrieved.
<!-- Simple field -->
<p>Article was published in: <?php echo carbon_get_post_meta( get_the_ID(), 'crb_location' ); ?></p>

<!-- Complex field -->
<?php 
$slides = carbon_get_post_meta( get_the_ID(), 'crb_slides' );
if ( $slides ) {
    foreach ( $slides as $slide ) {
        echo $slide['image'];
    }
}
?>

You can also use carbon_get_the_post_meta( $name ) to access the values for the current post in The Loop.

<p>Article was published in: <?php echo carbon_get_the_post_meta( 'crb_location' ); ?></p>

<?php $slides = carbon_get_the_post_meta( 'crb_slides' ); ?>

After saving, the carbon_fields_post_meta_container_saved hook is called, which allows you to hook additional functionality after saving. It accepts the $post_id parameter, which is the ID of the post being updated. Example:

add_action( 'carbon_fields_post_meta_container_saved', 'crb_after_save_event' );
function crb_after_save_event( $post_id ) {
    if ( get_post_type( $post_id ) !== 'crb_event' ) {
        return false;
    }

    $event_date = carbon_get_post_meta( $post_id, 'crb_event_date' );
    if ( $event_date ) {
        $timestamp = strtotime( $event_date );
        update_post_meta( $post_id, '_crb_event_timestamp', $timestamp );
    }
}

Excited about Carbon Fields? Spread the word!