설명
중요 공지
테마가 특성 이미지를 로드하기 위해 사용자 지정 호출을 수행하는 경우(예: Twenty Seventeen 테마) 이 플러그인이 작동하지 않을 수 있습니다! get_the_post_thumbnail()
, wp_get_attachment_image()
또는 Post Featured Image 차단하여 제대로 작동하는지 확인하세요.
기본적으로 플러그인은 루프 내에 로드된 경우 추천 이미지만 숨깁니다. 테마가 루프 외부에서 추천 이미지를 로드하는 경우 플러그인 사용 방법에 대한 FAQ를 참조하세요.
설명
이 플러그인을 사용하면 특성 이미지가 단일 보기에 표시되어야 하는지 여부를 각 게시물 또는 페이지에 대해 선택할 수 있습니다. 특성 이미지를 사용하여 아카이브나 첫 페이지에 썸네일을 표시하지만 특성 이미지가 모든 게시물 보기 자체에 표시되는 것을 원하지 않는 경우 이 기능이 유용할 수 있습니다.
플러그인은 특성 이미지 패널(또는 클래식 편집기를 사용하는 경우 메타 상자)에 간단한 확인란을 추가하여 특성 이미지가 단일 보기에 표시되는지 여부를 선택할 수 있습니다.
스크린샷
설치
- 플러그인 파일을
/wp-content/plugins/conditional-featured-image
디렉토리에 업로드하거나 워드프레스 플러그인 화면을 통해 직접 플러그인을 설치합니다. - 워드프레스의
플러그인
화면을 통해 플러그인을 활성화합니다.
FAQ
-
플러그인이 내 테마와 작동하지 않습니다. 어떡해?
-
일반적으로 플러그인이 테마와 호환되지 않는 두 가지 가능성이 있습니다.
1) 테마는 루프 전에 특성 이미지를 로드합니다(예: 헤더).
2) 테마는 특성 이미지를 로드하기 위해 사용자 정의 호출을 합니다.1의 경우 플러그인을 일찍 초기화하고 in_the_loop 검사를 비활성화할 수 있습니다. 이렇게 하려면 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; // set the default state for posts } else if ( 'page' === $post_type ) { $default = false; // set the default state for pages } return $default; } add_filter( 'cybocfi_hide_by_default', 'cybocfi_set_default_hiding_state', 10, 2 );
-
이 플러그인을 게시물로 제한할 수 있습니까(그리고 다른 게시물 유형은 제외할 수 있습니까?)?
-
예. 기본적으로 플러그인은 특성 이미지가 있는 모든 게시물 유형에서 사용할 수 있습니다. 그러나 플러그인을 사용할 수 있는 게시물 유형을 제어할 수 있는 필터가 있습니다. 다음 예제에서는 게시물을 제외한 모든 항목에 대해 비활성화합니다.
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 );
필터는 현재 게시물 유형을 제공하며 활성화하려면
true
를 반환하고 비활성화하려면false
를 반환하여 이 게시물 유형에 플러그인을 사용할지 여부를 결정할 수 있습니다. 다음 스니펫을functions.php
에 추가하여 게시물 및 페이지에 대한 플러그인을 활성화하지만 다른 게시물 유형에 대해서는 비활성화합니다.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 );
-
내 언어로 플러그인을 얻을 수 있습니까?
-
물론입니다. 당신의 언어로 번역하는 것에 초대되었습니다. 번역은 커뮤니티에서 검토해야 하므로 승인될 때까지 시간이 조금 걸립니다.
-
확인란의 텍스트를 어떻게 변경할 수 있습니까?
-
이를 위한 필터 후크가 있습니다. functions.php에 다음 스니펫을 추가합니다.
function cybocfi_set_featured_image_label( $label ) { return 'Hide featured image in post'; // change this string } add_filter( 'cibocfi_checkbox_label', 'cybocfi_set_featured_image_label' );
-
워드프레스 5.7.0에서 게시물을 저장할 수 없습니다.
-
워드프레스 코어 #52787의 버그는 두 번째 플러그인이 확실한 방법. 이 문제의 영향을 받는 사람들은 “업데이트 실패. 데이터베이스에서 메타 값을 삭제할 수 없습니다.”라는 오류 메시지를 보게 됩니다. 문제가 워드프레스 코어와 관련되어 있으므로 해결 방법은 워드프레스 5.6.2로 다운그레이드하거나 워드프레스 5.7.1로 업그레이드하는 것입니다. 현재 우리가 아는 한 이 결함의 영향을 받는 사용자는 극소수에 불과합니다. 단일 게시물 및 페이지에 조건부로 특성 이미지 표시 플러그인 자체는 워드프레스 5.7.0에서 예상대로 작동하며 두 번째 플러그인이 워드프레스 코어에서 버그를 트리거하는 경우에만 문제가 나타날 수 있습니다.
-
지원 중단 알림을 받고 있습니다. 어떻게 해야 하나요?
-
필터 인수가 특이한 방식으로 사용되었기 때문에
cybocfi_post_type
필터는cybocfi_enabled_for_post_type
을 위해 더 이상 사용되지 않습니다. 전자에서 후자로 전환하는 것은 쉽습니다. 예를 들면 다음과 같습니다.// Using the deprecated filter - REMOVE THIS CALL 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 ); // Using the new filter - THIS IS HOW IT SHOULD BE DONE NOW 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 );
다음 작업만 수행하면 됩니다.
1) 필터 훅을
cybocfi_post_type
에서cybocfi_enabled_for_post_type
으로 변경합니다.
2) 필터 함수 인수를 바꿉니다.$enabled
는 이제 첫 번째 인수인$post_type
이고 두 번째 인수입니다.위의 예에 표시된 것처럼 하나의 인수(
$post_type
)만 사용한 경우 함수 서명을 조정할 뿐만 아니라add_filter()
함수 호출에 우선 순위와 인수 수를 추가해야 합니다.
후기
기여자 & 개발자
변경이력
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
- 최초 공개