// Get a post/page meta value
$value = onemeta_get_meta( get_the_ID(), 'field_key' );

// Get a user meta value
$value = onemeta_get_user_meta( $user_id, 'field_key' );

// With a default fallback
$value = onemeta_get_meta( get_the_ID(), 'field_key', 'Default Value' );

// Get
$value = onemeta_get_meta( $post_id, 'field_key', 'default' );

// Update
onemeta_update_meta( $post_id, 'field_key', $value );

// Delete
onemeta_delete_meta( $post_id, 'field_key' );

// Get
$value = onemeta_get_user_meta( $user_id, 'field_key', 'default' );

// Update
onemeta_update_user_meta( $user_id, 'field_key', $value );

// Delete
onemeta_delete_user_meta( $user_id, 'field_key' );

$text = onemeta_get_meta( get_the_ID(), 'custom_title' );
echo '<h2>' . esc_html( $text ) . '</h2>';

$content = onemeta_get_meta( get_the_ID(), 'field_description' );
// Preserve line breaks and escape
echo wp_kses_post( wpautop( $content ) );

$url = onemeta_get_meta( get_the_ID(), 'field_website' );
if ( $url ) {
    echo '<a href="' . esc_url( $url ) . '" target="_blank" rel="noopener">Visit Website</a>';
}

$email = onemeta_get_meta( get_the_ID(), 'field_email' );
if ( $email ) {
    echo '<a href="mailto:' . esc_attr( $email ) . '">' . esc_html( $email ) . '</a>';
}

$date = onemeta_get_meta( get_the_ID(), 'field_event_date' );
if ( $date ) {
    // Returns Y-m-d format — convert to any display format
    echo '<time datetime="' . esc_attr( $date ) . '">';
    echo date_i18n( get_option( 'date_format' ), strtotime( $date ) );
    echo '</time>';
}

// Returns "1" for on, empty string for off — not boolean
$is_featured = onemeta_get_meta( get_the_ID(), 'is_featured' );
if ( $is_featured === '1' ) {
    echo '<span class="badge">⭐ Featured</span>';
}

// All return the selected value as a string
$layout = onemeta_get_meta( get_the_ID(), 'field_layout' );
echo '<div class="layout-' . esc_attr( $layout ) . '">';

// Map values to labels
$choices = [ 'grid' => 'Grid View', 'list' => 'List View' ];
echo esc_html( $choices[ $layout ] ?? $layout );

// Returns array of selected values
$features = onemeta_get_meta( get_the_ID(), 'field_features' );
if ( is_array( $features ) && ! empty( $features ) ) {
    foreach ( $features as $feature ) {
        echo '<span class="badge">' . esc_html( $feature ) . '</span>';
    }
}

// Check if a specific value is selected
if ( in_array( 'wifi', $features, true ) ) {
    echo '📶 WiFi Available';
}

// Returns attachment ID (integer)
$image_id = onemeta_get_meta( get_the_ID(), 'featured_image' );
if ( $image_id ) {
    // Recommended: use wp_get_attachment_image() for srcset, lazy loading, etc.
    echo wp_get_attachment_image( $image_id, 'large', false, [
        'class' => 'featured-image',
        'alt'   => get_the_title(),
    ] );
}

// Returns attachment ID (integer)
$file_id = onemeta_get_meta( get_the_ID(), 'field_document' );
if ( $file_id ) {
    $file_url  = wp_get_attachment_url( $file_id );
    $file_name = basename( get_attached_file( $file_id ) );
    $file_size = size_format( filesize( get_attached_file( $file_id ) ) );
    echo '<a href="' . esc_url( $file_url ) . '" download>';
    echo esc_html( $file_name ) . ' (' . $file_size . ')';
    echo '</a>';
}

// Returns array of attachment IDs
$gallery = onemeta_get_meta( get_the_ID(), 'field_gallery' );
if ( is_array( $gallery ) && ! empty( $gallery ) ) {
    echo '<div class="gallery">';
    foreach ( $gallery as $image_id ) {
        echo wp_get_attachment_image( $image_id, 'medium', false, [
            'class' => 'gallery-item',
        ] );
    }
    echo '</div>';
}

// Returns array of row arrays — each row contains your sub-field values
$team = onemeta_get_meta( get_the_ID(), 'field_team_members' );
if ( is_array( $team ) && ! empty( $team ) ) {
    echo '<div class="team-grid">';
    foreach ( $team as $member ) {
        echo '<div class="team-member">';
        if ( ! empty( $member['member_avatar'] ) ) {
            echo wp_get_attachment_image( $member['member_avatar'], 'thumbnail', false, [
                'alt' => esc_attr( $member['member_name'] ?? '' ),
            ] );
        }
        echo '<h3>' . esc_html( $member['member_name'] ?? '' ) . '</h3>';
        echo wp_kses_post( wpautop( $member['member_bio'] ?? '' ) );
        echo '</div>';
    }
    echo '</div>';
}

'my_field' => [
    'type'        => 'text',
    'label'       => 'My Text Field',
    'conditional' => [
        'field'    => 'my_other_field',
        'operator' => '!=',
        'value'    => '',
    ],
],

define( 'WP_DEBUG', true );
define( 'ONEMETA_DEV_MODE', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
define( 'WP_ENVIRONMENT_TYPE', 'local' );

// define( 'ONEMETA_DEV_MODE', true );