apply_filters()(필터 생성)
apply_filters() 함수는 필터를 생성하는 데 사용되며 대부분 함수에 사용됩니다. 이는 WordPress 플러그인 메커니즘에서 매우 중요한 기능으로, 다른 테마와 플러그인에서 값을 수정하고 필터링할 수 있습니다. .
사용방법
apply_filters( $tag, $value, $var... );
매개변수
$태그
(문자열) (필수) 필터의 이름입니다.
기본값: 없음
$값
(혼합) (필수) 필터링할 값입니다. 필터링하는 사람이 없으면 이 값이 직접 반환됩니다.
$var
(혼합) (선택 사항) 필터 함수에 추가 변수 매개변수를 전달하여 반환 값을 작동할 때 필터 기능을 지원합니다.
반환값
(혼합) 필터링된 값, 아무도 필터링하지 않으면 $value 값이 직접 반환됩니다.
예
아무도 필터링하지 않음:
echo apply_filters( 'test', '可以被修改的值' );
결과 인쇄:
수정 가능한 값
누군가 필터링됨:
function test_func(){ return '修改值'; } add_filter( 'test', 'test_func' ); echo apply_filters( 'test', '可以被修改的值' );
결과 인쇄:
값 수정
수신 매개변수:
function test_func(){ return '修改值'; } add_filter( 'test', 'test_func' ); function test_func2( $text ){ return $text . '2'; } add_filter( 'test', 'test_func2' ); echo apply_filters( 'test', '可以被修改的值' );
여러 매개변수:
function test_func( $text, $var, $var2 ){ return '修改值' . $var1 . $var2; } add_action( 'test', 'test_func', 10, 3 ); echo apply_filters( 'test', '可以被修改的值', '辅助值1', '辅助值2' );
기타
이 기능은 wp-includes/plugin.php에 있습니다
add_filter()(필터 추가)
add_filter()는 지정된 필터에 함수를 탑재할 수 있습니다.
사용방법
add_filter( $tag, $function_to_add, $priority, $accepted_args );
매개변수
$태그
(문자열) (필수) 마운트할 필터의 이름입니다(대상 apply_filters() 함수의 $tag 속성과 동일).
기본값: 없음
$function_to_add
(콜백) (필수) 마운트할 콜백 함수는 PHP 콜백 함수 종류 문서를 참고하세요.
기본값: 없음
$우선순위
(정수) (선택 사항) 실행 순서, 함수가 작을수록 먼저 실행됩니다.
기본값: 10
$accepted_args
(정수) (선택 사항) 콜백 함수에서 받은 매개 변수 수입니다. 여러 매개 변수를 설정하면 apply_filters() 함수에서 전달된 더 많은 매개 변수를 받을 수 있습니다.
기본값: 1
반환값
(부울) 항상 True
예
function test_func( $text, $var1, $var2 ){ return $text . $var1 . $var2; } add_action( 'test', 'test_func', 10, 3 ); echo apply_filters( 'test', '参数2', '参数3', '参数4' );
인쇄:
테스트 매개변수 2 매개변수 3
기타
이 기능은 wp-includes/plugin.php에 있습니다