[ Index ]

PHP Cross Reference of WordPress

title

Body

[close]

/wp-admin/ -> customize.php (source)

   1  <?php
   2  /**
   3   * Theme Customize Screen.
   4   *
   5   * @package WordPress
   6   * @subpackage Customize
   7   * @since 3.4.0
   8   */
   9  
  10  define( 'IFRAME_REQUEST', true );
  11  
  12  /** Load WordPress Administration Bootstrap */
  13  require_once  __DIR__ . '/admin.php';
  14  
  15  if ( ! current_user_can( 'customize' ) ) {
  16      wp_die(
  17          '<h1>' . __( 'You need a higher level of permission.' ) . '</h1>' .
  18          '<p>' . __( 'Sorry, you are not allowed to customize this site.' ) . '</p>',
  19          403
  20      );
  21  }
  22  
  23  /**
  24   * @global WP_Scripts           $wp_scripts
  25   * @global WP_Customize_Manager $wp_customize
  26   */
  27  global $wp_scripts, $wp_customize;
  28  
  29  if ( $wp_customize->changeset_post_id() ) {
  30      $changeset_post = get_post( $wp_customize->changeset_post_id() );
  31  
  32      if ( ! current_user_can( get_post_type_object( 'customize_changeset' )->cap->edit_post, $changeset_post->ID ) ) {
  33          wp_die(
  34              '<h1>' . __( 'You need a higher level of permission.' ) . '</h1>' .
  35              '<p>' . __( 'Sorry, you are not allowed to edit this changeset.' ) . '</p>',
  36              403
  37          );
  38      }
  39  
  40      $missed_schedule = (
  41          'future' === $changeset_post->post_status &&
  42          get_post_time( 'G', true, $changeset_post ) < time()
  43      );
  44      if ( $missed_schedule ) {
  45          /*
  46           * Note that an Ajax request spawns here instead of just calling `wp_publish_post( $changeset_post->ID )`.
  47           *
  48           * Because WP_Customize_Manager is not instantiated for customize.php with the `settings_previewed=false`
  49           * argument, settings cannot be reliably saved. Some logic short-circuits if the current value is the
  50           * same as the value being saved. This is particularly true for options via `update_option()`.
  51           *
  52           * By opening an Ajax request, this is avoided and the changeset is published. See #39221.
  53           */
  54          $nonces       = $wp_customize->get_nonces();
  55          $request_args = array(
  56              'nonce'                      => $nonces['save'],
  57              'customize_changeset_uuid'   => $wp_customize->changeset_uuid(),
  58              'wp_customize'               => 'on',
  59              'customize_changeset_status' => 'publish',
  60          );
  61          ob_start();
  62          ?>
  63          <?php wp_print_scripts( array( 'wp-util' ) ); ?>
  64          <script>
  65              wp.ajax.post( 'customize_save', <?php echo wp_json_encode( $request_args ); ?> );
  66          </script>
  67          <?php
  68          $script = ob_get_clean();
  69  
  70          wp_die(
  71              '<h1>' . __( 'Your scheduled changes just published' ) . '</h1>' .
  72              '<p><a href="' . esc_url( remove_query_arg( 'changeset_uuid' ) ) . '">' . __( 'Customize New Changes' ) . '</a></p>' . $script,
  73              200
  74          );
  75      }
  76  
  77      if ( in_array( get_post_status( $changeset_post->ID ), array( 'publish', 'trash' ), true ) ) {
  78          wp_die(
  79              '<h1>' . __( 'Something went wrong.' ) . '</h1>' .
  80              '<p>' . __( 'This changeset cannot be further modified.' ) . '</p>' .
  81              '<p><a href="' . esc_url( remove_query_arg( 'changeset_uuid' ) ) . '">' . __( 'Customize New Changes' ) . '</a></p>',
  82              403
  83          );
  84      }
  85  }
  86  
  87  
  88  wp_reset_vars( array( 'url', 'return', 'autofocus' ) );
  89  if ( ! empty( $url ) ) {
  90      $wp_customize->set_preview_url( wp_unslash( $url ) );
  91  }
  92  if ( ! empty( $return ) ) {
  93      $wp_customize->set_return_url( wp_unslash( $return ) );
  94  }
  95  if ( ! empty( $autofocus ) && is_array( $autofocus ) ) {
  96      $wp_customize->set_autofocus( wp_unslash( $autofocus ) );
  97  }
  98  
  99  $registered             = $wp_scripts->registered;
 100  $wp_scripts             = new WP_Scripts;
 101  $wp_scripts->registered = $registered;
 102  
 103  add_action( 'customize_controls_print_scripts', 'print_head_scripts', 20 );
 104  add_action( 'customize_controls_print_footer_scripts', '_wp_footer_scripts' );
 105  add_action( 'customize_controls_print_styles', 'print_admin_styles', 20 );
 106  
 107  /**
 108   * Fires when Customizer controls are initialized, before scripts are enqueued.
 109   *
 110   * @since 3.4.0
 111   */
 112  do_action( 'customize_controls_init' );
 113  
 114  wp_enqueue_script( 'heartbeat' );
 115  wp_enqueue_script( 'customize-controls' );
 116  wp_enqueue_style( 'customize-controls' );
 117  
 118  /**
 119   * Enqueue Customizer control scripts.
 120   *
 121   * @since 3.4.0
 122   */
 123  do_action( 'customize_controls_enqueue_scripts' );
 124  
 125  // Let's roll.
 126  header( 'Content-Type: ' . get_option( 'html_type' ) . '; charset=' . get_option( 'blog_charset' ) );
 127  
 128  wp_user_settings();
 129  _wp_admin_html_begin();
 130  
 131  $body_class = 'wp-core-ui wp-customizer js';
 132  
 133  if ( wp_is_mobile() ) :
 134      $body_class .= ' mobile';
 135      add_filter( 'admin_viewport_meta', '_customizer_mobile_viewport_meta' );
 136  endif;
 137  
 138  if ( $wp_customize->is_ios() ) {
 139      $body_class .= ' ios';
 140  }
 141  
 142  if ( is_rtl() ) {
 143      $body_class .= ' rtl';
 144  }
 145  $body_class .= ' locale-' . sanitize_html_class( strtolower( str_replace( '_', '-', get_user_locale() ) ) );
 146  
 147  if ( wp_use_widgets_block_editor() ) {
 148      $body_class .= ' wp-embed-responsive';
 149  }
 150  
 151  $admin_title = sprintf( $wp_customize->get_document_title_template(), __( 'Loading&hellip;' ) );
 152  
 153  ?>
 154  <title><?php echo esc_html( $admin_title ); ?></title>
 155  
 156  <script type="text/javascript">
 157  var ajaxurl = <?php echo wp_json_encode( admin_url( 'admin-ajax.php', 'relative' ) ); ?>,
 158      pagenow = 'customize';
 159  </script>
 160  
 161  <?php
 162  /**
 163   * Fires when Customizer control styles are printed.
 164   *
 165   * @since 3.4.0
 166   */
 167  do_action( 'customize_controls_print_styles' );
 168  
 169  /**
 170   * Fires when Customizer control scripts are printed.
 171   *
 172   * @since 3.4.0
 173   */
 174  do_action( 'customize_controls_print_scripts' );
 175  
 176  /**
 177   * Fires in head section of Customizer controls.
 178   *
 179   * @since 5.5.0
 180   */
 181  do_action( 'customize_controls_head' );
 182  ?>
 183  </head>
 184  <body class="<?php echo esc_attr( $body_class ); ?>">
 185  <div class="wp-full-overlay expanded">
 186      <form id="customize-controls" class="wrap wp-full-overlay-sidebar">
 187          <div id="customize-header-actions" class="wp-full-overlay-header">
 188              <?php
 189              $compatible_wp  = is_wp_version_compatible( $wp_customize->theme()->get( 'RequiresWP' ) );
 190              $compatible_php = is_php_version_compatible( $wp_customize->theme()->get( 'RequiresPHP' ) );
 191              ?>
 192              <?php if ( $compatible_wp && $compatible_php ) : ?>
 193                  <?php $save_text = $wp_customize->is_theme_active() ? __( 'Publish' ) : __( 'Activate &amp; Publish' ); ?>
 194                  <div id="customize-save-button-wrapper" class="customize-save-button-wrapper" >
 195                      <?php submit_button( $save_text, 'primary save', 'save', false ); ?>
 196                      <button id="publish-settings" class="publish-settings button-primary button dashicons dashicons-admin-generic" aria-label="<?php esc_attr_e( 'Publish Settings' ); ?>" aria-expanded="false" disabled></button>
 197                  </div>
 198              <?php else : ?>
 199                  <?php $save_text = _x( 'Cannot Activate', 'theme' ); ?>
 200                  <div id="customize-save-button-wrapper" class="customize-save-button-wrapper disabled" >
 201                      <button class="button button-primary disabled" aria-label="<?php esc_attr_e( 'Publish Settings' ); ?>" aria-expanded="false" disabled><?php echo $save_text; ?></button>
 202                  </div>
 203              <?php endif; ?>
 204              <span class="spinner"></span>
 205              <button type="button" class="customize-controls-preview-toggle">
 206                  <span class="controls"><?php _e( 'Customize' ); ?></span>
 207                  <span class="preview"><?php _e( 'Preview' ); ?></span>
 208              </button>
 209              <a class="customize-controls-close" href="<?php echo esc_url( $wp_customize->get_return_url() ); ?>">
 210                  <span class="screen-reader-text"><?php _e( 'Close the Customizer and go back to the previous page' ); ?></span>
 211              </a>
 212          </div>
 213  
 214          <div id="customize-sidebar-outer-content">
 215              <div id="customize-outer-theme-controls">
 216                  <ul class="customize-outer-pane-parent"><?php // Outer panel and sections are not implemented, but its here as a placeholder to avoid any side-effect in api.Section. ?></ul>
 217              </div>
 218          </div>
 219  
 220          <div id="widgets-right" class="wp-clearfix"><!-- For Widget Customizer, many widgets try to look for instances under div#widgets-right, so we have to add that ID to a container div in the Customizer for compat -->
 221              <div id="customize-notifications-area" class="customize-control-notifications-container">
 222                  <ul></ul>
 223              </div>
 224              <div class="wp-full-overlay-sidebar-content" tabindex="-1">
 225                  <div id="customize-info" class="accordion-section customize-info" data-block-theme="<?php echo (int) wp_is_block_theme(); ?>">
 226                      <div class="accordion-section-title">
 227                          <span class="preview-notice">
 228                          <?php
 229                              /* translators: %s: The site/panel title in the Customizer. */
 230                              printf( __( 'You are customizing %s' ), '<strong class="panel-title site-title">' . get_bloginfo( 'name', 'display' ) . '</strong>' );
 231                          ?>
 232                          </span>
 233                          <button type="button" class="customize-help-toggle dashicons dashicons-editor-help" aria-expanded="false"><span class="screen-reader-text"><?php _e( 'Help' ); ?></span></button>
 234                      </div>
 235                      <div class="customize-panel-description">
 236                          <p>
 237                              <?php
 238                              _e( 'The Customizer allows you to preview changes to your site before publishing them. You can navigate to different pages on your site within the preview. Edit shortcuts are shown for some editable elements. The Customizer is intended for use with non-block themes.' );
 239                              ?>
 240                          </p>
 241                          <p>
 242                              <?php
 243                              _e( '<a href="https://wordpress.org/support/article/appearance-customize-screen/">Documentation on Customizer</a>' );
 244                              ?>
 245                          </p>
 246                      </div>
 247                  </div>
 248  
 249                  <div id="customize-theme-controls">
 250                      <ul class="customize-pane-parent"><?php // Panels and sections are managed here via JavaScript ?></ul>
 251                  </div>
 252              </div>
 253          </div>
 254  
 255          <div id="customize-footer-actions" class="wp-full-overlay-footer">
 256              <button type="button" class="collapse-sidebar button" aria-expanded="true" aria-label="<?php echo esc_attr_x( 'Hide Controls', 'label for hide controls button without length constraints' ); ?>">
 257                  <span class="collapse-sidebar-arrow"></span>
 258                  <span class="collapse-sidebar-label"><?php _ex( 'Hide Controls', 'short (~12 characters) label for hide controls button' ); ?></span>
 259              </button>
 260              <?php $previewable_devices = $wp_customize->get_previewable_devices(); ?>
 261              <?php if ( ! empty( $previewable_devices ) ) : ?>
 262              <div class="devices-wrapper">
 263                  <div class="devices">
 264                      <?php foreach ( (array) $previewable_devices as $device => $settings ) : ?>
 265                          <?php
 266                          if ( empty( $settings['label'] ) ) {
 267                              continue;
 268                          }
 269                          $active = ! empty( $settings['default'] );
 270                          $class  = 'preview-' . $device;
 271                          if ( $active ) {
 272                              $class .= ' active';
 273                          }
 274                          ?>
 275                          <button type="button" class="<?php echo esc_attr( $class ); ?>" aria-pressed="<?php echo esc_attr( $active ); ?>" data-device="<?php echo esc_attr( $device ); ?>">
 276                              <span class="screen-reader-text"><?php echo esc_html( $settings['label'] ); ?></span>
 277                          </button>
 278                      <?php endforeach; ?>
 279                  </div>
 280              </div>
 281              <?php endif; ?>
 282          </div>
 283      </form>
 284      <div id="customize-preview" class="wp-full-overlay-main"></div>
 285      <?php
 286  
 287      /**
 288       * Prints templates, control scripts, and settings in the footer.
 289       *
 290       * @since 3.4.0
 291       */
 292      do_action( 'customize_controls_print_footer_scripts' );
 293      ?>
 294  </div>
 295  </body>
 296  </html>


Generated: Wed May 18 01:00:03 2022 Cross-referenced by PHPXref 0.7.1