Creating Custom WordPress Widget on certain pages

Recently I needed to create a Facebook likebox WordPress widget for my friend, which of course can be easily created using a WordPress text widget, but since my friend is new to WordPress and has no clue about coding, and to make matters worse, she wanted to display it only on certain pages like single and category pages! So, I decided to quickly create a custom WordPress Widget, which should be flexible enough for her needs. wordpress-widget-tutorialIf you are familiar with WordPress, then you must be familiar with its Widgets which you can drag around, and place it on sidebar or any other "widgetized" areas such as header and footer. It's one of many powerful features of WordPress, where you can add your own "stuffs" on fly.

Getting Started

You can create your own separate Widget Plugin, which can be installed and activated in your admin plugin page, but as many people, I prefer to put my widget code in default theme's functions.php file, which is located in your active theme folder i.e (/wp-content/themes/YOUR-THEME). This way our custom widget works perfectly and I don't need to install additional plugin.

Writing Basic Widget Code

Open your theme's function.php (Create if you don't find one), and copy/paste this PHP code anywhere within function.php and save the file. Now go back to your admin widget page, you should see "Facebook Likebox" widget in Available widget section. Just drag it to sidebar to see it in action.
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
//extend the standard WP_Widget class class facebook_likebox_widget extends WP_Widget { //construct widget names and descriptions public function __construct() { parent::__construct( 'facebook_likebox_widget', // Base ID __('Facebook LikeBox', 'text_domain'), // Name array( 'description' => __( 'Customized Facebook LikeBox Widget for your WordPress.', 'text_domain' ), ) // Args ); } //output widget content public function widget( $args, $instance ) { //facebook Likebox code echo $args['before_widget']; echo '<div class="fb-like-box" data-href="https://www.facebook.com/sanwebe" data-colorscheme="light" data-show-faces="true" data-header="true" data-stream="false" data-show-border="true"></div>'; echo '<div id="fb-root"></div>'; echo '<script>(function(d, s, id) {'; echo 'var js, fjs = d.getElementsByTagName(s)[0];'; echo 'if (d.getElementById(id)) return;'; echo 'js = d.createElement(s); js.id = id;'; echo 'js.src = "//connect.facebook.net/en_US/sdk.js#xfbml=1&appId=365936720119443&version=v2.0";'; echo 'fjs.parentNode.insertBefore(js, fjs);'; echo '}(document, \'script\', \'facebook-jssdk\'));</script>'; echo $args['after_widget']; } //option for admin public function form( $instance ) { //do stuff } // processes widget options to be saved public function update( $new_instance, $old_instance ) { //do stuff } } //register widget using the widgets_init add_action( 'widgets_init', 'reg_facebook_likebox_widget' ); function reg_facebook_likebox_widget() { register_widget( 'facebook_likebox_widget' ); }
As you can see it works like a charm, it displays Facebook Like Box as it should, but it's rather static. It doesn't have any user option in admin page nor it accepts any variable customization from a user, if we need to change anything, we need to change the hardcoded lines in function.php. So, to add more functionality to our Facebook Like Box widget, we need to understand how our code exactly works. If you review code above carefully you'll notice I've followed simple steps to achieve the widget functionality.
  1. Extend WP_Widget class as shown in code above.
    • function __construct() : Define widget name, desc in your Widget Class.
    • function widget() : HTML content output for your widget.
    • function form() : HTML options form for user in admin section.
    • function update() : This function saves options provided by user in option form.
  2. Register Widget using widgets_init.

Writing Customizable Widget

You can play with code above in your functions.php file, and when you think you are more comfortable, we can extend our Widget code further.Since our Facebook like widget will have many options, such as Facebook Page URL field, width, height fields and most importantly option to choose pages where user will be displaying the widget. I've made several changes in widget code adding HTML fields in function form(). I have also made changes in function update() and function widget() accordingly. You can see the changes in our complete Facebook Likebox widget code below:
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
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
class facebook_likebox_widget extends WP_Widget{ public function __construct() { parent::__construct( 'facebook_likebox_widget', // Base ID __('Facebook LikeBox', 'text_domain'), // Name array( 'description' => __( 'Customized Facebook LikeBox Widget for your WordPress.', 'text_domain' ), ) // Args ); } //output widget content public function widget( $args, $instance ) { //Display widget according to user settings $display_widget = false; if(is_front_page() && $instance['ifront_page']){ $display_widget = true; } if(is_page() && $instance['ipages']){ $display_widget = true; } if(is_tag() && $instance['itags']){ $display_widget = true; } if(is_category() && $instance['icats']){ $display_widget = true; } if(is_single() && $instance['iposts']){ $display_widget = true; } if($display_widget){ //output widget echo $args['before_widget']; if ( ! empty( $instance['title'] ) ) { echo $args['before_title'] . apply_filters( 'widget_title', $instance['title'] ). $args['after_title']; //title } $facebook_page_url = (!empty($instance['fb_page_url'])) ? $instance['fb_page_url'] : ''; //fb page url $fb_likebox_color = (!empty($instance['fb_likebox_color'])) ? 'data-colorscheme="'.$instance['fb_likebox_color'].'"' : 'data-colorscheme="light"'; //fb color scheme $ishow_face = ($instance['ishow_face']) ? 'data-show-faces="true"' : 'data-show-faces="false"'; //fb show faces $ishow_header = ($instance['ishow_header']) ? 'data-header="true"' : 'data-header="false"'; //fb show header $ishow_posts = ($instance['ishow_posts']) ? 'data-stream="true"' : 'data-stream="false"'; //fb show stream posts $ishow_border = ($instance['ishow_border']) ? 'data-show-border="true"' : 'data-show-border="false"'; //fb show border //facebook Likebox code echo '<div class="fb-like-box" data-href="'.$facebook_page_url.'" '.$fb_likebox_color.' '.$ishow_face.' '.$ishow_header.' '.$ishow_posts.' '.$ishow_border.'></div>'; echo '<div id="fb-root"></div>'; echo '<script>(function(d, s, id) {'; echo 'var js, fjs = d.getElementsByTagName(s)[0];'; echo 'if (d.getElementById(id)) return;'; echo 'js = d.createElement(s); js.id = id;'; echo 'js.src = "//connect.facebook.net/en_US/sdk.js#xfbml=1&appId=365936720119443&version=v2.0";'; echo 'fjs.parentNode.insertBefore(js, fjs);'; echo '}(document, \'script\', \'facebook-jssdk\'));</script>'; echo $args['after_widget']; } } //display options for widget admin public function form( $instance ){ //title of widget $title = (isset($instance[ 'title' ]))? $instance[ 'title' ] : __( 'New title', 'text_domain' ); echo '<p>'; echo '<label for="' .$this->get_field_id( 'title' ). '">' ._e( 'Title:' ). '</label> '; echo '<input class="widefat" id="'. $this->get_field_id( 'title' ) .'" name="'. $this->get_field_name( 'title' ) .'" type="text" value="'. esc_attr( $title ) .'">'; echo '</p>'; //Facebook Page URL $fb_page_url = (isset($instance[ 'fb_page_url' ]))? $instance[ 'fb_page_url' ] : __( 'http://www.facebook.com/sanwebe', 'text_domain' ); echo '<p>'; echo '<label for="' .$this->get_field_id( 'fb_page_url' ). '">' ._e( 'Facebook Page URL:' ). '</label> '; echo '<input class="widefat" id="'. $this->get_field_id( 'fb_page_url' ) .'" name="'. $this->get_field_name( 'fb_page_url' ) .'" type="text" value="'. esc_attr( $fb_page_url ) .'">'; echo '</p>'; //Facebook LikeBox Width $fb_likebox_width = (isset($instance[ 'fb_likebox_width' ]))? $instance[ 'fb_likebox_width' ] : __( '300', 'text_domain' ); echo '<p>'; echo '<label for="' .$this->get_field_id( 'fb_likebox_width' ). '">' ._e( 'LikeBox Width:' ). '</label> '; echo '<input class="widefat" id="'. $this->get_field_id( 'fb_likebox_width' ) .'" name="'. $this->get_field_name( 'fb_likebox_width' ) .'" type="text" value="'. esc_attr( $fb_likebox_width ) .'">'; echo '</p>'; //Facebook LikeBox Height $fb_likebox_height = (isset($instance[ 'fb_likebox_height' ]))? $instance[ 'fb_likebox_height' ] : __( '300', 'text_domain' ); echo '<p>'; echo '<label for="' .$this->get_field_id( 'fb_likebox_height' ). '">' ._e( 'LikeBox Height:' ). '</label> '; echo '<input class="widefat" id="'. $this->get_field_id( 'fb_likebox_height' ) .'" name="'. $this->get_field_name( 'fb_likebox_height' ) .'" type="text" value="'. esc_attr( $fb_likebox_height ) .'">'; echo '</p>'; //Facebook LikeBox Color Scheme $fb_likebox_color = (isset($instance[ 'fb_likebox_color' ]))? $instance[ 'fb_likebox_color' ] : ''; echo '<p>'; echo '<label for="' .$this->get_field_id( 'fb_likebox_color' ). '">' ._e( 'LikeBox Color Scheme:' ). '</label> '; echo '<select style="width: 100%;" id="'. $this->get_field_id( 'fb_likebox_color' ) .'" name="'. $this->get_field_name( 'fb_likebox_color' ) .'">'; echo '<option value="light">Light</option>'; if(esc_attr( $fb_likebox_color ) == "dark"){ echo '<option value="dark" selected>Dark</option>'; }else{ echo '<option value="dark">Dark</option>'; } echo '</select>'; echo '</p>'; //Facebook Customization options echo '<p>'; $ishow_face = ($instance[ 'ishow_face' ])? 'checked' : ''; $ishow_header = ($instance[ 'ishow_header' ])? 'checked' : ''; $ishow_posts = ($instance[ 'ishow_posts' ])? 'checked' : ''; $ishow_border = ($instance[ 'ishow_border' ])? 'checked' : ''; echo '<label>' ._e( 'Facebook Look:' ). '</label> '; echo '<ul>'; echo '<li><input class="widefat" name="'. $this->get_field_name( 'ishow_face' ) .'" type="checkbox" value="1" '.$ishow_face.'>Show Friends\' Faces</li>'; echo '<li><input class="widefat" name="'. $this->get_field_name( 'ishow_header' ) .'" type="checkbox" value="1" '.$ishow_header.'>Show Header</li>'; echo '<li><input class="widefat" name="'. $this->get_field_name( 'ishow_posts' ) .'" type="checkbox" value="1" '.$ishow_posts.'>Show Posts</li>'; echo '<li><input class="widefat" name="'. $this->get_field_name( 'ishow_border' ) .'" type="checkbox" value="1" '.$ishow_border.'> Show Border </li>'; echo '</ul>'; echo '</p>'; //Display Zones options echo '<p>'; $ifront_page = ($instance[ 'ifront_page' ])? 'checked' : ''; $ipages = ($instance[ 'ipages' ])? 'checked' : ''; $itags = ($instance[ 'itags' ])? 'checked' : ''; $icats = ($instance[ 'icats' ])? 'checked' : ''; $iposts = ($instance[ 'iposts' ])? 'checked' : ''; echo '<label>' ._e( 'Display Zones:' ). '</label> '; echo '<ul>'; echo '<li><input class="widefat" name="'. $this->get_field_name( 'ifront_page' ) .'" type="checkbox" value="1" '.$ifront_page.'>Front Page </li>'; echo '<li><input class="widefat" name="'. $this->get_field_name( 'ipages' ) .'" type="checkbox" value="1" '.$ipages.'>Pages </li>'; echo '<li><input class="widefat" name="'. $this->get_field_name( 'itags' ) .'" type="checkbox" value="1" '.$itags.'>Tagged Pages </li>'; echo '<li><input class="widefat" name="'. $this->get_field_name( 'icats' ) .'" type="checkbox" value="1" '.$icats.'> Category Pages </li>'; echo '<li><input class="widefat" name="'. $this->get_field_name( 'iposts' ) .'" type="checkbox" value="1" '.$iposts.'> Posts </li>'; echo '</ul>'; echo '</p>'; } //processes widget options to be saved public function update( $new_instance, $old_instance ){ $instance = array(); //We simply add values to $instance array for saving. $instance['title'] = ( ! empty( $new_instance['title'] ) ) ? strip_tags( $new_instance['title'] ) : ''; $instance['fb_page_url'] = ( ! empty( $new_instance['fb_page_url'] ) ) ? strip_tags( $new_instance['fb_page_url'] ) : ''; $instance['fb_likebox_width'] = ( ! empty( $new_instance['fb_likebox_width'] ) ) ? strip_tags( $new_instance['fb_likebox_width'] ) : ''; $instance['fb_likebox_height'] = ( ! empty( $new_instance['fb_likebox_height'] ) ) ? strip_tags( $new_instance['fb_likebox_height'] ) : ''; $instance['fb_likebox_color'] = ( ! empty( $new_instance['fb_likebox_color'] ) ) ? strip_tags( $new_instance['fb_likebox_color'] ) : ''; $instance['ishow_face'] = ( ! empty( $new_instance['ishow_face'] ) ) ? strip_tags( $new_instance['ishow_face'] ) : ''; $instance['ishow_header'] = ( ! empty( $new_instance['ishow_header'] ) ) ? strip_tags( $new_instance['ishow_header'] ) : ''; $instance['ishow_posts'] = ( ! empty( $new_instance['ishow_posts'] ) ) ? strip_tags( $new_instance['ishow_posts'] ) : ''; $instance['ishow_border'] = ( ! empty( $new_instance['ishow_border'] ) ) ? strip_tags( $new_instance['ishow_border'] ) : ''; $instance['ifront_page'] = ( ! empty( $new_instance['ifront_page'] ) ) ? strip_tags( $new_instance['ifront_page'] ) : ''; $instance['ipages'] = ( ! empty( $new_instance['ipages'] ) ) ? strip_tags( $new_instance['ipages'] ) : ''; $instance['itags'] = ( ! empty( $new_instance['itags'] ) ) ? strip_tags( $new_instance['itags'] ) : ''; $instance['icats'] = ( ! empty( $new_instance['icats'] ) ) ? strip_tags( $new_instance['icats'] ) : ''; $instance['iposts'] = ( ! empty( $new_instance['iposts'] ) ) ? strip_tags( $new_instance['iposts'] ) : ''; return $instance; } } //register widget using the widgets_init add_action( 'widgets_init', 'reg_facebook_likebox_widget' ); function reg_facebook_likebox_widget() { register_widget( 'facebook_likebox_widget' ); }
The function widget() simply displays anything we want, in our case the Facebook Like box code, which is HTML and Javascript code. But since we want to be able to feed it with different user options, such as page URL, height and width etc. We need a separate form fields in admin widget section, for that we use function form(), here I've added HTML fields for user options, and then using function update() we will save each values, which will be retrieve at function widget() to output customized widget.

Conclusion

Open your functions.php page in WordPress theme folder, copy/paste/save this code to see it in action, that's it! You should find a new widget called "Facebook Like Box" under the widget section. It should present to you with many options for your Facebook Like Box, good luck!
New question is currently disabled!