WordPress_php 기술에서 템플릿을 검색하는 데 사용되는 관련 PHP 함수 분석

locate_template()은 우선순위가 가장 높은 기존 템플릿 파일을 검색하는 데 사용되며, 템플릿 파일을 직접 로드할 수도 있습니다.

lococate_template() 함수로 검색할 때 자식 테마가 있으면 자식 테마의 템플릿을 먼저 사용하고, 부모 테마는 다시 검색하지 않습니다.

사용방법

locate_template( $template_names, $load, $require_once );

매개변수

$템플릿_이름

(배열) (필수) 가져올 템플릿 파일의 이름(확장자 필요) 파일 존재 여부는 배열에 따라 하나씩 일치됩니다.

기본값: 없음

$로드

(부울) (선택 사항) True로 설정한 경우 템플릿 파일을 직접 가져옵니다.

기본값: 거짓

$require_once

(Boolean) (선택) True로 설정하면 이전에 도입된 경우 이번에는 도입하지 않고(require_once), 그렇지 않으면 도입 여부와 관계없이 도입합니다(require).

(이 매개변수는 $load가 True인 경우에만 적용됩니다.)

기본값: 거짓

반환값

(문자열) 지정된 템플릿 파일이 존재하는 한 해당 경로를 반환하고, 그렇지 않으면 빈 문자열을 반환합니다.

예

if( locate_template( 'content-' . $pageName . '.php' ) !== '' ){
  //存在，引入模板文件
  get_template_part( 'content', $pageName );
}else{
  //不存在，直接显示内容
  the_content();
}

기타

이 기능은 wp-includes/template.php에 있습니다

빠른 검색 템플릿

get_query_template()은 페이지 템플릿을 빠르게 검색하는 데 사용되며 미리 정의된 페이지 유형(type)에 따라야 합니다.

locate_template()과 차이점은 페이지 유형을 입력해야 하며 {$type}_template 템플릿 경로 필터가 생성된다는 것입니다.
사용법

get_query_template( $type, $templates );

매개변수

$유형

(문자열) (필수) 가져올 템플릿 파일의 페이지 유형입니다. 확장자(예: Single) 없이 해당 템플릿 파일의 파일 이름을 입력합니다.

기본값: 없음

$템플릿

(배열) (선택 사항) 대체 템플릿 목록입니다.

기본값: 빈 배열

반환값

템플릿 파일의 경로를 반환합니다.

예

404 페이지용 템플릿이 있는 경우 소개하세요.

if ( '' != get_404_template() ) include( get_404_template() );

기타

이 기능은 wp-includes/template.php에 있습니다