wp-widget-labels/widget-labels.php at master · maor/wp-widget-labels · GitHub

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
<?php
/*
Plugin Name: Widget Labels
Plugin URI:  https://wordpress.org/plugins/widget-labels/
Description: Add custom labels/titles to any WordPress widget.
Version:     1.1.2
Author:      Maor Chasen
Author URI:  https://generatewp.com/
Text Domain: widget-labels
*/


/**
 * Security check
 * Prevent direct access to the file.
 *
 * @since 1.1.0
 */
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}


/**
 * MC_Widget_Labels class.
 *
 * The main widget labels class.
 *
 * @since 1.0.0
 */
final class MC_Widget_Labels {

	/**
	 * Instance
	 *
	 * The current widget instance's settings.
	 *
	 * @since 1.0.0
	 * @access private
	 * @static
	 * @var array
	 */
	private static $instance;

	/**
	 * Instance
	 *
	 * @since 1.0.0
	 * @access public
	 * @static
	 */
	public static function instance() {
		if ( ! isset( self::$instance ) ) {
			self::$instance = new self;
			self::$instance->setup_actions();
		}
		return self::$instance;
	}

	/**
	 * Setup hooks
	 *
	 * Fire the plugin hooks.
	 *
	 * @since 1.0.0
	 * @access public
	 */
	public function setup_actions() {
		add_filter( 'widget_update_callback', 	array( $this, 'filter_widget_update_callback' ), 10, 2 );
		add_action( 'in_widget_form', 			array( $this, 'filter_in_widget_form' ), 10, 3 );
		add_action( 'admin_enqueue_scripts', 	array( $this, 'scripts_n_styles' ) );
		add_action( 'plugins_loaded',           array( $this, 'load_textdomain' ) );
	}

	/**
	 * Add Fields
	 *
	 * Adds fields to the widget form.
	 *
	 * @since 1.0.0
	 * @access public
	 *
	 * @param WP_Widget $widget   The current widget instance.
	 * @param bool      $return   Return null if new fields are added.
	 * @param array     $instance The current widget instance's settings.
	 *
	 * @return array
	 */
	public function filter_in_widget_form( $widget, $return, $instance ) {
		$field_value = ( array_key_exists( 'mc_widget_label', $instance ) ) ? $instance['mc_widget_label'] : '';
		?>
		<p>
			<label for="<?php echo esc_attr( sprintf( 'widget-%s-%s-mc_widget_label', $widget->id_base, $widget->number ) ); ?>"><?php esc_html_e( 'Widget Label:', 'widget-labels' ); ?></label>
			<input type="text" name="<?php echo esc_attr( "widget-{$widget->id_base}[{$widget->number}][mc_widget_label]" ); ?>" id="<?php echo esc_attr( "widget-{$widget->id_base}-{$widget->number}-mc_widget_label" ); ?>" value="<?php echo esc_attr( $field_value ); ?>" class="widefat">
			<br>
			<small><?php esc_html_e( 'This text will show up as the label for this widget.', 'widget-labels' ); ?></small>
		</p>
		<?php
	}

	/**
	 * Widget update
	 *
	 * Updates the Widget with the classes.
	 *
	 * @since 1.0.0
	 * @access public
	 *
	 * @param array $old_instance Array of old widget settings.
	 * @param array $new_instance Array of new widget settings.
	 *
	 * @return array
	 */
	public function filter_widget_update_callback( $old_instance, $new_instance ) {
		if ( ! empty( $new_instance['mc_widget_label'] ) ) {
			$old_instance['mc_widget_label'] = $new_instance['mc_widget_label'];
		} else {
			unset( $old_instance['mc_widget_label'] );
		}

		do_action( 'widget_labels_update', $old_instance, $new_instance );
		return $old_instance;
	}

	/**
	 * Load scripts
	 *
	 * Enqueues various "scripts n' styles" as I like to call it.
	 *
	 * @since 1.0.0
	 * @access public
	 */
	public function scripts_n_styles() {
		$screen = get_current_screen();

		// are we on the widgets page?
		if ( 'widgets' == $screen->id ) {
			wp_enqueue_script( 'mc-widget-labels', plugins_url( 'js/widget-labels.js', __FILE__ ), array( 'jquery' ), false, true );
		}
	}

	/**
	 * Load textdomain
	 *
	 * Internationalization - Load plugin translation files from api.wordpress.org.
	 *
	 * @since 1.1.0
	 * @access public
	 */
	public function load_textdomain() {
		load_plugin_textdomain( 'widget-labels' );
	}

}


function mc_widget_labels() {
	return MC_Widget_Labels::instance();
}
add_action( 'plugins_loaded', 'mc_widget_labels' );