Статьи

Путеводитель по шаблонам: восьмая партия

Февраль 1, 2019

В восьмой части серии мы рассмотрели седьмую серию тегов шаблонов WordPress. В этой девятой части мы рассмотрим последнюю партию из почти 200 шаблонных тегов. В этом руководстве мы увидим теги шаблонов для закладок и другие «разные» теги шаблонов.

Предупреждение о закладках: Начиная с WordPress 3.5, «закладки» по умолчанию скрыты в панели администратора. Для работы с закладками необходимо установить плагин Link Manager .

Получение и отображение списка закладок: wp_list_bookmarks()

Этот тег шаблона возвращает или отображает список закладок, старую функцию WordPress.

параметры

Этот шаблонный тег принимает только один параметр:

  • $args (необязательно — массив) :
    Массив следующих аргументов:
    • 'orderby' (строка): как заказать закладки. Принимает ‘name’, ‘link_id’, ‘url’, ‘target’, ‘description’, ‘owner’ (пользователь, добавивший закладку), ‘rating’, ‘updated’ (даты обновления), ‘rel’ (XFN отношение закладок), ‘notes’, ‘rss’, ‘length’ (длина имени закладки), ‘rand’ (random).
      (По умолчанию: «имя»)
    • 'order' (строка): заказывать элементы в порядке возрастания (ASC) или убывания (DESC).
      По умолчанию: «ASC»
    • 'limit' (целое число): количество элементов для отображения.
      (По умолчанию: -1, что означает все закладки)
    • 'category' (строка): разделенные запятыми идентификаторы категорий, из которых можно получить элементы.
      (По умолчанию: », что означает все категории)
    • 'exclude_category' (строка): идентификаторы категорий закладок для исключения.
      (По умолчанию: ‘ ‘)
    • 'category_name' (строка): имя категории для отображения закладок из (переопределяет ‘category’).
      (По умолчанию: ‘ ‘)
    • 'hide_invisible' (целое число): скрывать или скрывать невидимые ссылки.
      (По умолчанию: 1)
    • 'show_updated' (integer): должна ли отображаться последняя обновленная отметка времени или нет.
      (По умолчанию: 0)
    • 'echo' (целое число): выводить ли вывод (1) или возвращать его (0).
      (По умолчанию: 1)
    • 'categorize' (целое число): группировать закладки по категориям (1) или нет (0).
      (По умолчанию: 1)
    • 'title_li' (строка): заключает вывод в <li> и отображает заголовок перед списком закладок. Возможно, вы захотите установить это в пустую строку и отключить перенос.
      По умолчанию: «Закладки»
    • 'title_before' (строка): HTML-код, добавляемый перед каждым заголовком.
      По умолчанию: «<h2>»
    • 'title_after' (строка): HTML-код, добавляемый после каждого заголовка.
      По умолчанию: «</ h2>»
    • 'class' (строка): имена классов CSS для добавления в каждую категорию.
      По умолчанию: ‘linkcat’
    • 'category_before' (строка): HTML-код, добавляемый перед каждой категорией.
      По умолчанию: ‘<li id ​​=% id class =% class>’)
    • 'category_after' (строка): HTML-код, добавляемый после каждой категории.
      По умолчанию: «</ li>»
    • 'category_orderby' (строка): как упорядочить категории. Принимает «имя», «идентификатор», «слизняк» и «количество».
      (По умолчанию: «имя»)
    • 'category_order' (строка): упорядочивать категории по возрастанию (ASC) или по убыванию (DESC).
      По умолчанию: «ASC»

использование

01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<?php
 
$args = array(
     
    // Random order.
    ‘orderby’ => ‘rand’,
     
    // Take just 5 bookmarks.
    ‘limit’ => 5,
     
    // Take bookmarks from a specific category.
    ‘category_name’ => ‘Friends’,
     
    // Don’t echo.
    ‘echo’ => 0,
     
    // Custom class.
    ‘class’ => ‘friends-bookmark-list’
     
);
 
$bookmarks_list = wp_list_bookmarks( $args );
 
?>

Получение массива всех закладок: get_bookmarks()

Этот тег шаблона возвращает массив ваших закладок WordPress.

параметры

Этот шаблонный тег принимает только один параметр:

  • $args (необязательно — массив) :
    Массив следующих аргументов:
    • 'orderby' (строка): как заказать ссылки. Принимает поля сообщения, такие как «имя», «идентификатор», «заголовок», «дата» и т. Д.
      (По умолчанию: «имя»)
    • 'order' (строка): заказывать элементы в порядке возрастания (ASC) или убывания (DESC).
      По умолчанию: «ASC»
    • 'limit' (целое число): количество элементов для отображения.
      (По умолчанию: -1, что означает все)
    • 'category' (строка): разделенные запятыми идентификаторы категорий, из которых можно получить элементы.
      (По умолчанию: пусто)
    • 'category_name' (строка): имя категории, из которой можно получить элементы.
      (По умолчанию: пусто)
    • 'hide_invisible' (целое или логическое): показывать или скрывать ссылки, помеченные как «невидимые».
      (По умолчанию: 1|TRUE )
    • 'show_updated' (целое или логическое): отображать время последнего обновления закладки.
      По умолчанию: 0|FALSE
    • 'include' (строка): список идентификаторов для включения в запятую.
      (По умолчанию: пусто)
    • 'exclude' (строка): разделенный запятыми список идентификаторов для исключения.
      (По умолчанию: пусто)

использование

01
02
03
04
05
06
07
08
09
10
11
12
13
<?php
 
$args = array(
    ‘orderby’ => ‘title’,
    ‘order’ => ‘ASC’,
    ‘limit’ => 15,
    ‘hide_invisible’ => false,
    ‘exclude’ => ‘12,16,23’
);
 
$bookmarks_array = get_bookmarks( $args );
 
?>

Получение данных закладки: get_bookmark()

Этот тег шаблона возвращает все данные данной закладки.

параметры

Этот шаблон тега принимает три параметра:

  • $bookmark (обязательно — смешанный) :
    Идентификатор закладки или объект.
    (По умолчанию: NULL )
  • $output (необязательно — строка) :
    Либо OBJECT, ARRAY_N, либо ARRAY_A константа.
    (По умолчанию: OBJECT )
  • $filter (необязательно — строка) :
    Независимо от того, чтобы избежать выхода или нет. Если вы хотите отфильтровать вывод, установите для него значение «Отображать».
    По умолчанию: «raw»

использование

1
2
3
4
5
6
<?php
 
// Getting a specific bookmark’s fields with escaping the output.
$bookmark_data( 19, OBJECT, ‘display’ );
 
?>

Получение данных поля с одной get_bookmark_field() : get_bookmark_field()

Этот тег шаблона позволяет вам извлекать данные из поля одной закладки.

параметры

Этот шаблон тега принимает три параметра:

  • $field (обязательно для заполнения) :
    Название поля.
    (По умолчанию: NULL )
  • $bookmark (обязательно — целое число) :
    Идентификатор закладки.
    (По умолчанию: NULL )
  • $context (необязательно — строка) :
    Как отфильтровать значение поля — «raw», «edit», «attribute», «js», «db» или «display».
    (По умолчанию: «дисплей»)

использование

1
2
3
4
5
6
<?php
 
// Get the bookmark with the id 16 and escape & echo its title.
echo get_bookmark_field( ‘title’, 16, ‘display’ );
 
?>

Получение и отображение ссылки «Редактировать закладку»: get_edit_bookmark_link() & edit_bookmark_link()

Эти теги шаблонов позволяют получить или повторить ссылку «Изменить эту закладку» для использования в ваших шаблонах.

параметры

get_edit_bookmark_link() принимает только один параметр:

  • $bookmark_id (обязательно — целое число) :
    Идентификатор закладки.
    (По умолчанию: 0)

И edit_bookmark_link() принимает четыре параметра:

  • $text (необязательно — строка) :
    Текст для отображения ссылки.
    (По умолчанию: «Редактировать это»)
  • $before (необязательно — строка) :
    Текст или HTML-код для отображения перед выводом.
    (По умолчанию: пусто)
  • $after (необязательно — строка) :
    Текст или HTML-код для отображения после вывода.
    (По умолчанию: пусто)
  • $bookmark_id (обязательно — целое число) :
    Идентификатор закладки.
    (По умолчанию: NULL )

использование

01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
<?php
 
// Retrieve the current bookmark’s «edit bookmark» link.
$edit_bookmark_link = get_edit_bookmark_link();
 
// Retrieve a specific bookmark’s «edit bookmark» link.
$edit_bookmark_link = get_edit_bookmark_link( 98 );
 
// Display the current bookmark’s «edit bookmark» link.
edit_bookmark_link( __( ‘Edit’, ‘translation-domain’ ), ‘<strong>’, ‘</strong>’ );
 
// Display a specific bookmark’s «edit bookmark» link.
edit_bookmark_link( __( ‘Edit’, ‘translation-domain’ ), », », 98 );
 
?>

Получение и отображение информации о вашем сайте: get_bloginfo() & bloginfo()

Эти чрезвычайно популярные теги шаблонов возвращают и отображают общую информацию о вашем сайте.

параметры

get_ bloginfo() принимает два параметра:

  • $show (необязательно — строка) :
    Немного информации, чтобы получить. Одно из следующих значений:
    • 'url' (строка): домашний URL.
    • 'wpurl' (строка): URL, на котором установлен WordPress.
    • 'description' (строка): описание сайта.
    • 'rdf_url' (строка): URL фида RDF / RSS 1.0.
    • 'rss_url' (строка): URL канала RSS 0.92.
    • 'rss2_url' (строка): URL канала RSS 2.0.
    • 'atom_url' (строка): URL фида Atom.
    • 'comments_rss2_url' (строка): URL канала RSS 2.0 для комментариев.
    • 'comments_atom_url' (строка): URL фида Atom для комментариев.
    • 'pingback_url' (строка): URL-адрес файла pingback XML-RPC.
    • 'stylesheet_url' (string): URL-адрес основного CSS-файла темы.
    • 'stylesheet_directory' (строка): URL-адрес главного каталога CSS-файла темы.
    • 'template_directory' или 'template_url' (строка): URL-адрес каталога активной темы.
    • 'admin_email' (строка): адрес электронной почты, введенный при установке WordPress.
    • 'charset' (строка): набор символов сайта.
    • 'html_type' (строка): тип содержимого страниц HTML WordPress.
    • 'version' (строка): версия WordPress.
    • 'language' (строка): язык установки WordPress.
    • 'text_direction' (строка): направление текста языка.
    • 'name' (строка): имя сайта.

    (По умолчанию: «имя»)

  • $filter (необязательно — строка) :
    Установите для него значение 'filter' чтобы отфильтровать URL-адрес, возвращаемый тегом шаблона.
    По умолчанию: «raw»

И bloginfo() принимает только один параметр:

  • $show (необязательно — строка) :
    Те же детали, что и выше.
    По умолчанию: «blogname»

использование

01
02
03
04
05
06
07
08
09
10
11
12
<?php
 
// Display the name of the site.
bloginfo();
 
// Get the stylesheet url.
$stylesheet = get_bloginfo( ‘stylesheet_url’ );
 
// Display the WordPress version.
bloginfo( ‘version’ );
 
?>

Получение и отображение автоматических <body> классов: get_body_class() & body_class()

Эти очень популярные теги шаблонов генерируют семантические классы и позволяют нам их отображать или возвращать. Они также позволяют нам добавлять дополнительные имена классов.

параметры

Оба тега шаблона принимают только один параметр:

  • $class (необязательно — строка или массив) :
    Дополнительные имена классов CSS для добавления.
    (По умолчанию: пусто)

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Display the body class.
body_class();
 
// Retrieve the body class with an extra class.
$body_class = get_body_class( ‘mytheme-body’ );
 
?>

Получение и отображение меню навигации: wp_nav_menu()

Этот шаблонный тег возвращает или отображает навигационные меню, ключевую функцию WordPress. Вы можете увидеть этот тег шаблона во всех новых темах WordPress, выпущенных в 2013 году или позже.

параметры

Этот шаблонный тег принимает только один параметр:

  • $args (необязательно — массив) :
    Массив следующих аргументов:
    • 'menu' (строка): идентификатор, слаг или название меню.
      (По умолчанию: пусто)
    • 'menu_class' (string): CSS-класс элемента UL меню.
      (По умолчанию: «меню»)
    • 'menu_id' (строка): идентификатор элемента UL меню.
      (По умолчанию: фрагмент меню, увеличен)
    • 'container' (string): следует ли обернуть UL и чем обернуть его.
      (По умолчанию: DIV )
    • 'container_class' (string): CSS-класс элемента-оболочки.
      По умолчанию: ‘menu- {menu slug} -container’)
    • 'container_id' (строка): идентификатор элемента оболочки.
      (По умолчанию: пусто)
    • 'fallback_cb' (callback или boolean): имя резервной функции, запускаемой, если меню не существует. Установите в false, чтобы не было запасного варианта.
      По умолчанию: 'wp_page_menu'
    • 'before' (строка): текст перед текстом ссылки.
      (По умолчанию: пусто)
    • 'after' (строка): текст после текста ссылки.
      (По умолчанию: пусто)
    • 'link_before' (строка): текст перед ссылкой.
      (По умолчанию: пусто)
    • 'link_after' (строка): текст после ссылки.
      (По умолчанию: пусто)
    • 'echo' (логическое значение): выводить тег шаблона или нет.
      (По умолчанию: TRUE )
    • 'depth' (целое число): сколько уровней иерархии должно быть включено.
      (По умолчанию: 0, что означает все уровни)
    • 'walker' (объект): экземпляр пользовательского класса ходунков.
      (По умолчанию: пусто)
    • 'theme_location' (строка): расположение темы, которая будет использоваться. Должен быть зарегистрирован в register_nav_menu (), чтобы пользователь мог выбирать его.
      (По умолчанию: пусто)
    • 'items_wrap' (строка): как элементы списка должны быть обернуты.
      (По умолчанию: <ul id="%1$s" class="%2$s">%3$s</ul> )

использование

01
02
03
04
05
06
07
08
09
10
11
<?php
 
$args = array(
    ‘container_id’ => ‘primary-nav’,
    ‘link_before’ => ‘<i class=»icon-link»></i>’,
    ‘theme_location’ => ‘primary’
);
 
wp_nav_menu( $args );
 
?>

Получение и отображение заголовков страниц: wp_title()

Этот тег шаблона возвращает или повторяет заголовок страницы ваших страниц.

параметры

Этот шаблон тега принимает три параметра:

  • $sep (необязательно — строка) :
    Текст, который будет использоваться в качестве разделителя.
    По умолчанию: «& raquo;»
  • $echo (необязательно — логическое) :
    Выводить ли ( TRUE ) или возвращать ( FALSE ) тег.
    (По умолчанию: TRUE )
  • $seplocation (необязательно — строка) :
    Положение сепаратора и направление крошки. Установите его «вправо», чтобы перевернуть крошку.
    (По умолчанию: пусто)

использование

1
2
3
4
5
6
7
8
<?php
 
wp_title( ‘ — ‘, true );
 
// Reverse the separator location to use left-hand indicators.
$page_title = wp_title( ‘ &laquo ‘, false, ‘right’ );
 
?>

Получение и отображение домашнего URL: get_home_url() & home_url()

Эти теги шаблона просто возвращают домашний URL.

параметры

get_home_url() принимает три параметра:

  • $blog_id (необязательно — целое число) :
    Идентификатор блога.
    (По умолчанию: NULL )
  • $path (необязательно — строка) :
    Необязательный путь для добавления к URL.
    (По умолчанию: пусто)
  • $scheme (необязательно — строка) :
    Схема для определения контекста домашней ссылки («http», «https» или «родственник»).
    (По умолчанию: NULL )

И home_url() принимает два параметра:

  • $path (необязательно — строка) :
    Необязательный путь для добавления к URL.
    (По умолчанию: пусто)
  • $scheme (необязательно — строка) :
    Схема для определения контекста домашней ссылки («http», «https» или «родственник»).
    (По умолчанию: NULL )

Не путайте эти две функции как «одна возвращает результат, а другая отображает его» — я знаю, что сделал. Разница немного странная: хотя get_home_url() возвращает домашний URL определенного блога, функция home_url() возвращает домашний URL текущего сайта . Помните: ни один из них не повторяет ничего!

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Getting a specific blog’s home url with https.
$home_url_of_petes_blog = get_home_url( 2, », ‘https’ );
 
// Echoes the current home url with a little addition.
echo home_url( ‘?rel=navlink’ );
 
?>

Получение и отображение URL сайта: get_site_url() & site_url()

Эти теги шаблона получают и отображают «URL сайта», адрес, на котором установлен WordPress.

параметры

get_site_url() принимает три параметра:

  • $blog_id (необязательно — целое число) :
    Идентификатор блога.
    (По умолчанию: текущий сайт)
  • $path (необязательно — строка) :
    Необязательный путь для добавления к URL.
    (По умолчанию: пусто)
  • $scheme (необязательно — строка) :
    Схема для определения контекста домашней ссылки («http», «https» или «родственник»).
    (По умолчанию: нормальное или безопасное соединение, в зависимости от is_ssl() )

И site_url() принимает два параметра:

  • $path (необязательно — строка) :
    Необязательный путь для добавления к URL.
    (По умолчанию: пусто)
  • $scheme (необязательно — строка) :
    Схема для определения контекста домашней ссылки («http», «https» или «родственник»).
    (По умолчанию: нормальное или безопасное соединение, в зависимости от is_ssl() )

Как и в случае с home_url() и get_home_url() , не get_home_url() эти две функции, так как «одна возвращает результат, а другая отображает его». В то время как get_site_url() возвращает URL сайта определенного блога, функция site_url() возвращает URL сайта текущего сайта . Помните: ни один из них не повторяет ничего!

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Getting a specific blog’s site url with https.
$site_url_of_janes_blog = get_site_url( 3, », ‘https’ );
 
// Echoes the current site url.
echo site_url();
 
?>

Получение текущего идентификатора сайта: get_current_blog_id()

Этот шаблонный тег просто возвращает идентификатор текущего сайта в мультисайтовой сети.

параметры

Этот шаблон тега не принимает никаких параметров.

использование

1
2
3
4
5
<?php
 
get_current_blog_id();
 
?>

Получение и отображение URL панели администратора: get_admin_url() & admin_url()

Эти теги шаблона возвращают и отображают URL панели инструментов вашего сайта.

параметры

get_admin_url() принимает три параметра:

  • $blog_ID (необязательно — целое число) :
    Идентификатор блога.
    (По умолчанию: текущий сайт)
  • $path (необязательно — строка) :
    Необязательный путь для добавления к URL.
    (По умолчанию: пусто)
  • $scheme (необязательно — строка) :
    Схема для использования. is_ssl() уважает определенную схему (с помощью функции is_ssl() ), но вы можете переопределить ее, установив этот параметр. Принимает ‘http’, ‘https’, ‘admin’, ‘rpc’, ‘login’ и ‘login_post’.
    По умолчанию: «admin»

И admin_url() принимает два параметра:

  • $path (необязательно — строка) :
    Необязательный путь для добавления к URL.
    (По умолчанию: пусто)
  • $scheme (необязательно — строка) :
    Схема для использования. «admin» уважает определенную схему (с помощью функции is_ssl() ), но вы можете переопределить ее, установив для этого параметра значение «http» или «https».
    По умолчанию: «admin»

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Get the dashboard url of the current blog.
$admin_url = get_admin_url();
 
// Display the admin url and force a secure connection.
admin_url( », ‘https’ );
 
?>

Получение и отображение постоянной ссылки на тип get_feed_link() : get_feed_link() & the_feed_link()

Эти теги шаблона возвращают и выводят постоянную ссылку на канал.

параметры

get_feed_link() принимает только один параметр:

  • $feed_type (необязательно — строка) :
    Тип корма.
    (По умолчанию: тип фида по умолчанию)

И the_feed_link() принимает два параметра:

  • $anchor (обязательно — строка) :
    Текст для отображения по ссылке.
    (По умолчанию: NULL )
  • $feed_type (необязательно — строка) :
    Тип корма.
    (По умолчанию: тип фида по умолчанию)

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Get default feed type’s link.
get_feed_link();
 
// Display a link for the «atom» feed.
the_feed_link( __( ‘Atom Feed’, ‘translation-domain’ ), ‘atom’ );
 
?>

Завершение строки с или без user_trailingslashit() : user_trailingslashit()

Этот тег шаблона проверяет структуру постоянных ссылок и добавляет завершающий слеш или удаляет существующий конечный слеш в конце данного URL.

параметры

Этот тег шаблона принимает два параметра:

  • $string (обязательно — строка) :
    URL с косой чертой или без нее.
    (По умолчанию: NULL )
  • $type_of_url (устарело — строка) :
    Технически это не рекомендуется, но не используется в функции, поэтому не имеет никакого эффекта.

использование

1
2
3
4
5
<?php
 
$url_to_fix = user_trailingslashit( get_home_url() . ‘some-special-page’ );
 
?>

Получение количества дней с начала недели: calendar_week_mod()

Этот странный шаблонный тег получает количество дней с начала недели. По сути, это « операция по модулю ».

Честно говоря, я не знаю, как использовать это или зачем использовать это. Если вы знаете, почему существует этот шаблон, сделайте комментарий, чтобы сообщить мне и нашим читателям!

параметры

Этот шаблонный тег принимает только один параметр:

  • $number (обязательно — целое число) :
    Дни с начала недели.
    (По умолчанию: 0)

использование

1
2
3
4
5
6
7
8
<?php
 
// Umm…
echo calendar_week_mod( 199 );
 
// Right?
 
?>

Получение и отображение календаря: get_calendar()

Помните те календари, которые мы использовали для размещения на боковых панелях наших блогов? Этот тег шаблона делает именно это: он возвращает или отображает календарь.

параметры

Этот тег шаблона принимает два параметра:

  • $initial (необязательно — логическое) :
    Использовать начальные названия календаря ( TRUE ) или нет ( FALSE ).
    (По умолчанию: TRUE )
  • $echo (необязательно — логическое) :
    Выводить ли ( TRUE ) или возвращать ( FALSE ) вывод.
    (По умолчанию: TRUE )

использование

1
2
3
4
5
6
7
8
9
<?php
 
// Return the calendar.
$my_calendar = get_calendar( true, false );
 
// Display the calendar.
get_calendar();
 
?>

Вывод

Надеюсь, вам понравилась эта последняя партия тегов шаблона. В следующей части, финале серии, мы рассмотрим то, что узнали, и закончим серию.

Если у вас есть какие-либо вопросы, комментарии или исправления, вы можете поделиться с нами своими мыслями в разделе «Комментарии». И если вам понравилась статья, не забудьте поделиться ею с друзьями!

38
Share: