WordPress
단축 코드 추가
수색…
통사론
add_shortcode( $tag , $func );
매개 변수
매개 변수 | 세부 |
---|---|
$ 태그 | (문자열) (필수) 게시물 내용에서 검색 할 단축 태그 |
$ func | (호출 가능) (필수) 단축 코드가있을 때 실행할 훅 |
비고
- shortcode 콜백에는 shortcode 속성, shortcode 내용 (있는 경우) 및 shortcode의 이름의 세 가지 인수가 전달됩니다.
- 각 단축 코드에는 하나의 고리 만있을 수 있습니다. 즉, 다른 플러그인이 비슷한 shortcode를 가지고 있다면, 플러그인이 포함되거나 실행 된 순서에 따라 귀하의 플러그인을 덮어 쓰게됩니다.
- 단축 코드 속성 이름은 핸들러 함수에 전달되기 전에 항상 소문자로 변환됩니다. 값은 변경되지 않습니다.
- shortcode에 의해 호출 된 함수는 어떠한 종류의 출력도 생성해서는 안됩니다. 단축 코드 함수는 단축 코드를 대체하는 데 사용할 텍스트를 반환해야합니다. 출력을 직접 생성하면 예기치 않은 결과가 발생할 수 있습니다. 이는 필터 함수가 호출되는 시점과 위치를 제어 할 수 없으므로 호출에서 예상되는 부작용을 생성해서는 안되기 때문에 필터 함수가 작동하는 방식과 유사합니다.
최근 게시물에 대한 간단한 단축 코드
add_shortcode
는 wp 키워드입니다.
// recent-posts is going to be our shortcode.
add_shortcode('recent-posts', 'recent_posts_function');
// This function is taking action when recent post shortcode is called.
function recent_posts_function() {
query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => 1));
if (have_posts()) :
while (have_posts()) : the_post();
$return_string = '<a href="'.get_permalink().'">'.get_the_title().'</a>';
endwhile;
endif;
wp_reset_query();
return $return_string;
}
이 조각은 당신의 테마에 배치 할 수 있습니다 functions.php
.
[recent-posts]
최근 게시물의 단축 코드입니다. 이 단축 코드는 백엔드 (예 : 페이지, 게시물, 위젯)에 적용 할 수 있습니다.
코드 내에서 동일한 단축 코드를 사용할 수도 있습니다. do_shortcode
의 도움으로
예 : echo do_shortcode( '[recent-posts]' );
최근 게시물에 대한 고급 단축 코드
이 함수는 표시하려는 최근 게시물의 수에 대한 매개 변수를 취합니다.
예 : 5 개의 최근 게시물 만 표시하고 싶습니다. posts = "5"로 인수를 전달했습니다 (표시하려는 최근 게시물을 여러 개 전달할 수 있음).
함수는 데이터베이스에서 5 개의 최근 게시물 만 가져옵니다.
// recent-posts is going to be our shortcode.
add_shortcode('recent-posts', 'recent_posts_function');
// Functions takes parameter such as posts="5".
function recent_posts_function($atts){
extract(shortcode_atts(array(
'posts' => 1,
), $atts));
$return_string = '<ul>';
query_posts(array('orderby' => 'date', 'order' => 'DESC' , 'showposts' => $posts));
if (have_posts()) :
while (have_posts()) : the_post();
$return_string .= '<li><a href="'.get_permalink().'">'.get_the_title().'</a></li>';
endwhile;
endif;
$return_string .= '</ul>';
wp_reset_query();
return $return_string;
}
예 : echo do_shortcode( '[recent-posts posts="5"]' );
Modified text is an extract of the original Stack Overflow Documentation
아래 라이선스 CC BY-SA 3.0
와 제휴하지 않음 Stack Overflow