설명
개별 글과 페이지에서 추천 이미지의 표시 여부를 쉽게 제어하면서 아카이브 페이지, 쿼리 루프 및 기타 목록 보기에서도 계속 표시할 수 있습니다. 이 플러그인은 글 편집기 내에서 간단한 체크박스 옵션을 제공하여 개별 글과 페이지에서 추천 이미지 표시를 활성화 또는 비활성화할 수 있습니다.
주요 기능
- 단일 페이지 및 글에서 추천 이미지를 표시하거나 숨깁니다.
- 워드프레스 글 편집기와 원활하게 통합됩니다.
- 간단한 확인란 토글 – 기술 지식이 필요하지 않습니다.
- 대부분의 테마와 호환됩니다.
- 우커머스 제품 페이지를 지원합니다.
- 가볍고 성능에 최적화되어 있습니다.
- 100% 무료 – 광고, 업셀, 프리미엄 버전이 없습니다!
게시물별로 추천 이미지의 가시성을 정밀하게 제어하려는 블로거, 콘텐츠 제작자 및 개발자에게 적합합니다.
중요 공지 사항
테마에서 사용자 정의 메서드를 사용하여 추천 이미지를 로드하는 경우(예: 트웬티 세븐틴 테마) 이 플러그인이 작동하지 않을 수 있습니다. 호환성을 보장하려면 get_the_post_thumbnail()
, wp_get_attachment_image()
또는 추천 이미지 게시 블록과 같은 표준 워드프레스 함수를 사용하세요.
또한 기본적으로 이 플러그인은 추천 이미지가 루프 내부에서 로드될 때만 숨깁니다. 테마가 루프 외부에서 로드하는 경우 첫 번째 FAQ 항목에서 해결 방법을 확인하세요.
스크린샷
설치
- 플러그인 파일을
/wp-content/plugins/conditional-featured-image
디렉토리에 업로드하거나 워드프레스 플러그인 화면을 통해 직접 플러그인을 설치합니다. - 워드프레스의
플러그인
화면을 통해 플러그인을 활성화합니다.
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 );
후기
기여자 & 개발자
변경이력
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
- 최초 공개