├── README.md
└── example-widget-plugin.php


/README.md:
--------------------------------------------------------------------------------
1 | # Example Widget Plugin
2 | 
3 | This simple WordPress plugin creates a widget which display the widget title, site title, and tagline in any widget area. This plugin was created to illustrate basic use of the `WP_Widget` class to create WordPress widgets and is discussed in an article published at the [WPMU DEV blog](https://premium.wpmudev.org/blog/?p=160800).
4 | 
5 | To use the plugin go to the releases tab and download the latest release.


--------------------------------------------------------------------------------
/example-widget-plugin.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | /**
 3 |  * Plugin Name:   Example Widget Plugin
 4 |  * Plugin URI:    https://jonpenland.com
 5 |  * Description:   Adds an example widget that displays the site title and tagline in a widget area.
 6 |  * Version:       1.0
 7 |  * Author:        Jon Penland
 8 |  * Author URI:    https://www.jonpenland.com
 9 |  */
10 | 
11 | class jpen_Example_Widget extends WP_Widget {
12 | 
13 | 
14 |   // Set up the widget name and description.
15 |   public function __construct() {
16 |     $widget_options = array( 'classname' => 'example_widget', 'description' => 'This is an Example Widget' );
17 |     parent::__construct( 'example_widget', 'Example Widget', $widget_options );
18 |   }
19 | 
20 | 
21 |   // Create the widget output.
22 |   public function widget( $args, $instance ) {
23 |     $title = apply_filters( 'widget_title', $instance[ 'title' ] );
24 |     $blog_title = get_bloginfo( 'name' );
25 |     $tagline = get_bloginfo( 'description' );
26 | 
27 |     echo $args['before_widget'] . $args['before_title'] . $title . $args['after_title']; ?>
28 |     <p><strong>Site Name:</strong> <?php echo $blog_title ?></p>
29 |     <p><strong>Tagline:</strong> <?php echo $tagline ?></p>
30 |     <?php echo $args['after_widget'];
31 |   }
32 | 
33 |   
34 |   // Create the admin area widget settings form.
35 |   public function form( $instance ) {
36 |     $title = ! empty( $instance['title'] ) ? $instance['title'] : ''; ?>
37 |     <p>
38 |       <label for="<?php echo $this->get_field_id( 'title' ); ?>">Title:</label>
39 |       <input type="text" id="<?php echo $this->get_field_id( 'title' ); ?>" name="<?php echo $this->get_field_name( 'title' ); ?>" value="<?php echo esc_attr( $title ); ?>" />
40 |     </p><?php
41 |   }
42 | 
43 | 
44 |   // Apply settings to the widget instance.
45 |   public function update( $new_instance, $old_instance ) {
46 |     $instance = $old_instance;
47 |     $instance[ 'title' ] = strip_tags( $new_instance[ 'title' ] );
48 |     return $instance;
49 |   }
50 | 
51 | }
52 | 
53 | // Register the widget.
54 | function jpen_register_example_widget() { 
55 |   register_widget( 'jpen_Example_Widget' );
56 | }
57 | add_action( 'widgets_init', 'jpen_register_example_widget' );
58 | 
59 | ?>


--------------------------------------------------------------------------------