Post Relation Field

Field type: post_relation
Renderer class: WPContent
Aliases using the same renderer: cpt_select, page_select, post_autocomplete, post_checkbox, post_radio, post_select

Purpose

Multiple post relationship selector.

Value shape

Array of selected values/IDs.

Supported attributes

Common attributes

Attribute	Type	Description
`id`	string	Required for data-saving fields. Unique key inside the option/meta array. Required for saving.
`type`	string	Required. Field type slug, for example `text`, `select`, or `repeater`.
`title`	string	Main field label displayed in the left column.
`subtitle`	string	Small helper text below the field title.
`desc`	string/html	Description displayed below the control. Limited HTML is allowed.
`default`	mixed	Default value used when there is no saved value yet.
`placeholder`	string	Placeholder text for input/select-like fields when supported.
`dependency`	array	Conditional visibility rules. Example: `[ "field" => "enable", "operator" => "==", "value" => 1 ]`.
`sanitize_callback`	callable	Custom sanitizer callback. Receives `$value` and `$field`.

Field-specific attributes

| Attribute | Type | Description | |---|---:|---| | limit | int | Maximum items to load/show. | | multiple | bool | Allow selecting more than one value. Saved value becomes an array. | | order | string | ASC or DESC. | | orderby | string | Post query orderby value such as date, title, or menu_order. | | post_status | string|array | Post status filter. Usually publish. | | post_type | string|array | Post type or list of post types to query. | | variant | string | Renderer variant, for example select, checkbox, radio, autocomplete, or relation. |

Options Framework example

KAVRO::createSection( $prefix, array(
    'title'  => 'Post Relation Example',
    'fields' => array(
        array(
            'id' => 'demo_post_relation',
            'type' => 'post_relation',
            'title' => 'Post Relation',
            'subtitle' => 'Post Relation field example.',
            'desc' => 'This is a documented post_relation field example.',
            'post_type' => 'post',
            'post_status' => 'publish',
            'limit' => 20,
            'default' => array(
                'one',
                'two',
            ),
        ),
    ),
) );

Metabox example

KAVRO::createSection( $metabox_prefix, array(
    'title'  => 'Post Relation Meta',
    'fields' => array(
        array(
            'id' => 'demo_post_relation',
            'type' => 'post_relation',
            'title' => 'Post Relation',
            'subtitle' => 'Post Relation field example.',
            'desc' => 'This is a documented post_relation field example.',
            'post_type' => 'post',
            'post_status' => 'publish',
            'limit' => 20,
            'default' => array(
                'one',
                'two',
            ),
        ),
    ),
) );

Customizer example

$customize_prefix = 'kavro_customize_demo';

KAVRO::createCustomizeOptions( $customize_prefix, array(
    'title' => 'Kavro Customizer Demo',
) );

KAVRO::createSection( $customize_prefix, array(
    'title'  => 'Post Relation Customizer',
    'fields' => array(
        array(
            'id'       => 'demo_post_relation',
            'type'     => 'post_relation',
            'title'    => 'Post Relation',
            'subtitle' => 'Post Relation field example.',
            'desc'     => 'This example uses the same field configuration in this framework context.',
        ),
    ),
) );

Taxonomy Options example

$taxonomy_prefix = 'kavro_taxonomy_demo';

KAVRO::createTaxonomyOptions( $taxonomy_prefix, array(
    'taxonomy' => array( 'category', 'post_tag' ),
) );

KAVRO::createSection( $taxonomy_prefix, array(
    'title'  => 'Post Relation Term Field',
    'fields' => array(
        array(
            'id'       => 'demo_post_relation',
            'type'     => 'post_relation',
            'title'    => 'Post Relation',
            'subtitle' => 'Post Relation field example.',
            'desc'     => 'This example uses the same field configuration in this framework context.',
        ),
    ),
) );

Profile/User Options example

$profile_prefix = 'kavro_profile_demo';

KAVRO::createProfileOptions( $profile_prefix, array(
    'roles' => array( 'administrator', 'editor' ),
) );

KAVRO::createSection( $profile_prefix, array(
    'title'  => 'Post Relation User Field',
    'fields' => array(
        array(
            'id'       => 'demo_post_relation',
            'type'     => 'post_relation',
            'title'    => 'Post Relation',
            'subtitle' => 'Post Relation field example.',
            'desc'     => 'This example uses the same field configuration in this framework context.',
        ),
    ),
) );

Nav Menu Options example

$nav_menu_prefix = 'kavro_nav_menu_demo';

KAVRO::createNavMenuOptions( $nav_menu_prefix, array(
    'title' => 'Kavro Menu Item Options',
) );

KAVRO::createSection( $nav_menu_prefix, array(
    'title'  => 'Post Relation Menu Item Field',
    'fields' => array(
        array(
            'id'       => 'demo_post_relation',
            'type'     => 'post_relation',
            'title'    => 'Post Relation',
            'subtitle' => 'Post Relation field example.',
            'desc'     => 'This example uses the same field configuration in this framework context.',
        ),
    ),
) );

Widget Options example

$widget_prefix = 'kavro_widget_demo';

KAVRO::createWidgetOptions( $widget_prefix, array(
    'title' => 'Kavro Widget Options',
) );

KAVRO::createSection( $widget_prefix, array(
    'title'  => 'Post Relation Widget Field',
    'fields' => array(
        array(
            'id'       => 'demo_post_relation',
            'type'     => 'post_relation',
            'title'    => 'Post Relation',
            'subtitle' => 'Post Relation field example.',
            'desc'     => 'This example uses the same field configuration in this framework context.',
        ),
    ),
) );

Comment Options example

$comment_prefix = 'kavro_comment_demo';

KAVRO::createCommentOptions( $comment_prefix, array(
    'title' => 'Kavro Comment Options',
) );

KAVRO::createSection( $comment_prefix, array(
    'title'  => 'Post Relation Comment Field',
    'fields' => array(
        array(
            'id'       => 'demo_post_relation',
            'type'     => 'post_relation',
            'title'    => 'Post Relation',
            'subtitle' => 'Post Relation field example.',
            'desc'     => 'This example uses the same field configuration in this framework context.',
        ),
    ),
) );

Shortcode Framework example

KAVRO::createShortcode( 'kavro_demo_shortcode', array(
    'title'  => 'Kavro Demo Shortcode',
    'tag'    => 'kavro_demo',
    'fields' => array(
        array(
            'id'       => 'demo_post_relation',
            'type'     => 'post_relation',
            'title'    => 'Post Relation',
            'subtitle' => 'Post Relation field example.',
            'desc'     => 'This example uses the same field configuration in this framework context.',
        ),
    ),
) );

Get saved value

From Options Framework

$value = kavro_get_option( $prefix, 'demo_post_relation', null );

From Metabox

$value = kavro_get_post_meta( get_the_ID(), $metabox_prefix, 'demo_post_relation', null );

From Customizer

$value = get_theme_mod( 'demo_post_relation', null );

From Taxonomy Options

$value = kavro_get_term_meta( $term_id, $taxonomy_prefix, 'demo_post_relation', null );

From Profile/User Options

$value = kavro_get_user_meta( $user_id, $profile_prefix, 'demo_post_relation', null );

From Nav Menu Options

$value = kavro_get_nav_menu_item_meta( $menu_item_id, $nav_menu_prefix, 'demo_post_relation', null );

From Widget Options

$value = kavro_get_widget_option( $widget_id, $widget_prefix, 'demo_post_relation', null );

From Comment Options

$value = kavro_get_comment_meta( $comment_id, $comment_prefix, 'demo_post_relation', null );

From Shortcode Framework

Shortcode field values are passed to the shortcode callback as attributes or normalized settings depending on your shortcode registration callback.

$value = isset( $atts['demo_post_relation'] ) ? $atts['demo_post_relation'] : null;

Notes

This field queries WordPress data. Keep limit reasonable on large sites and prefer AJAX/autocomplete variants for large datasets.

← Post Radio Post Select →