• Домашняя страница
  • Статьи
  • Общий
  • Как создать плагин WordPress с опцией многоэкземплярного виджета для боковой панели или нижнего колонтитула — готовый код плагина WordPress

Как создать плагин WordPress с опцией многоэкземплярного виджета для боковой панели или нижнего колонтитула — готовый код плагина WordPress

Опубликовано: 2016-05-11

Плагин многоэкземплярного виджета WordPress — пример кода — Crunchify Tips

Несколько экземпляров виджета WordPress / Пользовательский виджет WordPress

За последние несколько лет Crunchify создал несколько плагинов для WordPress. Одним из требований, которые мы получили для нашего плагина Facebook Members, является наличие multiple instance одного и того же виджета, потому что пользователи могут захотеть добавить плагин страницы Facebook в свою Sidebar , а также в раздел Footer .

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

В этом уроке мы рассмотрим Sample ready-to-use WordPress Plugin , который поместит живой виджет Facebook Page Plugin на боковую панель и/или нижний колонтитул вашего блога. Не стесняйтесь использовать этот код в своем плагине.

Давайте начнем:

Шаг 1

Я обычно делаю все разработки для Java и WordPress в Eclipse IDE. Итак, следуйте руководству по настройке комплекта разработки PHP в Eclipse.

Создайте файл crunchify-plugin.php в crunchify-plugin и поместите ниже код.

crunchify-plugin.php
PHP
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
<?php
/*
* Plugin Name: Crunchify Plugin
* Plugin URI: https://crunchify.com/
* Description: The Simplest Ready to use WordPress Plugin with Multiple Instance of the same Widgets option - by Crunchify
* Version: 1.0
* Author: Crunchify
* Author URI: https://crunchify.com
* Text Domain: crunchify-plugin
*/
 
class crunchify_widget extends WP_Widget
{
// Create Multiple WordPress Widgets
     function __construct ( )
     {
         parent : : __construct ( 'crunchify_widget' , __ ( 'Crunchify Plugin' , 'crunchify_plugin_domain' ) , array (
             'description' = > __ ( 'Sample WordPress Plugin by Crunchify' , 'crunchify_plugin_domain' )
         ) ) ;
     }
    
     // This function creates nice Facebook Page Like box in Header or Footer
     public function widget ( $args , $instance )
     {
         $crunchify_facebook_url        = apply_filters ( 'crunchify_facebook_url' , $instance [ 'crunchify_facebook_url' ] ) ;
         $crunchify_facebook_hidecover = $instance [ 'crunchify_facebook_hidecover' ] ? 'true' : 'false' ;
         $crunchify_facebook_showface   = $instance [ 'crunchify_facebook_showface' ] ? 'true' : 'false' ;
        
         $facebookpage = '<div><iframe src="//www.facebook.com/plugins/page.php?href=' . $crunchify_facebook_url . '&amp;tabs=&amp;width=300&amp;height=220&amp;small_header=false&amp;adapt_container_width=true&amp;hide_cover=' . $crunchify_facebook_hidecover . '&amp;show_facepile=' . $crunchify_facebook_showface . '&amp;show_border=false&amp;header=false" scrolling="no" frameborder="0" allowTransparency="true"></iframe></div>' ;
        
         echo $before_widget ;
         echo $before_title . $after_title ;
         echo $facebookpage ;
         echo $after_widget ;
     }
    
     // Create Instance and Assign Values
     public function form ( $instance )
     {
         if ( isset ( $instance [ 'crunchify_facebook_url' ] ) ) {
             $crunchify_facebook_url = $instance [ 'crunchify_facebook_url' ] ;
         } else {
             $crunchify_facebook_url = __ ( 'https://facebook.com/Crunchify' , 'crunchify_plugin_domain' ) ;
         }
        
         $instance [ 'crunchify_facebook_hidecover' ] = $instance [ 'crunchify_facebook_hidecover' ] ? 'true' : 'false' ;
         $instance [ 'crunchify_facebook_showface' ]   = $instance [ 'crunchify_facebook_showface' ] ? 'true' : 'false' ;
        
?>
 
< ! --   This is Crunchify Widget Form -- >
< p >
 
< label for = " <?php echo $this - > get_field_id ( 'crunchify_facebook_url' ) ; ?> " > <?php _e ( 'Facebook Page URL' ) ; ?> < / label >
< input class = "widefat" id = " <?php echo $this - > get_field_id ( 'crunchify_facebook_url' ) ; ?> " name = " <?php echo $this - > get_field_name ( 'crunchify_facebook_url' ) ; ?> " type = "text" value = " <?php echo esc_attr ( $crunchify_facebook_url ) ; ?> " / >
 
< br / > < br / >
< label for = " <?php echo $this - > get_field_id ( 'crunchify_facebook_hidecover' ) ; ?> " > <?php _e ( 'Hide Cover?' ) ; ?> < / label >
< input class = "checkbox" type = "checkbox" <?php checked ( $instance [ 'crunchify_facebook_hidecover' ] , 'true' ) ; ?> id = " <?php echo $this - > get_field_id ( 'crunchify_facebook_hidecover' ) ; ?> " name = " <?php echo $this - > get_field_name ( 'crunchify_facebook_hidecover' ) ; ?> " / >
 
< br / > < br / >
< label for = " <?php echo $this - > get_field_id ( 'crunchify_facebook_showface' ) ; ?> " > <?php _e ( 'Show Facepile?' ) ; ?> < / label >
< input class = "checkbox" type = "checkbox" <?php checked ( $instance [ 'crunchify_facebook_showface' ] , 'true' ) ; ?> id = " <?php echo $this - > get_field_id ( 'crunchify_facebook_showface' ) ; ?> " name = " <?php echo $this - > get_field_name ( 'crunchify_facebook_showface' ) ; ?> " / >
 
< / p >
 
<?php
     }
    
     // Updating widget replacing old instances with new
     function update ( $new_instance , $old_instance )
     {
     $instance                            = array ( ) ;
     $instance [ 'crunchify_facebook_url' ] = ( ! empty ( $new_instance [ 'crunchify_facebook_url' ] ) ) ? strip_tags ( $new_instance [ 'crunchify_facebook_url' ] ) : '' ;
    
     $instance [ 'crunchify_facebook_hidecover' ] = $new_instance [ 'crunchify_facebook_hidecover' ] ;
     $instance [ 'crunchify_facebook_showface' ]   = $new_instance [ 'crunchify_facebook_showface' ] ;
     return $instance ;
     }
}
 
function crunchify_plugin ( )
{
     register_widget ( 'crunchify_widget' ) ;
}
 
// Initialize Plugin
add_action ( 'widgets_init' , 'crunchify_plugin' ) ;
 
?>

Давайте разберемся с 4 выделенными строками кода выше:

  1. функция __construct()
    • Инициализируйте плагин WordPress с именем и описанием
  2. виджет публичной функции ($args, $instance)
    • Это то, что отображается в вашем блоге — вывод содержимого виджета
  3. форма публичной функции ($ экземпляр)
    • Здесь вы указываете параметры виджета WordPress внутри Appearance » -> Widgets ».
  4. обновление функции ($ new_instance, $ old_instance)
    • Когда вы нажимаете кнопку «Сохранить» — значения параметров будут сохранены.

NOTE: действие widgets_init вызовет вашу функцию crunchify_plugin , которая внутренне registers виджет с именем crunchify_widget .

Шаг 2

Создайте файл readme.txt в той же crunchify-plugin с приведенным ниже содержимым. Не стесняйтесь обновлять его в соответствии с вашими потребностями.

readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
=== Crunchify Plugin ===
Contributors : Crunchify
Tags : WordPress , WordPress Plugins , Crunchify ,    multiple widgets
Requires at least : 4.3
Tested up to : 4.5.2
Stable tag : 1.0
 
The simplest ready to use WordPress Plugin with Multiple Instance of the same Widgets option - by Crunchify . com
 
== Description ==
 
Sample WordPress Plugin which creates Multiple Widgets for your plugin .
 
[ Feedback ] ( https : //crunchify.com/) | [Twitter](https://twitter.com/Crunchify)
 
== Installation ==
1. Unpack the ` download - package ` .
2. Upload the file to the ` / wp - content / plugins / ` directory .
3. Activate the plugin through the ` Plugins ` menu in WordPress .
4. Go to Appearance - > Widgets Section - > Select Plugin ` Crunchify Plugin ` .
5. Done and Ready .
 
== Frequently Asked Questions ==
 
= FAQ1 =
* Your Answer1 .
 
= Where do I get latest updates on plugin ? =
* On < a href = "http://twitter.com/Crunchify" target = "_blank" > Twitter < / a > and < a href = "http://www.facebook.com/Crunchify" target = "_blank" > Facebook < / a > .
 
== Screenshots ==
1. Screenshot1 details
2. Screenshot2 details
 
== Changelog ==
 
= 1.0 =
* Initial Working Version

Шаг 3

Просто чтобы убедиться, что ваша структура папок должна выглядеть так:

Структура папки плагина WordPress — пример готового к использованию кода виджета с несколькими экземплярами

Поместите crunchify-plugin в папку с plugins .

Шаг 4 Как включить?

  • Зайдите в Admin Panel вашего сайта
  • Нажмите на Plugins
  • Activate плагин Crunchify Plugin

Активировать плагин WordPress

Шаг 5. Настройка параметров плагина

  • Нажмите Appearance -> Widgets
  • Выберите плагин Widget Crunchify Plugin и поместите его под боковую Sidebar или Footer
  • Обновите параметры и нажмите save

Шаг 6 Как проверить?

Я разместил два виджета с разными параметрами.

Мультиэкземпляр - Плагин Crunchify - Живая демонстрация

Вы должны увидеть multiple instances of same Crunchify Plugin , который создает хороший Facebook Page Plugin на боковой панели или в нижнем колонтитуле в соответствии с вашими настройками.