Image Galleries

'content_source' => 'images',
'images' => array(
    array(
        'id' => 123,                    // Attachment ID (required)
        'title' => 'My Image',          // Custom title
        'description' => 'Description', // Custom description
        'categories' => array('Nature', 'Landscape'),
        'format' => 'standard',         // standard | video
        'video_url' => '',              // For video format
        'url' => '',                    // Custom click URL
        'author' => 'John Doe',         // Author name
        'author_url' => 'https://...',  // Author URL
        'focalPoint' => array('x' => 0.5, 'y' => 0.5),
    )
)

'images_titles_source' => 'custom'  // Options below

'images_descriptions_source' => 'custom'  // Same options as above

'categories' => array('Web Design', 'Branding', 'Photography')

'format' => 'standard'

'format' => 'video',
'video_url' => 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'

'url' => 'https://example.com/project'

'author' => 'Jane Smith',
'author_url' => 'https://janesmith.com'

'focalPoint' => array(
    'x' => 0.5,  // 0 (left) to 1 (right)
    'y' => 0.3   // 0 (top) to 1 (bottom)
)

'images_order_by' => 'default'  // Options below

'images_order_direction' => 'asc'  // ASC | DESC

// Add unique IDs for each image
foreach ($options['images'] as $k => $img) {
    $options['images'][$k]['uid'] = hash('crc32b', 'image-' . $k . $img['id']);
}

if (isset($_GET['vp_filter'])) {
    $category = sanitize_text_field(wp_unslash($_GET['vp_filter']));
    
    foreach ($options['images'] as $img) {
        if (isset($img['categories']) && is_array($img['categories'])) {
            foreach ($img['categories'] as $cat) {
                if (self::create_slug($cat) === $category) {
                    $images[] = $img;
                    break;
                }
            }
        }
    }
}

$all_attachments = get_posts(array(
    'post_type'              => 'attachment',
    'posts_per_page'         => -1,
    'post__in'               => $images_ids,
    'update_post_meta_cache' => false,
    'update_post_term_cache' => false,
));

if ('date' === $custom_order) {
    $custom_order = 'published_time';
}

$images = self::sort_array_by_field(
    $images, 
    $custom_order, 
    $custom_order_direction
);

if ('rand' === $custom_order) {
    mt_srand(self::get_rand_seed_session());
    for ($i = count($images) - 1; $i > 0; $i--) {
        $j = @mt_rand(0, $i);
        $tmp = $images[$i];
        $images[$i] = $images[$j];
        $images[$j] = $tmp;
    }
}

$query_opts['max_num_pages'] = ceil(count($images) / $count);
$start_from_item = ($paged - 1) * $count;
$end_on_item = $start_from_item + $count;

// Get images for current page only
foreach ((array) $images as $k => $img) {
    $i = $k + 1;
    if ($i > $start_from_item && $i <= $end_on_item) {
        $query_opts['images'][] = $img;
    }
}

$args = array(
    'uid'            => 'image-123-456',
    'url'            => 'https://...',      // Click URL or popup URL
    'title'          => 'Image Title',
    'content'        => 'Description',
    'excerpt'        => 'Short desc...',
    'format'         => 'standard',         // or 'video'
    'published_time' => '2024-03-04 12:00:00',
    'filter'         => 'nature,landscape', // Category slugs
    'image_id'       => 123,                // Attachment ID
    'focal_point'    => array('x' => 0.5, 'y' => 0.5),
    'allow_popup'    => true,
    'categories'     => array(
        array(
            'slug'   => 'nature',
            'label'  => 'Nature',
            'url'    => '?vp_filter=nature'
        )
    ),
    'author'         => 'John Doe',
    'author_url'     => 'https://...',
);

'image_controls' => array(
    'title' => array(
        'type'  => 'text',
        'label' => 'Title',
    ),
    'description' => array(
        'type'  => 'textarea',
        'label' => 'Description',
    ),
    'categories' => array(
        'type'            => 'select',
        'multiple'        => true,
        'creatable'       => true,
        'allow_bulk_edit' => true,
    ),
    'format' => array(
        'type'    => 'select',
        'options' => array(
            'standard' => 'Standard',
            'video'    => 'Video',
        ),
        'allow_bulk_edit' => true,
    ),
)

array(
    'content_source' => 'images',
    'images' => array(
        array('id' => 123, 'title' => 'Image 1'),
        array('id' => 124, 'title' => 'Image 2'),
        array('id' => 125, 'title' => 'Image 3'),
    ),
    'images_titles_source' => 'custom',
    'images_order_by' => 'default'
)

array(
    'content_source' => 'images',
    'images' => array(
        array(
            'id' => 123,
            'categories' => array('Web Design', 'UI/UX'),
            'format' => 'standard'
        ),
        array(
            'id' => 124,
            'categories' => array('Motion Graphics'),
            'format' => 'video',
            'video_url' => 'https://vimeo.com/123456'
        ),
    ),
    'images_order_by' => 'title',
    'images_order_direction' => 'asc'
)

array(
    'content_source' => 'images',
    'images' => array(
        array(
            'id' => 123,
            'author' => 'Jane Photographer',
            'author_url' => 'https://janephoto.com'
        ),
    ),
    'images_titles_source' => 'caption',
    'images_descriptions_source' => 'description',
    'images_order_by' => 'rand'
)

add_filter('vpf_image_item_args', function($args, $img) {
    // Add custom data or modify existing
    $args['custom_field'] = 'value';
    return $args;
}, 10, 2);

// In /gutenberg/components/gallery-control/utils/get-all-categories.js
function getAllCategories(images) {
    const categories = new Set();
    images.forEach(img => {
        if (img.categories) {
            img.categories.forEach(cat => categories.add(cat));
        }
    });
    return Array.from(categories);
}