wp/wp-includes/customize/class-wp-customize-themes-section.php
changeset 7 cf61fcea0001
child 9 177826044cd9
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/wp/wp-includes/customize/class-wp-customize-themes-section.php	Mon Oct 14 17:39:30 2019 +0200
@@ -0,0 +1,175 @@
+<?php
+/**
+ * Customize API: WP_Customize_Themes_Section class
+ *
+ * @package WordPress
+ * @subpackage Customize
+ * @since 4.4.0
+ */
+
+/**
+ * Customize Themes Section class.
+ *
+ * A UI container for theme controls, which are displayed within sections.
+ *
+ * @since 4.2.0
+ *
+ * @see WP_Customize_Section
+ */
+class WP_Customize_Themes_Section extends WP_Customize_Section {
+
+	/**
+	 * Section type.
+	 *
+	 * @since 4.2.0
+	 * @var string
+	 */
+	public $type = 'themes';
+
+	/**
+	 * Theme section action.
+	 *
+	 * Defines the type of themes to load (installed, wporg, etc.).
+	 *
+	 * @since 4.9.0
+	 * @var string
+	 */
+	public $action = '';
+
+	/**
+	 * Theme section filter type.
+	 *
+	 * Determines whether filters are applied to loaded (local) themes or by initiating a new remote query (remote).
+	 * When filtering is local, the initial themes query is not paginated by default.
+	 *
+	 * @since 4.9.0
+	 * @var string
+	 */
+	public $filter_type = 'local';
+
+	/**
+	 * Get section parameters for JS.
+	 *
+	 * @since 4.9.0
+	 * @return array Exported parameters.
+	 */
+	public function json() {
+		$exported = parent::json();
+		$exported['action'] = $this->action;
+		$exported['filter_type'] = $this->filter_type;
+
+		return $exported;
+	}
+
+	/**
+	 * Render a themes section as a JS template.
+	 *
+	 * The template is only rendered by PHP once, so all actions are prepared at once on the server side.
+	 *
+	 * @since 4.9.0
+	 */
+	protected function render_template() {
+		?>
+		<li id="accordion-section-{{ data.id }}" class="theme-section">
+			<button type="button" class="customize-themes-section-title themes-section-{{ data.id }}">{{ data.title }}</button>
+			<?php if ( current_user_can( 'install_themes' ) || is_multisite() ) : // @todo: upload support ?>
+			<?php endif; ?>
+			<div class="customize-themes-section themes-section-{{ data.id }} control-section-content themes-php">
+				<div class="theme-overlay" tabindex="0" role="dialog" aria-label="<?php esc_attr_e( 'Theme Details' ); ?>"></div>
+				<div class="theme-browser rendered">
+					<div class="customize-preview-header themes-filter-bar">
+						<?php $this->filter_bar_content_template(); ?>
+					</div>
+					<?php $this->filter_drawer_content_template(); ?>
+					<div class="error unexpected-error" style="display: none; "><p><?php _e( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="https://wordpress.org/support/">support forums</a>.' ); ?></p></div>
+					<ul class="themes">
+					</ul>
+					<p class="no-themes"><?php _e( 'No themes found. Try a different search.' ); ?></p>
+					<p class="no-themes-local">
+						<?php
+						/* translators: %s: "Search WordPress.org themes" button */
+						printf( __( 'No themes found. Try a different search, or %s.' ),
+							sprintf( '<button type="button" class="button-link search-dotorg-themes">%s</button>', __( 'Search WordPress.org themes' ) )
+						);
+						?>
+					</p>
+					<p class="spinner"></p>
+				</div>
+			</div>
+		</li>
+		<?php
+	}
+
+	/**
+	 * Render the filter bar portion of a themes section as a JS template.
+	 *
+	 * The template is only rendered by PHP once, so all actions are prepared at once on the server side.
+	 * The filter bar container is rendered by @see `render_template()`.
+	 *
+	 * @since 4.9.0
+	 */
+	protected function filter_bar_content_template() {
+		?>
+		<button type="button" class="button button-primary customize-section-back customize-themes-mobile-back"><?php _e( 'Back to theme sources' ); ?></button>
+		<# if ( 'wporg' === data.action ) { #>
+			<div class="search-form">
+				<label for="wp-filter-search-input-{{ data.id }}" class="screen-reader-text"><?php _e( 'Search themes&hellip;' ); ?></label>
+				<input type="search" id="wp-filter-search-input-{{ data.id }}" placeholder="<?php esc_attr_e( 'Search themes&hellip;' ); ?>" aria-describedby="{{ data.id }}-live-search-desc" class="wp-filter-search">
+				<div class="search-icon" aria-hidden="true"></div>
+				<span id="{{ data.id }}-live-search-desc" class="screen-reader-text"><?php _e( 'The search results will be updated as you type.' ); ?></span>
+			</div>
+			<button type="button" class="button feature-filter-toggle">
+				<span class="filter-count-0"><?php _e( 'Filter themes' ); ?></span><span class="filter-count-filters">
+				<?php
+				/* translators: %s: number of filters selected. */
+				printf( __( 'Filter themes (%s)' ), '<span class="theme-filter-count">0</span>' );
+				?>
+				</span>
+			</button>
+		<# } else { #>
+			<div class="themes-filter-container">
+				<label for="{{ data.id }}-themes-filter" class="screen-reader-text"><?php _e( 'Search themes&hellip;' ); ?></label>
+				<input type="search" id="{{ data.id }}-themes-filter" placeholder="<?php esc_attr_e( 'Search themes&hellip;' ); ?>" aria-describedby="{{ data.id }}-live-search-desc" class="wp-filter-search wp-filter-search-themes" />
+				<div class="search-icon" aria-hidden="true"></div>
+				<span id="{{ data.id }}-live-search-desc" class="screen-reader-text"><?php _e( 'The search results will be updated as you type.' ); ?></span>
+			</div>
+		<# } #>
+		<div class="filter-themes-count">
+			<span class="themes-displayed">
+				<?php
+				/* translators: %s: number of themes displayed. */
+				echo sprintf( __( '%s themes' ), '<span class="theme-count">0</span>' );
+				?>
+			</span>
+		</div>
+		<?php
+	}
+
+	/**
+	 * Render the filter drawer portion of a themes section as a JS template.
+	 *
+	 * The filter bar container is rendered by @see `render_template()`.
+	 *
+	 * @since 4.9.0
+	 */
+	protected function filter_drawer_content_template() {
+		$feature_list = get_theme_feature_list( false ); // @todo: Use the .org API instead of the local core feature list. The .org API is currently outdated and will be reconciled when the .org themes directory is next redesigned.
+		?>
+		<# if ( 'wporg' === data.action ) { #>
+			<div class="filter-drawer filter-details">
+				<?php foreach ( $feature_list as $feature_name => $features ) : ?>
+					<fieldset class="filter-group">
+						<legend><?php echo esc_html( $feature_name ); ?></legend>
+						<div class="filter-group-feature">
+							<?php foreach ( $features as $feature => $feature_name ) : ?>
+								<input type="checkbox" id="filter-id-<?php echo esc_attr( $feature ); ?>" value="<?php echo esc_attr( $feature ); ?>" />
+								<label for="filter-id-<?php echo esc_attr( $feature ); ?>"><?php echo esc_html( $feature_name ); ?></label>
+							<?php endforeach; ?>
+						</div>
+					</fieldset>
+				<?php endforeach; ?>
+			</div>
+		<# } #>
+		<?php
+	}
+}