워드프레스는 전 세계적으로 가장 많이 사용되는 CMS(Content Management System)입니다. 특히 워드프레스를 이용한 테마 제작이나 커스터마이징은 자유도가 높고, PHP 기반의 구조 덕분에 누구나 원하는 형태의 웹사이트를 만들 수 있습니다.
그러나 테마 수정을 처음 시작할 때 가장 혼란스러운 부분 중 하나는 어떤 파일을 수정해야 하는지, 그리고 어떤 템플릿 태그를 사용해야 원하는 정보를 출력할 수 있는지를 파악하는 것입니다.
이 글에서는 워드프레스 테마 수정에 필수적인 **템플릿 태그(template tag)**들의 종류와 역할, 사용법을 정리하고 예제와 함께 설명드리겠습니다. 워드프레스 개발자나 커스터마이징을 진행하고자 하는 분들께 도움이 될 수 있도록 구성했습니다.
📁 1. 템플릿 태그 관련 파일 위치
워드프레스의 템플릿 태그는 대부분 wp-includes 디렉토리에 위치한 PHP 파일에 정의되어 있습니다. 파일명은 주로 -template.php로 끝나며, 기능에 따라 다음과 같이 구분됩니다.
파일명 주요 내용
| general-template.php | 공통적으로 자주 사용되는 템플릿 태그 |
| author-template.php | 글쓴이 관련 정보 출력 |
| bookmark-template.php | 북마크 출력 |
| category-template.php | 카테고리 정보 출력 |
| comment-template.php | 댓글 정보 출력 |
| link-template.php | 링크 관련 템플릿 태그 |
| post-template.php | 본문 및 클래스 정보 출력 |
| post-thumbnail-template.php | 썸네일 관련 태그 |
| nav-menu-template.php | 내비게이션 메뉴 관련 |
🏷️ 2. 템플릿 태그 종류별 설명과 사용법
🔹 2-1. General Template Tags (일반 태그)
- get_header()
👉 header.php 파일을 불러올 때 사용 - <?php get_header(); ?>
- get_footer()
👉 footer.php 파일을 불러올 때 사용 - <?php get_footer(); ?>
- get_sidebar()
👉 sidebar.php 파일을 불러올 때 사용 - <?php get_sidebar(); ?>
- get_template_part()
👉 부분 템플릿을 재사용할 때 - <?php get_template_part('template-parts/content', 'single'); ?>
- bloginfo()
👉 사이트의 메타 정보를 출력 - <?php bloginfo('name'); ?> <!-- 사이트 제목 --> <?php bloginfo('description'); ?> <!-- 사이트 설명 -->
- wp_title()
👉 페이지 타이틀 출력 (deprecated, 대신 add_theme_support('title-tag') 권장) - wp_enqueue_script()
👉 자바스크립트, CSS 파일 등록 - function my_script() { wp_enqueue_script('custom-script', get_template_directory_uri().'/js/script.js', array(), null, true); } add_action('wp_enqueue_scripts', 'my_script');
- single_post_title()
👉 루프 밖에서 현재 글의 제목 출력 - single_tag_title()
👉 현재 페이지의 태그 이름 출력
🔹 2-2. Author Template Tags (작가 관련 태그)
- the_author()
👉 포스트 작성자 이름 출력 - <p>작성자: <?php the_author(); ?></p>
- get_the_author()
👉 루프 외부에서 작성자 정보를 가져올 때
🔹 2-3. Bookmark Template Tags (북마크 태그)
- wp_list_bookmarks()
👉 등록된 북마크 목록 출력 - <?php wp_list_bookmarks(); ?>
- get_bookmark()
👉 특정 북마크 정보 반환
🔹 2-4. Category Template Tags (카테고리 관련)
- category_description()
👉 현재 카테고리의 설명 출력 - <?php echo category_description(); ?>
- the_category()
👉 현재 글이 속한 카테고리 링크 출력 - <p>카테고리: <?php the_category(', '); ?></p>
- wp_list_categories()
👉 전체 카테고리 리스트 출력 - <?php wp_list_categories(array( 'orderby' => 'name', 'title_li' => '' )); ?>
🔹 2-5. Comment Template Tags (댓글 관련)
- comment_author()
👉 댓글 작성자 출력 - comment_date()
👉 댓글 날짜 출력 - comment_text()
👉 댓글 본문 출력 - wp_list_comments()
👉 댓글 리스트 출력 - <?php wp_list_comments(); ?>
🔹 2-6. Link Template Tags (링크 관련 태그)
- the_permalink()
👉 현재 포스트의 고유 링크 출력 - <a href="<?php the_permalink(); ?>">자세히 보기</a>
- get_post_permalink()
👉 특정 포스트 ID로 링크 가져오기 - get_page_link()
👉 페이지 링크 반환 - get_tag_link()
👉 특정 태그 아카이브 페이지 링크 - site_url()
👉 사이트 기본 주소 반환 - <a href="<?php echo site_url('/contact'); ?>">Contact</a>
🔹 2-7. Post Template Tags (포스트 관련 태그)
- body_class()
👉 <body> 태그에 클래스 부여 - <body <?php body_class(); ?>>
- the_content()
👉 포스트 본문 출력 - <div class="post-content"><?php the_content(); ?></div>
- post_class()
👉 <article> 등의 태그에 클래스 부여 - <article <?php post_class(); ?>>
🔹 2-8. Post Thumbnail Tags (특성 이미지 관련)
- has_post_thumbnail()
👉 특성 이미지 존재 여부 확인 - <?php if ( has_post_thumbnail() ) : ?> <?php the_post_thumbnail('medium'); ?> <?php endif; ?>
🔹 2-9. Navigation Menu Tags (내비게이션 메뉴)
- wp_nav_menu()
👉 사용자 지정 메뉴 출력 - <?php wp_nav_menu(array( 'theme_location' => 'main-menu', 'container' => 'nav', 'menu_class' => 'main-nav' )); ?>
✅ 3. 예제: 커스텀 템플릿 파일 만들기
다음은 위 태그들을 활용해 커스텀 템플릿 파일을 구성하는 간단한 예입니다.
<?php get_header(); ?>
<main>
<h1><?php single_post_title(); ?></h1>
<p class="author"><?php the_author(); ?></p>
<div class="content">
<?php the_content(); ?>
</div>
<div class="categories">
<?php the_category(', '); ?>
</div>
<?php if ( has_post_thumbnail() ) : ?>
<div class="thumbnail"><?php the_post_thumbnail('large'); ?></div>
<?php endif; ?>
</main>
<?php get_footer(); ?>
📝 마무리하며
워드프레스 테마를 자유롭게 커스터마이징하려면 기본적인 템플릿 태그의 기능과 구조를 이해하는 것이 매우 중요합니다. 이 글에서 소개한 태그들은 테마 개발과 수정의 핵심이 되는 요소들입니다.
태그를 직접 테스트하며 익히고, 공식 문서(WordPress Codex)도 함께 참고하면 더욱 빠르게 실력을 향상시킬 수 있습니다.
앞으로 워드프레스를 이용한 다양한 테마 작업을 보다 체계적이고 효율적으로 하시길 바라며, 다음 글에서는 커스텀 포스트 타입과 루프 제어를 위한 고급 태그 활용법에 대해 다뤄보겠습니다.
태그:
워드프레스, WordPress 테마, 템플릿 태그, 워드프레스 개발, wp-includes, get_header, wp_nav_menu, 커스터마이징
'IT' 카테고리의 다른 글
| Spring Boot 3 JPA에서 데이터 수정(Update)하는 가장 깔끔한 방법과 예제 (0) | 2025.05.09 |
|---|---|
| 워드프레스 테마 구조 완벽 정리 | 템플릿 파일과 폴더의 역할 이해하기 (0) | 2025.05.08 |
| 윈도우 보안 열었을 때 검은 화면 또는 흰 화면이 뜨는 문제 해결법 (0) | 2025.05.08 |
| 워드프레스 회원가입 및 관리 플러그인 완벽 비교 ｜ Ultimate Member, WP-Members, YITH WooCommerce Membership, WooCommerce Membership (0) | 2025.05.08 |
| 워드프레스 플러그인 추천 리스트 총정리 | 자주 사용하는 필수 플러그인 모음 (0) | 2025.05.08 |