├── README.md
├── extend-widgets-bundle
    ├── custom-fields
    │   └── better-text.class.php
    ├── extend-widgets-bundle.php
    └── extra-widgets
    │   ├── hello-world-widget
    │       ├── assets
    │       │   └── banner.svg
    │       ├── hello-world-widget.php
    │       ├── styles
    │       │   └── hello-world-widget-style.less
    │       └── tpl
    │       │   └── hello-world-widget-template.php
    │   ├── my-awesome-widget
    │       ├── images
    │       │   └── awesome_widget_banner.svg
    │       ├── my-awesome-widget.php
    │       ├── styles
    │       │   └── my-awesome-widget-style.less
    │       └── tpl
    │       │   └── my-awesome-widget-template.php
    │   └── my-custom-field-test-widget
    │       └── my-custom-field-test-widget.php
└── widget-form-fields-demo
    ├── widget-form-fields-demo.php
    └── widgets
        └── widget-form-fields
            └── widget-form-fields.php


/README.md:
--------------------------------------------------------------------------------
 1 | Developer docs code examples
 2 | ===============
 3 | 
 4 | Some code examples for developer documentation.
 5 | 
 6 | Here we will demonstrate various developer related concepts.
 7 | 
 8 | >These examples are meant to demonstrate how a WordPress plugin developer may use the [SiteOrigin Widgets Bundle](https://wordpress.org/plugins/so-widgets-bundle/) plugin as a framework for creating widgets. As such, they do not function as independent plugins, but rather as an extension of the Widgets Bundle plugin. That means the Widgets Bundle plugin must be installed and activated for these examples to work.
 9 | 
10 | >The so-dev-examples folder is not a plugin itself, but rather a container for a collection of individual example plugins. Currently, the collection consists of only two example plugins, but we will add to these in future.
11 | 
12 | >Inside so-dev-examples, the plugin folders each have the familiar plugin structure as put forth by WordPress [here](http://codex.wordpress.org/Writing_a_Plugin#Names.2C_Files.2C_and_Locations). If you copy any one of these folders into your plugins folder you should see the example widgets, assuming you have installed and activated the Widgets Bundle plugin.
13 | 


--------------------------------------------------------------------------------
/extend-widgets-bundle/custom-fields/better-text.class.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /**
 4 |  * Class My_Custom_Field_Better_Text
 5 |  */
 6 | class My_Custom_Field_Better_Text extends SiteOrigin_Widget_Field_Base {
 7 | 
 8 | 	/**
 9 | 	 * My custom property for doing custom things.
10 | 	 *
11 | 	 * @access protected
12 | 	 * @var mixed
13 | 	 */
14 | 	protected $my_property;
15 | 
16 | 	protected function render_field( $value, $instance ) {
17 | 		?>
18 | 		<input type="text" id="<?php echo $this->element_id ?>" name="<?php echo $this->element_name ?>"
19 | 		       value="<?php echo esc_attr( $value ); ?>"/>
20 | 		<?php
21 | 	}
22 | 
23 | 	protected function sanitize_field_input($value, $instance) {
24 | 		$sanitized_value = sanitize_text_field( $value );
25 | 		return $sanitized_value;
26 | 	}
27 | 
28 | 	protected function add_label_classes( $label_classes ) {
29 | 		$label_classes[] = 'my-custom-field-label-css-class';
30 | 		return $label_classes;
31 | 	}
32 | 
33 | 	protected function render_field_label($value, $instance) {
34 | 		?>
35 | 		<h1>My custom label rendering</h1>
36 | 		<?php
37 | 	}
38 | 	protected function render_before_field( $value, $instance ) {
39 | 		// This is to keep the default label rendering behaviour.
40 | 		parent::render_before_field( $value, $instance );
41 | 		// Add custom rendering here.
42 | 		$this->render_field_description();
43 | 	}
44 | 
45 | 	protected function render_after_field( $value, $instance ) {
46 | 		// Leave this blank so that the description is not rendered twice
47 | 	}
48 | }
49 | 


--------------------------------------------------------------------------------
/extend-widgets-bundle/extend-widgets-bundle.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 | Plugin Name: SiteOrigin Extend Widgets Bundle Plugin
 5 | Description: An example plugin to demonstrate extending the SiteOrigin Widgets Bundle.
 6 | Version: 0.1
 7 | Author: SiteOrigin
 8 | Author URI: http://siteorigin.com
 9 | License: GPL3
10 | License URI: https://www.gnu.org/licenses/gpl-3.0.txt
11 | */
12 | 
13 | function add_my_awesome_widgets_collection($folders){
14 | 	$folders[] = plugin_dir_path(__FILE__).'extra-widgets/';
15 | 	return $folders;
16 | }
17 | add_filter('siteorigin_widgets_widget_folders', 'add_my_awesome_widgets_collection');
18 | 
19 | function my_custom_fields_class_prefixes( $class_prefixes ) {
20 | 	$class_prefixes[] = 'My_Custom_Field_';
21 | 	return $class_prefixes;
22 | }
23 | add_filter( 'siteorigin_widgets_field_class_prefixes', 'my_custom_fields_class_prefixes' );
24 | 
25 | function my_custom_fields_class_paths( $class_paths ) {
26 | 	$class_paths[] = plugin_dir_path( __FILE__ ) . 'custom-fields/';
27 | 	return $class_paths;
28 | }
29 | add_filter( 'siteorigin_widgets_field_class_paths', 'my_custom_fields_class_paths' );


--------------------------------------------------------------------------------
/extend-widgets-bundle/extra-widgets/hello-world-widget/assets/banner.svg:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 2 | <!-- Created with Inkscape (http://www.inkscape.org/) -->
 3 | 
 4 | <svg
 5 |    xmlns:dc="http://purl.org/dc/elements/1.1/"
 6 |    xmlns:cc="http://creativecommons.org/ns#"
 7 |    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
 8 |    xmlns:svg="http://www.w3.org/2000/svg"
 9 |    xmlns="http://www.w3.org/2000/svg"
10 |    xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
11 |    xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
12 |    width="210mm"
13 |    height="297mm"
14 |    viewBox="0 0 744.09448819 1052.3622047"
15 |    id="svg2"
16 |    version="1.1"
17 |    inkscape:version="0.91 r13725"
18 |    sodipodi:docname="hello_world.svg">
19 |   <defs
20 |      id="defs4" />
21 |   <sodipodi:namedview
22 |      id="base"
23 |      pagecolor="#ffffff"
24 |      bordercolor="#666666"
25 |      borderopacity="1.0"
26 |      inkscape:pageopacity="0.0"
27 |      inkscape:pageshadow="2"
28 |      inkscape:zoom="0.35"
29 |      inkscape:cx="375"
30 |      inkscape:cy="520"
31 |      inkscape:document-units="px"
32 |      inkscape:current-layer="layer1"
33 |      showgrid="false"
34 |      inkscape:window-width="1920"
35 |      inkscape:window-height="1017"
36 |      inkscape:window-x="-8"
37 |      inkscape:window-y="-8"
38 |      inkscape:window-maximized="1" />
39 |   <metadata
40 |      id="metadata7">
41 |     <rdf:RDF>
42 |       <cc:Work
43 |          rdf:about="">
44 |         <dc:format>image/svg+xml</dc:format>
45 |         <dc:type
46 |            rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
47 |         <dc:title></dc:title>
48 |       </cc:Work>
49 |     </rdf:RDF>
50 |   </metadata>
51 |   <g
52 |      inkscape:label="Layer 1"
53 |      inkscape:groupmode="layer"
54 |      id="layer1">
55 |     <text
56 |        xml:space="preserve"
57 |        style="font-style:normal;font-weight:normal;font-size:268.584198px;line-height:125%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
58 |        x="2.8571417"
59 |        y="132.18733"
60 |        id="text3336"
61 |        sodipodi:linespacing="125%"><tspan
62 |          sodipodi:role="line"
63 |          id="tspan3338"
64 |          x="2.8571417"
65 |          y="132.18733"
66 |          style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:LilyUPC;-inkscape-font-specification:LilyUPC;fill:#ff0000">Hello</tspan><tspan
67 |          sodipodi:role="line"
68 |          x="2.8571417"
69 |          y="463.77466"
70 |          id="tspan3340"
71 |          style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:LilyUPC;-inkscape-font-specification:LilyUPC;fill:#ff0000">    World!</tspan></text>
72 |   </g>
73 | </svg>
74 | 


--------------------------------------------------------------------------------
/extend-widgets-bundle/extra-widgets/hello-world-widget/hello-world-widget.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 | Widget Name: Hello world widget
 5 | Description: An example widget which displays 'Hello world!'.
 6 | Author: Me
 7 | Author URI: http://example.com
 8 | */
 9 | 
10 | class Hello_World_Widget extends SiteOrigin_Widget {
11 | 	function __construct() {
12 | 
13 | 		parent::__construct(
14 | 			'hello-world-widget',
15 | 			__('Hello World Widget', 'hello-world-widget-text-domain'),
16 | 			array(
17 | 				'description' => __('A hello world widget.', 'hello-world-widget-text-domain'),
18 | 			),
19 | 			array(
20 | 
21 | 			),
22 | 			array(
23 | 				'text' => array(
24 | 					'type' => 'text',
25 | 					'label' => __('Hello world! goes here.', 'hello-world-widget-text-domain'),
26 | 					'default' => 'Hello world!'
27 | 				),
28 | 			),
29 | 			plugin_dir_path(__FILE__)
30 | 		);
31 | 	}
32 | 
33 | 	function get_template_name($instance) {
34 | 		return 'hello-world-widget-template';
35 | 	}
36 | 
37 | 	function get_style_name($instance) {
38 | 		return 'hello-world-widget-style';
39 | 	}
40 | 
41 | }
42 | 
43 | siteorigin_widget_register('hello-world-widget', __FILE__, 'Hello_World_Widget');


--------------------------------------------------------------------------------
/extend-widgets-bundle/extra-widgets/hello-world-widget/styles/hello-world-widget-style.less:
--------------------------------------------------------------------------------
1 | @import "../../../base/less/mixins";
2 | @import "path/to/some/file";
3 | 
4 | @a_variable: #41a9d5;
5 | 
6 | .a-class {
7 | }


--------------------------------------------------------------------------------
/extend-widgets-bundle/extra-widgets/hello-world-widget/tpl/hello-world-widget-template.php:
--------------------------------------------------------------------------------
1 | <div>
2 | 	<?php echo wp_kses_post($instance['text']) ?>
3 | </div>


--------------------------------------------------------------------------------
/extend-widgets-bundle/extra-widgets/my-awesome-widget/images/awesome_widget_banner.svg:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 2 | <!-- Created with Inkscape (http://www.inkscape.org/) -->
 3 | 
 4 | <svg
 5 |    xmlns:dc="http://purl.org/dc/elements/1.1/"
 6 |    xmlns:cc="http://creativecommons.org/ns#"
 7 |    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
 8 |    xmlns:svg="http://www.w3.org/2000/svg"
 9 |    xmlns="http://www.w3.org/2000/svg"
10 |    xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
11 |    xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
12 |    width="210mm"
13 |    height="297mm"
14 |    viewBox="0 0 744.09448819 1052.3622047"
15 |    id="svg2"
16 |    version="1.1"
17 |    inkscape:version="0.91 r13725"
18 |    sodipodi:docname="awesome_widget_banner.svg">
19 |   <defs
20 |      id="defs4" />
21 |   <sodipodi:namedview
22 |      id="base"
23 |      pagecolor="#ffffff"
24 |      bordercolor="#666666"
25 |      borderopacity="1.0"
26 |      inkscape:pageopacity="0.0"
27 |      inkscape:pageshadow="2"
28 |      inkscape:zoom="0.35"
29 |      inkscape:cx="375"
30 |      inkscape:cy="520"
31 |      inkscape:document-units="px"
32 |      inkscape:current-layer="layer1"
33 |      showgrid="false"
34 |      inkscape:window-width="1920"
35 |      inkscape:window-height="1017"
36 |      inkscape:window-x="-8"
37 |      inkscape:window-y="-8"
38 |      inkscape:window-maximized="1" />
39 |   <metadata
40 |      id="metadata7">
41 |     <rdf:RDF>
42 |       <cc:Work
43 |          rdf:about="">
44 |         <dc:format>image/svg+xml</dc:format>
45 |         <dc:type
46 |            rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
47 |         <dc:title></dc:title>
48 |       </cc:Work>
49 |     </rdf:RDF>
50 |   </metadata>
51 |   <g
52 |      inkscape:label="Layer 1"
53 |      inkscape:groupmode="layer"
54 |      id="layer1">
55 |     <text
56 |        xml:space="preserve"
57 |        style="font-style:normal;font-weight:normal;font-size:145.45222473px;line-height:125%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#005544;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;"
58 |        x="7.7404923"
59 |        y="531.37787"
60 |        id="text3354"
61 |        sodipodi:linespacing="125%"><tspan
62 |          sodipodi:role="line"
63 |          id="tspan3356"
64 |          x="7.7404923"
65 |          y="531.37787">Awesome!</tspan></text>
66 |     <path
67 |        sodipodi:type="star"
68 |        style="fill:#00ccff"
69 |        id="path3358"
70 |        sodipodi:sides="5"
71 |        sodipodi:cx="137.14285"
72 |        sodipodi:cy="189.50506"
73 |        sodipodi:r1="92.140091"
74 |        sodipodi:r2="46.070045"
75 |        sodipodi:arg1="1.4464413"
76 |        sodipodi:arg2="2.0747599"
77 |        inkscape:flatsided="false"
78 |        inkscape:rounded="0"
79 |        inkscape:randomized="0"
80 |        d="m 148.57143,280.93364 -33.67581,-51.08617 -61.174884,-1.2202 38.179435,-47.81409 -17.743596,-58.55784 57.271995,21.53544 50.20874,-34.97053 -2.7834,61.12372 48.77431,36.94486 -58.99223,16.2411 z"
81 |        inkscape:transform-center-x="-3.5316228"
82 |        inkscape:transform-center-y="5.3718788" />
83 |     <path
84 |        sodipodi:type="spiral"
85 |        style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
86 |        id="path3360"
87 |        sodipodi:cx="471.42856"
88 |        sodipodi:cy="883.79077"
89 |        sodipodi:expansion="1"
90 |        sodipodi:revolution="3"
91 |        sodipodi:radius="236.38432"
92 |        sodipodi:argument="-18.055611"
93 |        sodipodi:t0="0"
94 |        d="m 471.42856,883.79077 c 8.30865,8.45191 -7.29381,15.36976 -14.04762,13.80952 -18.30243,-4.22816 -21.0495,-27.74106 -13.57142,-41.90476 13.37653,-25.33555 47.57313,-28.02471 69.76191,-13.33332 32.56292,21.56021 35.20936,67.67522 13.09521,97.61905 -29.47469,39.91042 -87.87329,42.48343 -125.4762,12.85711 -47.31942,-37.28171 -49.80378,-108.11713 -12.619,-153.33334 45.03575,-54.76288 128.38677,-57.15093 181.19048,-12.38089 62.22734,52.75994 64.51492,148.67247 12.14279,209.04761 -60.46569,69.70545 -168.96892,71.89015 -236.90476,11.90465 -77.19301,-68.15923 -79.2732,-189.27287 -11.66658,-264.76186 75.8444,-84.68724 209.58239,-86.66196 292.61904,-11.42848 92.18642,83.52343 94.055,229.89602 11.19038,320.47614" />
95 |   </g>
96 | </svg>
97 | 


--------------------------------------------------------------------------------
/extend-widgets-bundle/extra-widgets/my-awesome-widget/my-awesome-widget.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 | Widget Name: My totally awesome widget
 5 | Description: An example widget which is totally awesome.
 6 | Author: Me
 7 | Author URI: http://example.com
 8 | */
 9 | 
10 | function my_awesome_widget_banner_img_src( $banner_url, $widget_meta ) {
11 | 	if( $widget_meta['ID'] == 'my-awesome-widget') {
12 | 		$banner_url = plugin_dir_url(__FILE__) . 'images/awesome_widget_banner.svg';
13 | 	}
14 | 	return $banner_url;
15 | }
16 | add_filter( 'siteorigin_widgets_widget_banner', 'my_awesome_widget_banner_img_src', 10, 2);
17 | 
18 | class My_Awesome_Widget extends SiteOrigin_Widget {
19 | 	function __construct() {
20 | 
21 | 		parent::__construct(
22 | 			'my-awesome-widget',
23 | 			__('My Awesome Widget', 'my-awesome-widget-text-domain'),
24 | 			array(
25 | 				'description' => __('A totally awesome widget.', 'my-awesome-widget-text-domain'),
26 | 			),
27 | 			array(
28 | 
29 | 			),
30 | 			array(
31 | 				'text' => array(
32 | 					'type' => 'text',
33 | 					'label' => __('Hello world! goes here.', 'my-awesome-widget-text-domain'),
34 | 					'default' => 'Hello world!'
35 | 				),
36 | 			),
37 | 			plugin_dir_path(__FILE__)
38 | 		);
39 | 	}
40 | 
41 | 	function get_template_name($instance) {
42 | 		return 'my-awesome-widget-template';
43 | 	}
44 | 
45 | 	function get_style_name($instance) {
46 | 		return 'my-awesome-widget-style';
47 | 	}
48 | }
49 | 
50 | siteorigin_widget_register('my-awesome-widget', __FILE__, 'My_Awesome_Widget');


--------------------------------------------------------------------------------
/extend-widgets-bundle/extra-widgets/my-awesome-widget/styles/my-awesome-widget-style.less:
--------------------------------------------------------------------------------
1 | @import "../../../../so-widgets-bundle/base/less/mixins";
2 | 
3 | @a_variable: #bada55;
4 | 
5 | .a-class {
6 | }


--------------------------------------------------------------------------------
/extend-widgets-bundle/extra-widgets/my-awesome-widget/tpl/my-awesome-widget-template.php:
--------------------------------------------------------------------------------
1 | <div>
2 | 	<?php echo wp_kses_post($instance['text']) ?>
3 | </div>


--------------------------------------------------------------------------------
/extend-widgets-bundle/extra-widgets/my-custom-field-test-widget/my-custom-field-test-widget.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 | Widget Name: My widget with my custom field
 5 | Description: An example widget which uses my custom field.
 6 | Author: Me
 7 | Author URI: http://example.com
 8 | */
 9 | 
10 | class My_Custom_Field_Test_Widget extends SiteOrigin_Widget {
11 | 	function __construct() {
12 | 
13 | 		parent::__construct(
14 | 			'my-custom-field-test-widget',
15 | 			__('My Custom Field Test Widget', 'my-custom-field-test-widget-text-domain'),
16 | 			array(
17 | 				'description' => __('A custom field widget.', 'my-custom-field-test-widget-text-domain'),
18 | 			),
19 | 			array(
20 | 
21 | 			),
22 | 			array(
23 | 				'text' => array(
24 | 					'type' => 'better-text',
25 | 					'my_property' => 'This is my custom property value',
26 | 					'label' => __( 'A better text field.', 'my-custom-field-test-widget-text-domain' ),
27 | 					'description' => __( 'A description for my custom text field.' ),
28 | 					'default' => 'Some better text.'
29 | 				),
30 | 			),
31 | 			plugin_dir_path(__FILE__)
32 | 		);
33 | 	}
34 | 
35 | 	function get_template_name($instance) {
36 | 		return '';
37 | 	}
38 | 
39 | 	function get_style_name($instance) {
40 | 		return '';
41 | 	}
42 | }
43 | 
44 | siteorigin_widget_register('my-custom-field-test-widget', __FILE__, 'My_Custom_Field_Test_Widget');


--------------------------------------------------------------------------------
/widget-form-fields-demo/widget-form-fields-demo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | /*
 4 | Plugin Name: SiteOrigin Widget Form Fields Demo Plugin
 5 | Description: An example plugin to demonstrate the widget form fields provided by the SiteOrigin Widgets Bundle.
 6 | Version: 0.1
 7 | Author: SiteOrigin
 8 | Author URI: http://siteorigin.com
 9 | License: GPL3
10 | License URI: https://www.gnu.org/licenses/gpl-3.0.txt
11 | */
12 | 
13 | function sow_form_fields_demo_add_widgets_folder($folders){
14 | 	$folders[] = plugin_dir_path(__FILE__).'widgets/';
15 | 	return $folders;
16 | }
17 | add_filter( 'siteorigin_widgets_widget_folders', 'sow_form_fields_demo_add_widgets_folder' );


--------------------------------------------------------------------------------
/widget-form-fields-demo/widgets/widget-form-fields/widget-form-fields.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | /*
  4 | Widget Name: Widget form fields
  5 | Description: An example widget with all the form fields.
  6 | Author: Me
  7 | Author URI: http://example.com
  8 | */
  9 | 
 10 | class Widget_Form_Fields extends SiteOrigin_Widget {
 11 | 	function __construct() {
 12 | 		$form_options = array(
 13 | 			'some_tinymce_editor' => array(
 14 | 				'type' => 'tinymce',
 15 | 				'label' => __( 'Visually edit, richly.', 'widget-form-fields-text-domain' ),
 16 | 				'default' => 'An example of a long message.</br>It is even possible to add a few html tags.</br><a href="siteorigin.com" target="_blank"">Links!</a>',
 17 | 				'rows' => 10,
 18 | 				'default_editor' => 'html',
 19 | 				'button_filters' => array(
 20 | 					'mce_buttons' => array( $this, 'filter_mce_buttons' ),
 21 | 					'mce_buttons_2' => array( $this, 'filter_mce_buttons_2' ),
 22 | 					'mce_buttons_3' => array( $this, 'filter_mce_buttons_3' ),
 23 | 					'mce_buttons_4' => array( $this, 'filter_mce_buttons_5' ),
 24 | 					'quicktags_settings' => array( $this, 'filter_quicktags_settings' ),
 25 | 				),
 26 | 			),
 27 | 			'some_text' => array(
 28 | 				'type' => 'text',
 29 | 				'label' => __( 'Some text goes here', 'widget-form-fields-text-domain' ),
 30 | 				'default' => 'Some default text.'
 31 | 			),
 32 | 			'some_url' => array(
 33 | 				'type' => 'link',
 34 | 				'label' => __('Some URL goes here', 'widget-form-fields-text-domain'),
 35 | 				'default' => 'http://www.example.com'
 36 | 			),
 37 | 			'some_color' => array(
 38 | 				'type' => 'color',
 39 | 				'label' => __( 'Choose a color', 'widget-form-fields-text-domain' ),
 40 | 				'default' => '#bada55'
 41 | 			),
 42 | 			'some_number' => array(
 43 | 				'type' => 'number',
 44 | 				'label' => __( 'Enter a number', 'widget-form-fields-text-domain' ),
 45 | 				'default' => '12654'
 46 | 			),
 47 | 			'some_long_message' => array(
 48 | 				'type' => 'textarea',
 49 | 				'label' => __( 'Type a message', 'widget-form-fields-text-domain' ),
 50 | 				'default' => 'An example of a long message.</br>It is even possible to add a few html tags.</br><a href="siteorigin.com" target="_blank"">Links!</a></br><strong>Strong</strong> and <em>emphasized</em> text.',
 51 | 				'rows' => 5
 52 | 			),
 53 | 			'some_number_in_a_range' => array(
 54 | 				'type' => 'slider',
 55 | 				'label' => __( 'Choose a number', 'widget-form-fields-text-domain' ),
 56 | 				'default' => 24,
 57 | 				'min' => 0,
 58 | 				'max' => 42
 59 | 			),
 60 | 			'some_selection' => array(
 61 | 				'type' => 'select',
 62 | 				'label' => __( 'Choose a thing from a long list of things', 'widget-form-fields-text-domain' ),
 63 | 				'default' => 'the_other_thing',
 64 | 				'options' => array(
 65 | 					'this_thing' => __( 'This thing', 'widget-form-fields-text-domain' ),
 66 | 					'that_thing' => __( 'That thing', 'widget-form-fields-text-domain' ),
 67 | 					'the_other_thing' => __( 'The other thing', 'widget-form-fields-text-domain' ),
 68 | 					'thing_1' => __( 'Thing One', 'widget-form-fields-text-domain' ),
 69 | 					'thing_2' => __( 'Thing Two', 'widget-form-fields-text-domain' ),
 70 | 					'thing_3' => __( 'Thing Three', 'widget-form-fields-text-domain' ),
 71 | 					'thing_4' => __( 'Thing Four', 'widget-form-fields-text-domain' ),
 72 | 					'thing_5' => __( 'Thing Five', 'widget-form-fields-text-domain' ),
 73 | 					'thing_6' => __( 'Thing Six', 'widget-form-fields-text-domain' ),
 74 | 					'thing_7' => __( 'Thing Seven', 'widget-form-fields-text-domain' ),
 75 | 					'thing_8' => __( 'Thing Eight', 'widget-form-fields-text-domain' ),
 76 | 					'thing_9' => __( 'Thing Nine', 'widget-form-fields-text-domain' ),
 77 | 					'thing_10' => __( 'Thing Ten', 'widget-form-fields-text-domain' ),
 78 | 				)
 79 | 			),
 80 | 			'some_multiple_selection' => array(
 81 | 				'type' => 'select',
 82 | 				'label' => __( 'Choose many things from a long list of things', 'widget-form-fields-text-domain' ),
 83 | 				'multiple' => true,
 84 | 				'default' => 'the_other_thing',
 85 | 				'options' => array(
 86 | 					'this_thing' => __( 'This thing', 'widget-form-fields-text-domain' ),
 87 | 					'that_thing' => __( 'That thing', 'widget-form-fields-text-domain' ),
 88 | 					'the_other_thing' => __( 'The other thing', 'widget-form-fields-text-domain' ),
 89 | 					'thing_1' => __( 'Thing One', 'widget-form-fields-text-domain' ),
 90 | 					'thing_2' => __( 'Thing Two', 'widget-form-fields-text-domain' ),
 91 | 					'thing_3' => __( 'Thing Three', 'widget-form-fields-text-domain' ),
 92 | 					'thing_4' => __( 'Thing Four', 'widget-form-fields-text-domain' ),
 93 | 					'thing_5' => __( 'Thing Five', 'widget-form-fields-text-domain' ),
 94 | 					'thing_6' => __( 'Thing Six', 'widget-form-fields-text-domain' ),
 95 | 					'thing_7' => __( 'Thing Seven', 'widget-form-fields-text-domain' ),
 96 | 					'thing_8' => __( 'Thing Eight', 'widget-form-fields-text-domain' ),
 97 | 					'thing_9' => __( 'Thing Nine', 'widget-form-fields-text-domain' ),
 98 | 					'thing_10' => __( 'Thing Ten', 'widget-form-fields-text-domain' ),
 99 | 				)
100 | 			),
101 | 			'another_selection' => array(
102 | 				'type' => 'select',
103 | 				'prompt' => __( 'Choose a thing from a long list of things', 'widget-form-fields-text-domain' ),
104 | 				'options' => array(
105 | 					'this_thing' => __( 'This thing', 'widget-form-fields-text-domain' ),
106 | 					'that_thing' => __( 'That thing', 'widget-form-fields-text-domain' ),
107 | 					'the_other_thing' => __( 'The other thing', 'widget-form-fields-text-domain' ),
108 | 					'thing_1' => __( 'Thing One', 'widget-form-fields-text-domain' ),
109 | 					'thing_2' => __( 'Thing Two', 'widget-form-fields-text-domain' ),
110 | 					'thing_3' => __( 'Thing Three', 'widget-form-fields-text-domain' ),
111 | 					'thing_4' => __( 'Thing Four', 'widget-form-fields-text-domain' ),
112 | 					'thing_5' => __( 'Thing Five', 'widget-form-fields-text-domain' ),
113 | 					'thing_6' => __( 'Thing Six', 'widget-form-fields-text-domain' ),
114 | 					'thing_7' => __( 'Thing Seven', 'widget-form-fields-text-domain' ),
115 | 					'thing_8' => __( 'Thing Eight', 'widget-form-fields-text-domain' ),
116 | 					'thing_9' => __( 'Thing Nine', 'widget-form-fields-text-domain' ),
117 | 					'thing_10' => __( 'Thing Ten', 'widget-form-fields-text-domain' ),
118 | 				)
119 | 			),
120 | 			'some_boolean' => array(
121 | 				'type' => 'checkbox',
122 | 				'label' => __( 'Allow this thing?', 'widget-form-fields-text-domain' ),
123 | 				'default' => true
124 | 			),
125 | 			'radio_selection' => array(
126 | 				'type' => 'radio',
127 | 				'label' => __( 'Choose a thing from a short list of things', 'widget-form-fields-text-domain' ),
128 | 				'default' => 'that_thing',
129 | 				'options' => array(
130 | 					'this_thing' => __( 'This thing', 'widget-form-fields-text-domain' ),
131 | 					'that_thing' => __( 'That thing', 'widget-form-fields-text-domain' ),
132 | 					'the_other_thing' => __( 'The other thing', 'widget-form-fields-text-domain' )
133 | 				)
134 | 			),
135 | 			'some_media' => array(
136 | 				'type' => 'media',
137 | 				'label' => __( 'Choose a media thing', 'widget-form-fields-text-domain' ),
138 | 				'choose' => __( 'Choose image', 'widget-form-fields-text-domain' ),
139 | 				'update' => __( 'Set image', 'widget-form-fields-text-domain' ),
140 | 				'library' => 'image',//'image', 'audio', 'video', 'file'
141 | 				'fallback' => true
142 | 			),
143 | 			'some_posts' => array(
144 | 				'type' => 'posts',
145 | 				'label' => __('Some posts query', 'widget-form-fields-text-domain'),
146 | 			),
147 | 			'a_section' => array(
148 | 				'type' => 'section',
149 | 				'label' => __( 'A section containing related fields.' , 'widget-form-fields-text-domain' ),
150 | 				'hide' => true,
151 | 				'fields' => array(
152 | 					'grouped_text' => array(
153 | 						'type' => 'text',
154 | 						'label' => __( 'A grouped text field', 'widget-form-fields-text-domain' )
155 | 					),
156 | 					'grouped_checkbox' => array(
157 | 						'type' => 'checkbox',
158 | 						'label' => __( 'A grouped checkbox', 'widget-form-fields-text-domain' )
159 | 					)
160 | 				)
161 | 			),
162 | 			'a_repeater' => array(
163 | 				'type' => 'repeater',
164 | 				'label' => __( 'A repeating repeater.' , 'widget-form-fields-text-domain' ),
165 | 				'item_name'  => __( 'Repeater item', 'siteorigin-widgets' ),
166 | 				'scroll_count' => 10,
167 | 				'item_label' => array(
168 | 					'selector'     => "[id*='repeat_text']",
169 | 					'update_event' => 'change',
170 | 					'value_method' => 'val'
171 | 				),
172 | 				'fields' => array(
173 | 					'repeat_text' => array(
174 | 						'type' => 'text',
175 | 						'label' => __( 'A text field in a repeater item.', 'widget-form-fields-text-domain' )
176 | 					),
177 | 					'repeat_checkbox' => array(
178 | 						'type' => 'checkbox',
179 | 						'label' => __( 'A checkbox in a repeater item.', 'widget-form-fields-text-domain' )
180 | 					)
181 | 				)
182 | 			),
183 | 			'some_widget' => array(
184 | 				'type' => 'widget',
185 | 				'label' => __( 'Button Widget', 'widget-form-fields-text-domain' ),
186 | 				'class' => 'SiteOrigin_Widget_Button_Widget',
187 | 				'hide' => true
188 | 			),
189 | 			'some_icon' => array(
190 | 				'type' => 'icon',
191 | 				'label' => __('Select an icon', 'widget-form-fields-text-domain'),
192 | 			),
193 | 			'some_font' => array(
194 | 				'type' => 'font',
195 | 				'label' => __('Select a font', 'widget-form-fields-text-domain'),
196 | 			),
197 | 			'some_date' => array(
198 | 				'type' => 'text',
199 | 				'label' => __( 'Some date goes here', 'widget-form-fields-text-domain' ),
200 | 				'sanitize' => 'date',
201 | 			),
202 | 		);
203 | 
204 | 		add_filter( 'siteorigin_widgets_sanitize_field_date', array( $this, 'sanitize_date' ) );
205 | 
206 | 		parent::__construct(
207 | 			'widget-form-fields',
208 | 			__('Widget Form Fields Example', 'widget-form-fields-text-domain'),
209 | 			array(
210 | 				'description' => __('A blank widget which simply demonstrates the use of all the widget admin form fields.', 'widget-form-fields-text-domain'),
211 | 			),
212 | 			array(),
213 | 			$form_options,
214 | 			plugin_dir_path(__FILE__)
215 | 		);
216 | 	}
217 | 
218 | 	function filter_mce_buttons( $buttons, $editor_id ) {
219 | 		if ( ( $key = array_search( 'fullscreen', $buttons ) ) !== false ||
220 | 		     ( $key = array_search( 'dfw', $buttons ) ) !== false) {
221 | 			unset($buttons[$key]);
222 | 		}
223 | 		return $buttons;
224 | 	}
225 | 
226 | 	function filter_mce_buttons_2( $buttons, $editor_id ) {
227 | 		if ( ( $key = array_search( 'fullscreen', $buttons ) ) !== false ||
228 | 		     ( $key = array_search( 'dfw', $buttons ) ) !== false) {
229 | 			unset($buttons[$key]);
230 | 		}
231 | 		return $buttons;
232 | 	}
233 | 
234 | 	function filter_mce_buttons_3( $buttons, $editor_id ) {
235 | 		if ( ( $key = array_search( 'fullscreen', $buttons ) ) !== false ||
236 | 		     ( $key = array_search( 'dfw', $buttons ) ) !== false) {
237 | 			unset($buttons[$key]);
238 | 		}
239 | 		return $buttons;
240 | 	}
241 | 
242 | 	function filter_mce_buttons_4( $buttons, $editor_id ) {
243 | 		if ( ( $key = array_search( 'fullscreen', $buttons ) ) !== false ||
244 | 		     ( $key = array_search( 'dfw', $buttons ) ) !== false) {
245 | 			unset($buttons[$key]);
246 | 		}
247 | 		return $buttons;
248 | 	}
249 | 
250 | 	public function quicktags_settings( $settings, $editor_id ) {
251 | 		$settings['buttons'] = preg_replace( '/,fullscreen/', '', $settings['buttons'] );
252 | 		$settings['buttons'] = preg_replace( '/,dfw/', '', $settings['buttons'] );
253 | 		return $settings;
254 | 	}
255 | 
256 | 	function sanitize_date( $date_to_sanitize ) {
257 | 		// Perform custom date sanitization here.
258 | 		$sanitized_date = sanitize_text_field( $date_to_sanitize );
259 | 		return $sanitized_date;
260 | 	}
261 | 
262 | 	function get_template_name($instance) {
263 | 		return '';
264 | 	}
265 | 
266 | 	function get_style_name($instance) {
267 | 		return '';
268 | 	}
269 | }
270 | 
271 | siteorigin_widget_register('widget-form-fields', __FILE__, 'Widget_Form_Fields');


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