class-jetpack-gallery-settings.php at 14.2 · Jetpack – WP Security, Backup, Speed, & Growth

jetpack / class-jetpack-gallery-settings.php

class-jetpack-gallery-settings.php

120 lines 3.4 KB

Raw Download Zip

1	<?php
2	/**
3	* Adding extra functions for the gallery.
4	*
5	* @package automattic/jetpack
6	*/
7
8	use Automattic\Jetpack\Assets;
9
10	/**
11	* Renders extra controls in the Gallery Settings section of the new media UI.
12	*/
13	class Jetpack_Gallery_Settings {
14	/**
15	* Available gallery types.
16	*
17	* @var array
18	*/
19	public $gallery_types;
20
21	/**
22	* The constructor.
23	*/
24	public function __construct() {
25	add_action( 'admin_init', array( $this, 'admin_init' ) );
26	}
27
28	/**
29	* Initialize the admin resources.
30	*/
31	public function admin_init() {
32	/**
33	* Filter the available gallery types.
34	*
35	* @module shortcodes, tiled-gallery
36	*
37	* @since 2.5.1
38	*
39	* @param array $value Array of the default thumbnail grid gallery type. Default array contains one key, ‘default’.
40	*/
41	$this->gallery_types = apply_filters( 'jetpack_gallery_types', array( 'default' => __( 'Thumbnail Grid', 'jetpack' ) ) );
42
43	// Enqueue the media UI only if needed.
44	if ( is_countable( $this->gallery_types ) && count( $this->gallery_types ) > 1 ) {
45	add_action( 'wp_enqueue_media', array( $this, 'wp_enqueue_media' ) );
46	add_action( 'print_media_templates', array( $this, 'print_media_templates' ) );
47	}
48	// Add Slideshow and Galleries functionality to core's media gallery widget.
49	add_filter( 'widget_media_gallery_instance_schema', array( $this, 'core_media_widget_compat' ) );
50	}
51
52	/**
53	* Updates the schema of the core gallery widget so we can save the
54	* fields that we add to Gallery Widgets, like `type` and `conditions`
55	*
56	* @param array $schema The current schema for the core gallery widget.
57	* @return array the updated schema
58	*/
59	public function core_media_widget_compat( $schema ) {
60	$schema['type'] = array(
61	'type' => 'string',
62	'enum' => array_keys( $this->gallery_types ),
63	'description' => __( 'Type of gallery.', 'jetpack' ),
64	'default' => 'default',
65	);
66	return $schema;
67	}
68
69	/**
70	* Registers/enqueues the gallery settings admin js.
71	*/
72	public function wp_enqueue_media() {
73	if ( ! wp_script_is( 'jetpack-gallery-settings', 'registered' ) ) {
74	/**
75	* This only happens if we're not in Jetpack, but on WPCOM instead.
76	* This is the correct path for WPCOM.
77	*/
78	wp_register_script(
79	'jetpack-gallery-settings',
80	Assets::get_file_url_for_environment( '_inc/build/gallery-settings.min.js', '_inc/gallery-settings.js' ),
81	array( 'jquery', 'media-views' ),
82	'20121225',
83	false
84	);
85	}
86
87	wp_enqueue_script( 'jetpack-gallery-settings' );
88	}
89
90	/**
91	* Outputs a view template which can be used with wp.media.template
92	*/
93	public function print_media_templates() {
94	/**
95	* Filter the default gallery type.
96	*
97	* @module tiled-gallery
98	*
99	* @since 2.5.1
100	*
101	* @param string $value A string of the gallery type. Default is ‘default’.
102	*/
103	$default_gallery_type = apply_filters( 'jetpack_default_gallery_type', 'default' );
104
105	?>
106	<script type="text/html" id="tmpl-jetpack-gallery-settings">
107	<label class="setting">
108	<span><?php esc_html_e( 'Type', 'jetpack' ); ?></span>
109	<select class="type" name="type" data-setting="type">
110	<?php foreach ( $this->gallery_types as $value => $caption ) : ?>
111	<option value="<?php echo esc_attr( $value ); ?>" <?php selected( $value, $default_gallery_type ); ?>><?php echo esc_html( $caption ); ?></option>
112	<?php endforeach; ?>
113	</select>
114	</label>
115	</script>
116	<?php
117	}
118	}
119	new Jetpack_Gallery_Settings();
120