WordPress中通过自定义查询实现Portfolio Gallery跨画廊链接及筛选问题

Hey there! Let's break down why your custom query isn't pulling in the cubeportfolio custom post type (CPT) and how to get your gallery linking/filtering working as expected.

1. Verify the Cubeportfolio CPT Registration Details #

First, double-check that the cubeportfolio CPT is actually queryable. Sometimes plugins register CPTs with restricted parameters that block front-end queries:

• Check if the CPT has public_queryable set to true (this is required for it to show up in front-end queries).
• Ensure exclude_from_search is set to false if you want it included in search/filter results.

To confirm the exact CPT name and its parameters, add this temporary snippet to your theme's functions.php (remove it after testing):

add_action('wp_footer', 'check_cubeportfolio_cpt');
function check_cubeportfolio_cpt() {
    $cpt = get_post_type_object('cubeportfolio');
    if ($cpt) {
        echo '<pre>';
        var_dump($cpt);
        echo '</pre>';
    } else {
        echo 'Cubeportfolio CPT not found!';
    }
}

This will output the CPT's settings at the bottom of your site—look for public_queryable and exclude_from_search values.

2. Adjust Visual Portfolio's Custom Query #

Some gallery plugins (like Visual Portfolio) use custom query parameters instead of the default post_type arg. Here are two approaches:

Option A: Use Visual Portfolio's Built-in Filters #

If Visual Portfolio has a dedicated filter hook for modifying its query, use that instead of a generic pre_get_posts hook. For example:

add_filter('visual_portfolio/query_args', 'add_cubeportfolio_to_vp');
function add_cubeportfolio_to_vp($args) {
    // Add cubeportfolio to the existing post types
    $args['post_type'] = array_merge((array)$args['post_type'], array('cubeportfolio'));
    return $args;
}

Option B: Modify the Main Query with pre_get_posts #

If the above doesn't work, target the specific Visual Portfolio query directly:

add_action('pre_get_posts', 'include_cubeportfolio_in_vp_queries');
function include_cubeportfolio_in_vp_queries($query) {
    // Only target front-end Visual Portfolio queries
    if (!is_admin() && $query->is_main_query() && isset($query->query_vars['vp_post_type'])) {
        $current_post_types = (array)$query->get('post_type');
        // Add cubeportfolio if it's not already included
        if (!in_array('cubeportfolio', $current_post_types)) {
            $current_post_types[] = 'cubeportfolio';
            $query->set('post_type', $current_post_types);
        }
    }
    return $query;
}

3. Sync Filtering Taxonomies #

For filtering to work across both galleries, make sure they share compatible taxonomies. If Cubeportfolio uses a custom taxonomy (like cubeportfolio_category), you need to include it in your filter query:

add_filter('visual_portfolio/query_args', 'sync_cubeportfolio_taxonomy_filters');
function sync_cubeportfolio_taxonomy_filters($args) {
    // Get the current filter term from the URL
    $current_term = get_query_var('vp_filter');
    
    if ($current_term) {
        $args['tax_query'] = array(
            'relation' => 'OR',
            // Match default categories
            array(
                'taxonomy' => 'category',
                'field'    => 'slug',
                'terms'    => $current_term,
            ),
            // Match Cubeportfolio's custom taxonomy
            array(
                'taxonomy' => 'cubeportfolio_category', // Replace with your actual taxonomy slug
                'field'    => 'slug',
                'terms'    => $current_term,
            ),
        );
    }
    return $args;
}

4. Troubleshoot Cache & Plugin Conflicts #

• Clear Cache: Flush your WordPress cache, browser cache, and any CDN cache you might be using—stale cache can prevent query changes from showing up.
• Test for Conflicts: Temporarily disable all other plugins except Visual Portfolio and Cubeportfolio. If the query starts working, re-enable plugins one by one to find the conflicting one.

内容的提问来源于stack exchange，提问作者john zuh