• Pagina inicial
  • Artigos
  • Em geral
  • Como criar um plug-in do WordPress com opção de widget de várias instâncias para uso na barra lateral ou no rodapé – pronto para usar o código do plug-in do WordPress

Como criar um plug-in do WordPress com opção de widget de várias instâncias para uso na barra lateral ou no rodapé – pronto para usar o código do plug-in do WordPress

Publicados: 2016-05-11

Plugin de widget de várias instâncias do WordPress - código de exemplo - dicas do Crunchify

WordPress Widget Múltiplas Instâncias / WordPress Custom Widget

Crunchify criou vários plugins do WordPress nos últimos anos. Um dos requisitos que recebemos para o nosso plugin Membros do Facebook é ter multiple instance do mesmo Widget porque os usuários podem querer o Plugin da Página do Facebook em sua Sidebar e também na seção Footer .

Enquanto trabalhamos com vários clientes nos últimos anos, criamos alguns plugins simples com opção de widget de várias instâncias.

Neste tutorial, examinaremos o código Sample ready-to-use WordPress Plugin que colocará o widget Facebook Page Plugin ao vivo na barra lateral e/ou rodapé do seu blog. Sinta-se à vontade para usar este código em seu plugin.

Vamos começar:

Passo 1

Eu costumo fazer todo o desenvolvimento Java e WordPress no Eclipse IDE. Então, siga o tutorial para configurar o kit de desenvolvimento PHP no Eclipse.

Crie o arquivo crunchify-plugin.php na pasta crunchify-plugin e coloque o código abaixo.

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' ) ;
 
?>

Vamos entender 4 linhas destacadas do código acima:

  1. função __construir()
    • Inicialize o plugin WordPress com Nome e Descrição
  2. widget de função pública($args, $instance)
    • Isto é o que mostra no seu Blog – saída do conteúdo do widget
  3. formulário de função pública($instância)
    • É aqui que você especifica as opções do WordPress Widget dentro Appearance -> Widgets
  4. função update($new_instance, $old_instance)
    • Ao clicar no botão Salvar – os valores das opções serão salvos

NOTE: a ação widgets_init chamará sua função crunchify_plugin que registers internamente o widget com o nome crunchify_widget .

Passo 2

Crie o arquivo readme.txt na mesma pasta crunchify-plugin com o conteúdo abaixo. Sinta-se à vontade para atualizá-lo conforme sua necessidade.

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

Etapa 3

Apenas para garantir que sua estrutura de pastas fique assim:

Estrutura de pastas de plug-in do WordPress - amostra pronta para usar código de widget de várias instâncias

Coloque a pasta crunchify-plugin na pasta plugins .

Passo-4 Como habilitar?

  • Vá para o Admin Panel do seu site
  • Clique em Plugins
  • Activate plugin Crunchify Plugin

Ativar o plug-in do WordPress

Etapa-5 Opções do Plugin de Configuração

  • Clique em Appearance -> Widgets
  • Escolha Crunchify Plugin e coloque-o na Sidebar ou no Footer
  • Atualize as opções e clique em save

Passo-6 Como verificar?

Coloquei dois widgets com opções diferentes.

Multi Instance - Plugin Crunchify - Demonstração ao vivo

Você deve ver multiple instances of same Crunchify Plugin que emite um belo plug- Facebook Page Plugin na sua barra lateral ou rodapé, conforme sua configuração.