Скупой add review php. Как написать плагин для WordPress. Что такое пользовательские типы записей

Мы также включим функцию редактора записей Custom Fields (пользовательские или произвольные поля) для каждого типа и отобразим поля в новых шаблонах.

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

Но прежде чем мы продолжим, давайте разберёмся с тем, что такое пользовательские записи.

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

Если коротко, то произвольные типы записей WordPress позволяют вам сортировать публикации по их содержимому. В WordPress типы публикаций по умолчанию: Запись, Страница, Медиафайлы и др.

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

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

В примере выше, если пользователь перейдёт в раздел базы данных фильмов (movie) на вашем сайте, публикации с отзывами (review) не будут включены. Если вы, к примеру, сделаете категории ‘Action’ и ‘Romance’, ваши пользователи смогут пойти в категорию фильмов Action и увидеть все отзывы и фильмы категории.

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

Вы можете изменить различные тексты названий (заданные с использованием массива $labels ), такие как переименовать Add New Post в Add New Movie . Например, вы можете переименовать текст Featured Image (Изображение записи) в Add Poster (Добавить постер) .

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

Продолжая пример с Movies и Movie Reviews, публикации Movie могут добавлять пользовательские/произвольные поля для таких параметров как год выпуска, режисёр, рейтинги многие другие с кратким обзором фильмы в виде содержимого записи.

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

Создание новых типов записей

Когда вы создаёте значительные изменения в WordPress, одним из доступных вариантов реализации является создание плагина . Вы также можете создавать новые произвольные типы записей в файле functions.php . Для этого руководства мы создадим плагин и продолжим использовать пример с базой данных movie/reviews (фильмы/отзывы).

Для создания пользовательского типа записи нужно написать несколько функций, которые вызывают функцию WordPress с названием register_post_type() с двумя параметрами. Ваша функция должна быть привязана к хуку действия(action hook) init , иначе произвольный тип записи не будет зарегистрирован верно.

// The custom function MUST be hooked to the init action hook add_action("init", "lc_register_movie_post_type"); // A custom function that calls register_post_type function lc_register_movie_post_type() { // Set various pieces of text, $labels is used inside the $args array $labels = array("name" => _x("Movies", "post type general name"), "singular_name" => _x("Movie", "post type singular name"), ...); // Set various pieces of information about the post type $args = array("labels" => $labels, "description" => "My custom post type", "public" => true, ...); // Register the movie post type with all the information contained in the $arguments array register_post_type("movie", $args); }

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

Два параметра для функции register_post_type() это:

Название типа записи, максимум 20 символов, и не должно содержать пробелов и заглавных букв
Ассоциативный массив, под названием $args , который содержит информацию о типе записи в виде пар ключ значение ‘key’ => ‘value’

Массив $args

Наиболее часто используемые ключи для массива $args показаны ниже, все не являются обязательными:

labels – массив array , который задаёт разные фрагменты текста, например ‘Добавить новую запись’ может быть переименована в ‘Добавить новый фильм’. Ключи для массива labels с пояснениями описаны ниже;
description – короткое и ёмкое описание типа записи, оно может быть отображено в шаблонах типов, но больше нигде не используется;
public – видно ли тип записи для автором и посетителей, значение по умолчанию FALSE, что значит он не появляется даже в Админ консоли;
exclude_from_search – будут ли записи этого типа появляться в результатах обычного поиска, значение по умолчанию противоположное значению public;
publicly_queryable – можно ли получить запись этого типа с помощью URL-адреса, например, http://www.mywebsite.com/?post_type=movie, или в расширенном использовании через функцию query_posts(). Значение по умолчанию, это значение public;
show_ui – подключаются ли ссылки меню и редактор сообщений в панели управления администратора. Значение по умолчанию –public;
show_in_nav_menus – будут ли записи этого типа добавляться в меню навигации, созданные на странице Внешний вид ->Меню, значение по умолчанию – это значение public;
show_in_menu – отображается ли ссылка типа записи в навигации админ консоли. FALSE – скрывает ссылку. TRUE – добавляет ссылку как новую ссылку верхнего уровня. Ввод строки позволяет разместить ссылку внутри существующей ссылки верхнего уровня, то есть ввести параметры options-general.php располагает её под ссылкой Настройки.
show_in_admin_bar – появится ли этот тип записей выше Admin bar, под ссылкой + New
menu_position – позиция новой ссылки в меню навигации админ консоли, 5 располагает ниже Записей, 100 располагает ниже Настроек, весь список позиций можно найти в WordPress Codex
hierarchical – может ли запись быть назначена к родительской записи, если значение TRUE, то массив $supports должен содержать параметр ‘page-attributes’
supports – выборочно включает функции записи такие как: изображения, фрагменты текста, произвольные поля и др. Если установлено в FALSE, то вместо массива выключается редактор для этого типа поста – полезно, если вы хотите закрыть все записи этого типа от редактирования, но оставить видимыми (список значений массива ниэе)
taxonomies – массив таксономий, который может быть применён к публикациям этого типа, таксономии должны быть уже зарегистрированными – отсюда они не создаются!
has_archive – будут ли у записей этого типа архивные страницы, URL имеет структуру постоянной ссылки и описательная часть URL – это параметр 1 функции register_post_types(), то есть http://www.mywebsite.com/movie_reviews/ покажет все записи movie_review.
query_var – TRUE или FALSE определяет, может ли запись быть показанной, вписывая в виде запроса в URL тип записи и имя записи, то есть ‘http://www.mywebsite.com/?movie =the-matrix ‘. Если вы вводите строку текста, нужно располагать текст после символа?, таким образом ‘film’ будет выглядеть в результате как ‘?film =the-matrix ‘.

Массивы labels

Первый ключ в массиве $args называется labels (ярлыки) и должен быть массивом. Он задаёт различные фрагменты текста, относящиеся к типу записи. Так как здесь может быть много данных, лучше всего создать массив с названием $labels для их хранения. Приведенный выше код немного проясняет, что это значит.

Ниже представлены некоторые важные ключи для массива labels, все не являются обязательными:

name – общее названия для типа сообщений, например, movies (фильмы)
singular_name – название для одной записи этого типа, например, movie (фильм)
add_new – замена текста ‘Add New’ (Добавить новую) на указанный текст, например, ‘Add Movie’ (Добавить фильм)
add_new_item – замена для ‘Add New Post’ (Добавить новую запись), например, на ‘Add New Movie’ (Добавить новый фильм)
edit_item – замена для ‘Edit Post’ (Редактировать запись), например, на ‘Edit Movie’ (Редактировать Фильм)
featured_image – замена для ‘Featured Image’ (Изображение записи) в редакторе записи, например, на ‘Movie Poster’
set_featured_image – замена ‘Set Featured Image’, к примеру, на такой вариант ‘Add Movie Poster’
menu_name – изменение текста ссылки на верхнем уровне, текст для ссылки по умолчанию имя ключа

Массив supports

// Enable specific features in the post editor for my post type $supports = array ("title", "editor", "author", "thumbnail"); // Disable ALL features of the post editor for my post type $supports = FALSE;

Один из ключей в массиве $args называется supports . Это простой массив, где вы записываете список функций редактора записи, которые вы хотите включить для своего типа записи. По умолчанию только название (title) и редактор (editor) включены.

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

Вот перечень функций, которые вы можете включить в массиве $supports :

title (название)
editor (редактор)
author – ПРИМЕЧАНИЕ: это позволяет вам изменять автора публикации
thumbnail (иконка)
excerpt (фрагмент текста)
trackbacks (трекбек)
custom-fields (произвольное поле)
comments (комментарии)
revisions (версии)
page-attributes (атрибуты страницы)
post-formats (форматы записи)

Создание произвольного типа записи WordPress через плагин

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

lc_custom_post_movie() to the init action hook add_action("init", "lc_custom_post_movie"); // The custom function to register a movie post type function lc_custom_post_movie() { // Set the labels, this variable is used in the $args array $labels = array("name" => __("Movies"), "singular_name" => __("Movie"), "add_new" => __("Add New Movie"), "add_new_item" => __("Add New Movie"), "edit_item" => __("Edit Movie"), "new_item" => __("New Movie"), "all_items" => __("All Movies"), "view_item" => __("View Movie"), "search_items" => __("Search Movies"), "featured_image" => "Poster", "set_featured_image" => "Add Poster"); // The arguments for our post type, to be entered as parameter 2 of register_post_type() $args = array("labels" => $labels, "description" => "Holds our movies and movie specific data", "public" => true, "menu_position" => 5, "supports" => array("title", "editor", "thumbnail", "excerpt", "comments", "custom-fields"), "has_archive" => true, "show_in_admin_bar" => true, "show_in_nav_menus" => true, "has_archive" => true, "query_var" => "film"); // Call the actual WordPress function // Parameter 1 is a name for the post type // Parameter 2 is the $args array register_post_type("movie", $args); } // Hook lc_custom_post_movie_reviews() to the init action hook add_action("init", "lc_custom_post_movie_reviews"); // The custom function to register a movie review post type function lc_custom_post_movie_reviews() { // Set the labels, this variable is used in the $args array $labels = array("name" => __("Movie Reviews"), "singular_name" => __("Movie Review"), "add_new" => __("Add New Movie Review"), "add_new_item" => __("Add New Movie Review"), "edit_item" => __("Edit Movie Review"), "new_item" => __("New Movie Review"), "all_items" => __("All Movie Reviews"), "view_item" => __("View Movie Reviews"), "search_items" => __("Search Movie Reviews")); // The arguments for our post type, to be entered as parameter 2 of register_post_type() $args = array("labels" => $labels, "description" => "Holds our movie reviews", "public" => true, "menu_position" => 6, "supports" => array("title", "editor", "thumbnail", "excerpt", "comments", "custom-fields"), "has_archive" => true, "show_in_admin_bar" => true, "show_in_nav_menus" => true, "has_archive" => true); // Call the actual WordPress function // Parameter 1 is a name for the post type // $args array goes in parameter 2. register_post_type("review", $args); }

Ели вы включите этот плагин, то увидите новую ссылку в панели навигации админ консоли, сразу после ссылки Записи.

При наведении мыши будет показаны пункты меню ‘View All’ (Показать все) и ‘Add New’ (Добавить новую), текст будет соответствовать тому, который был задан в массиве $labels . Посмотрите в редакторе, где изменились ссылки.

Ограничение произвольных полей для заданных записей

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

get_post_meta()

принимает 3 параметра и возвращает результат
первый параметр – ID записи, вы можете использовать здесь $post->ID для получения ID текущей отображаемой записи
второй параметр – имя произвольного поля записи, чувствительное к регистру
третий параметр имеет тип boolean, называется $single и может быть TRUE (возвращает результат в виде строки) или FALSE (возвращает массив).

ПРИМЕЧАНИЕ: Вы можете создать несколько настраиваемых полей с тем же именем и разными значениями. Если существует несколько полей с одинаковым именем, установка FALSE вернёт их массив.

ID, "Box Art", TRUE); if (!empty($movie_box_art)) { ?>

" alt=" ">

Поскольку функция get_post_meta() возвращает значение, вы можете использовать значение в условном выражении для соответствующего изменения внешнего вида.

В примере выше мы проверяем, содержит ли фильм (movie) box art, назначенный ему в виде произвольного поля. Если $movie_box_art не пустое, вывести div и image.

Отображение Advanced Custom Fields

// Display field value the_field("FIELD NAME"); // Return field value get_field("FIELD NAME");

Плагин Advanced Custom Fields предлагает свои собственные функции и шорткоды для отображения полей.

the_field(‘ FIELD NAME’);

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

get_field(‘FIELD NAME’);

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

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

Шорткоды

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

Отображение произвольного типа записей на главной странице

// Hook our custom function to the pre_get_posts action hook add_action("pre_get_posts", "add_reviews_to_frontpage"); // Alter the main query function add_reviews_to_frontpage($query) { if (is_home() && $query->is_main_query()) { $query->set("post_type", array("post", "movie", "review")); } return $query; }

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

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

$query->set() принимает два параметра:

первый параметр – приоритет, который вы хотите изменить, в нашем случае мы изменяем приоритет post_type
второй параметр – массив, который вы хотите передать как значение признака post_type

В примере кода выше массив начинается с ‘post’ – вот почему каждая запись WordPress имеет тип ‘post’ и мы всё ещё хотим включить её на главной странице.

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

Значение, которое вы вводите должно соответствовать параметру 1 функции register_post_type() .

Заключение

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

First, from a code organization standpoint, it’d be better to put all of the review logic into one or more includable files and then include it on product pages:

Include("includes/reviews.php");

This way, the product pages can remain unadulterated and the same review code can easily be used, or modified, as needed. The reviews.php script would do several things:

Show the review form
Handle the review form
List the existing reviews
Handle secondary actions, such as flagging reviews or comments as inappropriate, indicating that reviews were helpful, adding comments to reviews, indicating that comments where helpful, and so forth

Hopefully you’ve done plenty of web development already, so you know that a form for adding reviews would just be like so:

Clearly you’d want to use some CSS to make it pretty, but that’s the basic idea. The main catch is that the product ID and product type (or whatever the database must have in order to associate a review with an item) must be stored in hidden inputs. You’d have the PHP script that displays the product write these values to the inputs.

If login is required, you might add (PHP) code that only shows the form to logged-in users, or prints a comment saying the user must log in to review the product. Similarly, if you have a system in place for guaranteeing a person only ever reviews a product once, you’d have PHP check for that scenario before showing this form.

The form submission could go to a new page, but then the user would need to click the Back button to return to the product page, which isn’t ideal. I would instead submit the form back to the product page. For example, on any dynamic website, the same PHP script is used to display all the content of a specific type. In my Effortless E-Commerce with PHP and MySQL book, the first example site uses the page.php script to show any page of content. The action attribute of the form would point to the same page.php . You can accomplish this by just leaving the attribute empty, or by using PHP to dynamically set the value.

If the PHP page that lists the products requires that a value identifying the product be passed in the URL, then the form would need to store that value in a hidden input as well. (That may already be the case, with the product_id input, depending upon how the site is set up.) Secondarily, the product script would also need to be updated to allow for the product value to be received via POST .

For the reviews.php script to know when to handle a form submission, it can check how the script was accessed:

If ($_SERVER["REQUEST_METHOD"] == "POST") { // Handle the form.

When the review form is submitted, the form data should be validated. You should also apply strip_tags() to the data to prevent Cross-Site Scripting (XSS) attacks or other bad behavior. And non-numeric values would be run through an escaping function, such as mysqli_real_escape_string() . Or you could just use prepared statements or stored procedures for better security and performance.

If you add an anchor to the form’s action attribute action="page.php#reviews "the user will be taken to the reviews section of the page upon the submission, which is a nice touch.

If the reviews.php script is also handling some of the other actionsinappropriate reviews or comments, helpful indicators, etc.the script would need to watch for those submissions, too. I would use hidden inputs named “task” to indicate which action is being taken.

In a separate article, I demonstrate how to use Ajax for a simple rating system. Similar Ajax code could be used for the review system, too.

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

Что такое пользовательские типы записей?

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

Пользовательские типы записей - это дополнительный набор настроек администратора, который существует наряду с настройками для таких типов записей по умолчанию, как записи , страницы , прикрепленные файлы , и т.д. Пользовательские типы записей могут хранить любой тип данных. У них есть отдельный редактор, загрузчик медиафайлов, и они используют уже существующую структуру таблиц WordPress, что упрощает управление данными. Основное преимущество пользовательских типов записей, созданных при помощи WordPress API, состоит в их совместимости с уже существующими темами и шаблонами. Также, благодаря использованию постоянных ссылок, пользовательские типы постов хорошо взаимодействуют и с поисковыми системами.

Зачем использовать пользовательские типы записей?

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

Создаем плагин для пользовательского типа записи

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

Шаг 1 . Создайте папку для WordPress плагина

Откройте папку с WordPress плагинами и создайте новую папку Movie-Reviews .

Шаг 2 : Создайте PHP файл

В созданной папке создайте PHP файл Movie-Reviews.php

Шаг 3 : Добавьте шапку

Откройте созданный файл и вставьте код для шапки сверху.

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

Add_action("init", "create_movie_review");

Шаг 5 : Выполнение функции

Код для выполнения функции create_movie_review .

Function create_movie_review() { register_post_type("movie_reviews", array("labels" => array("name" => "Movie Reviews", "singular_name" => "Movie Review", "add_new" => "Add New", "add_new_item" => "Add New Movie Review", "edit" => "Edit", "edit_item" => "Edit Movie Review", "new_item" => "New Movie Review", "view" => "View", "view_item" => "View Movie Review", "search_items" => "Search Movie Reviews", "not_found" => "No Movie Reviews found", "not_found_in_trash" => "No Movie Reviews found in Trash", "parent" => "Parent Movie Review"), "public" => true, "menu_position" => 15, "supports" => array("title", "editor", "comments", "thumbnail", "custom-fields"), "taxonomies" => array(""), "menu_icon" => plugins_url("images/image.png", __FILE__), "has_archive" => true)); }

Функция register_post_type сделает бОльшую часть работы в нашем случае. Сразу как она вызовется, она подготовит необходимую для нового пользовательского поста конфигурацию WordPress, включая дополнительные разделы для администратора. В функцию передается два типа аргументов: уникальное имя (name) пользовательского типа поста и массив с его свойствами. Это другой массив с другими метками, которые указывают какие текстовые строки будут показываться в разных частях пользовательского типа записи, например: " name " выводит название пользовательского типа записи на панели управления, " edit " и " view " выводят кнопки Edit и View . Думаю, все остальные аргументы говорят сами за себя.

Так, в следующих аргументах:

"public" => true задает видимость пользовательского типа записи как на панели управления администратора, так и в клиентской части.
"menu_position" => 15 задает, где в меню, будет находиться пользовательский тип записи.
"supports" => array("title", "editor", "comments", "thumbnail", "custom-fields") задает те атрибуты пользовательского типа записи, которые будут отображаться.
"taxonomies" => array("") создает пользовательские таксономии. В данном случае они не определены.
"menu_icon" => plugins_url("images/image.png", __FILE__) показывает иконку в меню администратора.
"has_archive" => true разрешает архивирование пользовательских типов записей.

Вы можете узнать больше о других аргументах, используемых в пользовательских типах записей на странице WordPress Codex register_post_type .

Шаг 6 : Иконка для пользовательского типа записей

Сохраните иконку размером 16x16 пикселей в вашей папке с плагином. Это нужно для того, чтобы на панели управления у пользовательского типа записи была иконка.

Шаг 7 : Активируйте плагин

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

Шаг 8 : Добавляем новую запись

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

Шаг 9 : Публикуем

Опубликуйте запись и нажмите View Movie Review , чтобы увидеть созданный кинообзор.

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

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

Шаг 1 : Регистрируем пользовательскую функцию

Откройте файл Movie-Reviews.php и добавьте следующий код перед тегом закрытия. Этот код регистрирует функцию, которая будет вызываться при посещении панели администратора WordPress.

Add_action("admin_init", "my_admin");

Шаг 2 : Выполняем пользовательскую функцию

Добавьте выполнение функции my_admin , которая регистрирует дополнительные поля и связывает их с пользовательским типом записи movie_reviews .

Function my_admin() { add_meta_box("movie_review_meta_box", "Movie Review Details", "display_movie_review_meta_box", "movie_reviews", "normal", "high"); }

В данном случае функция add_meta_box используется для добавления дополнительных полей к пользовательскому типу записей. Об атрибутах:

movie_review_meta_box необходимый атрибут для HTML id
Movie Review Details текст, которые будет виден в заголовке дополнительного поля
display_movie_review_meta_box функция обратного вызова которая отображает содержимое дополнительных полей
movie_review имя пользовательского типа записи, где будут отображаться дополнительные поля
normal определяет где на странице будет показан блок редактирования
high определяет приоритет отображаемых полей

Шаг 3: Выполняем функцию display_movie_review_meta_box

ID, "movie_director", true)); $movie_rating = intval(get_post_meta($movie_review->ID, "movie_rating", true)); ?>

Movie Director
Movie Rating

Этот код выводит содержимое дополнительных полей. Здесь используется объектная переменная, которая содержит информацию о каждом из показанных на панели редактирования кинообзоров. Используя этот объект мы получили ID записи и использовали его, чтобы сделать запрос в базу данных для получения имени режиссера и рейтинга, что в свою очередь выведется в полях на экране. При добавлении новой записи, функция get_post_meta возвратит пустую строку, и в итоге дополнительные поля будут пустыми.

Шаг 4 : Регистрируем функцию сохранения записи

add_action("save_post", "add_movie_review_fields", 10, 2);

Эта функция вызывается при сохранении записи в базе данных.

Шаг 5 : Выполняем функцию add_movie_review_fields

function add_movie_review_fields($movie_review_id, $movie_review) { // Check post type for movie reviews if ($movie_review->post_type == "movie_reviews") { // Store data in post meta table if present in post data if (isset($_POST["movie_review_director_name"]) && $_POST["movie_review_director_name"] != "") { update_post_meta($movie_review_id, "movie_director", $_POST["movie_review_director_name"]); } if (isset($_POST["movie_review_rating"]) && $_POST["movie_review_rating"] != "") { update_post_meta($movie_review_id, "movie_rating", $_POST["movie_review_rating"]); } } }

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

Шаг 6 : Отключаем стандартные пользовательские поля

Создавая пользовательский тип записи, мы задали функцию create_movie_review . Удалите элемент custom-fields из массива supports , поскольку он нам больше не понадобиться. Теперь, если вы сохраните файл и откроете панель редактирования Movie Reviews , вы увидите два поля в дополнительных полях: Movie Author и Movie Rating . Вы можете добавить другие элементы тем же способом.

Создание шаблона для пользовательского типа записи

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

Шаг 1 : Регистрируем функцию запуска шаблона

Откройте файл Movie-Reviews.php и перед тегом закрытия добавьте следующий код. Этот код регистрирует функцию, которая будет вызываться при посещении панели администратора WordPress.

Add_filter("template_include", "include_template_function", 1);

Шаг 2 : Выполняем функцию

Здесь проверяется, есть ли в текущей папке темы шаблон типа single-(post-type-name).php . Если его там нет, то проверяется наличие шаблона в папке с плагином, куда мы и поместим наш шаблон, как часть плагина. Событийный обработчик (хук) template_include используется, чтобы изменить обычное выполнение программы и принудительно запустить специальный шаблон.

Шаг 3 : Создаем файл шаблона Single Page

Сохранив ранее открытый файл с плагином, создайте другой файл с именем single-movie_reviews.php и вставьте в него следующий код.

"movie_reviews",); $loop = new WP_Query($mypost); ?> have_posts()) : $loop->the_post();?>

Title:
Director:
Rating: "; } else { echo "

"; } } ?>

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

Внимание : необходимо создать новую страницу из панели управления используя созданный шаблон.

Шаг 4: Изображения

Сохраните два изображения с иконками для звездочек размером 32x32 пикселя в вашу папку с плагином. Назовите их соответственно icon.png и grey.png . Вот и все, теперь кинообзоры показываются на отдельной странице и отсортированы по дате.

Шаблоны файлов WooCommerce содержат разметку и структуру шаблона интерфейса (и HTML сообщения электронной почты) вашего магазина. Если Вы откроете эти файлы, то Вы заметите, что все они содержат много хуков (hooks), которые позволят Вам добавлять / перемещать контент без необходимости редактирования самих файлов шаблона. Такой подход защищает от любых проблем с обновлениями, так как файлы шаблона могут оставаться полностью нетронутыми.

Кроме того, вы можете редактировать эти файлы безопасным способом с помощью подмены. Просто скопируйте их в Ваш шаблон в папку с именем /woocommerce , сохраняя ту же иерархическую структуру вложенных файлов и папок. Скопированные файлы шаблонов переопределят файлы шаблонов WooCommerce, используемые по умолчанию. Не редактируйте файлы шаблонов в ядре самого плагина, так как они будут перезаписаны в процессе обновления и все внесенные в них изменения будут потеряны, поскольку обновленные файлы шаблонов затрут старые файлы шаблонов.

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

Пример: для внесения изменений в шаблон корзины, скопируйте woocommerce/templates/cart/cart.php в . После этого Вы можете вносить любые изменения в файл шаблона cart.php , расположенный в папке с вашей темой (т.е. в файл cart.php, расположенный по адресу ваша_тема/woocommerce/cart/cart.php ), и внесенные вами изменения сохранятся даже после обновления WooCommerce.

В директории /woocommerce/templates/ можно найти следующие файлы шаблонов

Спойлер: Список файлов

(данный список файлов шаблонов актуален для версии WooCommerce 2.0+):

· archive-product.php

· cart/

· cart-empty.php

· cross-sells.php

· mini-cart.php

· shipping-calculator.php

· shipping-methods.php

· totals.php

· checkout/

· cart-errors.php

· form-billing.php

· form-checkout.php

· form-coupon.php

· form-login.php

· form-pay.php

· form-shipping.php

· review-order.php

· thankyou.php

· content-product_cat.php

· content-product.php

· content-single-product.php

· emails/

· admin-new-order.php

· customer-completed-order.php

· customer-invoice.php

· customer-new_account.php

· customer-note.php

· customer-processing-order.php

· customer-reset-password.php

· email-addresses.php

· email-footer.php

· email-header.php

· email-order-items.php

· loop/

· add-to-cart.php

· loop-end.php

· loop-start.php

· no-products-found.php

· pagination.php

· result-count.php

· sale-flash.php

· myaccount/

· form-change-password.php

· form-edit-address.php

· form-login.php

· form-lost-password.php

· my-account.php

· my-address.php

· my-downloads.php

· my-orders.php

· order/

· form-tracking.php

· order-details.php

· tracking.php

· shop/

· breadcrumb.php

· form-login.php

· messages.php

· wrapper-end.php

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

| Скачать исходники |

Что такое Custom Post Types?

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

Пользовательские типы записей - новый набор административных настроек, которые используются наряду со стандартными типами, такими как Записи , Страницы , Прикрепленные файлы и так далее. Пользовательский тип записей может хранить любой тип информации. У него есть свой редактор и медиа-загрузчик. Он использует существующую структуру таблиц WordPress для простого управления данными. Главное преимущество создания пользовательских типов записей с помощью WordPress API - это удобное использование с существующими темами и шаблонами. Пользовательские типы записей также SEO-дружественны из-за своих постоянных ссылок.

Зачем использовать пользовательские типы записей?

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

Пример создания плагина Custom Post Type

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

Шаг 1. Создаем папку WordPress плагина

Откройте свою папку с WordPress плагинами и создайте новую под названием Movie-Reviews .

Шаг 2. Создаем PHP файл

Откройте папку и создайте PHP файл под названием Movie-Reviews.php .

Шаг 3. Добавляем шапку

Откройте файл и добавьте код шапки плагина.

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

Add_action("init", "create_movie_review");

Шаг 5. Выполнение функции

Выполнение функции create_movie_review :

Функция register_post_type делает за нас большинство работы. Как только она вызывается, она готовит среду WordPress к новому пользовательскому типу записи, включая разные разделы в админ. части.

Эта функция принимает два аргумента : первый - уникальное имя пользовательского типа записей, а второй - массив, который представляет свойства нового пользовательского типа записей. Вот другой массив, который содержит разные метки, которые обозначают, какие текстовые строки будут отображаться в разных частях пользовательского типа записей, например "name " отображает название пользовательского типа записей в консоли, "edit " и "view " отображаются соответственно в кнопках Edit и View . Думаю, остальное говорит само о себе.

Аргументы :

"public" => true - определяет видимость пользовательского типа записи и в панели администратора, и в клиентской части.
"menu_position" => 15 - обозначает позицию меню пользовательского типа записи.
"supports" => array("title", "editor", "comments", "thumbnail", "custom-fields" ) - определяет характеристики пользовательского типа записей, которые будут отображаться.
"taxonomies" => array(" ") - создает пользовательские таксономии. Здесь они не определены.
"menu_icon" => plugins_url( "images/image.png", __FILE__ ) - отображает иконку меню администратора.
"has_archive" => true - включает архивирование пользовательского типа записи.

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

Шаг 6. Иконка для пользовательского типа записи

Сохраните иконку размером 16 x 16 px в папку вашего текущего плагина. Это необходимо для иконки пользовательского типа записи в консоли.

Шаг 7. Активируем плагин

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

Шаг 8. Добавление новой записи

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

Шаг 9. Публикация

Опубликуйте запись и щелкните по View Movie Review , чтобы увидеть созданную кино-рецензию.

Создание полей Meta Box для пользовательских типов записей

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

Шаг 1. Регистрация пользовательской функции

Откройте файл Movie-Reviews.php и добавьте следующий код перед закрывающимся PHP тегом. Это регистрирует функцию, которая будет вызвана, когда будет посещен интерфейс администратора WordPress.

Add_action("admin_init", "my_admin");

Шаг 2. Выполнение пользовательской функции

Добавьте выполнение функции my_admin , которая регистрирует мета-блоки и связывает их с пользовательским типом записей movie_reviews .

Function my_admin() { add_meta_box("movie_review_meta_box", "Movie Review Details", "display_movie_review_meta_box", "movie_reviews", "normal", "high"); }

Здесь функция add_meta_box использована для добавления мета-блоков в пользовательские типы записей.

Атрибуты :

movie_review_meta_box - необходимый HTML атрибут id .
Movie Review Details - текст, видимый в верхней части мета-блока.
display_movie_review_meta_box - обратный вызов, который отображает содержимое мета-блока.
movie_reviews - это имя пользовательского типа записей, где будет отображаться мета-блок.
normal - определяет часть страницы, где должен быть отображен блок редактирования.
high - определяет приоритет в контексте, в котором будут отображаться блоки.

Шаг 3. Выполнение функции display_movie_review_meta_box

ID, "movie_director", true)); $movie_rating = intval(get_post_meta($movie_review->ID, "movie_rating", true)); ?>

Movie Director
Movie Rating

Этот код отображает содержимое мета-блока. Здесь мы использовали объектную переменную, которая содержит информацию о каждой кино-рецензии, которая отображается в редакторе. Используя этот объект, мы получили ID записи и использовали его для запроса в базу, чтобы получить связанное имя режиссера и рейтинг, что привело к отображению полей на экране. Когда новая запись добавлена, get_post_meta возвращает пустую строку, что приводит к отображению пустых полей в мета-блоке.

Шаг 4. Регистрация функции Save Post

add_action("save_post", "add_movie_review_fields", 10, 2);

Эта функция вызывается, когда записи сохраняются в базе данных.

Шаг 5. Вызов функции add_movie_review_fields

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

Шаг 6. Отключение стандартных пользовательских полей

При создании пользовательского типа записи мы определили функцию create_movie_review . Удалите элемент custom-fields из массива supports , потому что это больше не нужно. Сейчас если вы сохраните файл и откроете редактор Movie Reviews , вы заметите два поля в мета-блоке под названием Movie Author и Movie Rating . Таким же образом вы можете добавить и другие элементы.

Создание пользовательского шаблона для пользовательского типа записи

Правильный способ отображения данных пользовательского типа записи - это использование пользовательских шаблонов для каждого пользовательского типа записи. Здесь мы должны создать шаблон, который отображает все кино-рецензии, добавленные с использованием пользовательского типа записи Movie Review .

Шаг 1. Регистрируем функцию для шаблона

Откройте файл Movie-Reviews.php и добавьте перед тегом закрытия PHP следующий код. Он зарегистрирует функцию для вызова, когда будет посещен интерфейс администратора WordPress.

Add_filter("template_include", "include_template_function", 1);

Шаг 2. Выполнение функции

Здесь код ищет шаблон single-(post-type-name ).php в папке текущей темы. Если его там нет, он ищет в папке плагина шаблон, который мы предоставили как часть плагина. Зацепка template_include была использована для изменения стандартного поведения и применения специфического шаблона.

Шаг 3. Создание файла шаблона Single Page

После сохранения открытого файла плагина создайте другой PHP файл под названием single-movie_reviews.php и вставьте в него следующий код.

"movie_reviews",); $loop = new WP_Query($mypost); ?> have_posts()) : $loop->the_post();?>

Title:
Director:
Rating: "; } else { echo "

"; } } ?>

Здесь мы создали базовый шаблон страницы , используя цикл. Функция query_posts получает элементы пользовательского типа записи и отображает их, используя цикл. Конечно, это только базовый цикл, и вы можете играть с ним, как вам вздумается. Вы также можете использовать CSS стили, чтобы форматировать элементы.

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

Шаг 4. Изображения

Вам нужно сохранить два изображения иконок 32 x 32 px в папке вашего плагина. Назовите их icon.png и grey.png . Все, теперь кино-рецензии отображаются на отдельной странице, отсортированные по дате.

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