Manual Selection

array(
    'content_source' => 'post-based',
    'posts_source' => 'ids',
    'posts_ids' => array(123, 456, 789, 234)
)

if ('ids' === $options['posts_source']) {
    $query_opts['post_type'] = 'any';  // Allow any post type
    $query_opts['post__not_in'] = array();  // Clear exclusions
    
    if (!empty($options['posts_ids'])) {
        $query_opts['post__in'] = $options['posts_ids'];
    }
    
    // Ignore sticky posts for manual selection
    $query_opts['ignore_sticky_posts'] = true;
}

Visual_Portfolio_Controls::register(array(
    'category'       => 'content-source-post-based',
    'type'           => 'select',
    'label'          => 'Specific Posts',
    'name'           => 'posts_ids',
    'default'        => array(),
    'searchable'     => true,   // Search by title
    'multiple'       => true,   // Select multiple posts
    'value_callback' => 'find_posts_select_control',  // Dynamic post loading
    'condition'      => array(
        array(
            'control' => 'posts_source',
            'value'   => 'ids',
        ),
    ),
));

array(
    'posts_source' => 'ids',
    'posts_ids' => array(789, 123, 456),  // Display in this exact order
    'posts_order_by' => 'post__in'
)

case 'post__in':
    $query_opts['orderby'] = 'post__in';
    break;

array(
    'posts_source' => 'ids',
    'posts_ids' => array(123, 456, 789),
    'posts_order_by' => 'title',           // Sort alphabetically
    'posts_order_direction' => 'asc'
)

'condition' => array(
    array(
        'control'  => 'posts_source',
        'operator' => '!=',
        'value'    => 'ids',  // Hidden for manual selection
    ),
)

'condition' => array(
    array(
        'control'  => 'posts_source',
        'operator' => '!=',
        'value'    => 'ids',
    ),
)

'condition' => array(
    array(
        'control'  => 'posts_source',
        'operator' => '!=',
        'value'    => 'ids',
    ),
)

array(
    'content_source' => 'post-based',
    'posts_source' => 'ids',
    'posts_ids' => array(789, 456, 123, 234, 567),
    'posts_order_by' => 'post__in',  // Preserve order
    'items_count' => 6
)

array(
    'content_source' => 'post-based',
    'posts_source' => 'ids',
    'posts_ids' => array(
        123,  // Portfolio item
        456,  // Regular post
        789,  // Page
        234,  // Another portfolio item
    ),
    'posts_order_by' => 'post__in'
)

// Instead of showing all "Web Design" projects,
// manually select the best ones
array(
    'content_source' => 'post-based',
    'posts_source' => 'ids',
    'posts_ids' => array(101, 203, 305, 407),
    'posts_order_by' => 'post__in'
)

array(
    'content_source' => 'post-based',
    'posts_source' => 'ids',
    'posts_ids' => array(55, 72, 89, 91, 103, 115),
    'posts_order_by' => 'post__in',
    'items_count' => 6,
    'layout' => 'grid',
    'grid_columns' => 3
)

if ('ids' === $options['posts_source']) {
    // Allow any post type
    $query_opts['post_type'] = 'any';
    
    // Clear excluded posts
    $query_opts['post__not_in'] = array();
    
    // Set specific post IDs
    if (!empty($options['posts_ids'])) {
        $query_opts['post__in'] = $options['posts_ids'];
    }
    
    // Ignore sticky posts (they would appear at top)
    $query_opts['ignore_sticky_posts'] = true;
}

$query = new WP_Query(array(
    'post_type'              => 'any',
    'post__in'               => array(123, 456, 789),
    'orderby'                => 'post__in',
    'posts_per_page'         => 6,
    'paged'                  => 1,
    'ignore_sticky_posts'    => true,
));

public function find_posts_select_control($value, $control_name, $control_data) {
    $result = array();
    
    // Get posts matching search query
    $posts = get_posts(array(
        'post_type'      => 'any',
        'posts_per_page' => 20,
        's'              => $search_query,
        'post_status'    => array('publish', 'private', 'draft'),
    ));
    
    foreach ($posts as $post) {
        $result[] = array(
            'value' => $post->ID,
            'label' => $post->post_title . ' (' . $post->post_type . ')',
        );
    }
    
    return $result;
}

array(
    'posts_source' => 'ids',
    'posts_ids' => array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12),
    'items_count' => 6,         // 6 per page
    'pagination' => 'paged'     // 2 pages total
)

'ignore_sticky_posts' => true

'posts_ids' => array()  // or empty

'posts_order_by' => 'post__in'

// Good: All have featured images
'posts_ids' => array(portfolio_id, post_id, page_id)

// Bad: Pages without featured images mixed with portfolio items

// Q1 2024 Featured Projects
'posts_ids' => array(123, 456, 789)

'posts_order_by' => 'post__in'