Объектно-ориентированная разработка с WordPress

 /* * Event Showcase * Creates an 'event' content type to showcase upcoming functions and information * Uses hooks and filters inside your theme to output relevant information */ class event_showcase{ //variables private $directory = ''; private $singular_name = 'event'; private $plural_name = 'events'; private $content_type_name = 'event_showcase'; //magic function, called on creation public function __construct(){} //sets the directory (path) so that we can use this for our enqueuing public function set_directory_value(){} //check if we need to flush rewrite rules public function check_flush_rewrite_rules(){} //enqueue public scripts and styles public function enqueue_public_scripts_and_styles(){} //enqueue admin scripts and styles public function enqueue_admin_scripts_and_styles(){} //adding our new content type public function add_content_type(){} //adding meta box to save additional meta data for the content type public function add_meta_boxes_for_content_type(){} //displays the visual output of the meta box in admin (where we will save our meta data) public function display_function_for_content_type_meta_box($post){} //when saving the custom content type, save additional meta data public function save_custom_content_type($post_id){} //display additional meta information for the content type //@hooked using 'display_additional_meta_data' in theme function display_additional_meta_data(){} } //create new object $event_showcase = new event_showcase; 

Давайте рассмотрим методы и свойства, чтобы понять процесс:

• Переменные. Мы объявляем несколько переменных, чтобы сделать класс более модульным (поэтому мы можем скопировать этот файл и изменить несколько свойств, и класс будет обрабатывать другие изменения).
• __construct() — все наши хуки, фильтры и код инициализации будут здесь.
• set_directory_value() — Определяет наше свойство directory которое позволит нам легко ставить в очередь файлы, которые мы помещаем в наши каталоги CSS или JS.
• check_flush_rewrite_rules() — обрабатывает сброс симпатичных постоянных ссылок, когда мы добавляем наш тип контента (который заставляет работать новые элементы).
• enqueue_public_scripts_and_styles() — загружает наши общедоступные сценарии и стили.
• enqueue_admin_scripts_and_styles() — загружает сценарии и стили администратора.
• add_content_type() — определяет новый тип контента, который мы создаем.
• add_meta_boxes_for_content_type() — добавляет мета-блоки для нашего нового типа контента.
• display_function_for_content_type_meta_box — Создает внутренний интерфейс администратора для типа контента, чтобы мы могли сохранить дополнительную информацию.
• save_custom_content_type($post_id) — Обрабатывает сохранение пользовательского типа контента (и нашей метаинформации).
• display_additional_meta_data() — отображает сохраненную метаинформацию на внешнем интерфейсе.

Давайте пройдемся сейчас и обновим эти элементы и наметим код

Свойства класса

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

 //variables private $directory = ''; private $singular_name = 'event'; private $plural_name = 'events'; private $content_type_name = 'event_showcase'; 

__construct ()

Наша функция __construct является магической функцией. Эти функции являются специальными функциями PHP5 +, к которым классы могут обращаться для выполнения определенных действий.

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

Функция __construct вызывается, как только класс инициализируется, поэтому это первая функция, которая будет запущена. Именно здесь мы добавляем все наши хуки, фильтры и логику запуска. Обновите базовую схему следующим кодом.

 //magic function, called on creation public function __construct(){ $this->set_directory_value(); //set the directory url on creation add_action('init', array($this,'add_content_type')); //add content type add_action('init', array($this,'check_flush_rewrite_rules')); //flush re-write rules for permalinks (because of content type) add_action('add_meta_boxes', array($this,'add_meta_boxes_for_content_type')); //add meta boxes add_action('wp_enqueue_scripts', array($this,'enqueue_public_scripts_and_styles')); //enqueue public facing elements add_action('admin_enqueue_scripts', array($this, 'enqueue_admin_scripts_and_styles')); //enqueues admin elements add_action('save_post_' . $this->content_type_name, array($this,'save_custom_content_type')); //handles saving of content type meta info add_action('display_content_type_meta', array($this,'display_additional_meta_data')); //displays the saved content type meta info } 

Вы можете подумать, что add_action выглядит немного иначе, чем вы видели раньше, и вы правы.

При использовании вызовов add_action и add_filter внутри класса вы должны указать второй аргумент в массиве. Первое значение массива — $this переменная $this (то есть сам класс), а второе — имя функции, которая будет использоваться (заключенная в кавычки).

Для получения дополнительной информации просмотрите сноску класса для функции add_action в Кодексе WordPress.

set_directory_value ()

Поскольку мы будем ставить в очередь CSS и JS, имеет смысл сохранить URL-адрес каталога файлов в переменной, к которой мы можем получить доступ. Наша структура каталогов — /includes/event_showcase однако она может быть настроена в соответствии с вашей структурой.

 //sets the directory (path) so that we can use this for our enqueuing public function set_directory_value(){ $this->directory = get_stylesheet_directory_uri() . '/includes/event_showcase'; } 

check_flush_rewrite_rules ()

Так как мы добавляем пользовательский тип контента, нам нужно обрабатывать Pretty Permalinks ; эти постоянные ссылки являются переписанными, которые делают URL вашей страницы менее уродливым (вместо http://mywebsite.com.au/?p=123 вы можете иметь http://mywebsite.com.au/my-event ).

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

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

 //check if we need to flush rewrite rules public function check_flush_rewrite_rules(){ $has_been_flushed = get_option($this->content_type_name . '_flush_rewrite_rules'); //if we haven't flushed re-write rules, flush them (should be triggered only once) if($has_been_flushed != true){ flush_rewrite_rules(true); update_option($this->content_type_name . '_flush_rewrite_rules', true); } } 

 //enqueue public scripts and styles public function enqueue_public_scripts_and_styles(){ //public styles wp_enqueue_style( $this->content_type_name . '_public_styles', $this->directory . '/css/' . $this->content_type_name . '_public_styles.css' ); //public scripts wp_enqueue_script( $this->content_type_name . '_public_scripts', $this->directory . '/js/' . $this->content_type_name . '_public_scripts.js', array('jquery') ); } 

 //enqueue admin scripts and styles public function enqueue_admin_scripts_and_styles(){ global $pagenow, $post_type; //process only on post edit page for custom content type if(($post_type == $this->content_type_name) && ($pagenow == 'post-new.php' || $pagenow == 'post.php')){ //admin styles wp_enqueue_style( $this->content_type_name . '_public_styles', $this->directory . '/css/' . $this->content_type_name . '_admin_styles.css' ); //jquery ui styles for datepicker wp_enqueue_style( $this->content_type_name . '_jquery_ui_style', '//code.jquery.com/ui/1.11.4/themes/smoothness/jquery-ui.css' ); //timepicker styles wp_enqueue_style( 'jquery_ui_timepicker_styles', $this->directory . '/css/jquery.ui.timepicker.css' ); //timepicker script wp_enqueue_script( 'jquery_ui_timepicker_script', $this->directory . '/js/jquery.ui.timepicker.js' ); //admin scripts (depends on datepicker and timepicker) wp_enqueue_script( $this->content_type_name . '_public_scripts', $this->directory . '/js/' . $this->content_type_name . '_admin_scripts.js', array('jquery','jquery-ui-datepicker','jquery_ui_timepicker_script') ); } } 

 //adding our new content type public function add_content_type(){ $labels = array( 'name' => ucwords($this->singular_name), 'singular_name' => ucwords($this->singular_name), 'menu_name' => ucwords($this->plural_name), 'name_admin_bar' => ucwords($this->singular_name), 'add_new' => ucwords($this->singular_name), 'add_new_item' => 'Add New ' . ucwords($this->singular_name), 'new_item' => 'New ' . ucwords($this->singular_name), 'edit_item' => 'Edit ' . ucwords($this->singular_name), 'view_item' => 'View ' . ucwords($this->plural_name), 'all_items' => 'All ' . ucwords($this->plural_name), 'search_items' => 'Search ' . ucwords($this->plural_name), 'parent_item_colon' => 'Parent ' . ucwords($this->plural_name) . ':', 'not_found' => 'No ' . ucwords($this->plural_name) . ' found.', 'not_found_in_trash' => 'No ' . ucwords($this->plural_name) . ' found in Trash.', ); $args = array( 'labels' => $labels, 'public' => true, 'publicly_queryable'=> true, 'show_ui' => true, 'show_in_nav' => true, 'query_var' => true, 'hierarchical' => false, 'supports' => array('title','editor','thumbnail'), 'has_archive' => true, 'menu_position' => 20, 'show_in_admin_bar' => true, 'menu_icon' => 'dashicons-format-status' ); //register your content type register_post_type($this->content_type_name, $args); } 

 //adding meta box to save additional meta data for the content type public function add_meta_boxes_for_content_type(){ //add a meta box add_meta_box( $this->singular_name . '_meta_box', //id ucwords($this->singular_name) . ' Information', //box name array($this,'display_function_for_content_type_meta_box'), //display function $this->content_type_name, //content type 'normal', //context 'default' //priority ); } 

 //displays the back-end admin output for the event information public function display_function_for_content_type_meta_box($post){ //collect meta information $event_subtitle = get_post_meta($post->ID,'event_subtitle', true); $event_start_date = get_post_meta($post->ID,'event_start_date', true); $event_end_date = get_post_meta($post->ID,'event_end_date', true); $event_start_time = get_post_meta($post->ID,'event_start_time', true); $event_end_time = get_post_meta($post->ID,'event_end_time', true); $event_location = get_post_meta($post->ID,'event_location', true); $event_price = get_post_meta($post->ID,'event_price', true); //set nonce wp_nonce_field($this->content_type_name . '_nonce', $this->content_type_name . '_nonce_field'); ?> <p>Enter additional information about your event below</p> <div class="field-container"> <label for="event_subtitle">Subtitle</label> <input type="text" name="event_subtitle" id="event_subtitle" value="<?php echo $event_subtitle; ?/>"/> </div> <div class="field-container"> <label for="event_location">Event Location</label> <textarea name="event_location" id="event_location">< ?php echo $event_location; ?></textarea> </div> <div class="field-container"> <label for="event_start_date">Start Date</label> <input type="text" name="event_start_date" id="event_start_date" class="admin-datepicker" value="<?php echo $event_start_date; ?/>" required/> </div> <div class="field-container"> <label for="event_end_date">End Date</label> <input type="text" name="event_end_date" id="event_end_date" class="admin-datepicker" value="<?php echo $event_end_date; ?/>" required/> </div> <div class="field-container"> <label for="event_start_time">Start Time</label> <input type="text" name="event_start_time" id="event_start_time" class="admin-timepicker" value="<?php echo $event_start_time; ?/>" required/> </div> <div class="field-container"> <label for="event_end_time">End Time</label> <input type="text" name="event_end_time" id="event_end_time" class="admin-timepicker" value="<?php echo $event_end_time; ?/>" required/> </div> <div class="field-container"> <label for="event_price">Price</label> <input type="text" name="event_price" id="event_price" value="<?php echo $event_price; ?/>"/> </div> < ?php } 

 //when saving the custom content type, save additional meta data public function save_custom_content_type($post_id){ //check for nonce if(!isset($_POST[$this->content_type_name . '_nonce_field'])){ return $post_id; } //verify nonce if(!wp_verify_nonce($_POST[$this->content_type_name . '_nonce_field'] , $this->content_type_name . '_nonce')){ return $post_id; } //check for autosaves if(defined('DOING_AUTOSAVE') && DOING_AUTOSAVE){ return $post_id; } //check if the user can edit if(!current_user_can('edit_posts')){ return $post_id; } //collect sanitized information $event_subtitle =sanitize_text_field($_POST['event_subtitle']); $event_start_date =sanitize_text_field($_POST['event_start_date']); $event_end_date = sanitize_text_field($_POST['event_end_date']); $event_start_time =sanitize_text_field($_POST['event_start_time']); $event_end_time = sanitize_text_field($_POST['event_end_time']); $event_location = sanitize_text_field(wpautop($_POST['event_location'])); $event_price = sanitize_text_field($_POST['event_price']); //save post meta update_post_meta($post_id,'event_subtitle',$event_subtitle); update_post_meta($post_id,'event_start_date',$event_start_date); update_post_meta($post_id,'event_end_date',$event_end_date); update_post_meta($post_id,'event_start_time',$event_start_time); update_post_meta($post_id,'event_end_time',$event_end_time); update_post_meta($post_id,'event_location',$event_location); update_post_meta($post_id,'event_price', $event_price); } 

 add_action('display_content_type_meta', array($this,'display_additional_meta_data')); //displays the saved content type meta info 

 //display additional meta information for the content type //@hooked using 'display_additional_meta_data' in theme function display_additional_meta_data(){ global $post, $post_type; //if we are on our custom post type if($post_type == $this->content_type_name){ //collect information $event_subtitle = get_post_meta($post->ID,'event_subtitle', true); $event_start_date = get_post_meta($post->ID,'event_start_date', true); $event_end_date = get_post_meta($post->ID,'event_end_date', true); $event_start_time = get_post_meta($post->ID,'event_start_time', true); $event_end_time = get_post_meta($post->ID,'event_end_time', true); $event_location = get_post_meta($post->ID,'event_location', true); $event_price = get_post_meta($post->ID,'event_price', true); $html = ''; if(!empty($event_subtitle)){ $html .= ' 
  '.  $ event_subtitle.  ' 
  «;
			 }
			 $ html. = ' 
  «;
				 $ html. = ' 
  Начало: '.  $ event_start_date.  '-'.  $ event_start_time.  ' 
  «;
				 $ html. = ' 
  Конец: '.  $ event_end_date.  '-'.  $ event_end_time.  ' 
  «;
			 если (! опорожнить (event_location $)) {
				 $ html. = ' 
  Расположение: '.  $ event_location.  ' 
  «;
			 }
			 если (! опорожнить ($ event_price)) {
				 $ html. = ' 
  Цена: '.  $ event_price.  ' 
  «;
			 }
			 $ html. = ' 
  «;
			
			 echo $ html;
			
		 }
		
	 } 

 /* * Admin Styles * Styling the back-end of our content type */ .field-container{ margin-bottom: 10px; } .field-container label{ display: block; margin-bottom: 5px; width: 100%; } .field-container input, .field-container textarea, .field-container select{ width: 100%; } 

 /* * Public Styles * Front end stytes to format our additional content meta */ .additional-meta{ margin-bottom: 15px; } .additional-meta .meta{ margin-bottom: 5px; } .additional-meta .meta span{ margin-left: 10px; } 

 /* * Admin Scripts * activates jQuery date picker and time picker on the backend */ jQuery(document).ready(function($){ //activate datepicker $('.admin-datepicker').datepicker(); //activate timepicker $('.admin-timepicker').timepicker(); });