WordPress.org

Ready to get started?Download WordPress

Codex

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

Теги шаблонов/Анатомия тегов шаблонов

Эта страница помечена как незавершённая. Вы можете помочь проекту, дополнив её.

Вступление

This document provides a brief examination of the animal known as the WordPress template tag, to help those who may be new to WordPress and PHP understand what template tags are and how they're used.

Теги шаблонов в WordPress состоят из трёх компонентов:

О них будет рассказано ниже.

Теги PHP-кода

WordPress is built with the PHP scripting language. Though you certainly don't need to be a PHP developer to use it, knowing a little about the language can go a long way in getting the most out of WordPress. Here we provide a tiny bit of that PHP knowledge:

<?php ?>

The above shows the opening (<?php) and closing (?>) tag elements used to embed PHP functions and code in a HTML document, i.e. web page. There are a number of ways to embed PHP within a page, but this is the most "portable," in that it works on nearly every web server—as long as the server supports PHP (typically a document's filename also needs to end with the extension .php, so the server recognizes it as a PHP document).

Anything within this tag is parsed and handled by the PHP interpreter, which runs on the web server (the interpreter is the PHP engine that figures out what the various functions and code do, and returns their output). For our purposes, the PHP tag lets you place WordPress functions in your page template, and through these generate the dynamic portions of your blog.

Функции

Функция WordPress или шаблона -- это PHP-функция , которая выполняет действие или выводит информацию, специфичную для вашего блога.И как и PHP-функция, функция WordPress определяется текстовой строкой (из одного или нескольких слов, без пробелов), открывающей и закрывающей скобкой, и как правило, точкой с запятой. которая указывает на окончание кода в PHP. Как пример функции WordPress:

the_ID();

the_ID() выводит ID записи. Для использования тега шаблона в странице шаблона надо вставить его в тег PHP , описанный выше. Вот так:

<?php the_ID(); ?>

Это теперь настоящий тег шаблона WordPress , так как он использует теги PHP вместе с функцией WordPress.

Параметры

The final item making up a template tag is one you won't necessarily make use of unless you want to customize the tag's functionality. This, or rather these, are the parameters or arguments for a function. Here is the template function bloginfo(), with the show parameter being passed the 'name' value:

<?php bloginfo('name'); ?>

If your blog's name is Super Weblog, the bloginfo() template tag, when using 'name' as the show parameter value, will display that name where it's embedded in your page template.

Not all template tags accept parameters (the_ID() is one), and those which do accept different ones based on their intended use, so that the_content() accepts parameters separate from those which get_calendar() can be passed.

Читайте также

См. следующие страницы Кодекса для более глубокого изучения информации о тегах шаблонов: Templates
How to Pass Tag Parameters

See also index of Function Reference and index of Template Tags.