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

설명

개별 글과 페이지에서 추천 이미지의 표시 여부를 쉽게 제어하면서 아카이브 페이지, 쿼리 루프 및 기타 목록 보기에서도 계속 표시할 수 있습니다. 이 플러그인은 글 편집기 내에서 간단한 체크박스 옵션을 제공하여 개별 글과 페이지에서 추천 이미지 표시를 활성화 또는 비활성화할 수 있습니다.

주요 기능

  • 단일 페이지 및 글에서 추천 이미지를 표시하거나 숨깁니다.
  • 워드프레스 글 편집기와 원활하게 통합됩니다.
  • 간단한 확인란 토글 – 기술 지식이 필요하지 않습니다.
  • 대부분의 테마와 호환됩니다.
  • 우커머스 제품 페이지를 지원합니다.
  • 가볍고 성능에 최적화되어 있습니다.
  • 100% 무료 – 광고, 업셀, 프리미엄 버전이 없습니다!

게시물별로 추천 이미지의 가시성을 정밀하게 제어하려는 블로거, 콘텐츠 제작자 및 개발자에게 적합합니다.

중요 공지 사항

테마에서 사용자 정의 메서드를 사용하여 추천 이미지를 로드하는 경우(예: 트웬티 세븐틴 테마) 이 플러그인이 작동하지 않을 수 있습니다. 호환성을 보장하려면 get_the_post_thumbnail(), wp_get_attachment_image() 또는 추천 이미지 게시 블록과 같은 표준 워드프레스 함수를 사용하세요.

또한 기본적으로 이 플러그인은 추천 이미지가 루프 내부에서 로드될 때만 숨깁니다. 테마가 루프 외부에서 로드하는 경우 첫 번째 FAQ 항목에서 해결 방법을 확인하세요.

스크린샷

  • 백엔드(블록 편집기)
  • 프론트엔드(프론트 페이지 / 글 목록 / 쿼리 루프 블록 / 아카이브 보기)
  • 프론트엔드(포스트/페이지/단일 보기)
  • 백엔드(클래식 편집기)
  • 백엔드(우커머스 제품)

설치

  1. 플러그인 파일을 /wp-content/plugins/conditional-featured-image 디렉토리에 업로드하거나 워드프레스 플러그인 화면을 통해 직접 플러그인을 설치합니다.
  2. 워드프레스의 플러그인 화면을 통해 플러그인을 활성화합니다.

FAQ

플러그인이 내 테마에서 작동하지 않습니다. 어떻게 해야 하나요?

일부 테마는 사용자 정의 방식으로 추천 이미지를 로드하므로 호환성 문제가 발생할 수 있습니다. 가장 일반적인 두 가지 이유는 다음과 같습니다:

1) 테마가 루프 전(예: 헤더)에 추천 이미지를 로드합니다.
2) 테마가 사용자 정의 함수를 사용하여 추천 이미지를 수동으로 호출합니다.

사례 1에 대한 솔루션

테마가 루프 전에 추천 이미지를 로드하는 경우 functions.php 파일에 다음 스니펫을 추가하여 플러그인의 동작을 수정할 수 있습니다:

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' );

주: 이렇게 하면 SEO 플러그인이나 ‘최신 글’ 플러그인 등 해당 이미지를 사용하는 다른 플러그인에서 추천 이미지가 숨겨질 수 있습니다.

사례 2에 대한 솔루션

테마에서 사용자 정의 함수를 사용하여 추천 이미지를 표시하는 경우 다음 옵션을 시도해 보세요:

  • 테마 개발자에게 wp_get_attachment_image(), get_the_post_thumbnail() 또는 the_post_thumbnail() 같은 표준 워드프레스 함수를 사용하도록 요청하세요.
  • 자식 테마를 만들고 위의 함수 중 하나를 사용하여 추천 이미지를 로드합니다.

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

예! 이 플러그인은 개인 정보를 수집, 처리 또는 저장하지 않으므로 GDPR을 완벽하게 준수합니다.

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

예. 기본적으로 추천 이미지를 숨기려면 functions.php 파일에 다음 코드를 추가하세요:

add_filter('cybocfi_hide_by_default', '__return_true');

그러면 모든 글과 페이지에 대해 ‘추천 이미지 숨기기’ 옵션이 자동으로 선택됩니다. 기존 콘텐츠는 변경되지 않습니다.

글 유형에 따라 다른 기본 동작을 사용하려면 다음을 사용합니다:

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 );

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

예. 기본적으로 플러그인은 추천 이미지를 지원하는 모든 글 유형에서 작동합니다. 글에만 제한하려면 다음 스니펫을 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 );

글과 페이지 모두에서 작동하도록 하려면 다른 글 유형에 대해서는 비활성화하세요:

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 );

우커머스: 플러그인은 제품 이미지를 어떻게 처리하나요?

우커머스 제품에 대해 추천 이미지가 숨겨진 경우에도 카트, 결제 및 제품 목록에는 여전히 썸네일로 표시됩니다. 그러나 단일 제품 보기에는 표시되지 않습니다. 제품 갤러리를 사용할 수 있는 경우 숨겨진 추천 이미지를 제외한 모든 갤러리 이미지가 평소와 같이 표시됩니다.

우커머스: 숨겨진 이미지가 남긴 빈 공간을 제거할 수 있나요?

예. 플러그인은 표준 테마에 대해 CSS 조정을 자동으로 적용합니다. 필요한 경우 이 스니펫을 사용하여 사용자 정의합니다:

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

이러한 스타일은 추천 이미지가 우커머스 제품 페이지에서 숨겨져 있는 경우에만 적용됩니다.

이 플러그인을 내 언어로 번역할 수 있나요?

물론이죠! 여기에서 번역에 기여할 수 있습니다. 번역이 게시되기 전에 커뮤니티의 승인이 필요하다는 점에 유의하세요.

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

functions.php 파일에서 이 필터를 사용하여 확인란 레이블을 사용자 지정할 수 있습니다:

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' );

워드프레스 5.7.0에서 글을 저장할 수 없습니다.

다른 플러그인이 특정 방식으로 글 메타값을 사용할 때 워드프레스 코어 버그(#52787)로 인해 이 문제가 발생할 수 있습니다. “업데이트에 실패했습니다. 데이터베이스에서 메타값을 삭제할 수 없습니다.”라는 오류가 표시되면 시도해 보세요:

  • 워드프레스 5.6.2로 다운그레이드하기.
  • 워드프레스 5.7.1 이상으로 업그레이드하기.

사용 중단 알림을 받았습니다. 어떻게 해야 하나요?

cybocfi_post_type 필터가 cybocfi_enabled_for_post_type로 대체되었습니다. 코드를 업데이트하려면 다음과 같이 하세요:

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

인수를 하나만 사용한 경우($post_type) 함수 서명을 변경할 뿐만 아니라 add_filter() 함수 호출에 우선순위와 인수 개수를 추가해야 합니다.

다음은 한 가지 예입니다:

// 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 );

후기

2024년 11월 10일 답글 1개
Thank you so much for creating this plugin. I have been using it for a couple of months and it works superbly. I didn’t think such a plugin would exist since it serves such a niche purpose and was so pleased to have found it and that it just works. It works so simply (just a check box, basically plug and play) and is perfect for my site. For those of you who want to know applications for how this plugin could be used: I have another plugin that displays content on a page using a shortcode, that content already contains an image but that image does not show up in lists of recent posts such as on the home page, so I have to add that image as a featured image in the post that contains the short code. Without this plugin, the page will show two instances of the same image at the same time and would not look so good. This plugin lets me add a featured image to a post, display it anywhere that lists recent posts for visual purposes, but then hide it on the actual page itself so only the image from the shortcode shows. Perfect.
2024년 8월 20일 답글 1개
For some reason, CSS to hide featured image wasn’t working, this plugin did the trick… Thanks so much!
2024년 7월 23일 답글 1개
Plug and play, straight forward, just works. Works on Wordpress 6.6, maybe it doesn’t need to be updated that often. Thank you for such a simple fix to a niche request!
2024년 4월 6일
Finally. A plug-in that just works. Thank you for making my headache go away.
2024년 1월 26일
В некоторых темах просто не работает совсем. Галочку ставишь — эффекта нуль.
모든 38 평가 읽기

기여자 & 개발자

“단일 게시물 및 페이지에 특성 이미지를 조건부로 표시”(은)는 오픈 소스 소프트웨어입니다. 다음의 사람들이 이 플러그인에 기여하였습니다.

기여자

“단일 게시물 및 페이지에 특성 이미지를 조건부로 표시”(이)가 4 개 언어로 번역되었습니다. 기여해 주셔서 번역자님께 감사드립니다.

자국어로 “단일 게시물 및 페이지에 특성 이미지를 조건부로 표시”(을)를 번역하세요.

개발에 관심이 있으십니까?

코드 탐색하기는, SVN 저장소를 확인하시거나, 개발 기록RSS로 구독하세요.

변경이력

3.3.1

  • 워드프레스 코딩 표준 위반 수정

3.3.0

  • 우커머스 지원 추가
  • 하단 여백 사용 중단 안내 수정
  • 업데이트된 종속성

3.2.0

  • 워드프레스 6.6 이상 필요
  • 워드프레스 6.7까지 호환성
  • withState 사용 중단 공지 수정
  • 업데이트된 종속성

3.1.1

  • 구텐베르크 16.6.0과 호환
  • 업데이트된 종속성

3.0.1

  • 쿼리를 설정할 수 없도록 시작 훅을 사용자 지정한 사용자의 치명적인 오류를 수정합니다.

3.0.0

  • 블록 편집기와의 호환성 개선
  • 업데이트된 종속성

이번 릴리스는 철저한 테스트를 거쳤지만 사용 중인 테마와 플러그인에 따라 일부 예외적인 경우에 문제가 발생할 수 있습니다.

2.14.0

  • 특성 이미지는 이제 쿼리 블록 안에 표시됩니다.
  • 작은 성능 및 가독성 개선
  • 업데이트된 종속성

2.13.0

  • 블록 테마에 대한 향상된 호환성
  • cybocfi_enabled_for_post_type 필터는 이제 프런트엔드의 출력에도 직접 적용됩니다.
  • 단일 파일에서 파일당 단일 클래스로 리팩터링된 플러그인 아키텍처
  • 업데이트된 종속성

2.12.0

  • OEmbed 요청에서 특성 이미지를 숨기지 마세요.
  • 업데이트된 종속성

2.11.0

  • cybocfi_post_type 필터가 사용되는 경우 지원 중단 알림을 표시합니다. apply_filters_deprecated()에 주의를 기울인 @swissspidy에게 제안합니다.

2.10.0

  • 새로운 cybocfi_enabled_for_post_type 필터를 위해 더 이상 사용되지 않는 cybocfi_post_type 필터. cybocfi_post_type의 문제를 강조한 @swissspidy에게 제안합니다.
  • 업데이트된 종속성

2.9.0

  • In_the_loop() 테스트를 우회하는 필터를 추가하여 플러그인이 기본 루프 외부의 특성 이미지를 로드하는 테마와 호환되도록 만들 수 있습니다.

2.8.2

  • 최신 게시물 위젯에서 특성 이미지를 숨기던 버그를 수정했습니다. 이것을 지적한 @molcsa에게 제안합니다.
  • 업데이트된 종속성

2.8.1

  • 확장된 FAQ
  • 업데이트된 종속성
  • 워드프레스 5.8.2까지 테스트

2.8.0

  • 조기 초기화를 위한 후크 추가
  • 확장된 FAQ
  • 소규모 리팩토링
  • 업데이트된 종속성

2.7.1

  • 워드프레스 5.7까지 테스트
  • 업데이트된 종속성

2.7.0

  • Custom Post Type UI 플러그인에 대한 지원 추가
  • 업데이트된 종속성

2.6.0

  • Twentynineteen 테마에 대한 지원 추가

2.5.1

  • 수정: 기본 쿼리 이후에 실행된 쿼리에서 특성 이미지를 제거하지 마십시오.
  • 업데이트된 종속성

2.5.0

  • 프로그래밍 방식으로 추가된 게시물에 대한 cybocfi_hide_by_default 필터를 준수합니다.
  • 소규모 리팩토링
  • 워드프레스 5.6.0까지 테스트
  • 업데이트된 종속성

2.4.0

  • 기본적으로 특성 이미지를 숨기는 필터를 추가했습니다.
  • 워드프레스 5.5.1까지 테스트
  • 확장된 FAQ
  • 업데이트된 종속성

2.3.1

  • 워드프레스 5.5(RC1)까지 테스트됨
  • 확장된 FAQ
  • 업데이트된 종속성

2.3.0

  • 게시물 유형별로 플러그인을 활성화/비활성화하도록 허용

2.2.0

  • 특성 이미지 체크박스 라벨 필터링 허용
  • 읽어보기 업데이트
  • 종속성 업데이트

2.1.2

  • SVN에서 필수 데이터를 제외하지 않음

2.1.1

  • 종속성 업데이트

2.1.0

  • Yoast SEO 지원 추가(소셜 헤더 데이터에 대한 이미지 필터링 안 함)

2.0.0

  • 블록 편집기(구텐베르크)에 대한 지원 추가
  • 워드프레스 5.2.2까지 테스트

1.4.0

  • 메인 포스트만 수정합니다.
  • 워드프레스 5.0.0까지 테스트

1.3.0

  • 엘리멘터에서도 작동하도록 더 강력하게 만드세요.
  • 워드프레스 4.9.6까지 테스트

1.2.2

  • 워드프레스 4.7.3까지 테스트
  • 워드프레스 4.8.0까지 테스트
  • 워드프레스 4.9.0까지 테스트

1.2.1

  • 워드프레스 4.7.2까지 테스트

1.2.0

  • 언어 팩 준비(플러그인 폴더 이름과 동일한 텍스트 도메인 설정, load_plugin_textdomain 제거)

1.1.3

  • 워드프레스 4.7.0까지 테스트
  • 언어 폴더를 제거했습니다. 언어는 이제 wordpress.org에서 로드됩니다.

1.1.2

  • 플러그인 제목 개선
  • 확인란 문자열 개선
  • 문서 개선
  • 안정적인 태그 업데이트됨

1.1.1

  • 안정적인 태그 업데이트됨

1.1

  • 페이지로 확장된 기능

1.0

  • 최초 공개