WordPress 4.3
[autoinstalls/wordpress.git] / wp-admin / includes / theme.php
index ab665f81532ea5c6e15b18b1ee9f4d43a1381694..9bbfc7215d3572f4ff3d5cf00211321d15290354 100644 (file)
  *
  * @since 2.8.0
  *
+ * @global WP_Filesystem_Base $wp_filesystem Subclass
+ *
  * @param string $stylesheet Stylesheet of the theme to delete
  * @param string $redirect Redirect to page when complete.
- * @return mixed
+ * @return void|bool|WP_Error When void, echoes content.
  */
 function delete_theme($stylesheet, $redirect = '') {
        global $wp_filesystem;
@@ -25,8 +27,8 @@ function delete_theme($stylesheet, $redirect = '') {
        if ( empty( $redirect ) )
                $redirect = wp_nonce_url('themes.php?action=delete&stylesheet=' . urlencode( $stylesheet ), 'delete-theme_' . $stylesheet);
        if ( false === ($credentials = request_filesystem_credentials($redirect)) ) {
-               $data = ob_get_contents();
-               ob_end_clean();
+               $data = ob_get_clean();
+
                if ( ! empty($data) ){
                        include_once( ABSPATH . 'wp-admin/admin-header.php');
                        echo $data;
@@ -38,8 +40,8 @@ function delete_theme($stylesheet, $redirect = '') {
 
        if ( ! WP_Filesystem($credentials) ) {
                request_filesystem_credentials($redirect, '', true); // Failed to connect, Error and request again
-               $data = ob_get_contents();
-               ob_end_clean();
+               $data = ob_get_clean();
+
                if ( ! empty($data) ) {
                        include_once( ABSPATH . 'wp-admin/admin-header.php');
                        echo $data;
@@ -55,20 +57,34 @@ function delete_theme($stylesheet, $redirect = '') {
        if ( is_wp_error($wp_filesystem->errors) && $wp_filesystem->errors->get_error_code() )
                return new WP_Error('fs_error', __('Filesystem error.'), $wp_filesystem->errors);
 
-       //Get the base plugin folder
+       // Get the base plugin folder.
        $themes_dir = $wp_filesystem->wp_themes_dir();
-       if ( empty($themes_dir) )
-               return new WP_Error('fs_no_themes_dir', __('Unable to locate WordPress theme directory.'));
+       if ( empty( $themes_dir ) ) {
+               return new WP_Error( 'fs_no_themes_dir', __( 'Unable to locate WordPress theme directory.' ) );
+       }
 
        $themes_dir = trailingslashit( $themes_dir );
-       $theme_dir = trailingslashit($themes_dir . $stylesheet);
-       $deleted = $wp_filesystem->delete($theme_dir, true);
+       $theme_dir = trailingslashit( $themes_dir . $stylesheet );
+       $deleted = $wp_filesystem->delete( $theme_dir, true );
 
-       if ( ! $deleted )
-               return new WP_Error('could_not_remove_theme', sprintf(__('Could not fully remove the theme %s.'), $stylesheet) );
+       if ( ! $deleted ) {
+               return new WP_Error( 'could_not_remove_theme', sprintf( __( 'Could not fully remove the theme %s.' ), $stylesheet ) );
+       }
+
+       $theme_translations = wp_get_installed_translations( 'themes' );
+
+       // Remove language files, silently.
+       if ( ! empty( $theme_translations[ $stylesheet ] ) ) {
+               $translations = $theme_translations[ $stylesheet ];
+
+               foreach ( $translations as $translation => $data ) {
+                       $wp_filesystem->delete( WP_LANG_DIR . '/themes/' . $stylesheet . '-' . $translation . '.po' );
+                       $wp_filesystem->delete( WP_LANG_DIR . '/themes/' . $stylesheet . '-' . $translation . '.mo' );
+               }
+       }
 
-       // Force refresh of theme update information
-       delete_site_transient('update_themes');
+       // Force refresh of theme update information.
+       delete_site_transient( 'update_themes' );
 
        return true;
 }
@@ -107,7 +123,7 @@ function _get_template_edit_filename($fullpath, $containingfolder) {
  * @since 2.7.0
  * @see get_theme_update_available()
  *
- * @param object $theme Theme data object.
+ * @param WP_Theme $theme Theme data object.
  */
 function theme_update_available( $theme ) {
        echo get_theme_update_available( $theme );
@@ -120,11 +136,13 @@ function theme_update_available( $theme ) {
  *
  * @since 3.8.0
  *
+ * @staticvar object $themes_update
+ *
  * @param WP_Theme $theme WP_Theme object.
- * @return string|bool HTML for the update link, or false if invalid info was passed.
+ * @return false|string HTML for the update link, or false if invalid info was passed.
  */
 function get_theme_update_available( $theme ) {
-       static $themes_update;
+       static $themes_update = null;
 
        if ( !current_user_can('update_themes' ) )
                return false;
@@ -132,8 +150,9 @@ function get_theme_update_available( $theme ) {
        if ( !isset($themes_update) )
                $themes_update = get_site_transient('update_themes');
 
-       if ( ! is_a( $theme, 'WP_Theme' ) )
+       if ( ! ( $theme instanceof WP_Theme ) ) {
                return false;
+       }
 
        $stylesheet = $theme->get_stylesheet();
 
@@ -150,7 +169,7 @@ function get_theme_update_available( $theme ) {
                        if ( ! current_user_can('update_themes') ) {
                                $html = sprintf( '<p><strong>' . __( 'There is a new version of %1$s available. <a href="%2$s" class="thickbox" title="%3$s">View version %4$s details</a>.' ) . '</strong></p>',
                                        $theme_name, esc_url( $details_url ), esc_attr( $theme['Name'] ), $update['new_version'] );
-                       } else if ( empty( $update['package'] ) ) {
+                       } elseif ( empty( $update['package'] ) ) {
                                $html = sprintf( '<p><strong>' . __( 'There is a new version of %1$s available. <a href="%2$s" class="thickbox" title="%3$s">View version %4$s details</a>. <em>Automatic update is unavailable for this theme.</em>' ) . '</strong></p>',
                                        $theme_name, esc_url( $details_url ), esc_attr( $theme['Name'] ), $update['new_version'] );
                        } else {
@@ -238,7 +257,7 @@ function get_theme_feature_list( $api = true ) {
                return $features;
 
        if ( !$feature_list = get_site_transient( 'wporg_theme_feature_list' ) )
-               set_site_transient( 'wporg_theme_feature_list', array(), 10800);
+               set_site_transient( 'wporg_theme_feature_list', array(), 3 * HOUR_IN_SECONDS );
 
        if ( !$feature_list ) {
                $feature_list = themes_api( 'feature_list', array() );
@@ -249,7 +268,7 @@ function get_theme_feature_list( $api = true ) {
        if ( !$feature_list )
                return $features;
 
-       set_site_transient( 'wporg_theme_feature_list', $feature_list, 10800 );
+       set_site_transient( 'wporg_theme_feature_list', $feature_list, 3 * HOUR_IN_SECONDS );
 
        $category_translations = array(
                'Colors'   => __( 'Colors' ),
@@ -282,7 +301,7 @@ function get_theme_feature_list( $api = true ) {
  * It is possible for a theme to override the Themes API result with three
  * filters. Assume this is for themes, which can extend on the Theme Info to
  * offer more choices. This is very powerful and must be used with care, when
- * overridding the filters.
+ * overriding the filters.
  *
  * The first filter, 'themes_api_args', is for the args and gives the action as
  * the second parameter. The hook for 'themes_api_args' must ensure that an
@@ -297,13 +316,20 @@ function get_theme_feature_list( $api = true ) {
  * @param array|object $args   Optional. Arguments to serialize for the Theme Info API.
  * @return mixed
  */
-       function themes_api( $action, $args = null ) {
+function themes_api( $action, $args = null ) {
 
-       if ( is_array($args) )
-               $args = (object)$args;
+       if ( is_array( $args ) ) {
+               $args = (object) $args;
+       }
 
-       if ( !isset($args->per_page) )
+       if ( ! isset( $args->per_page ) ) {
                $args->per_page = 24;
+       }
+
+       if ( ! isset( $args->locale ) ) {
+               $args->locale = get_locale();
+       }
+
        /**
         * Filter arguments used to query for installer pages from the WordPress.org Themes API.
         *
@@ -314,7 +340,7 @@ function get_theme_feature_list( $api = true ) {
         * @param object $args   Arguments used to query for installer pages from the WordPress.org Themes API.
         * @param string $action Requested action. Likely values are 'theme_information',
         *                       'feature_list', or 'query_themes'.
-       */
+        */
        $args = apply_filters( 'themes_api_args', $args, $action );
 
        /**
@@ -337,19 +363,19 @@ function get_theme_feature_list( $api = true ) {
                if ( $ssl = wp_http_supports( array( 'ssl' ) ) )
                        $url = set_url_scheme( $url, 'https' );
 
-               $args = array(
+               $http_args = array(
                        'body' => array(
                                'action' => $action,
                                'request' => serialize( $args )
                        )
                );
-               $request = wp_remote_post( $url, $args );
+               $request = wp_remote_post( $url, $http_args );
 
                if ( $ssl && is_wp_error( $request ) ) {
                        if ( ! defined( 'DOING_AJAX' ) || ! DOING_AJAX ) {
                                trigger_error( __( '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>.' ) . ' ' . __( '(WordPress could not establish a secure connection to WordPress.org. Please contact your server administrator.)' ), headers_sent() || WP_DEBUG ? E_USER_WARNING : E_USER_NOTICE );
                        }
-                       $request = wp_remote_post( $http_url, $args );
+                       $request = wp_remote_post( $http_url, $http_args );
                }
 
                if ( is_wp_error($request) ) {
@@ -387,8 +413,26 @@ function get_theme_feature_list( $api = true ) {
 function wp_prepare_themes_for_js( $themes = null ) {
        $current_theme = get_stylesheet();
 
+       /**
+        * Filter theme data before it is prepared for JavaScript.
+        *
+        * Passing a non-empty array will result in wp_prepare_themes_for_js() returning
+        * early with that value instead.
+        *
+        * @since 4.2.0
+        *
+        * @param array      $prepared_themes An associative array of theme data. Default empty array.
+        * @param null|array $themes          An array of WP_Theme objects to prepare, if any.
+        * @param string     $current_theme   The current theme slug.
+        */
+       $prepared_themes = (array) apply_filters( 'pre_prepare_themes_for_js', array(), $themes, $current_theme );
+
+       if ( ! empty( $prepared_themes ) ) {
+               return $prepared_themes;
+       }
+
        // Make sure the current theme is listed first.
-       $prepared_themes = array( $current_theme => array() );
+       $prepared_themes[ $current_theme ] = array();
 
        if ( null === $themes ) {
                $themes = wp_get_themes( array( 'allowed' => true ) );
@@ -406,15 +450,19 @@ function wp_prepare_themes_for_js( $themes = null ) {
        }
 
        WP_Theme::sort_by_name( $themes );
+
+       $parents = array();
+
        foreach ( $themes as $theme ) {
+               $slug = $theme->get_stylesheet();
+               $encoded_slug = urlencode( $slug );
+
                $parent = false;
                if ( $theme->parent() ) {
                        $parent = $theme->parent()->display( 'Name' );
+                       $parents[ $slug ] = $theme->parent()->get_stylesheet();
                }
 
-               $slug = $theme->get_stylesheet();
-               $encoded_slug = urlencode( $slug );
-
                $prepared_themes[ $slug ] = array(
                        'id'           => $slug,
                        'name'         => $theme->display( 'Name' ),
@@ -430,19 +478,17 @@ function wp_prepare_themes_for_js( $themes = null ) {
                        'update'       => get_theme_update_available( $theme ),
                        'actions'      => array(
                                'activate' => current_user_can( 'switch_themes' ) ? wp_nonce_url( admin_url( 'themes.php?action=activate&amp;stylesheet=' . $encoded_slug ), 'switch-theme_' . $slug ) : null,
-                               'customize'=> current_user_can( 'edit_theme_options' ) ? wp_customize_url( $slug ) : null,
-                               'preview'   => add_query_arg( array(
-                                       'preview'        => 1,
-                                       'template'       => urlencode( $theme->get_template() ),
-                                       'stylesheet'     => urlencode( $slug ),
-                                       'preview_iframe' => true,
-                                       'TB_iframe'      => true,
-                               ), home_url( '/' ) ),
+                               'customize' => ( current_user_can( 'edit_theme_options' ) && current_user_can( 'customize' ) ) ? wp_customize_url( $slug ) : null,
                                'delete'   => current_user_can( 'delete_themes' ) ? wp_nonce_url( admin_url( 'themes.php?action=delete&amp;stylesheet=' . $encoded_slug ), 'delete-theme_' . $slug ) : null,
                        ),
                );
        }
 
+       // Remove 'delete' action if theme has an active child
+       if ( ! empty( $parents ) && array_key_exists( $current_theme, $parents ) ) {
+               unset( $prepared_themes[ $parents[ $current_theme ] ]['actions']['delete'] );
+       }
+
        /**
         * Filter the themes prepared for JavaScript, for themes.php.
         *
@@ -453,5 +499,62 @@ function wp_prepare_themes_for_js( $themes = null ) {
         * @param array $prepared_themes Array of themes.
         */
        $prepared_themes = apply_filters( 'wp_prepare_themes_for_js', $prepared_themes );
-       return array_values( $prepared_themes );
+       $prepared_themes = array_values( $prepared_themes );
+       return array_filter( $prepared_themes );
+}
+
+/**
+ * Print JS templates for the theme-browsing UI in the Customizer.
+ *
+ * @since 4.2.0
+ */
+function customize_themes_print_templates() {
+       $preview_url = esc_url( add_query_arg( 'theme', '__THEME__' ) ); // Token because esc_url() strips curly braces.
+       $preview_url = str_replace( '__THEME__', '{{ data.id }}', $preview_url );
+       ?>
+       <script type="text/html" id="tmpl-customize-themes-details-view">
+               <div class="theme-backdrop"></div>
+               <div class="theme-wrap">
+                       <div class="theme-header">
+                               <button type="button" class="left dashicons dashicons-no"><span class="screen-reader-text"><?php _e( 'Show previous theme' ); ?></span></button>
+                               <button type="button" class="right dashicons dashicons-no"><span class="screen-reader-text"><?php _e( 'Show next theme' ); ?></span></button>
+                               <button type="button" class="close dashicons dashicons-no"><span class="screen-reader-text"><?php _e( 'Close details dialog' ); ?></span></button>
+                       </div>
+                       <div class="theme-about">
+                               <div class="theme-screenshots">
+                               <# if ( data.screenshot[0] ) { #>
+                                       <div class="screenshot"><img src="{{ data.screenshot[0] }}" alt="" /></div>
+                               <# } else { #>
+                                       <div class="screenshot blank"></div>
+                               <# } #>
+                               </div>
+
+                               <div class="theme-info">
+                                       <# if ( data.active ) { #>
+                                               <span class="current-label"><?php _e( 'Current Theme' ); ?></span>
+                                       <# } #>
+                                       <h3 class="theme-name">{{{ data.name }}}<span class="theme-version"><?php printf( __( 'Version: %s' ), '{{ data.version }}' ); ?></span></h3>
+                                       <h4 class="theme-author"><?php printf( __( 'By %s' ), '{{{ data.authorAndUri }}}' ); ?></h4>
+                                       <p class="theme-description">{{{ data.description }}}</p>
+
+                                       <# if ( data.parent ) { #>
+                                               <p class="parent-theme"><?php printf( __( 'This is a child theme of %s.' ), '<strong>{{{ data.parent }}}</strong>' ); ?></p>
+                                       <# } #>
+
+                                       <# if ( data.tags ) { #>
+                                               <p class="theme-tags"><span><?php _e( 'Tags:' ); ?></span> {{ data.tags }}</p>
+                                       <# } #>
+                               </div>
+                       </div>
+
+                       <# if ( ! data.active ) { #>
+                               <div class="theme-actions">
+                                       <div class="inactive-theme">
+                                               <a href="<?php echo $preview_url; ?>" target="_top" class="button button-primary"><?php _e( 'Live Preview' ); ?></a>
+                                       </div>
+                               </div>
+                       <# } #>
+               </div>
+       </script>
+       <?php
 }