Руководство Tuts + для шаблонов Tags: Eighth Batch

24 января 2018

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

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

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

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

Параметры

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

$ args (optional-array): массив из следующих аргументов: 'orderby ' (string): How заказать закладки. Принимает 'имя ', 'link_id ', 'url ', 'target ', 'description ', 'owner ' (пользователь, добавивший закладку), 'rating ', 'updated ' (даты обновления), rel '(отношение закладки XFN), ' notes ', ' rss ', ' length '(длина имени закладки), 'rand ' (random). (По умолчанию: 'name ') 'order ' (строка): заказывать ли элементы по возрастанию ( ASC ') или нисходящие ( DESC '). (По умолчанию: ASC ') 'limit ' (integer): количество отображаемых элементов. (По умолчанию: -1, что означает все закладки) 'category ' (строка): идентификаторы категорий, разделенные запятой, для получения элементов. (По умолчанию: '', что означает все категории) 'exclude_category ' (строка): Категории закладок 'IDs для исключения. (По умолчанию: ' ') ' category_name '(строка): имя категории для отображения закладок (переопределяет категорию). (По умолчанию: ' ' обновленная временная шкала shoul d (отображается по умолчанию: 0) 'echo ' (integer): следует ли эхо выводить (1) или возвращать его (0). (По умолчанию: 1) 'категоризировать ' (целое число): группировать закладки по их категориям (1) или нет (0). (По умолчанию: 1) 'title_li ' (строка): обертывает вывод с тегом

  • и отображает заголовок перед списком закладок. Вероятно, вы захотите установить это в пустую строку и отключить упаковку. (По умолчанию: 'Закладки ') 'title_before ' (строка): HTML-код для добавления перед каждым заголовком. (По умолчанию: '

    ') 'title_after ' (строка): HTML-код для добавления после каждого заголовка. (По умолчанию: '

    ') 'class ' (string): имена классов CSS для добавления в каждую категорию. (По умолчанию: 'linkcat ') 'category_before ' (строка): HTML-код для добавления перед каждой категорией. (По умолчанию: '
  • ') ' category_after '(строка): HTML-код для добавления после каждой категории. (По умолчанию: '
  • ') ' category_orderby '(строка): Как заказать категории. Принимает 'имя ', 'id ', 'slug ' и count '. (По умолчанию: ' name ') ' category_order '(строка): Нужно ли заказывать категории по возрастанию ( ASC ') или убыванию ( DESC ) порядка. (По умолчанию: ' ASC ')

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

    <?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 (optional-array): массив из следующих аргументов: 'orderby ' (string): How заказывать ссылки. Принимает почтовые поля, такие как 'name ', 'ID ', 'title ', 'date ' и т. Д. (По умолчанию: 'name ') 'order ' (string): заказывать элементы в порядке возрастания ( ASC ') или убывания ( DESC ). (По умолчанию: ASC ') 'limit ' (integer): Количество элементов для отображения. (По умолчанию: -1, что означает все) 'category ' (строка): идентификаторы категорий, разделенные запятой, для получения элементов. (По умолчанию: Пусто) 'category_name ' (string): Название категории для получения элементов. (По умолчанию: Пусто) 'hide_invisible ' (целое или логическое): показывать или скрывать ссылку, помеченную как invisible ". (По умолчанию: 1 | TRUE) 'show_updated ' (integer или boolean): отображать ли время последнего обновления закладки. (По умолчанию: 0 | FALSE) 'include ' (строка): Список идентификаторов, разделенных запятыми. (По умолчанию: Пусто) 'exclude ' (строка): Список идентификаторов, разделенных запятыми, для исключения. (По умолчанию: Пусто)

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

    <?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 (необязательно-строка): следует избегать вывода или нет. Если вы хотите отфильтровать вывод, установите для этого значение display. (По умолчанию: 'raw ')

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

    <?php
    // Getting a specific bookmark's fields with escaping the output.
    $bookmark_data( 19, OBJECT, 'display' );
    ?>

    Получение отдельных полей поля закладки: get_bookmark_field ()

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

    Параметры

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

    $ field (required-string): Имя поля. (По умолчанию: NULL) $ bookmark (required-integer): Идентификатор закладки. (По умолчанию: NULL) $ context (необязательно-строка): как фильтровать значение поля - "raw ", 'edit ', 'attribute ', 'js ', 'db ' или 'display '. (По умолчанию: 'display ')

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

    <?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 (required-integer): идентификатор закладки. (По умолчанию: 0)

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

    $ text (необязательно-строка): текст для отображения ссылки. (По умолчанию: 'Edit This ') $ before (необязательная строка): текст или HTML (по умолчанию: Пусто) $ после (необязательно-строка): текст или HTML-код, который будет отображаться после вывода. (По умолчанию: Пусто) $ bookmark_id (required-integer): идентификатор закладки. (По умолчанию: NULL)

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

    <?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-адрес файла XML-RPC для pingback. 'stylesheet_url ' (строка): URL-адрес основного файла CSS. 'stylesheet_directory ' (строка): URL-адрес основного файла CSS темы 'template_directory ' или 'template_url ' (строка): URL-адрес каталога активной темы. 'admin_email ' (строка): адрес электронной почты адрес, введенный при установке WordPress. 'charset ' (строка): набор символов сайта. 'html_type ' (st ring): страницы содержимого WordPress HTML-содержимого. 'version ' (строка): версия WordPress. 'language ' (строка): язык установки WordPress. 'text_direction ' (строка): направление текста на языке. 'name ' (строка): имя сайта. (по умолчанию: 'name ') $ filter (необязательно-строка): установите фильтр для фильтрации URL-адреса, возвращаемого из этого тега шаблона. (По умолчанию: 'raw ')

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

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

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

    <?php
    // Display the name of the site.
    bloginfo();
    // Get the stylesheet url.
    $stylesheet = get_bloginfo( 'stylesheet_url' );
    // Display the WordPress version.
    bloginfo( 'version' );
    ?>

    Получение и отображение автоматическогоКлассы: get_body_class () & body_class ()

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

    Параметры

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

    $ class (необязательный-string или массив): дополнительные имена классов CSS для добавления. (По умолчанию: Empty)

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

    <?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 (optional-array): массив следующих аргументов: 'menu ' (string): ID, slug или имя меню. (По умолчанию: Пусто) 'menu_class ' (строка): класс CSS элемента UL в меню. (По умолчанию: 'menu ') 'menu_id ' (строка): идентификатор элемента UL в меню. (По умолчанию: пул меню, увеличивается) 'container ' (строка): следует ли обернуть UL и что его обертывать. (По умолчанию: DIV) 'container_class ' (строка): класс CSS элемента оболочки. (По умолчанию: 'menu- {menu slug} -container ') ' container_id '(строка): идентификатор элемента оболочки. (По умолчанию: Empty) ' fallback_cb '(обратный вызов или логическое): имя резервной копии для запуска, если меню не существует. Установите значение false для отсутствия возврата. (По умолчанию: 'wp_page_menu ') 'before ' (string): текст перед текстом ссылки. (По умолчанию: Empty) после '(строка): Текст после текста ссылки. (По умолчанию: Пусто) ' link_before '(строка): Текст перед ссылкой. (По умолчанию: Пусто) 'link_after ' (string): Текст после ссылки. (По умолчанию: Пусто) 'echo ' (boolean): следует ли эхо тег шаблона или нет. (По умолчанию: TRUE) 'depth ' (integer): Сколько уровней иерархии должно быть включено. (По умолчанию: 0, что означает все уровни) 'walker ' (object): Экземпляр пользовательский класс walker. (По умолчанию: Пусто) 'theme_location ' (строка): расположение темы, которое будет использоваться. Должен быть зарегистрирован с помощью register_nav_menu () для того, чтобы его можно было выбрать пользователем. (По умолчанию: Пусто) 'items_wrap ' (строка): как элементы списка должны быть завернуты. (По умолчанию:

      )

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

      <?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 (optional-boolean): использовать ли echo (TRUE) или return (FALSE) тег. (По умолчанию: TRUE) $ seplocation (необязательно-строка): положение разделителя и направление крошка. Установите его в положение «right», чтобы отменить хлеб. (По умолчанию: Пусто)

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

      <?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 (необязательно-строка): Схема, чтобы предоставить домашний контекст URL ( 'http ', 'https ' или 'relative '). (По умолчанию: NULL)

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

      $ path (необязательная строка): дополнительный путь для добавления к URL-адресу. (По умолчанию: Пустая) $ schem (необязательно-строка): Схема, чтобы дать домашний контекст url ( 'http ', 'https ' или 'relative '). (По умолчанию: NULL)

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

      Применение

      <?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 (optional-integer): идентификатор блога. (По умолчанию: текущий сайт) $ path (необязательная строка): Дополнительный путь для добавления к URL-адресу. (По умолчанию: Пусто) $ scheme (необязательно-строка): Схема, чтобы предоставить домашний контекст URL ( 'http ', 'https ' или 'relative '). (По умолчанию: нормальное или защищенное соединение, в зависимости от is_ssl ())

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

      $ path (необязательно-строка): необязательно путь к добавлению к URL-адресу. (По умолчанию: Пусто) $ scheme (необязательно-строка): схема, чтобы дать домашний контекст url ( 'http ', 'https ' или 'relative '). (По умолчанию: нормальное или защищенное соединение, в зависимости от is_ssl ())

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

      Применение

      <?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 ()

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

      Параметры

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

      Применение

      <?php
      get_current_blog_id();
      ?>

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

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

      Параметры

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

      $ blog_ID (необязательно-целое): идентификатор блога. (По умолчанию: текущий сайт) $ path (необязательная строка): Дополнительный путь для добавления к URL-адресу. (По умолчанию: Пусто) $ schem (optional-string): Используемая схема. 'admin соблюдает определенную схему (с функцией is_ssl ()), но вы можете переопределить ее, установив этот параметр. Принимает «http», «https», «admin», «rpc», «login» и «login_post». (По умолчанию: 'admin ')

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

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

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

      <?php
      // Get the dashboard url of the current blog.
      $admin_url = get_admin_url();
      // Display the admin url and force a secure coection.
      admin_url( '', 'https' );
      ?>

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

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

      Параметры

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

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

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

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

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

      <?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 ()

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

      Параметры

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

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

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

      <?php
      $url_to_fix = user_trailingslashit( get_home_url() . 'some-special-page' );
      ?>

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

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

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

      Параметры

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

      $ number (required-integer): Дни с начала недели. (По умолчанию: 0)

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

      <?php
      // Umm...
      echo calendar_week_mod( 199 );
      // Right? (it echoes "3" by the way).
      ?>

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

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

      Параметры

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

      $ initial (optional-boolean): используйте начальные имена календаря (TRUE) или нет (FALSE). (По умолчанию: TRUE) $ echo (optional-boolean): следует ли выводить (TRUE) или возвращать (FALSE) вывод. (По умолчанию: TRUE)

      Применение

      <?php
      // Return the calendar.
      $my_calendar = get_calendar( true, false );
      // Display the calendar.
      get_calendar();
      ?>

      Вывод

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

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