apply_filters( 'wpml_display_language_names', mixed $empty_value, string $native_name, string|bool $translated_name, bool $lang_native_hidden, bool $lang_translated_hidden )
- 유형
- filter
- 카테고리
- 사이트 전체 언어 정보
- WPML 버전
- 3.2
설명
언어의 고유 명칭과 동일한 언어의 번역된 명칭이 다른지 확인합니다. 다를 경우 둘 다 반환합니다. 그렇지 않으면 하나만 반환합니다.
이 필터는 주로 사용자 정의 언어 전환기에 사용됩니다.
인수
- $empty_value
- (mixed) (필수) 일반적으로 필터가 수정할 값입니다. 여기서는 아무것도 필터링하지 않으므로 이 값을 NULL로 설정하세요. 이는 필터 함수가 전체 인수 목록을 실제로 받도록 하기 위함입니다.
- $native_name
- (string) (필수) 언어의 고유 명칭입니다.
- $translated_name
- (string|bool) (필수) 언어의 번역된 이름입니다. 기본값은 FALSE입니다.
- $lang_native_hidden
- (bool) (선택 사항) 기본값은 FALSE입니다. 0|false 또는 1|true로 설정하여 언어의 고유 명칭을 숨길지 여부를 지정합니다.
- $lang_translated_hidden
- (bool) (선택 사항) 기본값은 FALSE입니다. 0|false 또는 1|true로 설정하여 언어의 번역된 이름을 숨길지 여부를 지정합니다.
사용 예시
예제
function my_footer_languages_list(){
$languages = apply_filters( 'wpml_active_languages', NULL, 'skip_missing=0&orderby=code' );
if( !empty( $languages ) ){
echo '<div id="footer_language_list"><ul>';
foreach( $languages as $l ){
echo '<li>';
if( $l['country_flag_url'] ){
if( !$l['active'] ) echo '<a href="'.$l['url'].'">';
echo '<img src="'.$l['country_flag_url'].'" height="12" alt="'.$l['language_code'].'" width="18" />';
if( !$l['active'] ) echo '</a>';
}
if(!$l['active']) echo '<a href="'.$l['url'].'">';
echo apply_filters( 'wpml_display_language_names', NULL, $l['native_name'], $l['translated_name'] );
if( !$l['active'] ) echo '</a>';
echo '</li>';
}
echo '</ul></div>';
}
}
위의 예제 함수는 다음을 수행합니다.
- 언어가 있는 경우 DIV를 생성하고 순서 없는 목록을 시작합니다.
- 그런 다음 각 언어를 반복하여 목록 항목으로 추가합니다.
언어가 활성 언어가 아닌 경우 해당 언어의 번역된 페이지에 대한 링크를 추가합니다. - 그런 다음 언어 국기를 추가합니다.
- 마지막으로, 고유 명칭과 번역된 이름이 다른 경우 두 가지 모두 추가합니다.
관련 훅
wpml_decode_custom_field, wpml_footer_language_selector, wpml_add_language_form_field, wpml_ls_exclude_in_menu, wpml_is_rtl, wpml_alternate_hreflang, wpml_head_langs, wpml_must_translate_canonical_url, wpml_browser_redirect_language_params, wpml_active_languages