wp/wp-admin/theme-editor.php
changeset 0 d970ebf37754
child 5 5e2f62d02dcd
equal deleted inserted replaced
-1:000000000000 0:d970ebf37754
       
     1 <?php
       
     2 /**
       
     3  * Theme editor administration panel.
       
     4  *
       
     5  * @package WordPress
       
     6  * @subpackage Administration
       
     7  */
       
     8 
       
     9 /** WordPress Administration Bootstrap */
       
    10 require_once( dirname( __FILE__ ) . '/admin.php' );
       
    11 
       
    12 if ( is_multisite() && ! is_network_admin() ) {
       
    13 	wp_redirect( network_admin_url( 'theme-editor.php' ) );
       
    14 	exit();
       
    15 }
       
    16 
       
    17 if ( !current_user_can('edit_themes') )
       
    18 	wp_die('<p>'.__('You do not have sufficient permissions to edit templates for this site.').'</p>');
       
    19 
       
    20 $title = __("Edit Themes");
       
    21 $parent_file = 'themes.php';
       
    22 
       
    23 get_current_screen()->add_help_tab( array(
       
    24 'id'		=> 'overview',
       
    25 'title'		=> __('Overview'),
       
    26 'content'	=>
       
    27 	'<p>' . __('You can use the Theme Editor to edit the individual CSS and PHP files which make up your theme.') . '</p>
       
    28 	<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>
       
    29 	<p>' . __('For PHP files, you can use the Documentation dropdown to select from functions recognized in that file. Look Up takes you to a web page with reference material about that particular function.') . '</p>
       
    30 	<p id="newcontent-description">' . __('In the editing area the Tab key enters a tab character. To move below this area by pressing Tab, press the Esc key followed by the Tab key.') . '</p>
       
    31 	<p>' . __('After typing in your edits, click Update File.') . '</p>
       
    32 	<p>' . __('<strong>Advice:</strong> think very carefully about your site crashing if you are live-editing the theme currently in use.') . '</p>
       
    33 	<p>' . sprintf( __('Upgrading to a newer version of the same theme will override changes made here. To avoid this, consider creating a <a href="%s" target="_blank">child theme</a> instead.'), __('http://codex.wordpress.org/Child_Themes') ) . '</p>' .
       
    34 	( is_network_admin() ? '<p>' . __('Any edits to files from this screen will be reflected on all sites in the network.') . '</p>' : '' )
       
    35 ) );
       
    36 
       
    37 get_current_screen()->set_help_sidebar(
       
    38 	'<p><strong>' . __('For more information:') . '</strong></p>' .
       
    39 	'<p>' . __('<a href="http://codex.wordpress.org/Theme_Development" target="_blank">Documentation on Theme Development</a>') . '</p>' .
       
    40 	'<p>' . __('<a href="http://codex.wordpress.org/Using_Themes" target="_blank">Documentation on Using Themes</a>') . '</p>' .
       
    41 	'<p>' . __('<a href="http://codex.wordpress.org/Editing_Files" target="_blank">Documentation on Editing Files</a>') . '</p>' .
       
    42 	'<p>' . __('<a href="http://codex.wordpress.org/Template_Tags" target="_blank">Documentation on Template Tags</a>') . '</p>' .
       
    43 	'<p>' . __('<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
       
    44 );
       
    45 
       
    46 wp_reset_vars( array( 'action', 'error', 'file', 'theme' ) );
       
    47 
       
    48 if ( $theme )
       
    49 	$stylesheet = $theme;
       
    50 else
       
    51 	$stylesheet = get_stylesheet();
       
    52 
       
    53 $theme = wp_get_theme( $stylesheet );
       
    54 
       
    55 if ( ! $theme->exists() )
       
    56 	wp_die( __( 'The requested theme does not exist.' ) );
       
    57 
       
    58 if ( $theme->errors() && 'theme_no_stylesheet' == $theme->errors()->get_error_code() )
       
    59 	wp_die( __( 'The requested theme does not exist.' ) . ' ' . $theme->errors()->get_error_message() );
       
    60 
       
    61 $allowed_files = $theme->get_files( 'php', 1 );
       
    62 $has_templates = ! empty( $allowed_files );
       
    63 $style_files = $theme->get_files( 'css' );
       
    64 $allowed_files['style.css'] = $style_files['style.css'];
       
    65 $allowed_files += $style_files;
       
    66 
       
    67 if ( empty( $file ) ) {
       
    68 	$relative_file = 'style.css';
       
    69 	$file = $allowed_files['style.css'];
       
    70 } else {
       
    71 	$relative_file = $file;
       
    72 	$file = $theme->get_stylesheet_directory() . '/' . $relative_file;
       
    73 }
       
    74 
       
    75 validate_file_to_edit( $file, $allowed_files );
       
    76 $scrollto = isset( $_REQUEST['scrollto'] ) ? (int) $_REQUEST['scrollto'] : 0;
       
    77 
       
    78 switch( $action ) {
       
    79 case 'update':
       
    80 	check_admin_referer( 'edit-theme_' . $file . $stylesheet );
       
    81 	$newcontent = wp_unslash( $_POST['newcontent'] );
       
    82 	$location = 'theme-editor.php?file=' . urlencode( $relative_file ) . '&theme=' . urlencode( $stylesheet ) . '&scrollto=' . $scrollto;
       
    83 	if ( is_writeable( $file ) ) {
       
    84 		//is_writable() not always reliable, check return value. see comments @ http://uk.php.net/is_writable
       
    85 		$f = fopen( $file, 'w+' );
       
    86 		if ( $f !== false ) {
       
    87 			fwrite( $f, $newcontent );
       
    88 			fclose( $f );
       
    89 			$location .= '&updated=true';
       
    90 			$theme->cache_delete();
       
    91 		}
       
    92 	}
       
    93 	wp_redirect( $location );
       
    94 	exit;
       
    95 break;
       
    96 
       
    97 default:
       
    98 
       
    99 	require_once( ABSPATH . 'wp-admin/admin-header.php' );
       
   100 
       
   101 	update_recently_edited( $file );
       
   102 
       
   103 	if ( ! is_file( $file ) )
       
   104 		$error = true;
       
   105 
       
   106 	$content = '';
       
   107 	if ( ! $error && filesize( $file ) > 0 ) {
       
   108 		$f = fopen($file, 'r');
       
   109 		$content = fread($f, filesize($file));
       
   110 
       
   111 		if ( '.php' == substr( $file, strrpos( $file, '.' ) ) ) {
       
   112 			$functions = wp_doc_link_parse( $content );
       
   113 
       
   114 			$docs_select = '<select name="docs-list" id="docs-list">';
       
   115 			$docs_select .= '<option value="">' . esc_attr__( 'Function Name&hellip;' ) . '</option>';
       
   116 			foreach ( $functions as $function ) {
       
   117 				$docs_select .= '<option value="' . esc_attr( urlencode( $function ) ) . '">' . htmlspecialchars( $function ) . '()</option>';
       
   118 			}
       
   119 			$docs_select .= '</select>';
       
   120 		}
       
   121 
       
   122 		$content = esc_textarea( $content );
       
   123 	}
       
   124 
       
   125 	?>
       
   126 <?php if ( isset( $_GET['updated'] ) ) : ?>
       
   127  <div id="message" class="updated"><p><?php _e( 'File edited successfully.' ) ?></p></div>
       
   128 <?php endif;
       
   129 
       
   130 $description = get_file_description( $file );
       
   131 $file_show = array_search( $file, array_filter( $allowed_files ) );
       
   132 if ( $description != $file_show )
       
   133 	$description .= ' <span>(' . $file_show . ')</span>';
       
   134 ?>
       
   135 <div class="wrap">
       
   136 <?php screen_icon(); ?>
       
   137 <h2><?php echo esc_html( $title ); ?></h2>
       
   138 
       
   139 <div class="fileedit-sub">
       
   140 <div class="alignleft">
       
   141 <h3><?php echo $theme->display('Name'); if ( $description ) echo ': ' . $description; ?></h3>
       
   142 </div>
       
   143 <div class="alignright">
       
   144 	<form action="theme-editor.php" method="post">
       
   145 		<strong><label for="theme"><?php _e('Select theme to edit:'); ?> </label></strong>
       
   146 		<select name="theme" id="theme">
       
   147 <?php
       
   148 foreach ( wp_get_themes( array( 'errors' => null ) ) as $a_stylesheet => $a_theme ) {
       
   149 	if ( $a_theme->errors() && 'theme_no_stylesheet' == $a_theme->errors()->get_error_code() )
       
   150 		continue;
       
   151 
       
   152 	$selected = $a_stylesheet == $stylesheet ? ' selected="selected"' : '';
       
   153 	echo "\n\t" . '<option value="' . esc_attr( $a_stylesheet ) . '"' . $selected . '>' . $a_theme->display('Name') . '</option>';
       
   154 }
       
   155 ?>
       
   156 		</select>
       
   157 		<?php submit_button( __( 'Select' ), 'button', 'Submit', false ); ?>
       
   158 	</form>
       
   159 </div>
       
   160 <br class="clear" />
       
   161 </div>
       
   162 <?php
       
   163 if ( $theme->errors() )
       
   164 	echo '<div class="error"><p><strong>' . __( 'This theme is broken.' ) . '</strong> ' . $theme->errors()->get_error_message() . '</p></div>';
       
   165 ?>
       
   166 	<div id="templateside">
       
   167 <?php
       
   168 if ( $allowed_files ) :
       
   169 	if ( $has_templates || $theme->parent() ) :
       
   170 ?>
       
   171 	<h3><?php _e('Templates'); ?></h3>
       
   172 	<?php if ( $theme->parent() ) : ?>
       
   173 	<p class="howto"><?php printf( __( 'This child theme inherits templates from a parent theme, %s.' ), '<a href="' . self_admin_url('theme-editor.php?theme=' . urlencode( $theme->get_template() ) ) . '">' . $theme->parent()->display('Name') . '</a>' ); ?></p>
       
   174 	<?php endif; ?>
       
   175 	<ul>
       
   176 <?php
       
   177 	endif;
       
   178 
       
   179 	foreach ( $allowed_files as $filename => $absolute_filename ) :
       
   180 		if ( 'style.css' == $filename )
       
   181 			echo "\t</ul>\n\t<h3>" . _x( 'Styles', 'Theme stylesheets in theme editor' ) . "</h3>\n\t<ul>\n";
       
   182 
       
   183 		$file_description = get_file_description( $absolute_filename );
       
   184 		if ( $file_description != basename( $filename ) )
       
   185 			$file_description .= '<br /><span class="nonessential">(' . $filename . ')</span>';
       
   186 
       
   187 		if ( $absolute_filename == $file )
       
   188 			$file_description = '<span class="highlight">' . $file_description . '</span>';
       
   189 ?>
       
   190 		<li><a href="theme-editor.php?file=<?php echo urlencode( $filename ) ?>&amp;theme=<?php echo urlencode( $stylesheet ) ?>"><?php echo $file_description; ?></a></li>
       
   191 <?php
       
   192 	endforeach;
       
   193 ?>
       
   194 </ul>
       
   195 <?php endif; ?>
       
   196 </div>
       
   197 <?php if ( $error ) :
       
   198 	echo '<div class="error"><p>' . __('Oops, no such file exists! Double check the name and try again, merci.') . '</p></div>';
       
   199 else : ?>
       
   200 	<form name="template" id="template" action="theme-editor.php" method="post">
       
   201 	<?php wp_nonce_field( 'edit-theme_' . $file . $stylesheet ); ?>
       
   202 		<div><textarea cols="70" rows="30" name="newcontent" id="newcontent" aria-describedby="newcontent-description"><?php echo $content; ?></textarea>
       
   203 		<input type="hidden" name="action" value="update" />
       
   204 		<input type="hidden" name="file" value="<?php echo esc_attr( $relative_file ); ?>" />
       
   205 		<input type="hidden" name="theme" value="<?php echo esc_attr( $theme->get_stylesheet() ); ?>" />
       
   206 		<input type="hidden" name="scrollto" id="scrollto" value="<?php echo $scrollto; ?>" />
       
   207 		</div>
       
   208 	<?php if ( ! empty( $functions ) ) : ?>
       
   209 		<div id="documentation" class="hide-if-no-js">
       
   210 		<label for="docs-list"><?php _e('Documentation:') ?></label>
       
   211 		<?php echo $docs_select; ?>
       
   212 		<input type="button" class="button" value=" <?php esc_attr_e( 'Look Up' ); ?> " 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'); }" />
       
   213 		</div>
       
   214 	<?php endif; ?>
       
   215 
       
   216 		<div>
       
   217 		<?php if ( is_child_theme() && $theme->get_stylesheet() == get_template() ) : ?>
       
   218 			<p><?php if ( is_writeable( $file ) ) { ?><strong><?php _e( 'Caution:' ); ?></strong><?php } ?>
       
   219 			<?php _e( 'This is a file in your current parent theme.' ); ?></p>
       
   220 		<?php endif; ?>
       
   221 <?php
       
   222 	if ( is_writeable( $file ) ) :
       
   223 		submit_button( __( 'Update File' ), 'primary', 'submit', true );
       
   224 	else : ?>
       
   225 <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>
       
   226 <?php endif; ?>
       
   227 		</div>
       
   228 	</form>
       
   229 <?php
       
   230 endif; // $error
       
   231 ?>
       
   232 <br class="clear" />
       
   233 </div>
       
   234 <script type="text/javascript">
       
   235 /* <![CDATA[ */
       
   236 jQuery(document).ready(function($){
       
   237 	$('#template').submit(function(){ $('#scrollto').val( $('#newcontent').scrollTop() ); });
       
   238 	$('#newcontent').scrollTop( $('#scrollto').val() );
       
   239 });
       
   240 /* ]]> */
       
   241 </script>
       
   242 <?php
       
   243 break;
       
   244 }
       
   245 
       
   246 include(ABSPATH . 'wp-admin/admin-footer.php' );