단일 게시물 및 페이지에 특성 이미지를 조건부로 표시

FAQ

The plugin doesn’t work with my theme. What can I do?

Some themes load featured images in custom ways, which may cause compatibility issues. The two most common reasons are:

1) The theme loads the featured image before the loop (e.g., in the header).
2) The theme manually calls the featured image using custom functions.

Solution for case 1

If your theme loads the featured image before the loop, you can modify the plugin’s behavior by adding the following snippet to your functions.php file:

function cybocfi_set_startup_hook() {
    return 'get_header';
}

add_filter( 'cybocfi_startup_hook', 'cybocfi_set_startup_hook' );
add_filter( 'cybocfi_only_hide_in_the_loop', '__return_false' );

Note: This may hide the featured image from other plugins that rely on it, such as SEO plugins or the ‘latest posts’ plugin.

Solution for case 2

If your theme uses custom functions to display featured images, try the following options:

• Ask the theme developer to use standard WordPress functions like wp_get_attachment_image(), get_the_post_thumbnail() or the_post_thumbnail().
• Create a child theme and load the featured image with one of the functions above.

이 플러그인은 GDPR을 준수합니까?

Yes! This plugin does not collect, process, or store any personal information, making it fully GDPR-compliant.

특성 이미지를 기본적으로 숨길 수 있나요?

Yes. Add the following code to your functions.php file to hide featured images by default:

add_filter('cybocfi_hide_by_default', '__return_true');

This will automatically check the “Hide Featured Image” option for all new posts and pages. Existing content remains unchanged.

For different default behaviors based on the post type, use:

function cybocfi_set_default_hiding_state( $default, $post_type ) {
    if ( 'post' === $post_type ) {
        $default = true; // Hide featured images on posts by default
    } else if ( 'page' === $post_type ) {
        $default = false; // Show featured images on pages by default
    }
    return $default;
}
add_filter( 'cybocfi_hide_by_default', 'cybocfi_set_default_hiding_state', 10, 2 );

이 플러그인을 게시물로 제한할 수 있습니까(그리고 다른 게시물 유형은 제외할 수 있습니까?)?

Yes. By default, the plugin works on all post types that support featured images. To restrict it to posts only, add the following snippet to your functions.php:

function cybocfi_limit_to_posts( $enabled, $post_type ) {
    if ( 'post' === $post_type ) {
        return $enabled;
    }

    return false;
}
add_filter( 'cybocfi_enabled_for_post_type', 'cybocfi_limit_to_posts', 10, 2 );

If you want it to work for both posts and pages but disable it for other post types:

function cybocfi_limit_to_posts_and_pages( $enabled, $post_type ) {
    $allowed_post_types = array( 'post', 'page' ); // add any post type you want to use the plugin with
    return in_array( $post_type, $allowed_post_types );
}
add_filter( 'cybocfi_enabled_for_post_type', 'cybocfi_limit_to_posts_and_pages', 10, 2 );

WooCommerce: How does the plugin handle product images?

If the featured image is hidden for a WooCommerce product, it will still appear as a thumbnail in the cart, checkout, and product lists. However, it will not be displayed in the single product view. If a product gallery is available, all gallery images will be shown as usual, except for the hidden featured image.

WooCommerce: Can I remove empty space left by the hidden image?

Yes. The plugin applies CSS adjustments automatically for standard themes. If needed, customize it with this snippet:

function cybocfi_woocommerce_styles( $css ) {
    return '.wp-block-woocommerce-product-image-gallery {display: none;}';
}
add_filter( 'cybocfi_woocommerce_style_overrides', 'cybocfi_woocommerce_styles' );

These styles apply only when the featured image is hidden in WooCommerce product pages.

Can I translate this plugin into my language?

Absolutely! You can contribute a translation here. Keep in mind that translations need community approval before they go live.

확인란의 텍스트를 어떻게 변경할 수 있습니까?

You can customize the checkbox label using this filter in your functions.php file:

function cybocfi_set_featured_image_label( $label ) {
    return 'Hide featured image in post'; // change this text
}
add_filter( 'cibocfi_checkbox_label', 'cybocfi_set_featured_image_label' );

I can’t save posts in WordPress 5.7.0

A WordPress core bug (#52787) may cause this issue when another plugin uses post meta values in a specific way. If you see the error “Updating failed. Could not delete meta value from database.”, try:

• Downgrading to WordPress 5.6.2.
• Upgrading to WordPress 5.7.1 or later.

I’m getting a deprecation notice. What should I do?

The cybocfi_post_type filter has been replaced with cybocfi_enabled_for_post_type. To update your code:

1) 필터 훅을 cybocfi_post_type에서 cybocfi_enabled_for_post_type으로 변경합니다.
2) 필터 함수 인수를 바꿉니다. $enabled는 이제 첫 번째 인수인 $post_type이고 두 번째 인수입니다.

In case you’ve only used one argument ($post_type), you must not only adapt the function signature, but also add the priority and number of arguments to your add_filter() function call.

Here’s an example:

// BEFORE UPDATE: Using the deprecated filter
function cybocfi_limit_to_posts( $post_type, $enabled ) {
    if ( 'post' === $post_type ) {
        return $enabled;
    }

    return false;
}
add_filter( 'cybocfi_post_type', 'cybocfi_limit_to_posts', 10, 2 );

// AFTER UPDATE: Using the new filter
function cybocfi_limit_to_posts( $enabled, $post_type ) {
    if ( 'post' === $post_type ) {
        return $enabled;
    }

    return false;
}
add_filter( 'cybocfi_enabled_for_post_type', 'cybocfi_limit_to_posts', 10, 2 );