get_loaded_content()

public function get_loaded_content( string $key, string $before, string $after, string $fallback = '' )

This method allows you to retrieve and filter content from loaded post meta more efficiently than by using the get_meta() method. Before this method is used, load_meta() must be first called to load a specified post's meta into the $loaded_meta property. Otherwise, this method will not function as expected. Loaded meta key values, if set and not empty, are passed through the filter_content() class method, then wrapped in values provide for the $before and $after arguments. This method is most useful when handeling content entered through a TinyMCE field.

Arguments#

$key
(string) (required) The loaded meta key to check and use if is set and not empty.
$before
(string) (required) Markup to include before the processed value of the loaded meta key, if the key is set and not empty, or a fallback value has been provided.
$after
(string) (required) Markup to include after the processed value of the loaded meta key, if the key is set and not empty, or a fallback value has been provided.
$fallback
(string) (optional) An optional string to fall back to if the loaded meta key isn't set or is empty. If a fallback value is not provided and the key isn't set or is empty, the method will return empty. If used, the $fallback string will not be passed through the filter_content() class method.

For this example, let's imagine that we have a custom post type called locations. For each location a content editor adds, we've used CMB2 to create a WYSIWYG (TinyMCE) field (stored as post meta with the key _method_location_short_description) that allows content editors to add a short description for each location, alongside the full description that we'd only show on each location's page (which WordPress' built-in editor field would handle). In the example below, we'll build a layout component that loops through each location, checks to see if a short description has been set, and displays it if available. Otherwise, nothing will be displayed:

Example#

$args = array(
    'posts_per_page' => -1,
    'post_type'   => 'locations',
    'fields'      => 'ids'
);
$items = get_posts( $args );
$this->html .= '
    <div id="method-location-list">
        <div class="container-fluid full-width-container">
            <div class="row justify-content-center">
                <div class="col-11">
';
foreach ( $items as $item ) {
    $this->load_meta( $item );
    $this->html .= '
        <div class="location-row">
            <h2>' . get_the_title( $item ) . '</h2>
            ' . get_loaded_content( '_method_location_short_description', '<div class="desc-wrap">', '</div>' ) . '
            <!-- Additional locatiom details would normally be pull and displayed here. -->
        </div>
    ';
    $this->unload_meta();
}
$this->html .= '
                </div>
            </div>
        </div>
    </div>
';