수색…


통사론

  • 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