Как создать тип записи в админ-панели с WPS Framework

732

Добрый день, в предыдущей статье мы познакомились с таким инструментом как WPS Framework и сегодня мы начнем создавать шаг за шагом функционал нашего будущего сайта.

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

Итак, задача: Создать тип записи в админ панели

Портфолио;
Таксономии к портфолио ( для категоризации работ).

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

Приступим к решению поставленной задачи

Стоит отметить, что файлы «конфигурация типов записей» рекомендуем размещать в папке wps_config. Именно эта директория предназначения для всех будущих настроек нашего сайта.

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

В папке wps_config создаем файл wps_portfolio.php

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

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

new WPS_CustomType(

array(

## Create Files

'create_archive_file' => false,

'create_single_file'  => false,

## Post Type Register

'register_post_type' => array(

'post_type' => 'custom_post_name', // 1) custom-type name

// labels

'labels'    => array(

'name'          => 'PostType2',

'singular_name' => 'PostType2',

'menu_name'     => 'PostType2'

// supports_label

'supports_label' => array(

'title',

//'thumbnail',

//'editor',

//'custom-fields',

// rewrite

'rewrite' => array(

'slug'         => 'custom_post_name', // 2) custom-type slug

'with_front'   => false,

'hierarchical' => true

// general

'general' => array(

// if need remove in query

//'query_var'           => false,

//'publicly_queryable'  => false,

//'exclude_from_search' => true,

'taxonomies'        => array('name_cat'), // 3)

'menu_icon'         => 'dashicons-star-empty', // 4)

)

## Create Taxonomy

'register_taxonomy' => array(

// tax

array (

'taxonomy_name' => 'name_cat',         // 1)

'setting' => array(

'label'             => 'Таксономия', // 2)

'hierarchical'      => true,

'public'            => true,

'query_var'         => true,

'rewrite'           => array(

'slug'         => 'name_cat',      // 3)

'with_front'   => true,

'hierarchical' => true

'show_admin_column' => true,

'show_ui'           => true

)

// tax

)

);

Разберем самые основные настройки, которые нам потребуется внести в данный код:

create_archive_file – булевый параметр, который позволяет автоматически создать внутри вашей темы архивный файл для данного типа записи. Если поставить true будет создан файл с названием archive-portfolio.php
create_single_file – булевый параметр, который позволяет автоматически создать внутри вашей системы файл для вывода содержимого записи данного типа – так называемый «single». Если поставить true, будет создан файл с названием single-portfolio.php
post_type – это латинское названием вашего типа записи, он же slug. Советуем одинаково именовать с полем slug. В нашем примере будет уместно указать portfolio
массив labels – здесь вы указываете, как на русском языке называется ваша страница, причем указывается название как в меню, так и внутри самой записи. В нашем случае, например, «Портфолио»
slug – он же url вашего типа записи, обязательно указывайте латиницу и без дефисов
query_var, publicly_queryable, exclude_from_search – параметры, которые отвечают за доступность вашего типа записи на клиентской части. Если у вас есть необходимость создать записи, которые не должны быть доступны по прямым ссылкам клиентам и не должны индексироваться в поиске, достаточно расскомментировать эти строки и указать значение true
taxonomies – здесь в формате массива можно указать имена таксономий, к которым можно будет прикреплять данный тип записи, если в этом есть необходимость. Если таксономии не нужны, оставляйте массив пустым, если нужны – указывайте название таксономии. В нашем случае будет указано имя «type».

Параметры раздела register_taxonomy:

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

taxonomy_name – имя таксономии, именно его значение указывается в массиве taxonomies
label – название таксономии в админ панели. В нашем случае «Типы»
slug – ссылка (url) будущей таксономии. Указывайте на латинице и без дефисов.

Итак, после проведения всех настроек наш файл выглядит следующим образом:

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

Для подключения файла допишем вот такую строку в файл functions.php:

require_once( trailingslashit( CHILD_DIR ) . ‘wps_config/wps_portfolio.php’ );

И получим вот такой вид нашего файла functions:

Заходим в админ панель (или перезагружаем страницу, если вы уже там) и видим результат. Среди пунктов меню появился наш собственный пункт «Портфолио», в котором есть подпункт «Типы».