2004-09-11 12:12:40 -04:00
< ? php
2008-08-16 03:27:34 -04:00
/**
* Theme editor administration panel .
*
* @ package WordPress
* @ subpackage Administration
*/
/** WordPress Administration Bootstrap */
2010-04-18 02:14:45 -04:00
require_once ( './admin.php' );
2006-11-18 02:31:29 -05:00
2010-12-06 10:41:19 -05:00
if ( is_multisite () && ! is_network_admin () ) {
wp_redirect ( network_admin_url ( 'theme-editor.php' ) );
exit ();
}
2009-08-08 03:22:19 -04:00
if ( ! current_user_can ( 'edit_themes' ) )
2010-04-29 21:54:32 -04:00
wp_die ( '<p>' . __ ( 'You do not have sufficient permissions to edit templates for this site.' ) . '</p>' );
2009-08-08 03:22:19 -04:00
2006-11-18 02:31:29 -05:00
$title = __ ( " Edit Themes " );
$parent_file = 'themes.php' ;
2010-05-26 14:27:13 -04:00
$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>' ;
2010-06-03 23:42:43 -04:00
$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>' ;
2010-05-27 07:52:15 -04:00
$help .= '<p><strong>' . __ ( 'For more information:' ) . '</strong></p>' ;
2010-06-03 17:00:39 -04:00
$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>' ;
2010-05-26 14:27:13 -04:00
add_contextual_help ( $current_screen , $help );
2009-10-19 17:39:04 -04:00
wp_reset_vars ( array ( 'action' , 'redirect' , 'profile' , 'error' , 'warning' , 'a' , 'file' , 'theme' , 'dir' ));
2004-09-11 12:12:40 -04:00
2008-05-21 20:06:41 -04:00
wp_admin_css ( 'theme-editor' );
2008-02-17 18:53:36 -05:00
2004-11-16 22:15:44 -05:00
$themes = get_themes ();
if ( empty ( $theme )) {
$theme = get_current_theme ();
2005-02-26 01:38:18 -05:00
} else {
$theme = stripslashes ( $theme );
2009-10-07 11:22:23 -04:00
}
2005-04-19 17:41:35 -04:00
if ( ! isset ( $themes [ $theme ]) )
2006-07-05 18:00:03 -04:00
wp_die ( __ ( 'The requested theme does not exist.' ));
2004-11-16 22:15:44 -05:00
2010-12-03 23:31:55 -05:00
$allowed_files = array_merge ( $themes [ $theme ][ 'Stylesheet Files' ], $themes [ $theme ][ 'Template Files' ] );
2004-11-16 22:15:44 -05:00
2010-12-03 23:31:55 -05:00
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 ];
2009-10-19 17:39:04 -04:00
} else {
2009-12-01 17:03:13 -05:00
$file = stripslashes ( $file );
2009-10-19 17:39:04 -04:00
if ( 'theme' == $dir ) {
2010-01-15 17:11:12 -05:00
$file = dirname ( dirname ( $themes [ $theme ][ 'Template Dir' ])) . $file ;
2009-10-19 17:39:04 -04:00
} else if ( 'style' == $dir ) {
2010-01-15 17:11:12 -05:00
$file = dirname ( dirname ( $themes [ $theme ][ 'Stylesheet Dir' ])) . $file ;
2009-10-19 17:39:04 -04:00
}
2004-11-16 22:15:44 -05:00
}
2009-12-01 17:03:13 -05:00
validate_file_to_edit ( $file , $allowed_files );
2009-08-08 03:22:19 -04:00
$scrollto = isset ( $_REQUEST [ 'scrollto' ]) ? ( int ) $_REQUEST [ 'scrollto' ] : 0 ;
2005-11-14 05:26:39 -05:00
$file_show = basename ( $file );
2004-09-11 12:12:40 -04:00
switch ( $action ) {
case 'update' :
2006-05-26 19:08:05 -04:00
check_admin_referer ( 'edit-theme_' . $file . $theme );
2006-03-30 18:12:54 -05:00
2004-09-11 12:12:40 -04:00
$newcontent = stripslashes ( $_POST [ 'newcontent' ]);
2004-11-25 11:15:27 -05:00
$theme = urlencode ( $theme );
2009-12-01 17:03:13 -05:00
if ( is_writeable ( $file )) {
2008-06-27 16:14:50 -04:00
//is_writable() not always reliable, check return value. see comments @ http://uk.php.net/is_writable
2009-12-01 17:03:13 -05:00
$f = fopen ( $file , 'w+' );
2008-06-27 16:14:50 -04:00
if ( $f !== FALSE ) {
fwrite ( $f , $newcontent );
fclose ( $f );
2009-08-08 03:22:19 -04:00
$location = " theme-editor.php?file= $file &theme= $theme &a=te&scrollto= $scrollto " ;
2008-06-27 16:14:50 -04:00
} else {
2009-08-08 03:22:19 -04:00
$location = " theme-editor.php?file= $file &theme= $theme &scrollto= $scrollto " ;
2008-06-27 16:14:50 -04:00
}
2004-11-16 22:15:44 -05:00
} else {
2009-08-08 03:22:19 -04:00
$location = " theme-editor.php?file= $file &theme= $theme &scrollto= $scrollto " ;
2004-11-16 22:15:44 -05:00
}
2004-09-11 12:12:40 -04:00
2006-10-02 15:26:12 -04:00
$location = wp_kses_no_null ( $location );
2009-06-20 13:42:24 -04:00
$strip = array ( '%0d' , '%0a' , '%0D' , '%0A' );
$location = _deep_replace ( $strip , $location );
2006-10-02 15:26:12 -04:00
header ( " Location: $location " );
2004-09-11 12:12:40 -04:00
exit ();
break ;
default :
2006-02-12 02:53:23 -05:00
2010-10-19 14:23:23 -04:00
require_once ( ABSPATH . 'wp-admin/admin-header.php' );
2006-08-22 14:20:00 -04:00
2004-11-16 22:15:44 -05:00
update_recently_edited ( $file );
2006-02-12 02:53:23 -05:00
2009-12-01 17:03:13 -05:00
if ( ! is_file ( $file ) )
2004-09-11 12:12:40 -04:00
$error = 1 ;
2006-02-12 02:53:23 -05:00
2010-10-04 04:48:43 -04:00
$content = '' ;
2009-12-01 17:03:13 -05:00
if ( ! $error && filesize ( $file ) > 0 ) {
$f = fopen ( $file , 'r' );
$content = fread ( $f , filesize ( $file ));
2009-02-20 15:00:09 -05:00
2009-12-01 17:03:13 -05:00
if ( '.php' == substr ( $file , strrpos ( $file , '.' ) ) ) {
2009-02-20 15:00:09 -05:00
$functions = wp_doc_link_parse ( $content );
2009-03-06 11:17:57 -05:00
2009-02-20 15:00:09 -05:00
$docs_select = '<select name="docs-list" id="docs-list">' ;
2009-05-05 15:43:53 -04:00
$docs_select .= '<option value="">' . esc_attr__ ( 'Function Name...' ) . '</option>' ;
2009-03-06 11:17:57 -05:00
foreach ( $functions as $function ) {
2009-05-05 15:43:53 -04:00
$docs_select .= '<option value="' . esc_attr ( urlencode ( $function ) ) . '">' . htmlspecialchars ( $function ) . '()</option>' ;
2009-02-20 15:00:09 -05:00
}
$docs_select .= '</select>' ;
}
2010-11-17 12:12:01 -05:00
$content = esc_textarea ( $content );
2004-09-11 12:12:40 -04:00
}
?>
< ? php if ( isset ( $_GET [ 'a' ])) : ?>
2009-12-26 04:00:58 -05:00
< div id = " message " class = " updated " >< p >< ? php _e ( 'File edited successfully.' ) ?> </p></div>
2008-03-02 15:17:30 -05:00
< ? php endif ;
2008-02-16 17:08:13 -05:00
$description = get_file_description ( $file );
2010-12-03 23:16:23 -05:00
$desc_header = ( $description != $file_show ) ? " $description <span>( $file_show )</span> " : $file_show ;
2010-12-03 22:52:59 -05:00
$is_child_theme = $themes [ $theme ][ 'Template' ] != $themes [ $theme ][ 'Stylesheet' ];
2004-09-11 12:12:40 -04:00
?>
2008-02-16 17:08:13 -05:00
< div class = " wrap " >
2008-11-26 08:51:25 -05:00
< ? php screen_icon (); ?>
2009-05-18 11:11:07 -04:00
< h2 >< ? php echo esc_html ( $title ); ?> </h2>
2009-06-26 07:07:10 -04:00
< div class = " fileedit-sub " >
< div class = " alignleft " >
2010-12-03 23:16:23 -05:00
< h3 >< ? php echo $themes [ $theme ][ 'Name' ] . ': ' . $desc_header ; ?> </h3>
2009-06-26 07:07:10 -04:00
</ div >
< div class = " alignright " >
< form action = " theme-editor.php " method = " post " >
2008-05-04 06:37:06 -04:00
< strong >< label for = " theme " >< ? php _e ( 'Select theme to edit:' ); ?> </label></strong>
2008-03-14 19:58:31 -04:00
< select name = " theme " id = " theme " >
2008-02-16 17:08:13 -05:00
< ? php
foreach ( $themes as $a_theme ) {
$theme_name = $a_theme [ 'Name' ];
if ( $theme_name == $theme ) $selected = " selected='selected' " ;
else $selected = '' ;
2009-05-05 15:43:53 -04:00
$theme_name = esc_attr ( $theme_name );
2008-02-16 17:08:13 -05:00
echo " \n \t <option value= \" $theme_name\ " $selected > $theme_name </ option > " ;
}
?>
</ select >
2010-10-28 17:56:43 -04:00
< ? php submit_button ( __ ( 'Select' ), 'button' , 'Submit' , false ); ?>
2008-02-16 17:08:13 -05:00
</ form >
</ div >
2008-03-14 19:58:31 -04:00
< br class = " clear " />
2008-02-16 17:08:13 -05:00
</ div >
2004-11-16 22:15:44 -05:00
< div id = " templateside " >
< ? php
if ( $allowed_files ) :
?>
2009-12-24 22:16:25 -05:00
< h3 >< ? php _e ( 'Templates' ); ?> </h3>
2010-12-03 22:52:59 -05:00
< ? 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 ; ?>
2008-02-16 17:08:13 -05:00
< ul >
2008-08-23 05:28:39 -04:00
< ? php
$template_mapping = array ();
2008-12-04 16:29:55 -05:00
$template_dir = $themes [ $theme ][ 'Template Dir' ];
2009-03-25 12:51:08 -04:00
foreach ( $themes [ $theme ][ 'Template Files' ] as $template_file ) {
2010-12-03 22:52:59 -05:00
// Don't show parent templates.
if ( $is_child_theme && strpos ( $template_file , $themes [ $theme ][ 'Template Dir' ] ) === 0 )
continue ;
2008-08-23 05:28:39 -04:00
$description = trim ( get_file_description ( $template_file ) );
2008-02-16 17:08:13 -05:00
$template_show = basename ( $template_file );
2009-12-24 22:16:25 -05:00
$filedesc = ( $description != $template_file ) ? " $description <br /><span class='nonessential'>( $template_show )</span> " : " $description " ;
2010-05-14 03:04:17 -04:00
$filedesc = ( $template_file == $file ) ? " <span class='highlight'> $description <br /><span class='nonessential'>( $template_show )</span></span> " : $filedesc ;
2010-12-03 23:16:23 -05:00
$template_mapping [ $description ] = array ( _get_template_edit_filename ( $template_file , $template_dir ), $filedesc );
2008-08-23 05:28:39 -04:00
}
ksort ( $template_mapping );
while ( list ( $template_sorted_key , list ( $template_file , $filedesc ) ) = each ( $template_mapping ) ) :
?>
2009-10-19 17:39:04 -04:00
< li >< a href = " theme-editor.php?file=<?php echo " $template_file " ; ?>&theme=<?php echo urlencode( $theme ) ?>&dir=theme " >< ? php echo $filedesc ?> </a></li>
2008-08-23 05:28:39 -04:00
< ? php endwhile ; ?>
2008-02-16 17:08:13 -05:00
</ ul >
2010-05-14 17:46:25 -04:00
< h3 >< ? php /* translators: Theme stylesheets in theme editor */ _ex ( 'Styles' , 'Theme stylesheets in theme editor' ); ?> </h3>
2006-11-19 02:56:05 -05:00
< ul >
2008-08-23 05:28:39 -04:00
< ? php
$template_mapping = array ();
2009-10-19 17:39:04 -04:00
$stylesheet_dir = $themes [ $theme ][ 'Stylesheet Dir' ];
2009-03-25 12:51:08 -04:00
foreach ( $themes [ $theme ][ 'Stylesheet Files' ] as $style_file ) {
2010-12-03 22:52:59 -05:00
// Don't show parent styles.
if ( $is_child_theme && strpos ( $style_file , $themes [ $theme ][ 'Template Dir' ] ) === 0 )
continue ;
2008-08-23 05:28:39 -04:00
$description = trim ( get_file_description ( $style_file ) );
2008-02-16 17:08:13 -05:00
$style_show = basename ( $style_file );
2009-12-24 22:16:25 -05:00
$filedesc = ( $description != $style_file ) ? " $description <br /><span class='nonessential'>( $style_show )</span> " : " $description " ;
2010-05-14 03:04:17 -04:00
$filedesc = ( $style_file == $file ) ? " <span class='highlight'> $description <br /><span class='nonessential'>( $style_show )</span></span> " : $filedesc ;
2009-11-13 13:54:54 -05:00
$template_mapping [ $description ] = array ( _get_template_edit_filename ( $style_file , $stylesheet_dir ), $filedesc );
2008-08-23 05:28:39 -04:00
}
ksort ( $template_mapping );
while ( list ( $template_sorted_key , list ( $style_file , $filedesc ) ) = each ( $template_mapping ) ) :
2008-02-16 17:08:13 -05:00
?>
2009-10-19 17:39:04 -04:00
< li >< a href = " theme-editor.php?file=<?php echo " $style_file " ; ?>&theme=<?php echo urlencode( $theme ) ?>&dir=style " >< ? php echo $filedesc ?> </a></li>
2008-08-23 05:28:39 -04:00
< ? php endwhile ; ?>
2006-11-19 02:56:05 -05:00
</ ul >
2004-11-16 22:15:44 -05:00
< ? php endif ; ?>
2006-11-19 02:56:05 -05:00
</ div >
2009-06-26 07:07:10 -04:00
< ? php if ( ! $error ) { ?>
2006-11-19 02:56:05 -05:00
< form name = " template " id = " template " action = " theme-editor.php " method = " post " >
< ? php wp_nonce_field ( 'edit-theme_' . $file . $theme ) ?>
2010-05-17 23:48:22 -04:00
< div >< textarea cols = " 70 " rows = " 25 " name = " newcontent " id = " newcontent " tabindex = " 1 " >< ? php echo $content ?> </textarea>
2006-11-19 02:56:05 -05:00
< input type = " hidden " name = " action " value = " update " />
2009-05-05 15:43:53 -04:00
< input type = " hidden " name = " file " value = " <?php echo esc_attr( $file ) ?> " />
< input type = " hidden " name = " theme " value = " <?php echo esc_attr( $theme ) ?> " />
2009-08-08 03:22:19 -04:00
< input type = " hidden " name = " scrollto " id = " scrollto " value = " <?php echo $scrollto ; ?> " />
2004-11-16 22:15:44 -05:00
</ div >
2009-03-15 13:14:44 -04:00
< ? php if ( isset ( $functions ) && count ( $functions ) ) { ?>
2010-05-25 23:57:55 -04:00
< div id = " documentation " class = " hide-if-no-js " >
2009-03-25 12:51:08 -04:00
< label for = " docs-list " >< ? php _e ( 'Documentation:' ) ?> </label>
2009-03-15 13:14:44 -04:00
< ? php echo $docs_select ; ?>
2010-05-25 23:57:55 -04:00
< 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'); } " />
2009-03-15 13:14:44 -04:00
</ div >
< ? php } ?>
2008-03-02 15:17:30 -05:00
2008-02-17 17:23:04 -05:00
< div >
2010-12-03 22:52:59 -05:00
< ? 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>
2010-12-03 17:58:56 -05:00
< ? php endif ; ?>
2004-11-16 22:15:44 -05:00
< ? php
2010-12-03 17:58:56 -05:00
if ( is_writeable ( $file ) ) :
2010-10-28 17:56:43 -04:00
submit_button ( __ ( 'Update File' ), 'primary' , 'submit' , true , array ( 'tabindex' => '2' ) );
else : ?>
2008-02-09 15:17:49 -05:00
< 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>
2004-11-16 22:15:44 -05:00
< ? php endif ; ?>
2008-02-17 17:23:04 -05:00
</ div >
2006-11-19 02:56:05 -05:00
</ form >
2009-06-26 07:07:10 -04:00
< ? php
2004-09-11 12:12:40 -04:00
} else {
echo '<div class="error"><p>' . __ ( 'Oops, no such file exists! Double check the name and try again, merci.' ) . '</p></div>' ;
}
2009-06-26 07:07:10 -04:00
?>
< br class = " clear " />
2006-11-19 02:56:05 -05:00
</ div >
2009-08-08 03:22:19 -04:00
< script type = " text/javascript " >
/* <![CDATA[ */
jQuery ( document ) . ready ( function ( $ ){
$ ( '#template' ) . submit ( function (){ $ ( '#scrollto' ) . val ( $ ( '#newcontent' ) . scrollTop () ); });
2010-02-18 00:14:48 -05:00
$ ( '#newcontent' ) . scrollTop ( $ ( '#scrollto' ) . val () );
2009-08-08 03:22:19 -04:00
});
/* ]]> */
</ script >
2004-09-11 12:12:40 -04:00
< ? php
break ;
}
2010-10-19 14:23:23 -04:00
include ( ABSPATH . " wp-admin/admin-footer.php " );