Введение в разработку плагинов WordPress

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

Что такое плагины для WordPress?

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

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

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

Сильные стороны, слабые стороны и соображения

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

Сильные стороны

• Вы можете добавить плагины практически с любой темой и ожидать, что она будет работать правильно. Плагины были созданы, чтобы быть модульными, чтобы вы могли скопировать в новый проект (или распространять), и это здорово.
• Плагин действует как контейнер для всего вашего кода и элементов. Если вы создадите подобную функциональность в теме, вы можете смешать элементы. С плагином все, что нужно для функционирования, существует в одном пакете.
• Их легко сделать, и они могут воспользоваться преимуществами действий и фильтров WordPress.
• Может быть легко создан объектно-ориентированным способом, создавая более надежный и управляемый код.

Слабые стороны

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

Основные понятия — действия, фильтры, шорткоды, виджеты и многое другое

Давайте немного поговорим о некоторых ключевых аспектах разработки плагинов.

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

Действия (Крючки)

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

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

Все действия определяются с помощью функции do_action() . Эта функция принимает следующие параметры

• $tag (обязательно)
• $args (необязательно, одна или несколько переменных)

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

Простое действие WordPress

Давайте рассмотрим save_post действия save_post . Это действие принимает четыре значения. Первое значение — это имя действия, а остальные три — дополнительные переменные, к которым можно получить доступ (содержащие идентификатор сообщения, сам объект сообщения, а также, если сообщения существуют и обновляются).

 //the save_post action hook do_action( `save_post` , $post_ID , $post , $update ); 

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

 // create a new action to be used after our page title do_action( 'page_subtitle' , $post); 

 //when 'save_post' is triggered, call our saving function add_action( 'save_post' , 'save_my_custom_post' ); //defines our function that will handle our saving function save_my_custom_post ( $post_id ) { //you will do your saving here } 

 //the save post action, defined in WordPress do_action( 'save_post' , $post_ID, $post, $update ); //add our function onto the ' save_post ' hook , supplying priority and args add_action ('save_post','save_my_page_extended,10,3) ; // function executed on save (we want all three variables) function save_my_page_extended ($post_ID, $post, $update) { //access all of our variables to do some work } 

 //get the except for a post, as defined in /wp-includes/post-template.php echo apply_filters( 'the_excerpt' , get_the_excerpt() ); 

 //make our name value array filterable $name_values = apply_filters( 'filter_name_array_values' , array ( 'Joanna' , 'Peter' ) ); 

 //Change the saved name values by filtering them function add_new_names ( $names ) { $names [] = 'Simon' ; return $names ; } add_filter( 'filter_name_array_values' , 'add_new_names' ); 

 //Add our shortcode add_shortcode( 'test_shortcode' , 'my_shortcode_output' ); //perform the shortcode output function my_shortcode_output ( $atts , $content = '' , $tag ) { $html = '' ; $html .= '<p>Hello World</p>' ; return $html ; } 

 //class for our widget class my_widget extends WP_widget { //constructor (sets basic elements for the widget) public function __construct () { parent ::__construct( 'my_widget' , // Base ID 'My Widget' , // Name array ( 'description' => 'An awesome widget' ) // Args ); add_action( 'widgets_init' , array ( $this , 'register_widget' )); } //handles front end display public function widget ( $args , $instance ) { echo $args [ 'before_widget' ]; echo $instance [ 'title' ]; echo $args [ 'after_widget' ]; } //handles back end widget display public function form ( $instance ) { $title = ( isset ( $instance [ 'title' ]) ? $instance [ 'title' ] : '' ); echo '<input type="text" id="' . $this ->get_field_id( 'title' ) . '" name="' . $this ->get_field_name( 'title' ) . '" value="' . $title . '"/>' ; } //handles saving public function save ( $new_instance , $old_instance ) { $instance = array (); $title = $new_instance [ 'title' ]; return $instance ; } //registers the widget with WordPress public function register_widget () { register_widget( 'my_widget' ); } } $my_widget = new my_widget;