Функции WordPress. Функции вордпресс
Функции WordPress.
|
| ||
| |||
| |
| ||
| | |||
|
|
Легенда: красный текст означает, что перевод описания функции еще не готов. Здесь перечислены не все функции! Добавляться будут по мере перевода.
www.wordpressplugins.ru
Функции Wordpress
Функции
wp_title »
Почитать можно тут.
Пример
<title><?php wp_title( '|', true, 'right' ); ?></title> |
[spoiler]
[spoiler show=»bloginfo» hide=»bloginfo»]
почитать можно тут.
<meta charset="<?php bloginfo( 'charset' ); ?>"> <link rel="pingback" href="<?php bloginfo( 'pingback_url' ); ?>"> |
get_stylesheet_uri »
Возвращает абсолютный путь к файлу style.css в текущей теме. Справка.
<link rel='stylesheet' href='<?php echo get_stylesheet_uri(); ?>' type='text/css' media='all' /> |
wp_head »
Это вроде хук, почитать за него можно
- https://codex.wordpress.org/Plugin_API/Action_Reference/wp_head
- http://truemisha.ru/blog/wordpress/wp_head.html
<head> .... .... .... <?php wp_head(); ?> </head> |
body_class »
Добавляет к <body> класс
- http://wp-kama.ru/function/body_class
- https://codex.wordpress.org/Function_Reference/body_class
<body <?php body_class(); ?>> |
esc_url »
- http://wp-kama.ru/function/esc_url
- https://codex.wordpress.org/Function_Reference/esc_url
Удаляет опасные символы в урлах заменяя их на html сущности.
<a href="<?php echo esc_url( home_url( '/' ) ); ?>" rel="home"><?php bloginfo( 'name' ); ?></a> |
home_url »
- http://wp-kama.ru/function/home_url
- https://codex.wordpress.org/Function_Reference/home_url
Возвращает УРЛ главной страницы сайта. Учитывает протокол SSL.
<a href="<?php echo esc_url( home_url( '/' ) ); ?>" rel="home"><?php bloginfo( 'name' ); ?></a> |
get_search_form »
- http://wp-kama.ru/function/get_search_form
- https://codex.wordpress.org/Function_Reference/get_search_form
Подключает форму поиска, файл темы searchform.php. Если такого файла в шаблоне темы нет, то будет использован дефолтный код для формы поиска.
<div> <?php get_search_form(); </div> |
wp_nav_menu »
- http://wp-kama.ru/function/wp_nav_menu#kcmenu
- https://codex.wordpress.org/Function_Reference/wp_nav_menu
Выводит навигационное меню, созданное в панели: «внешний вид > меню» (Appearance > Menus).
<!-- Меню --> <nav role="navigation"> <?php wp_nav_menu( array( 'theme_location' => 'primary', 'menu_class' => 'nav-menu' ) ); ?> </nav> |
have_posts »
- http://wp-kama.ru/function/have_posts
- https://codex.wordpress.org/Function_Reference/have_posts
Условный тег. Проверяет есть ли у текущего запроса WP результаты для вывода, т.е. есть ли в наличии посты, которые можно вывести для текущей страницы.
<!-- Начало цикла WordPress --> <?php if ( have_posts() ) : ?> <?php while ( have_posts() ) : the_post(); ?> |
the_post »
- http://wp-kama.ru/function/the_post
- https://codex.wordpress.org/Function_Reference/the_post
Устанавливает индексы поста в Цикле WP. Получает следующий пост, переопределяет глобальную переменную $post и устанавливает свойство ‘in the loop‘ в true.
<!-- Начало цикла WordPress --> <?php if ( have_posts() ) : ?> <?php while ( have_posts() ) : the_post(); |
the_ID »
- http://wp-kama.ru/function/the_id
- codex
Выводит ID текущего поста. Используется внутри Цикла WordPress.
<article <?php post_class(); ?>> |
post_class »
- http://wp-kama.ru/function/post_class
- https://codex.wordpress.org/Function_Reference/post_class
Выводит селекторы CSS (классы) всячески характеризующее пост/запись. Используется для упрощения верстки шаблона.
post_class() — тег шаблона, который призван упростить работу разработчиков тем для WordPress. Функция используется внутри HTML тега и снабжает его CSS классами описывающими пост, на котором в данный момент находится посетитель. Например,class=»post post-4564 category-48″
<article <?php post_class(); ?>> |
is_sticky »
- http://wp-kama.ru/function/is_sticky
- codex
Условный тег. Проверяет прилеплен ли текущий пост к главной странице сайта.
В функции нет хуков.
Возвращает
false или true
<?php if ( is_sticky() && is_home() && ! is_paged() ) : ?> |
is_home »
- http://wp-kama.ru/function/is_home
- https://codex.wordpress.org/Function_Reference/is_home
Условный тег, проверяет показывается ли страница с последними постами, обычно это главная страница сайта.
Этот тег очень похож на is_front_page().
Работа этого тега зависит от настроек параметра Параметры > Чтение > На главной странице отображать (Settings > Reading > Front page displays). По умолчанию, на главной странице выводятся последние записи сайта. По умолчанию, этот тег будет работать для главной страницы сайта, но если изменить настройки и указать для главной странице сайта статическую страницу, а для последних постов указать другую статическую страницу, то этот тег будет работать для страницы где выводятся последние посты и перестанет работать для главной страницы сайта.
На страницах пагинации этот тег будет также срабатывать: /page/2.
? 1 раз = 0.00005 сек. (очень быстро) / 50000 раз = 0.02 сек. (скорость света)
В функции нет хуков.
Возвращает
true или false.
<?php if ( is_sticky() && is_home() && ! is_paged() ) : ?> |
is_paged »
- http://wp-kama.ru/function/is_paged
- https://codex.wordpress.org/Function_Reference/is_paged
Проверяет отображается ли страница пагинации (страница типа /page/2, /page/3).
этот условный тег относится только к страницам типа архивов, главной страницы, дат, т.е. к тем страницам которые делятся на несколько. Но не относится постам и постоянным страницам разделенным на несколько страниц, тегом nextpage.
<?php if ( is_sticky() && is_home() && ! is_paged() ) : ?> |
_e »
- codex
Выводит возвращенный перевод текста из translate().
<div> <?php _e( 'Избранная запись' ); ?> </div> |
is_single »
- http://wp-kama.ru/function/is_single
- codex
Условные тег, проверяет отображается ли страница записи любого типа записей кроме attachment и page.
В первом параметре $post можно сузить проверку до конкретного поста.
<!-- Если это запись --> <?php if ( is_single() || is_sticky() ) : ?> |
Функции тем в WordPress
Шаблоны вордпресс могут включать специальный файл, functions.php, который дает много контроля и власти над вещами, которые происходят в шаблоне. Подумайте об этом, как о файле который может делать все, что могут делать плагины, но без плагинов! И во всей красе прелесть этого файла раскрывается в темах, которые должны быть укомплектованы определенными плагинами изначально.
Функции для специфических шаблонов
Т.к. вы можете выполнять похожие вещи как плагинами, так и встроенными функциями, то есть рациональное зерно в том, чтобы обходиться без плагинов.
Функции, содержащиеся в functions.php распространяются только на тот шаблон, к которому этот файл относится, и код зависит от темы, в которой используется. С другой стороны, плагины сохраняют свой функционал независимо от того, какая тема активирована. Т. о. не запихивайте в functions.php то, что может понадобиться и с другими шаблонами. И обратно — не используйте плагин там, где нужно что-то сделать в конкретной текущей теме.
Например:
| Отключить уведомление о обновлениях Вордпресс | Используй плагин |
| Добавить кнопку в редактор записей | Используй плагин |
| Загрузить jQuery с сервера google | Используй functions.php |
| Заменить аватары комментаторов по умолчанию | Используй functions.php |
В первых двух примерах желаемый результат связан с админкой сайта и ничего не делает непосредственно с шаблоном. Вам стоит использовать плагин, т.к. это не будет зависеть от шаблона и не перестанет работать, если его поменять (и, соответственно, изменится functions.php).
В последних двух примерах результат определяется конкретной темой и это должно происходить в соответствующем файле этой темы.
Преимущество над правкой ключевых файлов ядра
В дремучие времена, когда еще не было functions.php, правка и настройка функционала вордпресс часто была связана с изменением ключевых файлов движка, что приводило к куче проблем. Во-первых и в основных, вы ломали существующий порядок вещей и вернуться назад уже нельзя было, тем более делать частичный откат. Также важно понимать, что обновление вордпресса подразумевает обновление ключевых файлов ядра, их перезапись поверх старых. И вы могли потерять все изменения, если, конечно, не задокументировали подробно: что, где, как и когда вы меняли. И даже тогда вы получали кучу проблем с применением сделанных правок в новых версиях файлов, где уже мог быть совершенно другой код.
Худшая часть этой безумной практики в том, что после нескольких обновлений вы просто забрасывали эти бесконечные правки или же переставали обновляться. Что плохо во всех отношениях по отношению к потенциальным угрозам и неполучению последних и крутых фишек в новых версиях вордпресса.
К счастью, теперь практически никто не занимается правкой ключевых файлов, потому что есть множество альтернативных способов, чтобы добавлять новый функционал без ковыряния.
Но нужно понимать, что вордпресс не всемогущий и кое-какие правки в ядре все же придется сделать, о чем будет позже рассказано несколькими полезными советами.
iwsm.ru
Функции Wordpress
Функции
wp_title »
Почитать можно тут.
Пример
<title><?php wp_title( '|', true, 'right' ); ?></title> |
[spoiler]
[spoiler show=»bloginfo» hide=»bloginfo»]
почитать можно тут.
<meta charset="<?php bloginfo( 'charset' ); ?>"> <link rel="pingback" href="<?php bloginfo( 'pingback_url' ); ?>"> |
get_stylesheet_uri »
Возвращает абсолютный путь к файлу style.css в текущей теме. Справка.
<link rel='stylesheet' href='<?php echo get_stylesheet_uri(); ?>' type='text/css' media='all' /> |
wp_head »
Это вроде хук, почитать за него можно
- https://codex.wordpress.org/Plugin_API/Action_Reference/wp_head
- http://truemisha.ru/blog/wordpress/wp_head.html
<head> .... .... .... <?php wp_head(); ?> </head> |
body_class »
Добавляет к <body> класс
- http://wp-kama.ru/function/body_class
- https://codex.wordpress.org/Function_Reference/body_class
<body <?php body_class(); ?>> |
esc_url »
- http://wp-kama.ru/function/esc_url
- https://codex.wordpress.org/Function_Reference/esc_url
Удаляет опасные символы в урлах заменяя их на html сущности.
<a href="<?php echo esc_url( home_url( '/' ) ); ?>" rel="home"><?php bloginfo( 'name' ); ?></a> |
home_url »
- http://wp-kama.ru/function/home_url
- https://codex.wordpress.org/Function_Reference/home_url
Возвращает УРЛ главной страницы сайта. Учитывает протокол SSL.
<a href="<?php echo esc_url( home_url( '/' ) ); ?>" rel="home"><?php bloginfo( 'name' ); ?></a> |
get_search_form »
- http://wp-kama.ru/function/get_search_form
- https://codex.wordpress.org/Function_Reference/get_search_form
Подключает форму поиска, файл темы searchform.php. Если такого файла в шаблоне темы нет, то будет использован дефолтный код для формы поиска.
<div> <?php get_search_form(); </div> |
wp_nav_menu »
- http://wp-kama.ru/function/wp_nav_menu#kcmenu
- https://codex.wordpress.org/Function_Reference/wp_nav_menu
Выводит навигационное меню, созданное в панели: «внешний вид > меню» (Appearance > Menus).
<!-- Меню --> <nav role="navigation"> <?php wp_nav_menu( array( 'theme_location' => 'primary', 'menu_class' => 'nav-menu' ) ); ?> </nav> |
have_posts »
- http://wp-kama.ru/function/have_posts
- https://codex.wordpress.org/Function_Reference/have_posts
Условный тег. Проверяет есть ли у текущего запроса WP результаты для вывода, т.е. есть ли в наличии посты, которые можно вывести для текущей страницы.
<!-- Начало цикла WordPress --> <?php if ( have_posts() ) : ?> <?php while ( have_posts() ) : the_post(); ?> |
the_post »
- http://wp-kama.ru/function/the_post
- https://codex.wordpress.org/Function_Reference/the_post
Устанавливает индексы поста в Цикле WP. Получает следующий пост, переопределяет глобальную переменную $post и устанавливает свойство ‘in the loop‘ в true.
<!-- Начало цикла WordPress --> <?php if ( have_posts() ) : ?> <?php while ( have_posts() ) : the_post(); |
the_ID »
- http://wp-kama.ru/function/the_id
- codex
Выводит ID текущего поста. Используется внутри Цикла WordPress.
<article <?php post_class(); ?>> |
post_class »
- http://wp-kama.ru/function/post_class
- https://codex.wordpress.org/Function_Reference/post_class
Выводит селекторы CSS (классы) всячески характеризующее пост/запись. Используется для упрощения верстки шаблона.
post_class() — тег шаблона, который призван упростить работу разработчиков тем для WordPress. Функция используется внутри HTML тега и снабжает его CSS классами описывающими пост, на котором в данный момент находится посетитель. Например,class=»post post-4564 category-48″
<article <?php post_class(); ?>> |
is_sticky »
- http://wp-kama.ru/function/is_sticky
- codex
Условный тег. Проверяет прилеплен ли текущий пост к главной странице сайта.
В функции нет хуков.
Возвращает
false или true
<?php if ( is_sticky() && is_home() && ! is_paged() ) : ?> |
is_home »
- http://wp-kama.ru/function/is_home
- https://codex.wordpress.org/Function_Reference/is_home
Условный тег, проверяет показывается ли страница с последними постами, обычно это главная страница сайта.
Этот тег очень похож на is_front_page().
Работа этого тега зависит от настроек параметра Параметры > Чтение > На главной странице отображать (Settings > Reading > Front page displays). По умолчанию, на главной странице выводятся последние записи сайта. По умолчанию, этот тег будет работать для главной страницы сайта, но если изменить настройки и указать для главной странице сайта статическую страницу, а для последних постов указать другую статическую страницу, то этот тег будет работать для страницы где выводятся последние посты и перестанет работать для главной страницы сайта.
На страницах пагинации этот тег будет также срабатывать: /page/2.
? 1 раз = 0.00005 сек. (очень быстро) / 50000 раз = 0.02 сек. (скорость света)
В функции нет хуков.
Возвращает
true или false.
<?php if ( is_sticky() && is_home() && ! is_paged() ) : ?> |
is_paged »
- http://wp-kama.ru/function/is_paged
- https://codex.wordpress.org/Function_Reference/is_paged
Проверяет отображается ли страница пагинации (страница типа /page/2, /page/3).
этот условный тег относится только к страницам типа архивов, главной страницы, дат, т.е. к тем страницам которые делятся на несколько. Но не относится постам и постоянным страницам разделенным на несколько страниц, тегом nextpage.
<?php if ( is_sticky() && is_home() && ! is_paged() ) : ?> |
_e »
- codex
Выводит возвращенный перевод текста из translate().
<div> <?php _e( 'Избранная запись' ); ?> </div> |
is_single »
- http://wp-kama.ru/function/is_single
- codex
Условные тег, проверяет отображается ли страница записи любого типа записей кроме attachment и page.
В первом параметре $post можно сузить проверку до конкретного поста.
<!-- Если это запись --> <?php if ( is_single() || is_sticky() ) : ?> |
kselax.ru
