WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

ko:Function Reference/get post format

Contents

설명

포스트의 포맷(형태)을 반환합니다. 이 함수는 루프문에서 주로 사용됩니다만, 인자값으로 포스트ID 를 입력하면, 언제 어디서든 이 함수는 사용이 가능합니다.

사용법

<?php $format get_post_format$post_id ); ?>

인자값

$post_id
(integer) (Optional) 포스트 ID.
Default: 현재 루프 중인 포스트 혹은 현재 포스트

반환값

Format (string) 
포스트의 포맷(형태) 값, 혹은 false 값. false값은 지정된 포맷이 없는 경우 발생합니다.

현재 정의되어 있는 포맷의 형태는 아래와 같습니다.

  • aside
  • chat
  • gallery
  • link
  • image
  • quote
  • status
  • video
  • audio

참고. 기본 포맷(예를 들어 일반 포스트)인 경우 false를 반환합니다. 하지만, 어떤 부분에서는 이것이 '표준' 포맷(형태)로 제공됩니다. 몇가지 경우에서는, 유지보수의 일관성을 위해서 개발자분들이 아래와 같이 처리하시는 것이 좋을 수도 있습니다.

$format = get_post_format();
if ( false === $format )
	$format = 'standard';

예제

<?php
/*
 * 포스트 포맷에 따라서, 다른 하위 템플릿을 가져오는 소스.
 * 
 * 이 소스는 기본적으로 '<tt>format.php</tt>' 파일을 뿌려줄 것입니다. 
 * 템플릿 이름을 '<tt>format-link.php</tt>', '<tt>format-aside.php</tt>', 
 * 기타 다른 이름으로 사용하셔서 하위템플릿을 달리하여 사용하십시오.
 *
 * 이것을 사용하려면 루프 안에서 사용하셔야 합니다. 
 */

$format = get_post_format();
get_template_part( 'format', $format );
?>

변경로그

소스파일

get_post_format()은(는) wp-includes/post.php에 있습니다.

관련자료

아래 자료들은 모두 영문 자료입니다. 한글자료를 발견하신 경우 편집하여 추가해주시면 문서 발전에 도움이 될것 입니다.

관련된것들

Template:ko:Post Formats

Function ReferenceTemplate Tags의 목록을 참고해주세요.