/wp-includes/customize/class-wp-customize-theme-control.php

https://github.com/livinglab/openlab · PHP · 271 lines · 197 code · 12 blank · 62 comment · 10 complexity · ea0209ec184b97ff8a5754d582f563be MD5 · raw file 

    

  1. <?php
    2. 

  2. /**
    3. 

  3.  * Customize API: WP_Customize_Theme_Control class
    4. 

  4.  *
    5. 

  5.  * @package WordPress
    6. 

  6.  * @subpackage Customize
    7. 

  7.  * @since 4.4.0
    8. 

  8.  */
    9. 

  9. 

  10. /**
    11. 

  11.  * Customize Theme Control class.
    12. 

  12.  *
    13. 

  13.  * @since 4.2.0
    14. 

  14.  *
    15. 

  15.  * @see WP_Customize_Control
    16. 

  16.  */
    17. 

  17. class WP_Customize_Theme_Control extends WP_Customize_Control {
    18. 

  18. 

  19. 	/**
    20. 

  20. 	 * Customize control type.
    21. 

  21. 	 *
    22. 

  22. 	 * @since 4.2.0
    23. 

  23. 	 * @var string
    24. 

  24. 	 */
    25. 

  25. 	public $type = 'theme';
    26. 

  26. 

  27. 	/**
    28. 

  28. 	 * Theme object.
    29. 

  29. 	 *
    30. 

  30. 	 * @since 4.2.0
    31. 

  31. 	 * @var WP_Theme
    32. 

  32. 	 */
    33. 

  33. 	public $theme;
    34. 

  34. 

  35. 	/**
    36. 

  36. 	 * Refresh the parameters passed to the JavaScript via JSON.
    37. 

  37. 	 *
    38. 

  38. 	 * @since 4.2.0
    39. 

  39. 	 *
    40. 

  40. 	 * @see WP_Customize_Control::to_json()
    41. 

  41. 	 */
    42. 

  42. 	public function to_json() {
    43. 

  43. 		parent::to_json();
    44. 

  44. 		$this->json['theme'] = $this->theme;
    45. 

  45. 	}
    46. 

  46. 

  47. 	/**
    48. 

  48. 	 * Don't render the control content from PHP, as it's rendered via JS on load.
    49. 

  49. 	 *
    50. 

  50. 	 * @since 4.2.0
    51. 

  51. 	 */
    52. 

  52. 	public function render_content() {}
    53. 

  53. 

  54. 	/**
    55. 

  55. 	 * Render a JS template for theme display.
    56. 

  56. 	 *
    57. 

  57. 	 * @since 4.2.0
    58. 

  58. 	 */
    59. 

  59. 	public function content_template() {
    60. 

  60. 		/* translators: %s: Theme name. */
    61. 

  61. 		$details_label = sprintf( __( 'Details for theme: %s' ), '{{ data.theme.name }}' );
    62. 

  62. 		/* translators: %s: Theme name. */
    63. 

  63. 		$customize_label = sprintf( __( 'Customize theme: %s' ), '{{ data.theme.name }}' );
    64. 

  64. 		/* translators: %s: Theme name. */
    65. 

  65. 		$preview_label = sprintf( __( 'Live preview theme: %s' ), '{{ data.theme.name }}' );
    66. 

  66. 		/* translators: %s: Theme name. */
    67. 

  67. 		$install_label = sprintf( __( 'Install and preview theme: %s' ), '{{ data.theme.name }}' );
    68. 

  68. 		?>
    69. 

  69. 		<# if ( data.theme.active ) { #>
    70. 

  70. 			<div class="theme active" tabindex="0" aria-describedby="{{ data.section }}-{{ data.theme.id }}-action">
    71. 

  71. 		<# } else { #>
    72. 

  72. 			<div class="theme" tabindex="0" aria-describedby="{{ data.section }}-{{ data.theme.id }}-action">
    73. 

  73. 		<# } #>
    74. 

  74. 

  75. 			<# if ( data.theme.screenshot && data.theme.screenshot[0] ) { #>
    76. 

  76. 				<div class="theme-screenshot">
    77. 

  77. 					<img data-src="{{ data.theme.screenshot[0] }}" alt="" />
    78. 

  78. 				</div>
    79. 

  79. 			<# } else { #>
    80. 

  80. 				<div class="theme-screenshot blank"></div>
    81. 

  81. 			<# } #>
    82. 

  82. 

  83. 			<span class="more-details theme-details" id="{{ data.section }}-{{ data.theme.id }}-action" aria-label="<?php echo esc_attr( $details_label ); ?>"><?php _e( 'Theme Details' ); ?></span>
    84. 

  84. 

  85. 			<div class="theme-author">
    86. 

  86. 			<?php
    87. 

  87. 				/* translators: Theme author name. */
    88. 

  88. 				printf( _x( 'By %s', 'theme author' ), '{{ data.theme.author }}' );
    89. 

  89. 			?>
    90. 

  90. 			</div>
    91. 

  91. 

  92. 			<# if ( 'installed' === data.theme.type && data.theme.hasUpdate ) { #>
    93. 

  93. 				<# if ( data.theme.updateResponse.compatibleWP && data.theme.updateResponse.compatiblePHP ) { #>
    94. 

  94. 					<div class="update-message notice inline notice-warning notice-alt" data-slug="{{ data.theme.id }}">
    95. 

  95. 						<p>
    96. 

  96. 							<?php
    97. 

  97. 							if ( is_multisite() ) {
    98. 

  98. 								_e( 'New version available.' );
    99. 

  99. 							} else {
    100. 

  100. 								printf(
    101. 

  101. 									/* translators: %s: "Update now" button. */
    102. 

  102. 									__( 'New version available. %s' ),
    103. 

  103. 									'<button class="button-link update-theme" type="button">' . __( 'Update now' ) . '</button>'
    104. 

  104. 								);
    105. 

  105. 							}
    106. 

  106. 							?>
    107. 

  107. 						</p>
    108. 

  108. 					</div>
    109. 

  109. 				<# } else { #>
    110. 

  110. 					<div class="update-message notice inline notice-error notice-alt" data-slug="{{ data.theme.id }}">
    111. 

  111. 						<p>
    112. 

  112. 							<# if ( ! data.theme.updateResponse.compatibleWP && ! data.theme.updateResponse.compatiblePHP ) { #>
    113. 

  113. 								<?php
    114. 

  114. 								printf(
    115. 

  115. 									/* translators: %s: Theme name. */
    116. 

  116. 									__( 'There is a new version of %s available, but it doesn&#8217;t work with your versions of WordPress and PHP.' ),
    117. 

  117. 									'{{{ data.theme.name }}}'
    118. 

  118. 								);
    119. 

  119. 								if ( current_user_can( 'update_core' ) && current_user_can( 'update_php' ) ) {
    120. 

  120. 									printf(
    121. 

  121. 										/* translators: 1: URL to WordPress Updates screen, 2: URL to Update PHP page. */
    122. 

  122. 										' ' . __( '<a href="%1$s">Please update WordPress</a>, and then <a href="%2$s">learn more about updating PHP</a>.' ),
    123. 

  123. 										self_admin_url( 'update-core.php' ),
    124. 

  124. 										esc_url( wp_get_update_php_url() )
    125. 

  125. 									);
    126. 

  126. 									wp_update_php_annotation( '</p><p><em>', '</em>' );
    127. 

  127. 								} elseif ( current_user_can( 'update_core' ) ) {
    128. 

  128. 									printf(
    129. 

  129. 										/* translators: %s: URL to WordPress Updates screen. */
    130. 

  130. 										' ' . __( '<a href="%s">Please update WordPress</a>.' ),
    131. 

  131. 										self_admin_url( 'update-core.php' )
    132. 

  132. 									);
    133. 

  133. 								} elseif ( current_user_can( 'update_php' ) ) {
    134. 

  134. 									printf(
    135. 

  135. 										/* translators: %s: URL to Update PHP page. */
    136. 

  136. 										' ' . __( '<a href="%s">Learn more about updating PHP</a>.' ),
    137. 

  137. 										esc_url( wp_get_update_php_url() )
    138. 

  138. 									);
    139. 

  139. 									wp_update_php_annotation( '</p><p><em>', '</em>' );
    140. 

  140. 								}
    141. 

  141. 								?>
    142. 

  142. 							<# } else if ( ! data.theme.updateResponse.compatibleWP ) { #>
    143. 

  143. 								<?php
    144. 

  144. 								printf(
    145. 

  145. 									/* translators: %s: Theme name. */
    146. 

  146. 									__( 'There is a new version of %s available, but it doesn&#8217;t work with your version of WordPress.' ),
    147. 

  147. 									'{{{ data.theme.name }}}'
    148. 

  148. 								);
    149. 

  149. 								if ( current_user_can( 'update_core' ) ) {
    150. 

  150. 									printf(
    151. 

  151. 										/* translators: %s: URL to WordPress Updates screen. */
    152. 

  152. 										' ' . __( '<a href="%s">Please update WordPress</a>.' ),
    153. 

  153. 										self_admin_url( 'update-core.php' )
    154. 

  154. 									);
    155. 

  155. 								}
    156. 

  156. 								?>
    157. 

  157. 							<# } else if ( ! data.theme.updateResponse.compatiblePHP ) { #>
    158. 

  158. 								<?php
    159. 

  159. 								printf(
    160. 

  160. 									/* translators: %s: Theme name. */
    161. 

  161. 									__( 'There is a new version of %s available, but it doesn&#8217;t work with your version of PHP.' ),
    162. 

  162. 									'{{{ data.theme.name }}}'
    163. 

  163. 								);
    164. 

  164. 								if ( current_user_can( 'update_php' ) ) {
    165. 

  165. 									printf(
    166. 

  166. 										/* translators: %s: URL to Update PHP page. */
    167. 

  167. 										' ' . __( '<a href="%s">Learn more about updating PHP</a>.' ),
    168. 

  168. 										esc_url( wp_get_update_php_url() )
    169. 

  169. 									);
    170. 

  170. 									wp_update_php_annotation( '</p><p><em>', '</em>' );
    171. 

  171. 								}
    172. 

  172. 								?>
    173. 

  173. 							<# } #>
    174. 

  174. 						</p>
    175. 

  175. 					</div>
    176. 

  176. 				<# } #>
    177. 

  177. 			<# } #>
    178. 

  178. 

  179. 			<# if ( ! data.theme.compatibleWP || ! data.theme.compatiblePHP ) { #>
    180. 

  180. 				<div class="notice notice-error notice-alt"><p>
    181. 

  181. 					<# if ( ! data.theme.compatibleWP && ! data.theme.compatiblePHP ) { #>
    182. 

  182. 						<?php
    183. 

  183. 						_e( 'This theme doesn&#8217;t work with your versions of WordPress and PHP.' );
    184. 

  184. 						if ( current_user_can( 'update_core' ) && current_user_can( 'update_php' ) ) {
    185. 

  185. 							printf(
    186. 

  186. 								/* translators: 1: URL to WordPress Updates screen, 2: URL to Update PHP page. */
    187. 

  187. 								' ' . __( '<a href="%1$s">Please update WordPress</a>, and then <a href="%2$s">learn more about updating PHP</a>.' ),
    188. 

  188. 								self_admin_url( 'update-core.php' ),
    189. 

  189. 								esc_url( wp_get_update_php_url() )
    190. 

  190. 							);
    191. 

  191. 							wp_update_php_annotation( '</p><p><em>', '</em>' );
    192. 

  192. 						} elseif ( current_user_can( 'update_core' ) ) {
    193. 

  193. 							printf(
    194. 

  194. 								/* translators: %s: URL to WordPress Updates screen. */
    195. 

  195. 								' ' . __( '<a href="%s">Please update WordPress</a>.' ),
    196. 

  196. 								self_admin_url( 'update-core.php' )
    197. 

  197. 							);
    198. 

  198. 						} elseif ( current_user_can( 'update_php' ) ) {
    199. 

  199. 							printf(
    200. 

  200. 								/* translators: %s: URL to Update PHP page. */
    201. 

  201. 								' ' . __( '<a href="%s">Learn more about updating PHP</a>.' ),
    202. 

  202. 								esc_url( wp_get_update_php_url() )
    203. 

  203. 							);
    204. 

  204. 							wp_update_php_annotation( '</p><p><em>', '</em>' );
    205. 

  205. 						}
    206. 

  206. 						?>
    207. 

  207. 					<# } else if ( ! data.theme.compatibleWP ) { #>
    208. 

  208. 						<?php
    209. 

  209. 						_e( 'This theme doesn&#8217;t work with your version of WordPress.' );
    210. 

  210. 						if ( current_user_can( 'update_core' ) ) {
    211. 

  211. 							printf(
    212. 

  212. 								/* translators: %s: URL to WordPress Updates screen. */
    213. 

  213. 								' ' . __( '<a href="%s">Please update WordPress</a>.' ),
    214. 

  214. 								self_admin_url( 'update-core.php' )
    215. 

  215. 							);
    216. 

  216. 						}
    217. 

  217. 						?>
    218. 

  218. 					<# } else if ( ! data.theme.compatiblePHP ) { #>
    219. 

  219. 						<?php
    220. 

  220. 						_e( 'This theme doesn&#8217;t work with your version of PHP.' );
    221. 

  221. 						if ( current_user_can( 'update_php' ) ) {
    222. 

  222. 							printf(
    223. 

  223. 								/* translators: %s: URL to Update PHP page. */
    224. 

  224. 								' ' . __( '<a href="%s">Learn more about updating PHP</a>.' ),
    225. 

  225. 								esc_url( wp_get_update_php_url() )
    226. 

  226. 							);
    227. 

  227. 							wp_update_php_annotation( '</p><p><em>', '</em>' );
    228. 

  228. 						}
    229. 

  229. 						?>
    230. 

  230. 					<# } #>
    231. 

  231. 				</p></div>
    232. 

  232. 			<# } #>
    233. 

  233. 

  234. 			<# if ( data.theme.active ) { #>
    235. 

  235. 				<div class="theme-id-container">
    236. 

  236. 					<h3 class="theme-name" id="{{ data.section }}-{{ data.theme.id }}-name">
    237. 

  237. 						<span><?php _ex( 'Previewing:', 'theme' ); ?></span> {{ data.theme.name }}
    238. 

  238. 					</h3>
    239. 

  239. 					<div class="theme-actions">
    240. 

  240. 						<button type="button" class="button button-primary customize-theme" aria-label="<?php echo esc_attr( $customize_label ); ?>"><?php _e( 'Customize' ); ?></button>
    241. 

  241. 					</div>
    242. 

  242. 				</div>
    243. 

  243. 				<div class="notice notice-success notice-alt"><p><?php _ex( 'Installed', 'theme' ); ?></p></div>
    244. 

  244. 			<# } else if ( 'installed' === data.theme.type ) { #>
    245. 

  245. 				<div class="theme-id-container">
    246. 

  246. 					<h3 class="theme-name" id="{{ data.section }}-{{ data.theme.id }}-name">{{ data.theme.name }}</h3>
    247. 

  247. 					<div class="theme-actions">
    248. 

  248. 						<# if ( data.theme.compatibleWP && data.theme.compatiblePHP ) { #>
    249. 

  249. 							<button type="button" class="button button-primary preview-theme" aria-label="<?php echo esc_attr( $preview_label ); ?>" data-slug="{{ data.theme.id }}"><?php _e( 'Live Preview' ); ?></button>
    250. 

  250. 						<# } else { #>
    251. 

  251. 							<button type="button" class="button button-primary disabled" aria-label="<?php echo esc_attr( $preview_label ); ?>"><?php _e( 'Live Preview' ); ?></button>
    252. 

  252. 						<# } #>
    253. 

  253. 					</div>
    254. 

  254. 				</div>
    255. 

  255. 				<div class="notice notice-success notice-alt"><p><?php _ex( 'Installed', 'theme' ); ?></p></div>
    256. 

  256. 			<# } else { #>
    257. 

  257. 				<div class="theme-id-container">
    258. 

  258. 					<h3 class="theme-name" id="{{ data.section }}-{{ data.theme.id }}-name">{{ data.theme.name }}</h3>
    259. 

  259. 					<div class="theme-actions">
    260. 

  260. 						<# if ( data.theme.compatibleWP && data.theme.compatiblePHP ) { #>
    261. 

  261. 							<button type="button" class="button button-primary theme-install preview" aria-label="<?php echo esc_attr( $install_label ); ?>" data-slug="{{ data.theme.id }}" data-name="{{ data.theme.name }}"><?php _e( 'Install &amp; Preview' ); ?></button>
    262. 

  262. 						<# } else { #>
    263. 

  263. 							<button type="button" class="button button-primary disabled" aria-label="<?php echo esc_attr( $install_label ); ?>" disabled><?php _e( 'Install &amp; Preview' ); ?></button>
    264. 

  264. 						<# } #>
    265. 

  265. 					</div>
    266. 

  266. 				</div>
    267. 

  267. 			<# } #>
    268. 

  268. 		</div>
    269. 

  269. 		<?php
    270. 

  270. 	}
    271. 

  271. }
    272.