워드 프레스 의 shortcode 짧 은 코드 기능 사용 에 대한 자세 한 설명

WordPress 는 2.5 버 전부터 shortcode(짧 은 코드)API 를 추 가 했 습 니 다.BBS 의 BBCode 와 유사 하고 shortcode 도 글 이나 페이지 에 편리 하 게 기능 을 추가 할 수 있 으 며 shortcode 는 BBCode 보다 더욱 유연 하고 강력 합 니 다.다음은 카 요 가 쇼트 코드 를 소개 해 드 리 겠 습 니 다.
1.shortcode 소개
shortcode 는 개발 자 들 로 하여 금 함수 형식 으로 매크로 콘 텐 츠 를 만들어 내용 을 만 들 수 있 게 합 니 다.아마도 이 개념 은 약간 모호 해 보일 수 있 지만 사실은 간단 하고 실 용적 인 기능 입 니 다.기본 적 인 PHP 함수 만 작성 할 수 있다 면 shortcode 를 사용 할 수 있 습 니 다.다음은 실제 적 인 예 로 shortcode 의 사용 방법 을 설명 할 것 입 니 다.
2.shortcode 형식
shortcode 는 닫 힌 탭 과 자동 닫 힌 탭 을 지원 하고 탭 에서 파 라 메 터 를 사용 하 는 것 을 지원 합 니 다.shortcode 가 구체 적 으로 어떤 형식 인지 개발 자 들 이 이 shortcode 를 어떻게 작성 하 는 지 결정 합 니 다.

[myshortcode]Some Content[/myshortcode] //     
[myshortcode] //     
[myshortcode title="example"] //            
[myshortcode]<p><a href="#"><span>  </span></a></p>[/myshortcode] //            HTML
[myshortcode]Content [myshortcodesecond] more content[/myshortcodesecond] //          

3.shortcode 예
shortcode 를 사용 하기 전에 먼저 테마의 functions.php 파일 에서 shortcode 를 정의 해 야 합 니 다.예 를 들 어:

function myshortcode_function($atts, $content = null){ // $atts     shortcode      ，$content        
 
 extract(shortcode_atts(array( //    extract           
 "title" => '  ' //        ，       $           
 ), $atts));
 //     
 return '<div class="myshortcode">
    <h3>'. $title .'</h3>
    <p>
     '. $content .'
    </p>
   </div>';
}
 
add_shortcode("msc", "myshortcode_function"); //     shortcode，     [msc]       shortcode

위의 코드 를 functions.php 에 추가 하면 간단 한 shortcode 를 만 들 수 있 습 니 다.우 리 는[msc][/msc]탭 을 통 해 이 shortcode 를 호출 할 수 있 습 니 다.예 를 들 어:

[msc title="  "]       Kayo's Melody ，       [/msc]

글 이나 페이지 내용 에 위의 호출 을 입력 하면 해당 위치 에서 환영 문 구 를 출력 할 수 있 고 style.css 에서 해당 하 는 CSS 를 정의 하면 짧 은 코드 에 스타일 을 부여 할 수 있 습 니 다.
카 요 는 워드 프레스 의 짧 은 코드(shortcode)기능 을 간략하게 소 개 했 으 며,주로 shortcode 의 주요 개념 과 사용 방법 을 소개 했다.본 논문 에서 카 요 는 shortcode 에서 비교적 중요 한 API 를 더욱 상세 하 게 소개 할 것 이 며,여러분 이 비교적 복잡 한 shortcode 를 개발 하 는 데 도움 이 되 기 를 바 랍 니 다.
4.함수 addshortcode
이 함 수 는 shortcode 를 등록 하 는 데 사 용 됩 니 다.짧 은 코드 이름과 shortcode 처리 함수 이름 은 위의 예 를 참조 합 니 다.

function myshortcode_function($atts, $content = null){ // $atts     shortcode      ，$content        
 
 extract(shortcode_atts(array( //    extract           
 "title" => '  ' //        ，       $           
 ), $atts));
 //     
 return '<div class="myshortcode">
    <h3>'. $title .'</h3>
    <p>
     '. $content .'
    </p>
   </div>';
}
 
add_shortcode("msc", "myshortcode_function"); //     shortcode，     [msc]       shortcode

msc 는 짧 은 코드 이름 입 니 다.나중에 글 이나 페이지 를 쓸 때[msc][/msc]탭 을 사용 하여 이 짧 은 코드 를 호출 할 수 있 습 니 다."my shortcode"function"은 예 중의 짧 은 코드 처리 함수 의 이름 입 니 다.다음은 짧 은 코드 처리 함 수 를 중점적으로 분석 합 니 다.
5.짧 은 코드 처리 함수
shortcode 처리 함 수 는 shortcode 의 핵심 입 니 다.shortcode 처리 함 수 는 Flickr(WordPress 필터)와 유사 합 니 다.모두 특정한 인 자 를 받 아들 이 고 일정한 결 과 를 되 돌려 줍 니 다.shortcode 프로 세 서 는 두 개의 인 자 를 받 아들 입 니 다.$attr 와$content,$attr 는 shortcode 의 각 속성 인 자 를 대표 합 니 다.본질 적 으로 는 관련 배열 이 고$content 는 shortcode 태그 의 내용 을 대표 합 니 다.
위의 예 와 같이 글 에서 호출 을 하면 환영 문 구 를 출력 합 니 다.
[msc title="환영 합 니 다"]독립 블 로그 Kayo's Melody 입 니 다.본 블 로그 에 오신 것 을 환영 합 니 다[/msc]
글 이 표 시 될 때 워드 프레스 는 위의[msc]와 같은 모든 shortcode 를 등록 합 니 다.shortcode 에 속성 매개 변수 와 내용 이 있 으 면 워드 프레스 는 이 를 분리 하고 해석 한 다음 에 이 shortcode 의 짧 은 코드 처리 함수 에 전달 합 니 다.처리 후 짧 은 코드 의 원래 내용 대신 함수 출력 결 과 를 처리 합 니 다.
이 때 속성 매개 변 수 는 관련 배열 을 분석 하고$attr 에 전 달 됩 니 다.예 를 들 어$attr 의 값 은 다음 과 같은 관련 배열 입 니 다.

array( 'title' => '  ')

출력 결 과 를 출력 할 때$매개 변수 이름 으로 출력 할 수 있 습 니 다.예 를 들 어$title 로 이 속성 값 을 출력 할 수 있 습 니 다.
6.shortcodeatts
shortcode_atts 는 매우 실 용적 인 함수 입 니 다.필요 한 속성 매개 변 수 를 기본 값 으로 설정 하고 필요 하지 않 은 매개 변 수 를 삭제 할 수 있 습 니 다.
shortcode_atts()는 두 개의 인자$defaults 를 포함 합 니 다.array 와$atts,$attr 는 속성 매개 변수 집합,$defaultsarray 는 설정 해 야 할 속성 기본 값 입 니 다.예 를 들 어:

$result = shortcode_atts( array(
 'title' => '   ',
 'description' => '    '
), $atts );
$attr    

array( 'title' => '  ')

이 때$result 의 결 과 는?

array( 'title' => '   ', 'description' => '    ')

'title'은$defaults 에 있 기 때 문 입 니 다.array 는 서로 다른 값 이 있 기 때문에 이 새로운 값 을 기준 으로'title'을 업데이트 하 는 동시에'description'이라는 값 도 추가 하 였 습 니 다.주의해 야 할 것 은 shortcodeatts()는$defaults 를 걸 러 냅 니 다.array 에 없 는 속성 입 니 다.$attr 에'ohter'속성 이 있다 면$result 의 결 과 는 여전히 위의 결과 입 니 다.$defaults 때 문 입 니 다.array 에는'other'라 는 속성 이 없습니다.물론 여기 서 말 하 는 값 은 속성의 기본 값 일 뿐 실제 출력 값 은 shortcode 호출 시 작성 한 값 입 니 다.
7.속성 과 설정 속성 기본 값 을 더 분석 합 니 다.
extract()함 수 는 속성 을 더 분석 하고 속성 기본 값 을 설정 하 는 데 사 용 됩 니 다.그 중 하 나 는 각 속성 매개 변수 값 을'$매개 변수 이름'과 같은 변 수 를 저장 하 는 것 입 니 다.(예 를 들 어$title)호출 이 편리 합 니 다.이 함 수 를 사용 하여 shortcodeatts()는 안전 한 출력 결 과 를 얻 을 수 있 습 니 다.이 점 의 구체 적 인 사용 은 본 고의 첫 번 째 점 인'1.함수 add'를 참조 할 수 있다.shortcode 의 예.
또한 속성 명 에 있 는 대문자 가 처리 함수 에 전달 되 기 전에 소문 자로 바 뀌 므 로 속성 명 을 작성 할 때 소문 자 를 직접 사용 하 는 것 을 권장 합 니 다.