]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-admin/theme-editor.php
Wordpress 3.1.3
[autoinstalls/wordpress.git] / wp-admin / theme-editor.php
index c7343a7a521d9a4c972fdb7fe6559bd2c608108d..7760d507172b50388818c7fd0c9cfc651422021b 100644 (file)
@@ -7,12 +7,36 @@
  */
 
 /** WordPress Administration Bootstrap */
-require_once('admin.php');
+require_once('./admin.php');
+
+if ( is_multisite() && ! is_network_admin() ) {
+       wp_redirect( network_admin_url( 'theme-editor.php' ) );
+       exit();
+}
+
+if ( !current_user_can('edit_themes') )
+       wp_die('<p>'.__('You do not have sufficient permissions to edit templates for this site.').'</p>');
 
 $title = __("Edit Themes");
 $parent_file = 'themes.php';
 
-wp_reset_vars(array('action', 'redirect', 'profile', 'error', 'warning', 'a', 'file', 'theme'));
+$help = '<p>' . __('You can use the Theme Editor to edit the individual CSS and PHP files which make up your theme.') . '</p>';
+$help .= '<p>' . __('Begin by choosing a theme to edit from the dropdown menu and clicking Select. A list then appears of all the template files. Clicking once on any file name causes the file to appear in the large Editor box.') . '</p>';
+$help .= '<p>' . __('For PHP files, you can use the Documentation dropdown to select from functions recognized in that file. Lookup takes you to a web page with reference material about that particular function.') . '</p>';
+$help .= '<p>' . __('After typing in your edits, click Update File.') . '</p>';
+$help .= '<p>' . __('<strong>Advice:</strong> think very carefully about your site crashing if you are live-editing the theme currently in use.') . '</p>';
+$help .= '<p>' . __('Upgrading to a newer version of the same theme will override changes made here. To avoid this, consider creating a <a href="http://codex.wordpress.org/Child_Themes" target="_blank">child theme</a> instead.') . '</p>';
+if ( is_network_admin() )
+       $help .= '<p>' . __('Any edits to files from this screen will be reflected on all sites in the network.') . '</p>';
+$help .= '<p><strong>' . __('For more information:') . '</strong></p>';
+$help .= '<p>' . __('<a href="http://codex.wordpress.org/Theme_Development" target="_blank">Documentation on Theme Development</a>') . '</p>';
+$help .= '<p>' . __('<a href="http://codex.wordpress.org/Using_Themes" target="_blank">Documentation on Using Themes</a>') . '</p>';
+$help .= '<p>' . __('<a href="http://codex.wordpress.org/Editing_Files" target="_blank">Documentation on Editing Files</a>') . '</p>';
+$help .= '<p>' . __('<a href="http://codex.wordpress.org/Template_Tags" target="_blank">Documentation on Template Tags</a>') . '</p>';
+$help .= '<p>' . __('<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>';
+add_contextual_help($current_screen, $help);
+
+wp_reset_vars(array('action', 'redirect', 'profile', 'error', 'warning', 'a', 'file', 'theme', 'dir'));
 
 wp_admin_css( 'theme-editor' );
 
@@ -27,15 +51,24 @@ if (empty($theme)) {
 if ( ! isset($themes[$theme]) )
        wp_die(__('The requested theme does not exist.'));
 
-$allowed_files = array_merge($themes[$theme]['Stylesheet Files'], $themes[$theme]['Template Files']);
+$allowed_files = array_merge( $themes[$theme]['Stylesheet Files'], $themes[$theme]['Template Files'] );
 
-if (empty($file)) {
-       $file = $allowed_files[0];
+if ( empty( $file ) ) {
+       if ( false !== array_search( $themes[$theme]['Stylesheet Dir'] . '/style.css', $allowed_files ) )
+               $file = $themes[$theme]['Stylesheet Dir'] . '/style.css';
+       else
+               $file = $allowed_files[0];
+} else {
+       $file = stripslashes($file);
+       if ( 'theme' == $dir ) {
+               $file = dirname(dirname($themes[$theme]['Template Dir'])) . $file ;
+       } else if ( 'style' == $dir) {
+               $file = dirname(dirname($themes[$theme]['Stylesheet Dir'])) . $file ;
+       }
 }
 
-$file = validate_file_to_edit($file, $allowed_files);
-$real_file = get_real_file_to_edit($file);
-
+validate_file_to_edit($file, $allowed_files);
+$scrollto = isset($_REQUEST['scrollto']) ? (int) $_REQUEST['scrollto'] : 0;
 $file_show = basename( $file );
 
 switch($action) {
@@ -44,23 +77,20 @@ case 'update':
 
        check_admin_referer('edit-theme_' . $file . $theme);
 
-       if ( !current_user_can('edit_themes') )
-               wp_die('<p>'.__('You do not have sufficient permissions to edit templates for this blog.').'</p>');
-
        $newcontent = stripslashes($_POST['newcontent']);
        $theme = urlencode($theme);
-       if (is_writeable($real_file)) {
+       if (is_writeable($file)) {
                //is_writable() not always reliable, check return value. see comments @ http://uk.php.net/is_writable
-               $f = fopen($real_file, 'w+');
+               $f = fopen($file, 'w+');
                if ($f !== FALSE) {
                        fwrite($f, $newcontent);
                        fclose($f);
-                       $location = "theme-editor.php?file=$file&theme=$theme&a=te";
+                       $location = "theme-editor.php?file=$file&theme=$theme&a=te&scrollto=$scrollto";
                } else {
-                       $location = "theme-editor.php?file=$file&theme=$theme";
+                       $location = "theme-editor.php?file=$file&theme=$theme&scrollto=$scrollto";
                }
        } else {
-               $location = "theme-editor.php?file=$file&theme=$theme";
+               $location = "theme-editor.php?file=$file&theme=$theme&scrollto=$scrollto";
        }
 
        $location = wp_kses_no_null($location);
@@ -73,21 +103,19 @@ break;
 
 default:
 
-       if ( !current_user_can('edit_themes') )
-               wp_die('<p>'.__('You do not have sufficient permissions to edit themes for this blog.').'</p>');
-
-       require_once('admin-header.php');
+       require_once(ABSPATH . 'wp-admin/admin-header.php');
 
        update_recently_edited($file);
 
-       if ( !is_file($real_file) )
+       if ( !is_file($file) )
                $error = 1;
 
-       if ( !$error && filesize($real_file) > 0 ) {
-               $f = fopen($real_file, 'r');
-               $content = fread($f, filesize($real_file));
+       $content = '';
+       if ( !$error && filesize($file) > 0 ) {
+               $f = fopen($file, 'r');
+               $content = fread($f, filesize($file));
 
-               if ( '.php' == substr( $real_file, strrpos( $real_file, '.' ) ) ) {
+               if ( '.php' == substr( $file, strrpos( $file, '.' ) ) ) {
                        $functions = wp_doc_link_parse( $content );
 
                        $docs_select = '<select name="docs-list" id="docs-list">';
@@ -98,17 +126,18 @@ default:
                        $docs_select .= '</select>';
                }
 
-               $content = htmlspecialchars( $content );
-               $codepress_lang = codepress_get_lang($real_file);
+               $content = esc_textarea( $content );
        }
 
        ?>
 <?php if (isset($_GET['a'])) : ?>
- <div id="message" class="updated fade"><p><?php _e('File edited successfully.') ?></p></div>
+ <div id="message" class="updated"><p><?php _e('File edited successfully.') ?></p></div>
 <?php endif;
 
 $description = get_file_description($file);
-$desc_header = ( $description != $file_show ) ? "<strong>$description</strong> (%s)" : "%s";
+$desc_header = ( $description != $file_show ) ? "$description <span>($file_show)</span>" : $file_show;
+
+$is_child_theme = $themes[$theme]['Template'] != $themes[$theme]['Stylesheet'];
 ?>
 <div class="wrap">
 <?php screen_icon(); ?>
@@ -116,7 +145,7 @@ $desc_header = ( $description != $file_show ) ? "<strong>$description</strong> (
 
 <div class="fileedit-sub">
 <div class="alignleft">
-<big><?php echo sprintf($desc_header, $file_show); ?></big>
+<h3><?php echo $themes[$theme]['Name'] . ': ' . $desc_header; ?></h3>
 </div>
 <div class="alignright">
        <form action="theme-editor.php" method="post">
@@ -132,93 +161,94 @@ $desc_header = ( $description != $file_show ) ? "<strong>$description</strong> (
 }
 ?>
                </select>
-               <input type="submit" name="Submit" value="<?php esc_attr_e('Select') ?>" class="button" />
+               <?php submit_button( __( 'Select' ), 'button', 'Submit', false ); ?>
        </form>
 </div>
 <br class="clear" />
 </div>
-
-<div id="templateside">
-       <h3><?php _e("Theme Files"); ?></h3>
-
+       <div id="templateside">
 <?php
 if ($allowed_files) :
 ?>
-       <h4><?php _e('Templates'); ?></h4>
+       <h3><?php _e('Templates'); ?></h3>
+       <?php if ( $is_child_theme ) : ?>
+       <p class="howto"><?php printf( __( 'This child theme inherits templates from a parent theme, %s.' ), $themes[$theme]['Parent Theme'] ); ?></p>
+       <?php endif; ?>
        <ul>
 <?php
        $template_mapping = array();
        $template_dir = $themes[$theme]['Template Dir'];
        foreach ( $themes[$theme]['Template Files'] as $template_file ) {
+               // Don't show parent templates.
+               if ( $is_child_theme && strpos( $template_file, trailingslashit( $template_dir ) ) === 0 )
+                       continue;
+
                $description = trim( get_file_description($template_file) );
                $template_show = basename($template_file);
-               $filedesc = ( $description != $template_file ) ? "$description <span class='nonessential'>($template_show)</span>" : "$description";
-               $filedesc = ( $template_file == $file ) ? "<span class='highlight'>$description <span class='nonessential'>($template_show)</span></span>" : $filedesc;
-
-               // If we have two files of the same name prefer the one in the Template Directory
-               // This means that we display the correct files for child themes which overload Templates as well as Styles
-               if( array_key_exists($description, $template_mapping ) ) {
-                       if ( false !== strpos( $template_file, $template_dir ) )  {
-                               $template_mapping[ $description ] = array( $template_file, $filedesc );
-                       }
-               } else {
-                       $template_mapping[ $description ] = array( $template_file, $filedesc );
-               }
+               $filedesc = ( $description != $template_file ) ? "$description<br /><span class='nonessential'>($template_show)</span>" : "$description";
+               $filedesc = ( $template_file == $file ) ? "<span class='highlight'>$description<br /><span class='nonessential'>($template_show)</span></span>" : $filedesc;
+               $template_mapping[ $description ] = array( _get_template_edit_filename($template_file, $template_dir), $filedesc );
        }
        ksort( $template_mapping );
        while ( list( $template_sorted_key, list( $template_file, $filedesc ) ) = each( $template_mapping ) ) :
        ?>
-               <li><a href="theme-editor.php?file=<?php echo "$template_file"; ?>&amp;theme=<?php echo urlencode($theme) ?>"><?php echo $filedesc ?></a></li>
+               <li><a href="theme-editor.php?file=<?php echo "$template_file"; ?>&amp;theme=<?php echo urlencode($theme) ?>&amp;dir=theme"><?php echo $filedesc ?></a></li>
 <?php endwhile; ?>
        </ul>
-       <h4><?php /* translators: Theme stylesheets in theme editor */ echo _x('Styles', 'Theme stylesheets in theme editor'); ?></h4>
+       <h3><?php /* translators: Theme stylesheets in theme editor */ _ex('Styles', 'Theme stylesheets in theme editor'); ?></h3>
        <ul>
 <?php
        $template_mapping = array();
+       $stylesheet_dir = $themes[$theme]['Stylesheet Dir'];
        foreach ( $themes[$theme]['Stylesheet Files'] as $style_file ) {
+               // Don't show parent styles.
+               if ( $is_child_theme && strpos( $style_file, trailingslashit( $template_dir ) ) === 0 )
+                       continue;
+
                $description = trim( get_file_description($style_file) );
                $style_show = basename($style_file);
-               $filedesc = ( $description != $style_file ) ? "$description <span class='nonessential'>($style_show)</span>" : "$description";
-               $filedesc = ( $style_file == $file ) ? "<span class='highlight'>$description <span class='nonessential'>($style_show)</span></span>" : $filedesc;
-               $template_mapping[ $description ] = array( $style_file, $filedesc );
+               $filedesc = ( $description != $style_file ) ? "$description<br /><span class='nonessential'>($style_show)</span>" : "$description";
+               $filedesc = ( $style_file == $file ) ? "<span class='highlight'>$description<br /><span class='nonessential'>($style_show)</span></span>" : $filedesc;
+               $template_mapping[ $description ] = array( _get_template_edit_filename($style_file, $stylesheet_dir), $filedesc );
        }
        ksort( $template_mapping );
        while ( list( $template_sorted_key, list( $style_file, $filedesc ) ) = each( $template_mapping ) ) :
                ?>
-               <li><a href="theme-editor.php?file=<?php echo "$style_file"; ?>&amp;theme=<?php echo urlencode($theme) ?>"><?php echo $filedesc ?></a></li>
+               <li><a href="theme-editor.php?file=<?php echo "$style_file"; ?>&amp;theme=<?php echo urlencode($theme) ?>&amp;dir=style"><?php echo $filedesc ?></a></li>
 <?php endwhile; ?>
        </ul>
 <?php endif; ?>
 </div>
-
 <?php if (!$error) { ?>
-<form name="template" id="template" action="theme-editor.php" method="post">
+       <form name="template" id="template" action="theme-editor.php" method="post">
        <?php wp_nonce_field('edit-theme_' . $file . $theme) ?>
-                <div><textarea cols="70" rows="25" name="newcontent" id="newcontent" tabindex="1" class="codepress <?php echo $codepress_lang ?>"><?php echo $content ?></textarea>
+                <div><textarea cols="70" rows="25" name="newcontent" id="newcontent" tabindex="1"><?php echo $content ?></textarea>
                 <input type="hidden" name="action" value="update" />
                 <input type="hidden" name="file" value="<?php echo esc_attr($file) ?>" />
                 <input type="hidden" name="theme" value="<?php echo esc_attr($theme) ?>" />
+                <input type="hidden" name="scrollto" id="scrollto" value="<?php echo $scrollto; ?>" />
                 </div>
        <?php if ( isset($functions ) && count($functions) ) { ?>
-               <div id="documentation">
+               <div id="documentation" class="hide-if-no-js">
                <label for="docs-list"><?php _e('Documentation:') ?></label>
                <?php echo $docs_select; ?>
-               <input type="button" class="button" value=" <?php esc_attr_e( 'Lookup' ); ?> " onclick="if ( '' != jQuery('#docs-list').val() ) { window.open( 'http://api.wordpress.org/core/handbook/1.0/?function=' + escape( jQuery( '#docs-list' ).val() ) + '&locale=<?php echo urlencode( get_locale() ) ?>&version=<?php echo urlencode( $wp_version ) ?>&redirect=true'); }" />
+               <input type="button" class="button" value=" <?php esc_attr_e( 'Lookup' ); ?> " onclick="if ( '' != jQuery('#docs-list').val() ) { window.open( 'http://api.wordpress.org/core/handbook/1.0/?function=' + escape( jQuery( '#docs-list' ).val() ) + '&amp;locale=<?php echo urlencode( get_locale() ) ?>&amp;version=<?php echo urlencode( $wp_version ) ?>&amp;redirect=true'); }" />
                </div>
        <?php } ?>
 
                <div>
-<?php if ( is_writeable($real_file) ) : ?>
-                       <p class="submit">
+               <?php if ( is_child_theme() && ! $is_child_theme && $themes[$theme]['Template'] == get_option('template') ) : ?>
+                       <p><?php if ( is_writeable( $file ) ) { ?><strong><?php _e( 'Caution:' ); ?></strong><?php } ?>
+                       <?php _e( 'This is a file in your current parent theme.' ); ?></p>
+               <?php endif; ?>
 <?php
-       echo "<input type='submit' name='submit' class='button-primary' value='" . esc_attr__('Update File') . "' tabindex='2' />";
-?>
-</p>
-<?php else : ?>
+       if ( is_writeable( $file ) ) :
+               submit_button( __( 'Update File' ), 'primary', 'submit', true, array( 'tabindex' => '2' ) );
+       else : ?>
 <p><em><?php _e('You need to make this file writable before you can save your changes. See <a href="http://codex.wordpress.org/Changing_File_Permissions">the Codex</a> for more information.'); ?></em></p>
 <?php endif; ?>
                </div>
-</form>
+       </form>
 <?php
        } else {
                echo '<div class="error"><p>' . __('Oops, no such file exists! Double check the name and try again, merci.') . '</p></div>';
@@ -226,8 +256,16 @@ if ($allowed_files) :
 ?>
 <br class="clear" />
 </div>
+<script type="text/javascript">
+/* <![CDATA[ */
+jQuery(document).ready(function($){
+       $('#template').submit(function(){ $('#scrollto').val( $('#newcontent').scrollTop() ); });
+       $('#newcontent').scrollTop( $('#scrollto').val() );
+});
+/* ]]> */
+</script>
 <?php
 break;
 }
 
-include("admin-footer.php");
+include(ABSPATH . "wp-admin/admin-footer.php");