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


/README.md:
--------------------------------------------------------------------------------
1 | # My Widget Plugin
2 | 
3 | Full code from the WPExplorer.com tutorial: [How To Create A Widget Plugin For WordPress](http://www.wpexplorer.com/create-widget-plugin-wordpress/)


--------------------------------------------------------------------------------
/my-widget-plugin.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /*
  3 | Plugin Name: My Widget Plugin
  4 | Plugin URI: http://www.wpexplorer.com/create-widget-plugin-wordpress/
  5 | Description: This plugin adds a custom widget.
  6 | Version: 1.0
  7 | Author: AJ Clarke
  8 | Author URI: http://www.wpexplorer.com/create-widget-plugin-wordpress/
  9 | License: GPL2
 10 | */
 11 | 
 12 | // The widget class
 13 | class My_Custom_Widget extends WP_Widget {
 14 | 
 15 | 	// Main constructor
 16 | 	public function __construct() {
 17 | 		parent::__construct(
 18 | 			'my_custom_widget',
 19 | 			__( 'My Custom Widget', 'text_domain' ),
 20 | 			array(
 21 | 				'customize_selective_refresh' => true,
 22 | 			)
 23 | 		);
 24 | 	}
 25 | 
 26 | 	// The widget form (for the backend )
 27 | 	public function form( $instance ) {
 28 | 
 29 | 		// Set widget defaults
 30 | 		$defaults = array(
 31 | 			'title'    => '',
 32 | 			'text'     => '',
 33 | 			'textarea' => '',
 34 | 			'checkbox' => '',
 35 | 			'select'   => '',
 36 | 		);
 37 | 		
 38 | 		// Parse current settings with defaults
 39 | 		extract( wp_parse_args( ( array ) $instance, $defaults ) ); ?>
 40 | 
 41 | 		<?php // Widget Title ?>
 42 | 		<p>
 43 | 			<label for="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>"><?php _e( 'Widget Title', 'text_domain' ); ?></label>
 44 | 			<input class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'title' ) ); ?>" type="text" value="<?php echo esc_attr( $title ); ?>" />
 45 | 		</p>
 46 | 
 47 | 		<?php // Text Field ?>
 48 | 		<p>
 49 | 			<label for="<?php echo esc_attr( $this->get_field_id( 'text' ) ); ?>"><?php _e( 'Text:', 'text_domain' ); ?></label>
 50 | 			<input class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'text' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'text' ) ); ?>" type="text" value="<?php echo esc_attr( $text ); ?>" />
 51 | 		</p>
 52 | 
 53 | 		<?php // Textarea Field ?>
 54 | 		<p>
 55 | 			<label for="<?php echo esc_attr( $this->get_field_id( 'textarea' ) ); ?>"><?php _e( 'Textarea:', 'text_domain' ); ?></label>
 56 | 			<textarea class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'textarea' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'textarea' ) ); ?>"><?php echo wp_kses_post( $textarea ); ?></textarea>
 57 | 		</p>
 58 | 
 59 | 		<?php // Checkbox ?>
 60 | 		<p>
 61 | 			<input id="<?php echo esc_attr( $this->get_field_id( 'checkbox' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'checkbox' ) ); ?>" type="checkbox" value="1" <?php checked( '1', $checkbox ); ?> />
 62 | 			<label for="<?php echo esc_attr( $this->get_field_id( 'checkbox' ) ); ?>"><?php _e( 'Checkbox', 'text_domain' ); ?></label>
 63 | 		</p>
 64 | 
 65 | 		<?php // Dropdown ?>
 66 | 		<p>
 67 | 			<label for="<?php echo $this->get_field_id( 'select' ); ?>"><?php _e( 'Select', 'text_domain' ); ?></label>
 68 | 			<select name="<?php echo $this->get_field_name( 'select' ); ?>" id="<?php echo $this->get_field_id( 'select' ); ?>" class="widefat">
 69 | 			<?php
 70 | 			// Your options array
 71 | 			$options = array(
 72 | 				''        => __( 'Select', 'text_domain' ),
 73 | 				'option_1' => __( 'Option 1', 'text_domain' ),
 74 | 				'option_2' => __( 'Option 2', 'text_domain' ),
 75 | 				'option_3' => __( 'Option 3', 'text_domain' ),
 76 | 			);
 77 | 
 78 | 			// Loop through options and add each one to the select dropdown
 79 | 			foreach ( $options as $key => $name ) {
 80 | 				echo '<option value="' . esc_attr( $key ) . '" id="' . esc_attr( $key ) . '" '. selected( $select, $key, false ) . '>'. $name . '</option>';
 81 | 
 82 | 			} ?>
 83 | 			</select>
 84 | 		</p>
 85 | 
 86 | 	<?php }
 87 | 
 88 | 	// Update widget settings
 89 | 	public function update( $new_instance, $old_instance ) {
 90 | 		$instance = $old_instance;
 91 | 		$instance['title']    = isset( $new_instance['title'] ) ? wp_strip_all_tags( $new_instance['title'] ) : '';
 92 | 		$instance['text']     = isset( $new_instance['text'] ) ? wp_strip_all_tags( $new_instance['text'] ) : '';
 93 | 		$instance['textarea'] = isset( $new_instance['textarea'] ) ? wp_kses_post( $new_instance['textarea'] ) : '';
 94 | 		$instance['checkbox'] = isset( $new_instance['checkbox'] ) ? 1 : false;
 95 | 		$instance['select']   = isset( $new_instance['select'] ) ? wp_strip_all_tags( $new_instance['select'] ) : '';
 96 | 		return $instance;
 97 | 	}
 98 | 
 99 | 	// Display the widget
100 | 	public function widget( $args, $instance ) {
101 | 
102 | 		extract( $args );
103 | 
104 | 		// Check the widget options
105 | 		$title    = isset( $instance['title'] ) ? apply_filters( 'widget_title', $instance['title'] ) : '';
106 | 		$text     = isset( $instance['text'] ) ? $instance['text'] : '';
107 | 		$textarea = isset( $instance['textarea'] ) ?$instance['textarea'] : '';
108 | 		$select   = isset( $instance['select'] ) ? $instance['select'] : '';
109 | 		$checkbox = ! empty( $instance['checkbox'] ) ? $instance['checkbox'] : false;
110 | 
111 | 		// WordPress core before_widget hook (always include )
112 | 		echo $before_widget;
113 | 
114 | 		// Display the widget
115 | 		echo '<div class="widget-text wp_widget_plugin_box">';
116 | 
117 | 			// Display widget title if defined
118 | 			if ( $title ) {
119 | 				echo $before_title . $title . $after_title;
120 | 			}
121 | 
122 | 			// Display text field
123 | 			if ( $text ) {
124 | 				echo '<p>' . $text . '</p>';
125 | 			}
126 | 
127 | 			// Display textarea field
128 | 			if ( $textarea ) {
129 | 				echo '<p>' . $textarea . '</p>';
130 | 			}
131 | 
132 | 			// Display select field
133 | 			if ( $select ) {
134 | 				echo '<p>' . $select . '</p>';
135 | 			}
136 | 
137 | 			// Display something if checkbox is true
138 | 			if ( $checkbox ) {
139 | 				echo '<p>Something awesome</p>';
140 | 			}
141 | 
142 | 		echo '</div>';
143 | 
144 | 		// WordPress core after_widget hook (always include )
145 | 		echo $after_widget;
146 | 
147 | 	}
148 | 
149 | }
150 | 
151 | // Register the widget
152 | function my_register_custom_widget() {
153 | 	register_widget( 'My_Custom_Widget' );
154 | }
155 | add_action( 'widgets_init', 'my_register_custom_widget' );


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