[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

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  $url       = ! empty( $_REQUEST['url'] ) ? sanitize_text_field( $_REQUEST['url'] ) : '';
  88  $return    = ! empty( $_REQUEST['return'] ) ? sanitize_text_field( $_REQUEST['return'] ) : '';
  89  $autofocus = ! empty( $_REQUEST['autofocus'] ) ? sanitize_text_field( $_REQUEST['autofocus'] ) : '';
  90  
  91  if ( ! empty( $url ) ) {
  92      $wp_customize->set_preview_url( wp_unslash( $url ) );
  93  }
  94  if ( ! empty( $return ) ) {
  95      $wp_customize->set_return_url( wp_unslash( $return ) );
  96  }
  97  if ( ! empty( $autofocus ) && is_array( $autofocus ) ) {
  98      $wp_customize->set_autofocus( wp_unslash( $autofocus ) );
  99  }
 100  
 101  $registered             = $wp_scripts->registered;
 102  $wp_scripts             = new WP_Scripts();
 103  $wp_scripts->registered = $registered;
 104  
 105  add_action( 'customize_controls_print_scripts', 'print_head_scripts', 20 );
 106  add_action( 'customize_controls_print_footer_scripts', '_wp_footer_scripts' );
 107  add_action( 'customize_controls_print_styles', 'print_admin_styles', 20 );
 108  
 109  /**
 110   * Fires when Customizer controls are initialized, before scripts are enqueued.
 111   *
 112   * @since 3.4.0
 113   */
 114  do_action( 'customize_controls_init' );
 115  
 116  wp_enqueue_script( 'heartbeat' );
 117  wp_enqueue_script( 'customize-controls' );
 118  wp_enqueue_style( 'customize-controls' );
 119  
 120  /**
 121   * Fires when enqueuing Customizer control scripts.
 122   *
 123   * @since 3.4.0
 124   */
 125  do_action( 'customize_controls_enqueue_scripts' );
 126  
 127  // Let's roll.
 128  header( 'Content-Type: ' . get_option( 'html_type' ) . '; charset=' . get_option( 'blog_charset' ) );
 129  
 130  wp_user_settings();
 131  _wp_admin_html_begin();
 132  
 133  $body_class = 'wp-core-ui wp-customizer js';
 134  
 135  if ( wp_is_mobile() ) :
 136      $body_class .= ' mobile';
 137      add_filter( 'admin_viewport_meta', '_customizer_mobile_viewport_meta' );
 138  endif;
 139  
 140  if ( $wp_customize->is_ios() ) {
 141      $body_class .= ' ios';
 142  }
 143  
 144  if ( is_rtl() ) {
 145      $body_class .= ' rtl';
 146  }
 147  $body_class .= ' locale-' . sanitize_html_class( strtolower( str_replace( '_', '-', get_user_locale() ) ) );
 148  
 149  if ( wp_use_widgets_block_editor() ) {
 150      $body_class .= ' wp-embed-responsive';
 151  }
 152  
 153  $admin_title = sprintf( $wp_customize->get_document_title_template(), __( 'Loading&hellip;' ) );
 154  
 155  ?>
 156  <title><?php echo esc_html( $admin_title ); ?></title>
 157  
 158  <script type="text/javascript">
 159  var ajaxurl = <?php echo wp_json_encode( admin_url( 'admin-ajax.php', 'relative' ) ); ?>,
 160      pagenow = 'customize';
 161  </script>
 162  
 163  <?php
 164  /**
 165   * Fires when Customizer control styles are printed.
 166   *
 167   * @since 3.4.0
 168   */
 169  do_action( 'customize_controls_print_styles' );
 170  
 171  /**
 172   * Fires when Customizer control scripts are printed.
 173   *
 174   * @since 3.4.0
 175   */
 176  do_action( 'customize_controls_print_scripts' );
 177  
 178  /**
 179   * Fires in head section of Customizer controls.
 180   *
 181   * @since 5.5.0
 182   */
 183  do_action( 'customize_controls_head' );
 184  ?>
 185  </head>
 186  <body class="<?php echo esc_attr( $body_class ); ?>">
 187  <div class="wp-full-overlay expanded">
 188      <form id="customize-controls" class="wrap wp-full-overlay-sidebar">
 189          <div id="customize-header-actions" class="wp-full-overlay-header">
 190              <?php
 191              $compatible_wp  = is_wp_version_compatible( $wp_customize->theme()->get( 'RequiresWP' ) );
 192              $compatible_php = is_php_version_compatible( $wp_customize->theme()->get( 'RequiresPHP' ) );
 193              ?>
 194              <?php if ( $compatible_wp && $compatible_php ) : ?>
 195                  <?php $save_text = $wp_customize->is_theme_active() ? __( 'Publish' ) : __( 'Activate &amp; Publish' ); ?>
 196                  <div id="customize-save-button-wrapper" class="customize-save-button-wrapper" >
 197                      <?php submit_button( $save_text, 'primary save', 'save', false ); ?>
 198                      <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>
 199                  </div>
 200              <?php else : ?>
 201                  <?php $save_text = _x( 'Cannot Activate', 'theme' ); ?>
 202                  <div id="customize-save-button-wrapper" class="customize-save-button-wrapper disabled" >
 203                      <button class="button button-primary disabled" aria-label="<?php esc_attr_e( 'Publish Settings' ); ?>" aria-expanded="false" disabled><?php echo $save_text; ?></button>
 204                  </div>
 205              <?php endif; ?>
 206              <span class="spinner"></span>
 207              <button type="button" class="customize-controls-preview-toggle">
 208                  <span class="controls"><?php _e( 'Customize' ); ?></span>
 209                  <span class="preview"><?php _e( 'Preview' ); ?></span>
 210              </button>
 211              <a class="customize-controls-close" href="<?php echo esc_url( $wp_customize->get_return_url() ); ?>">
 212                  <span class="screen-reader-text">
 213                      <?php
 214                      /* translators: Hidden accessibility text. */
 215                      _e( 'Close the Customizer and go back to the previous page' );
 216                      ?>
 217                  </span>
 218              </a>
 219          </div>
 220  
 221          <div id="customize-sidebar-outer-content">
 222              <div id="customize-outer-theme-controls">
 223                  <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>
 224              </div>
 225          </div>
 226  
 227          <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 -->
 228              <div id="customize-notifications-area" class="customize-control-notifications-container">
 229                  <ul></ul>
 230              </div>
 231              <div class="wp-full-overlay-sidebar-content" tabindex="-1">
 232                  <div id="customize-info" class="accordion-section customize-info" data-block-theme="<?php echo (int) wp_is_block_theme(); ?>">
 233                      <div class="accordion-section-title">
 234                          <span class="preview-notice">
 235                          <?php
 236                              /* translators: %s: The site/panel title in the Customizer. */
 237                              printf( __( 'You are customizing %s' ), '<strong class="panel-title site-title">' . get_bloginfo( 'name', 'display' ) . '</strong>' );
 238                          ?>
 239                          </span>
 240                          <button type="button" class="customize-help-toggle dashicons dashicons-editor-help" aria-expanded="false"><span class="screen-reader-text">
 241                              <?php
 242                              /* translators: Hidden accessibility text. */
 243                              _e( 'Help' );
 244                              ?>
 245                          </span></button>
 246                      </div>
 247                      <div class="customize-panel-description">
 248                          <p>
 249                              <?php
 250                              _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.' );
 251                              ?>
 252                          </p>
 253                          <p>
 254                              <?php
 255                              _e( '<a href="https://wordpress.org/documentation/article/customizer/">Documentation on Customizer</a>' );
 256                              ?>
 257                          </p>
 258                      </div>
 259                  </div>
 260  
 261                  <div id="customize-theme-controls">
 262                      <ul class="customize-pane-parent"><?php // Panels and sections are managed here via JavaScript ?></ul>
 263                  </div>
 264              </div>
 265          </div>
 266  
 267          <div id="customize-footer-actions" class="wp-full-overlay-footer">
 268              <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' ); ?>">
 269                  <span class="collapse-sidebar-arrow"></span>
 270                  <span class="collapse-sidebar-label"><?php _ex( 'Hide Controls', 'short (~12 characters) label for hide controls button' ); ?></span>
 271              </button>
 272              <?php $previewable_devices = $wp_customize->get_previewable_devices(); ?>
 273              <?php if ( ! empty( $previewable_devices ) ) : ?>
 274              <div class="devices-wrapper">
 275                  <div class="devices">
 276                      <?php foreach ( (array) $previewable_devices as $device => $settings ) : ?>
 277                          <?php
 278                          if ( empty( $settings['label'] ) ) {
 279                              continue;
 280                          }
 281                          $active = ! empty( $settings['default'] );
 282                          $class  = 'preview-' . $device;
 283                          if ( $active ) {
 284                              $class .= ' active';
 285                          }
 286                          ?>
 287                          <button type="button" class="<?php echo esc_attr( $class ); ?>" aria-pressed="<?php echo esc_attr( $active ); ?>" data-device="<?php echo esc_attr( $device ); ?>">
 288                              <span class="screen-reader-text"><?php echo esc_html( $settings['label'] ); ?></span>
 289                          </button>
 290                      <?php endforeach; ?>
 291                  </div>
 292              </div>
 293              <?php endif; ?>
 294          </div>
 295      </form>
 296      <div id="customize-preview" class="wp-full-overlay-main"></div>
 297      <?php
 298  
 299      /**
 300       * Prints templates, control scripts, and settings in the footer.
 301       *
 302       * @since 3.4.0
 303       */
 304      do_action( 'customize_controls_print_footer_scripts' );
 305      ?>
 306  </div>
 307  </body>
 308  </html>


Generated : Wed May 8 08:20:02 2024 Cross-referenced by PHPXref