WPtuts.ru Уроки WordPress Произвольные поля в WordPress

Уроки WordPress

5,0K просмотров

9 минут чтения

One comment

Произвольные поля в WordPress

Николай Дмитриев

06.07.2020

В этой статье:

1. Что такое произвольные поля в WordPress
2. Как добавить произвольное поле в WordPress
3. Как вывести произвольные поля в WordPress
4. Не удается найти произвольное поле в выпадающем списке при редактировании записи
5. Создание интерфейса для произвольных полей
6. Использование плагина Advanced Custom Fields для добавления произвольных полей
7. Полезные советы по произвольным полям

Произвольные поля – это полезная функция WordPress, которая позволяет добавлять различные дополнительные данные/информацию в записи и страницы на сайте WordPress.

Многие популярные плагины и темы WordPress используют собственные произвольные поля для хранения важных данных. Вы также можете использовать произвольные поля для хранения собственных данных, а затем выводить их на своем сайте.

В этой статье мы покажем вам, как использовать произвольные поля в WordPress, расскажем несколько советов, хитростей и приемов.

Что такое произвольные поля в WordPress

Произвольные поля WordPress (Custom Fields) – это метаданные, которые используются для добавления дополнительной информации, относящихся к редактируемой записи или странице.

По умолчанию, когда вы пишите новый пост в блоге, добавляете страницу или любой другой тип контента, WordPress сохраняет информацию в двух разных областях.

Первая часть – это текст вашего контента, который вы добавляете с помощью редактора записей/страниц.

Вторая часть – это информация об этом конкретном контенте. Например, название, автор, дата, время и многое другое. Эта информация о посте называется метаданными.

WordPress автоматически добавляет все необходимые метаданные к каждой создаваемой вами статье или странице.

Создавать и хранить свои собственные метаданные вы можете с помощью произвольных полей.

По умолчанию возможность настройки произвольных полей скрыта на экране редактирования. Чтобы увидеть эту настройку, вам нужно нажать в правом верхнем углу на три точки и выбрать “Настройки”.

Произвольные поля в WordPress - png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABAQMAAAAl21bKAAAAA1BMVEUAAP+KeNJXAAAAAXRSTlMAQObYZgAAAAlwSFlzAAAOxAAADsQBlSsOGwAAAApJREFUCNdjYAAAAAIAAeIhvDMAAAAASUVORK5CYII=

Во всплывающем окне включите опцию “Произвольные поля” в разделе “Расширенные панели”. После этого нажмите “Включить и перезагрузить”, чтобы перезагрузить редактор. Перед включением заранее сохраните изменения в редакторе.

Редактор перезагрузится и вы увидите панель произвольных полей внизу страницы, под редактором контента.

Произвольные поля могут использоваться для добавления любой информации, связанной с вашей записью, страницей или любым другим типом контента.

Эта метаинформация может отображаться в вашей теме. Однако для этого вам потребуется отредактировать файлы темы WordPress.

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

Зная, что такое произвольные поля в WordPress мы может приступить к их добавлению и использованию.

Как добавить произвольное поле в WordPress

Первое, что нужно сделать – это перейти в редактор записи или страницы, где вы хотите добавить произвольное поле и перейти к добавлению нового поля.

Укажите имя произвольного поля, а также его значение.

Имя произвольного поля должно быть написано латинскими буквами. Значение может содержать любые символы. Старайтесь сделать так, чтобы имя произвольного поля было осмысленным и его могли понять другие разработчики. Поэтому старайтесь писать на английском.

В примере мы ввели имя “Mood” (Настроение) и значение “Отличное”.

Далее вам нужно указать имя для вашего настраиваемого поля и затем ввести его значение. Нажмите кнопку “Добавить произвольное поле”, чтобы сохранить его.

После сохранения вы увидите добавленное произвольное поле. Оно выглядит таким образом:

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

Не забудьте сохранить свою запись или страницу, чтобы применить изменения.

Как вывести произвольные поля в WordPress

Чтобы вывести произвольное поле на сайте WordPress, вам потребуется отредактировать файлы темы.

Найдите файл темы, который нужно отредактировать для отображения вашего произвольного поля. Например, если вы хотите вывести произвольное поле на странице записи, вам нужно отредактировать файл single.php или content-single.php. Эти файлы находятся в папке wp-content/themes/ваша-тема.

Код в файлах может отличаться в зависимости от тему, которая установлена на вашем сайте. Если вы делаете это впервые, то заранее сделайте резервную копию файлов шаблона.

Вам потребуется добавить код для вывода произвольного поля внутри цикла WordPress. Найдите строку, которая выглядит вот так:

<?php while ( have_posts() ) : the_post(); ?>

Также найдите следующую строку, в этом месте кончается цикл:

<?php endwhile; // end of the loop.?>

Теперь добавьте этот код в файл вашей темы:

<?php echo get_post_meta($post->ID, 'key', true); ?>

Не забудьте заменить ‘key’ на имя вашего произвольного поля. К примеру так мы вывели произвольное поле в нашей тестовой теме:

<p>Наше настроение: <?php echo get_post_meta($post->ID, 'Mood', true); ?></p>

Теперь вы можете сохранить изменения в файле и открыть запись, в которую вы уже добавили произвольное поле, чтобы увидеть код в действии.

Теперь вы можете использовать это произвольное поле во всех ваших записях.

Создайте новую запись или отредактируйте существующие. Перейдите в мета-поле произвольных полей, выберите нужное поле в раскрывающемся списке и введите значение.

Нажмите кнопку “Добавить произвольное поле”, чтобы сохранить изменения, а затем опубликуйте или обновите запись.

Не удается найти произвольное поле в выпадающем списке при редактировании записи

По умолчанию WordPress загружает только 30 произвольных полей в выпадающий список.

Многие темы и плагины WordPress добавляют свои произвольные поля и есть вероятность, что именно они появятся первыми в выпадающем списке. Из-за этого вы не сможете найти только что созданное произвольное поле.

Чтобы решить эту проблему, добавьте следующий файл в functions.php вашей темы:

<?php
	add_filter('postmeta_form_limit', 'meta_limit_increase' );
	function meta_limit_increase( $limit ) {
    return 50;
}
?>

В файл functions.php не нужно <?php и ?>, так как они уже есть в файле.

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

Создание интерфейса для произвольных полей

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

Если у вас есть много произвольных полей или несколько авторов пишут на вашем сайте, то это не лучший вариант.

Разве не круто, когда у вас есть свой пользовательский интерфейс, в котором авторы могли бы просто заполнять форму, вводя нужные значения в ваши произвольные поля?

Это делают многие популярные плагины. Например Yoast SEO, с помощью которого мы заполняем мета-теги добавляет пользовательский интерфейс для этого:

Самый простой способ добавить пользовательский интерфейс для произвольных полей – это использовать плагин Advanced Custom Fields (ACF).

Advanced Custom Fields (ACF)

Расширенные настраиваемые поля (ACF) помогают легко настраивать WordPress с помощью мощных, профессиональных и интуитивно понятных полей. С гордостью обслуживая более 2 миллионов человек, мы …

WP Engine

Использование плагина Advanced Custom Fields для добавления произвольных полей

Первое, что потребуется сделать – установить и активировать плагин Advanced Custom Fields. Также прочтите нашу подробную инструкцию, как устанавливать плагины в WordPress.

После активации плагина нужно перейти на страницу “Группы полей” и нажать кнопку “Добавить”.

Группа полей – это контейнер с набором настраиваемых произвольных полей. Это позволяет добавлять несколько произвольных полей и группировать их.

Теперь вам нужно добавить название группы и нажать кнопку “Добавить поле”.

Теперь укажите ярлык поля (название), выберите тип поля и напишите инструкцию. Ярлык поля и инструкция будут выводиться на странице редактирования записи, чтобы пояснить авторам, что нужно вписать в поле.

Имя поля автоматически транслитерируется в латинские буквы, но вы также можете заполнить поле самостоятельно, переведя ярлык поля на английский язык.

С помощью плагина ACF вы можете задать разный тип поля, включая текст, загрузку изображений, числа, выпадающие списки, чекбоксы и многое другое.

Прокручивая страницу ниже, вы можете видеть дополнительные настройки создаваемого произвольного поля. Вы можете изменять их в соотвествии своим требованиям.

Вы можете добавить несколько полей в свою группу полей, если это требуется. Когда вы закончите, нажмите на кнопку “Опубликовать”, чтобы сохранить изменения.

Теперь зайдем в редактирование уже созданной записи или создадим новую. В конце страницы вы увидите созданную нами группу произвольных полей, которую нужно заполнить.

Полезные советы по произвольным полям

Мы собрали для вас полезные советы с примерами кода, которые помогут вам понять работу произвольных полей. Эти рекомендации помогут вам облегчить работу с сайтом WordPress.

Как скрыть пустое произвольное поле в WordPress

Мы рассмотрели, как создать произвольное поле и вывести его на сайте.

Когда мы внесли правки в теме в шаблоне записи, мы автоматически добавили вывод текста перед произвольным полем. Но что, если произвольное поле у страницы не заполнено? У нас будет выводится “Наше настроение”, но никакого значения дальше выводиться не будет.

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

<?php
$mood = get_post_meta($post->ID, 'Mood', true);
if ($mood) {
?>
<p>Наше настроение: <? echo $mood; ?></p> <?php 
          }
else { // do nothing; }
?>

Не забудьте заменить “Mood” на имя вашего произвольного поля.

Добавление нескольких значений в произвольное поле

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

Однако код, который мы использовали в примерах выше, может выводить только одно значение.

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

<?php 
$mood = get_post_meta($post->ID, 'Mood', false);
if( count( $mood ) != 0 ) { ?>
<p>Наше настроение:</p>
<ul>
<?php foreach($mood as $mood) {
            echo '<li>'.$mood.'</li>';
            }
            ?>
</ul>
<?php 
} else { 
// do nothing; 
}
?>

Не забудьте заменить “Mood” на название вашего произвольного поля.

В этом примере вы могли заметить, что мы изменили последний параметр функции get_post_meta на false. Этот параметр определяет, должна ли функция возвращать одно значение или нет. Параметр false позволяет возвращать данные в виде массива, которые мы затем отображаем с помощью foreach цикла.

Вывод записей с определенным произвольным полем

WordPress позволяем нам выводить сообщения, в которых используется определенное произвольное поле с нужным значением.

Например, если мы хотим создать страницу на которой будут выводиться только те записи, в которых произвольное поле Mood имеет значение “Отлично”, то мы можем использовать класс WP_Query. Это позволит нам получить все записи с нужным произвольным полем и значением.

Вы можете использовать следующий код для примера:

$args = array(
    'meta_key'   => 'Mood',
    'meta_value' => 'Отлично'
);
$the_query = new WP_Query( $args );
 
<?php 
// the query
$the_query = new WP_Query( $args ); ?>
 
<?php if ( $the_query->have_posts() ) : ?>
 
    <!-- the loop -->
    <?php while ( $the_query->have_posts() ) : $the_query->the_post(); ?>
        <h2><?php the_title(); ?></h2>
        <?php the_content(); ?>
 
    <?php endwhile; ?>
    <!-- end of the loop -->
 
    <!-- pagination here -->
 
    <?php wp_reset_postdata(); ?>
 
<?php else : ?>
    <p><?php _e( 'К сожалению, записей с отличнм настроением нет.' ); ?></p>
<?php endif; ?>

Не забудьте заменить параметры meta_key и meta_value на свои значения.

Добавить имя автора гостевого поста используя произвольные поля

Вы хотите добавить гостевой пост, но не хотите добавлять нового пользователя, ради одного поста? Более простой способ сделать это – добавить имя автора гостевого поста в качестве произвольного поля.

Во-первых, добавьте следующий код в файл functions.php вашей темы.

<?php
add_filter( 'the_author', 'guest_author_name' );
add_filter( 'get_the_author_display_name', 'guest_author_name' );
function guest_author_name( $name ) {
global $post;
$author = get_post_meta( $post->ID, 'guest-author', true );
if ( $author )
$name = $author;
return $name;
}
?>

Этот код используем функции the_authorи get_the_author_display_name.

Сначала функция проверяет, есть ли гостевой автор. Если он есть, то имя автора заменяется на имя гостевого автора.

Теперь отредактируйте запись, в которой вы хотите вывести имя гостевого автора. Перейдите в редактирование произвольных полей, как мы рассказывали в начале статьи. Добавьте произвольное поле guest-author и введите имя.

Вывод нескольких авторов статьи с помощью произвольных полей

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

Исправить эту ситуацию можно с помощью плагина Co-Authors Plus.

Другой способ сделать это – добавить несколько авторов с помощью произвольного поля.

Откройте в редакторе нужную запись, в которой вы хотите добавить соавторов. Прокрутите вниз страницу до мета-поля произвольных полей и добавьте имена авторов. Название произвольного поля используйте – co-author.

Теперь добавьте этот код в файл вашей темы, где вы хотите вывести соавторов.

<?php 
 
$coauthors = get_post_meta($post->ID, 'co-author', false);
if( count( $coauthors ) != 0 ) { ?>
<ul class="coauthors">
<li>Contributors</li>
<?php foreach($coauthors as $coauthors) { ?>
           <?php echo '<li>'.$coauthors.'</li>' ;
            }
            ?>
</ul>
<?php 
} else { 
// do nothing; 
}
?>

Чтобы выводить имена авторов, разделенные запятыми, можете добавить следующий CSS код в пользовательский CSS вашей темы.

.coauthors ul { 
display:inline;
}
.coauthors li { 
display:inline;
list-style:none;
}
.coauthors li:after { 
content:","
}
.coauthors li:last-child:after {
    content: "";
}
.coauthors li:first-child:after {
    content: ":";
}

Вывод произвольных полей за пределами цикла WordPress

Мы показали вам примеры, когда произвольные поля выводятся внутри цикла WordPress. Но что если вам нужно вывести полей за пределами цикла? Например в боковой панели записи.

Чтобы вывести произвольное поле вне цикла WordPress, используйте следующий код:

<?php
global $wp_query;
$postid = $wp_query->post->ID;
echo get_post_meta($postid, 'key', true);
wp_reset_query();
?>

Не забудьте заменить key на название вашего произвольного поля.

Вывод пользовательского Header, Footer, Sidebar с помощью произвольных полей

Обычно большинство шаблонов WordPress используют одинаковые Header, Footer и Sidebar на всех страницах сайта. Существует несколько способов отображения разных Header, Footer, Sidebar на разных страницах сайта.

Одним из способов сделать это является использование произвольных полей. Зайдите в редактор записи или страницы, где вы хотите показать другую боковую панель, а затем добавьте sidebar в качестве произвольного поля.

Теперь нужно отредактировать файл темы WordPress, например single.php, где вы хотите отобразить пользовательскую боковую панель. Найдите следующий код:

Теперь вам нужно отредактировать файлы темы WordPress, например single.php, где вы хотите отобразить пользовательскую боковую панель. Вы будете искать следующий код:

<?php get_sidebar(); ?>

Замените эту строку следующим кодом:

<?php 
global $wp_query;
$postid = $wp_query->post->ID;
$sidebar = get_post_meta($postid, "sidebar", true);
get_sidebar($sidebar);
wp_reset_query();
?>

Этот код ищет произвольное поле sidebar и после нахождения отображает его в вашей теме. Например, если вы добавите wppost в качестве значения произвольного поля sidebar, код будет искать файл sidebar-wppost.php для вывода.

Вам нужно будет создать файл sidebar-wppost.php в папке вашей темы. Вы можете скопировать код из файла sidebar.php, чтобы этот код стал для вас отправной точкой.

Добавление произвольных полей в RSS-ленту WordPress

Хотите добавить дополнительные данные или контент для читателей вашей RSS-ленты? Используйте произвольные поля, чтобы управлять данными и добавлять контент в вашу ленту.

Добавьте следующий код в ваш файл functions.php:

<?php
function wptuts_postrss($content) {
global $wp_query;
$postid = $wp_query->post->ID;
$coolcustom = get_post_meta($postid, 'coolcustom', true);
if(is_feed()) {
if($coolcustom !== '') {
$content = $content."<br /><br /><div>".$coolcustom."</div>
";
}
else {
$content = $content;
}
}
return $content;
}
add_filter('the_excerpt_rss', 'wptuts_postrss');
add_filter('the_content', 'wptuts_postrss');
?>

Теперь просто создайте настраиваемое поле с именем «coolcustom» и добавьте любое значение, которое вам нравится. Вы можете использовать его для отображения рекламы, изображений, текста или чего угодно.

Управление заголовками в RSS-ленте с помощью произвольных полей

Иногда может потребоваться добавить дополнительный текст к заголовку записи для пользователей RSS-канала. Например, когда вы публикуете рекламный или гостевой пост.

Добавьте следующий код в файл functions.php вашей темы:

<?php
function wptuts_titlerss($content) {
global $wp_query;
$postid = $wp_query->post->ID;
$gpost = get_post_meta($postid, 'guest_post', true);
$spost = get_post_meta($postid, 'sponsored_post', true);
 
if($gpost !== '') {
$content = 'Гостевой пост: '.$content;
}
elseif ($spost !== ''){
$content = 'Спонсорский пост: '.$content;
}
else {
$content = $content;
}
return $content;
}
add_filter('the_title_rss', 'wptuts_titlerss');

Далее отредактируйте запись, в которой вы хотите отобразить дополнительный текст в заголовке в RSS-канале. Добавьте произвольные поля guest-post и sponsored-post.

Если какое-либо из этих двух произвольных полей будет иметь значение “true”, то перед заголовком будет добавлен соответствующий текст. Этот способ может использовать по разному и настроить вывод своего дополнительного текста.

Как установить срок публикации записи в WordPress с помощью произвольных полей

Хотите удалить свою запись после определенного времени? Это удобно, когда вы хотите опубликовать контент на определенное время, например при проведении опроса или публикации контента с ограниченным временем предложения.

Одним из способов это сделать является ручное удаление записи или использование плагина Post Expirator.

Другой способ это сделать – использовать произвольные поля для автоматического удаления по истечению определенного времени.

Вам потребуется отредактировать файлы вашей темы и модифицировать цикл WordPress следующим образом:

<?php
if (have_posts()) :
while (have_posts()) : the_post(); 
$expirationtime = get_post_meta($post->ID, "expiration", false);
if( count( $expirationtime ) != '' ) { 
if (is_array($expirationtime)) {
$expirestring = implode($expirationtime);
}
 
$secondsbetween = strtotime($expirestring)-time();
if ( $secondsbetween >= 0 ) {
echo 'Срок публикации этой записи истек ' .$expirestring.'';
the_content();
} else { 
echo "Извините, эта запись не доступна!"
}
} else { 
the_content();
} 
endwhile;
endif;
?>

Вам нужно будет отредактировать этот код в соответствии с вашей темой.

После добавления этого кода, вы можете добавить произвольное поле “expiration” к вашей записи. В значение впишите дату и время, когда срок публикации записи закончится. Формат даты: месяц/день/год 00:00:00.

Присвоение стиля для определенных записей с помощью произвольных полей

Хотите изменить внешний вид определенной записи. с помощью CSS? WordPress автоматически присваивает к каждой записи свой собственный класс. Этот класс вы можете использовать для добавления пользовательского CSS для определенной записи или страницы.

Однако, используя произвольные поля, вы можете добавить свой собственный пользовательский класс и в будущем использовать его для стилизации других записей и страниц.

Для начала, нам нужно отредактировать пост, который вы хотите оформить. Перейдите в редактирование произвольных полей в записи и добавьте поле post-class, в значение напишите название будущего класса.

Теперь нужно отредактировать файлы темы WordPress и добавить этот код в начале цикла WordPress.

<?php $custom_values = get_post_meta($post->ID, 'post-class'); ?>

Найдите строку с функцией post_class(). Вот так вот может выглядеть эта строка:

<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>

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

Измените эту строку, чтобы включить значение произвольного поля.

<article id="post-<?php the_ID(); ?>" <?php post_class($custom_values); ?>>

Теперь, если вы откроете просмотр кода страницы, вы увидите, что класс, который мы добавляли к записи с помощью произвольного поля добавлен в класс записи.

Теперь вы можете использовать этот CSS класс для оформления этой и других записей, у которых вы также пропишите класс с помощью произвольного поля.

Надеемся, что эта статья помогла вам больше узнать о произвольных полях в WordPress. Мы будем рады, если вы расскажете в комментариях о том, как используете произвольные поля. Возможно вы также поможете новичкам узнать что то новое.

Если вы нашли ошибку, пожалуйста, выделите фрагмент текста и нажмите Ctrl+Enter.

1 комментарий

Андрей:

16.11.2020 в 16:22

Спасибо, полезная статья.
А если произвольное поле нужно вывести в журнал записей в админке?
Чтобы можно было смотреть и сортировать по нему записи.

Ответить