Utility Functions

// Frontend AJAX implementation
jQuery.ajax({
    url: ajax_object.ajax_url,
    type: 'POST',
    data: {
        action: 'sancho_contact',
        nonce: ajax_object.nonce,
        name: jQuery('#name').val(),
        email: jQuery('#email').val(),
        message: jQuery('#message').val()
    },
    success: function(response) {
        if (response.success) {
            alert(response.data);
        } else {
            alert('Error: ' + response.data);
        }
    }
});

// Required nonce in template
wp_localize_script('your-script', 'ajax_object', array(
    'ajax_url' => admin_url('admin-ajax.php'),
    'nonce' => wp_create_nonce('sancho_nonce')
));

// Example metabox for About page
function my_about_metabox_callback($post) {
    $data = get_post_meta($post->ID, '_about_extra', true);
    wp_nonce_field('vertisub_save_about_extra', 'vertisub_about_extra_nonce');
    ?>
    <p>
        <label>Main Image URL:</label>
        <input type="url" name="about_extra[main_image]" 
               value="<?php echo esc_attr($data['main_image'] ?? ''); ?>" />
    </p>
    <p>
        <label>Main Video URL:</label>
        <input type="url" name="about_extra[main_video]" 
               value="<?php echo esc_attr($data['main_video'] ?? ''); ?>" />
    </p>
    <p>
        <label>Years of Experience:</label>
        <input type="number" name="about_extra[years]" 
               value="<?php echo esc_attr($data['years'] ?? ''); ?>" />
    </p>
    <p>
        <label>Number of Projects:</label>
        <input type="number" name="about_extra[projects]" 
               value="<?php echo esc_attr($data['projects'] ?? ''); ?>" />
    </p>
    <p>
        <label>Number of Clients:</label>
        <input type="number" name="about_extra[clients]" 
               value="<?php echo esc_attr($data['clients'] ?? ''); ?>" />
    </p>
    <p>
        <label>Additional Content:</label>
        <textarea name="about_extra[content]"><?php 
            echo esc_textarea($data['content'] ?? ''); 
        ?></textarea>
    </p>
    <?php
}

// Retrieve About page data in template
$about_data = get_post_meta(get_the_ID(), '_about_extra', true);

if (!empty($about_data['main_image'])) {
    echo '<img src="' . esc_url($about_data['main_image']) . '" alt="About">';
}

if (!empty($about_data['years'])) {
    echo '<div class="stat"><span>' . esc_html($about_data['years']) . 
         '</span> Years of Experience</div>';
}

if (!empty($about_data['projects'])) {
    echo '<div class="stat"><span>' . esc_html($about_data['projects']) . 
         '</span> Projects Completed</div>';
}

if (!empty($about_data['clients'])) {
    echo '<div class="stat"><span>' . esc_html($about_data['clients']) . 
         '</span> Satisfied Clients</div>';
}

// Get field from current post
$hero_title = vertisub_get_acf_field('hero_title');
if (!empty($hero_title)) {
    echo '<h1>' . esc_html($hero_title) . '</h1>';
}

// Get field from ACF options page
$site_phone = vertisub_get_acf_field('company_phone', true);
$site_email = vertisub_get_acf_field('company_email', true);
$site_address = vertisub_get_acf_field('company_address', true);

echo '<div class="contact-info">';
if (!empty($site_phone)) {
    echo '<p>Phone: ' . esc_html($site_phone) . '</p>';
}
if (!empty($site_email)) {
    echo '<p>Email: ' . esc_html($site_email) . '</p>';
}
if (!empty($site_address)) {
    echo '<p>Address: ' . esc_html($site_address) . '</p>';
}
echo '</div>';

// Work with image fields
$logo = vertisub_get_acf_field('site_logo', true);
if (!empty($logo)) {
    // If returning image array
    if (is_array($logo)) {
        echo '<img src="' . esc_url($logo['url']) . '" ' .
             'alt="' . esc_attr($logo['alt']) . '">';
    }
    // If returning image ID
    elseif (is_numeric($logo)) {
        echo wp_get_attachment_image($logo, 'full');
    }
    // If returning image URL
    else {
        echo '<img src="' . esc_url($logo) . '" alt="Logo">';
    }
}

// Work with repeater fields
$team_members = vertisub_get_acf_field('team_members');
if (!empty($team_members)) {
    echo '<div class="team-grid">';
    foreach ($team_members as $member) {
        echo '<div class="team-member">';
        echo '<h3>' . esc_html($member['name']) . '</h3>';
        echo '<p>' . esc_html($member['position']) . '</p>';
        if (!empty($member['photo'])) {
            echo '<img src="' . esc_url($member['photo']['url']) . '" ' .
                 'alt="' . esc_attr($member['name']) . '">';
        }
        echo '</div>';
    }
    echo '</div>';
}

// Safe usage without ACF plugin active
// This will return empty string instead of causing fatal error
$custom_field = vertisub_get_acf_field('some_field');
if (empty($custom_field)) {
    // Fallback to default value or standard WordPress meta
    $custom_field = get_post_meta(get_the_ID(), 'some_field', true);
}