What are the template tags in WordPress ?
WordPress is a free and open-source content management system written in PHP language that allows you to contribute to your project, and host websites all over the world at zero cost. WordPress provides different tags and templates to the user to make their project unique and outstanding.
Template tags in WordPress are nothing but a simple PHP function that is used to present data and customize their blog.
Syntax: The template tag is a PHP function. so it must contain brace within its tag . and must end with a semicolon.
The blog info template tag displays the information of the current blog.
- Useful to print dynamic content
- PHP function so it’s secure
- Can handle multiple themes and files
- Divide code into smaller part
- Easy to understand.
- Useful to fetch data from the database.
- It can call another theme file within the database.
- Can display data by passing argument.
Template Tags: Template tags files are defined in the wp-includes directory.
There are a total of 9 template tags in the wp-includes directory: The following is a list of template tag files that can be used in WordPress.
- wp-includes/general-template.php
- wp-includes/author-template.php
- wp-includes/bookmark-template.php
- wp-includes/category-template.php
- wp-includes/comment-template.php
- wp-includes/link-template.php
- wp-includes/post-template.php
- wp-includes/post-thumbnail-template.php
- wp-includes/nav-menu-template.php
Template Tag List: It contains a total of 9 template tags and these are the following:
- General tags
- Author tags
- Bookmark tags
- Category tags
- Comment tags
- Link tags
- Post tags
- Post Thumbnail tags
- Navigation Menu tags
1. General tag: These are defined in the “wp-includes/general-template.php” directory. This General tag contains a total of 29 template tags. These are the following:
| Template tag | Description |
| get_header() | Get header template of current blog |
| get_bloginfo() | Get information about the current blog site. |
| get_footer() | Get footer template of current blog. |
| get_sidebar() | Get sidebar template of current blog. |
| get_search_form() | Display search form on screen. |
| wp_loginout() | Display the Log In and log out form . |
| wp_logout_url() | Get logout URL of current blog |
| wp_login_form() | Display login form . |
| wp_lostpassword_url() | Return password with URL link |
| wp_title() | Display page title in all page of blog. |
| bloginfo() | Displays information about the current blog site |
2. Author tag: These are the different author tags defined in “wp-includes/author-template.php”. Some of the following:
| Template Tag | Description |
| get_the_author() | Get the author name of the current blog |
| the_author_meta() | Displays a meta data of user. |
| the_author() | Display author of the current blog. |
| the_author_link() | Display author’s data link. |
| get_the_author_link() | Display Author data URL link. |
| the_author_posts() | Display the all post count of author |
| the_author_posts_link() | Displays link to the author page. |
3. Bookmark tags: These are the only 4 template tags of Bookmark tags that are defined in “wp-includes/bookmark-template.php”.
| Template Tag | Description |
| wp_list_bookmarks() | Display all of the bookmarks page |
| get_bookmark() | fetch Bookmark data |
| get_bookmark_field() | display single bookmark data |
| get_bookmarks() . | Display the list of bookmarks pages |
4. Category tags:
| Template Tag | Description |
| wp_list_categories() | Displays the HTML list of categories |
| tag_description() | Display tag description |
| the_tags() | Displays the tags of post |
| wp_generate_tag_cloud() | Generates a tag cloud from provided data |
| single_term_title() | Display page title |
| category_description() | Display category description |
| the_category_rss() | Display the post categories in the feed |
| the_category() | Displays category list for a post. |
| wp_dropdown_categories() | Displays the HTML dropdown list of categories |
| term_description() | Display term description. |
| wp_tag_cloud() | Displays a tag cloud. |
5. Comment tags: These are the different comment tag template tags defined in “wp-includes/comment-template.php”. Some of these are the following
| Template Tag | Description |
| cancel_comment_reply_link() | Displays HTML data for canceled comment reply by admin. |
| comment_author_email_link() | Displays the HTML data of email link of author’s current comment |
| comment_author_rss() | Display the current comment of author . |
| comment_author_link() | Displays the HTML link to the URL of the author’s comment |
| comment_author_IP() | Displays the IP address of author comment. |
6. Link tags: These are the different template tags defined in “wp-includes/link-template.php”.
| Template Tag | Description |
| get_permalink() | Get permalink for the current post |
| get_page_link() | Display the permalink of post . |
| get_admin_url() | Display URL of admin. |
| get_home_url() | Display Home Page URL |
| get_admin_url() | Display URL of admin page . |
| the_permalink() | Displays the permalink for the current post |
7. Post tags: These are the different template tags defined in “wp-includes/post-template.php”
| Template Tag | Description |
| next_image_link() | Displays image link of next post . |
| post_class() | Displays the class of post. |
| next_posts_link() | Displays the next posts link |
| body_class() | Displays the class name of body . |
8. Post Thumbnail tags: These are only 4 template tags that are defined in “wp-includes/post-thumbnail-template.php”.
| Template Tag | Description |
| get_post_thumbnail_id() | get thumbnail ID |
| get_the_post_thumbnail() | Get the post thumbnail |
| the_post_thumbnail() | Display the thumbnail |
| has_post_thumbnail() | check whether a post has an thumbnail or not |
9. Navigation Menu tags: These are the only 2 template tags defined in “wp-includes/nav-menu-template.php”.
| Template Tag | Description |
| walk_nav_menu_tree() | display the HTML data list for navigation of menu items |
| wp_nav_menu() | Displays a navigation menu of current blog |
Изучаем теги шаблонов: введение
WordPress – это многофункциональная система управления контентом, обладающая гибкостью и расширяемостью. Если продукт расширяем, то люди смогут сделать свой вклад в его развитие, что приводит к рождению целого сообщества, готового помочь развитию проекта.
Это как замкнутый круг, в котором хороший продукт создает вокруг себя сообщество энтузиастов, желающих сделать этот продукт еще лучше, и именно так платформа WordPress стала самой популярной CMS в мире.
Сегодня мы открываем новую серию статей, посвященных одному из основополагающих компонентов WordPress : тегам шаблонов.
Что такое теги шаблонов (template tags)?
Два основных свойства, отражающих гибкость платформы WordPress – это возможность создавать « плагины » ( для расширения функционала ) и « темы оформления » ( для изменения внешнего вида ). Эти свойства являются результатом успешной реализации ключевых концепций WordPress: API и подсистем. Теги шаблонов являются одной из основ построения всей системы CMS .
Теги шаблонов появились еще задолго до самого WordPress . Он был представлен в b2 — платформе для ведения блогов, которую Мэтт Мулленвег и Майк Литтл слегка модернизировали при создании WordPress . Можно сказать, что это одна из первых функций, реализованная еще до поддержки в W P тем и плагинов.
В Кодексе WordPress , теги шаблонов описаны следующим образом:
« Теги шаблонов используются в шаблонах вашего блога для динамического вывода информации или настройки сайта, предоставляя для этого инструменты и позволяя сделать его более индивидуальным и интересным ».
Теги шаблонов – это PHP -функции, которые поручают WordPress » сделать » или » получить » что-нибудь. И поверьте, в этом нет ничего сложного, если вы знакомы с основами PHP и HTML .
Где находятся теги шаблонов?
Файлы, в которых хранятся функции для всех тегов шаблонов, находятся в папке wp-includes .
Всего существует 9 различных файлов с окончанием template :
- wp-includes/author-template.php — включает в себя теги шаблонов, связанные с автором;
- wp-includes/bookmark-template.php — включает в себя теги шаблонов, связанные с закладками;
- wp-includes/category-template.php — включает в себя теги шаблонов, связанные с таксономией и терминами, включая рубрики и теги;
- wp-includes/comment-template.php — включает в себя теги шаблонов, связанные с комментариями;
- wp-includes/link-template.php — включает в себя теги шаблонов, связанные со ссылками ( постоянные ссылки, ссылки на прикрепленные файлы, ссылки на архивы и т.д. );
- wp-includes/nav-menu-template.php — включает в себя теги шаблонов, связанные с меню навигации;
- wp-includes/post-template.php — включает в себя теги шаблонов, связанные с записями/публикациями;
- wp-includes/post-thumbnail-template.php — включает в себя теги шаблонов, связанные с миниатюрами записей;
- wp-includes/general-template.php — включает в себя все остальные теги шаблонов.
Как можно использовать теги шаблонов?
Вам будет несложно понять принцип работы шаблонных тегов, если вы знакомы с основами PHP , HTML и CSS . Так как теги шаблонов представляют собой не что иное, как PHP -функции, то вполне понятно, как ими пользоваться. Но вам следует знать о них кое-что еще.
Функции шаблонных тегов
Кроме тегов вставки ( Include Tags ) и условных тэгов ( Conditional Tags ), функции тегов шаблона можно разделить на две группы: те, что « выводят », и те, что « возвращают ». Эти два типа функций формируют основу тегов шаблона и позволяют создавать новые темы оформления.
Выявить « возвращающие » теги можно по их названиям – в них перед именем функции используется приставка get_ . Хоть они и выглядят как производное от обычных функций, но все же несут в себе уникальный код и возвращают результат. Теги шаблонов, которые выводят информацию, обычно привязываются к get_ функциям. Давайте взглянем на исходный код функции the_ID() :
Существуют функции, которым можно задавать логический $echo -параметр. Например, функция будет выводить информацию при установленном параметре TRUE , и возвращать значение при параметре FALSE . Не беспокойтесь, если запутались, так как мы познакомиться с параметрами всех шаблонных тегов.
Параметры функций шаблонных тегов
Параметры – это типы данных, которые способны изменять поведение тегов шаблона. С помощью параметров вы можете добавлять к выводимым данным префиксы и суффиксы, ограничивать объем получаемых данных, исключать определенные пункты из списков и так далее. Без знаний о доступных параметрах для каждого тега шаблона, вы ограничиваетесь лишь его поведением по умолчанию.
Объявление параметров
Есть три способа объявления параметра функции:
При помощи регулярных параметров: большинство тегов шаблона принимают регулярные PHP -параметры, которые можно разделять запятыми:
При помощи строки запроса ( Query-string ): некоторые функции принимают параметры в форме строки запроса, как показано в примере ниже:
При помощи массивов ( array ): лучший и более «опрятный » способ объявления параметров, чем строка запроса:
'my-primary-menu', 'theme_location' => 'primary', 'after' => '
' ); wp_nav_menu( $args ); ?>
Помните, что вы можете использовать массивы вместо параметров запросов и наоборот, но нельзя заменять регулярные параметры параметрами Query-string или же массивами. Если шаблонный тег принимает регулярные параметры, значит использовать можно только их. Если тег принимает параметры строки запроса или массив, можно использовать и то, и другое.
Если запутались, то рекомендуем вам ознакомиться со страницей, посвященной параметрам функций шаблонных тегов .
В завершение
Теперь, когда мы познакомились с основами использования тегов шаблона в WordPress , можно продолжить наше обучение. В следующих руководствах из этой серии мы изучим каждый из шаблонных тегов (описанных в Кодексе ), и представим их небольшое описание, объясним параметры, и приведем примеры использования каждого тега.
Это будет довольно долгое путешествие по миру шаблонных тегов, но мы постараемся сделать его как можно увлекательнее.
Может быть, вы хотите рассказать нам и другим читателям что-нибудь о тегах шаблона? Для этого воспользуйтесь размещенной ниже формой для комментариев. И если вам понравилась эта статья, не забудьте поделиться ей с друзьями!
Редакция Перевод статьи « The Tuts+ Guide to Template Tags: Introduction »