2004-09-11 16:12:40 +00:00
< ? php
2008-08-16 07:27:34 +00:00
/**
* Theme editor administration panel .
*
* @ package WordPress
* @ subpackage Administration
*/
/** WordPress Administration Bootstrap */
2010-04-18 06:14:45 +00:00
require_once ( './admin.php' );
2006-11-18 07:31:29 +00:00
2010-12-06 15:41:19 +00:00
if ( is_multisite () && ! is_network_admin () ) {
wp_redirect ( network_admin_url ( 'theme-editor.php' ) );
exit ();
}
2009-08-08 07:22:19 +00:00
if ( ! current_user_can ( 'edit_themes' ) )
2010-04-30 01:54:32 +00:00
wp_die ( '<p>' . __ ( 'You do not have sufficient permissions to edit templates for this site.' ) . '</p>' );
2009-08-08 07:22:19 +00:00
2006-11-18 07:31:29 +00:00
$title = __ ( " Edit Themes " );
$parent_file = 'themes.php' ;
2011-11-24 00:21:39 +00:00
get_current_screen () -> add_help_tab ( array (
'id' => 'overview' ,
'title' => __ ( 'Overview' ),
2011-12-01 04:51:35 +00:00
'content' =>
2011-11-24 00:21:39 +00:00
'<p>' . __ ( 'You can use the Theme Editor to edit the individual CSS and PHP files which make up your theme.' ) . ' </ p >
< 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 >
< 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 >
< p > ' . __(' After typing in your edits , click Update File . ') . ' </ p >
< p > ' . __(' < strong > Advice :</ strong > think very carefully about your site crashing if you are live - editing the theme currently in use . ') . ' </ p >
< 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 > ' .
( is_network_admin () ? '<p>' . __ ( 'Any edits to files from this screen will be reflected on all sites in the network.' ) . '</p>' : '' )
) );
2010-05-26 18:27:13 +00:00
2011-11-02 21:32:16 +00:00
get_current_screen () -> set_help_sidebar (
2011-11-02 05:33:53 +00:00
'<p><strong>' . __ ( 'For more information:' ) . '</strong></p>' .
'<p>' . __ ( '<a href="http://codex.wordpress.org/Theme_Development" target="_blank">Documentation on Theme Development</a>' ) . '</p>' .
'<p>' . __ ( '<a href="http://codex.wordpress.org/Using_Themes" target="_blank">Documentation on Using Themes</a>' ) . '</p>' .
'<p>' . __ ( '<a href="http://codex.wordpress.org/Editing_Files" target="_blank">Documentation on Editing Files</a>' ) . '</p>' .
'<p>' . __ ( '<a href="http://codex.wordpress.org/Template_Tags" target="_blank">Documentation on Template Tags</a>' ) . '</p>' .
'<p>' . __ ( '<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>' ) . '</p>'
);
2012-03-29 03:00:38 +00:00
wp_reset_vars ( array ( 'action' , 'error' , 'file' , 'theme' ) );
2004-09-11 16:12:40 +00:00
2012-03-29 03:00:38 +00:00
if ( $theme )
2012-03-29 03:34:51 +00:00
$stylesheet = urldecode ( $theme );
2012-03-29 03:00:38 +00:00
else
$stylesheet = get_stylesheet ();
2004-11-17 03:15:44 +00:00
2012-03-29 03:00:38 +00:00
$theme = wp_get_theme ( $stylesheet );
2005-04-19 21:41:35 +00:00
2012-03-29 03:00:38 +00:00
if ( ! $theme )
wp_die ( __ ( 'The requested theme does not exist.' ) );
2004-11-17 03:15:44 +00:00
2012-03-29 03:00:38 +00:00
$allowed_files = $theme -> get_files ( 'php' , 1 );
$style_files = $theme -> get_files ( 'css' );
if ( isset ( $style_files [ 'style.css' ] ) ) {
$allowed_files [ 'style.css' ] = $style_files [ 'style.css' ];
unset ( $style_files [ 'style.css' ] );
} else {
$style_files [ 'style.css' ] = false ;
}
$allowed_files += $style_files ;
2004-11-17 03:15:44 +00:00
2010-12-04 04:31:55 +00:00
if ( empty ( $file ) ) {
2012-03-29 03:00:38 +00:00
if ( ! empty ( $allowed_files [ 'style.css' ] ) ) {
$relative_file = 'style.css' ;
$file = $allowed_files [ 'style.css' ];
} else {
$relative_file = key ( $allowed_files );
$file = current ( $allowed_files );
2009-10-19 21:39:04 +00:00
}
2012-03-29 03:00:38 +00:00
} else {
2012-03-29 03:34:51 +00:00
$relative_file = urldecode ( stripslashes ( $file ) );
2012-03-29 03:00:38 +00:00
$file = $theme -> get_stylesheet_directory () . '/' . $relative_file ;
2004-11-17 03:15:44 +00:00
}
2012-03-29 03:00:38 +00:00
validate_file_to_edit ( $file , $allowed_files );
$scrollto = isset ( $_REQUEST [ 'scrollto' ] ) ? ( int ) $_REQUEST [ 'scrollto' ] : 0 ;
2004-09-11 16:12:40 +00:00
2012-03-29 03:00:38 +00:00
switch ( $action ) {
2004-09-11 16:12:40 +00:00
case 'update' :
2012-03-29 03:00:38 +00:00
check_admin_referer ( 'edit-theme_' . $file . $stylesheet );
$newcontent = stripslashes ( $_POST [ 'newcontent' ] );
$location = 'theme-editor.php?file=' . urlencode ( $relative_file ) . '&theme=' . urlencode ( $stylesheet ) . '&scrollto=' . $scrollto ;
if ( is_writeable ( $file ) ) {
2008-06-27 20:14:50 +00:00
//is_writable() not always reliable, check return value. see comments @ http://uk.php.net/is_writable
2012-03-29 03:00:38 +00:00
$f = fopen ( $file , 'w+' );
if ( $f !== false ) {
fwrite ( $f , $newcontent );
fclose ( $f );
$location .= '&updated=true' ;
2008-06-27 20:14:50 +00:00
}
2004-11-17 03:15:44 +00:00
}
2012-03-29 03:00:38 +00:00
wp_redirect ( $location );
exit ;
2004-09-11 16:12:40 +00:00
break ;
default :
2006-02-12 07:53:23 +00:00
2012-03-29 03:00:38 +00:00
require_once ( ABSPATH . 'wp-admin/admin-header.php' );
2006-08-22 18:20:00 +00:00
2012-03-29 03:00:38 +00:00
update_recently_edited ( $file );
2006-02-12 07:53:23 +00:00
2012-03-29 03:00:38 +00:00
if ( ! is_file ( $file ) )
$error = true ;
2006-02-12 07:53:23 +00:00
2010-10-04 08:48:43 +00:00
$content = '' ;
2012-03-29 03:00:38 +00:00
if ( ! $error && filesize ( $file ) > 0 ) {
2009-12-01 22:03:13 +00:00
$f = fopen ( $file , 'r' );
$content = fread ( $f , filesize ( $file ));
2009-02-20 20:00:09 +00:00
2009-12-01 22:03:13 +00:00
if ( '.php' == substr ( $file , strrpos ( $file , '.' ) ) ) {
2009-02-20 20:00:09 +00:00
$functions = wp_doc_link_parse ( $content );
2009-03-06 16:17:57 +00:00
2009-02-20 20:00:09 +00:00
$docs_select = '<select name="docs-list" id="docs-list">' ;
2009-05-05 19:43:53 +00:00
$docs_select .= '<option value="">' . esc_attr__ ( 'Function Name...' ) . '</option>' ;
2009-03-06 16:17:57 +00:00
foreach ( $functions as $function ) {
2009-05-05 19:43:53 +00:00
$docs_select .= '<option value="' . esc_attr ( urlencode ( $function ) ) . '">' . htmlspecialchars ( $function ) . '()</option>' ;
2009-02-20 20:00:09 +00:00
}
$docs_select .= '</select>' ;
}
2010-11-17 17:12:01 +00:00
$content = esc_textarea ( $content );
2004-09-11 16:12:40 +00:00
}
?>
2012-03-29 03:00:38 +00:00
< ? php if ( isset ( $_GET [ 'updated' ] ) ) : ?>
< div id = " message " class = " updated " >< p >< ? php _e ( 'File edited successfully.' ) ?> </p></div>
2008-03-02 20:17:30 +00:00
< ? php endif ;
2008-02-16 22:08:13 +00:00
2012-03-29 03:00:38 +00:00
$description = get_file_description ( $file );
$file_show = array_search ( $file , $allowed_files );
if ( $description != $file_show )
$description .= ' <span>(' . $file_show . ')</span>' ;
2004-09-11 16:12:40 +00:00
?>
2008-02-16 22:08:13 +00:00
< div class = " wrap " >
2008-11-26 13:51:25 +00:00
< ? php screen_icon (); ?>
2009-05-18 15:11:07 +00:00
< h2 >< ? php echo esc_html ( $title ); ?> </h2>
2009-06-26 11:07:10 +00:00
< div class = " fileedit-sub " >
< div class = " alignleft " >
2012-03-29 03:00:38 +00:00
< h3 >< ? php echo $theme -> display ( 'Name' ) . ': ' . $description ; ?> </h3>
2009-06-26 11:07:10 +00:00
</ div >
< div class = " alignright " >
< form action = " theme-editor.php " method = " post " >
2008-05-04 10:37:06 +00:00
< strong >< label for = " theme " >< ? php _e ( 'Select theme to edit:' ); ?> </label></strong>
2008-03-14 23:58:31 +00:00
< select name = " theme " id = " theme " >
2008-02-16 22:08:13 +00:00
< ? php
2012-03-29 03:00:38 +00:00
foreach ( wp_get_themes () as $a_stylesheet => $a_theme ) {
$selected = $a_stylesheet == $stylesheet ? ' selected="selected"' : '' ;
echo " \n \t " . '<option value="' . esc_attr ( $a_stylesheet ) . '"' . $selected . '>' . $a_theme -> display ( 'Name' ) . '</option>' ;
2008-02-16 22:08:13 +00:00
}
?>
</ select >
2010-10-28 21:56:43 +00:00
< ? php submit_button ( __ ( 'Select' ), 'button' , 'Submit' , false ); ?>
2008-02-16 22:08:13 +00:00
</ form >
</ div >
2008-03-14 23:58:31 +00:00
< br class = " clear " />
2008-02-16 22:08:13 +00:00
</ div >
2004-11-17 03:15:44 +00:00
< div id = " templateside " >
< ? php
2012-03-29 03:00:38 +00:00
if ( $allowed_files ) :
2004-11-17 03:15:44 +00:00
?>
2009-12-25 03:16:25 +00:00
< h3 >< ? php _e ( 'Templates' ); ?> </h3>
2012-03-29 03:00:38 +00:00
< ? php if ( $theme -> is_child_theme () ) : ?>
< p class = " howto " >< ? php printf ( __ ( 'This child theme inherits templates from a parent theme, %s.' ), '<a href="' . self_admin_url ( 'theme-editor.php?theme=' . $theme -> get_template ()) . '">' . $theme -> parent () -> display ( 'Name' ) . '</a>' ); ?> </p>
2010-12-04 03:52:59 +00:00
< ? php endif ; ?>
2008-02-16 22:08:13 +00:00
< ul >
2008-08-23 09:28:39 +00:00
< ? php
2012-03-29 03:00:38 +00:00
foreach ( $allowed_files as $filename => $absolute_filename ) :
if ( 'style.css' == $filename ) {
echo " \t </ul> \n \t <h3> " . _x ( 'Styles' , 'Theme stylesheets in theme editor' ) . " </h3> \n \t <ul> \n " ;
if ( ! $absolute_filename )
continue ;
}
2010-12-04 03:52:59 +00:00
2012-03-29 03:00:38 +00:00
$file_description = get_file_description ( $filename );
if ( $file_description != basename ( $filename ) )
$file_description .= '<br /><span class="nonessential">(' . $filename . ')</span>' ;
2010-12-04 03:52:59 +00:00
2012-03-29 03:00:38 +00:00
if ( $absolute_filename == $file )
$file_description = '<span class="highlight">' . $file_description . '</span>' ;
?>
< li >< a href = " theme-editor.php?file=<?php echo urlencode( $filename ) ?>&theme=<?php echo urlencode( $stylesheet ) ?> " >< ? php echo $file_description ; ?> </a></li>
< ? php
endforeach ;
?>
</ ul >
2004-11-17 03:15:44 +00:00
< ? php endif ; ?>
2006-11-19 07:56:05 +00:00
</ div >
2012-03-29 03:00:38 +00:00
< ? php if ( $error ) :
echo '<div class="error"><p>' . __ ( 'Oops, no such file exists! Double check the name and try again, merci.' ) . '</p></div>' ;
else : ?>
2006-11-19 07:56:05 +00:00
< form name = " template " id = " template " action = " theme-editor.php " method = " post " >
2012-03-29 03:00:38 +00:00
< ? php wp_nonce_field ( 'edit-theme_' . $file . $stylesheet ); ?>
< div >< textarea cols = " 70 " rows = " 30 " name = " newcontent " id = " newcontent " tabindex = " 1 " >< ? php echo $content ?> </textarea>
2006-11-19 07:56:05 +00:00
< input type = " hidden " name = " action " value = " update " />
2012-03-29 03:00:38 +00:00
< input type = " hidden " name = " file " value = " <?php echo esc_attr( $relative_file ); ?> " />
< input type = " hidden " name = " theme " value = " <?php echo esc_attr( $theme->get_stylesheet () ); ?> " />
2009-08-08 07:22:19 +00:00
< input type = " hidden " name = " scrollto " id = " scrollto " value = " <?php echo $scrollto ; ?> " />
2004-11-17 03:15:44 +00:00
</ div >
2012-03-29 03:00:38 +00:00
< ? php if ( ! empty ( $functions ) ) : ?>
2010-05-26 03:57:55 +00:00
< div id = " documentation " class = " hide-if-no-js " >
2009-03-25 16:51:08 +00:00
< label for = " docs-list " >< ? php _e ( 'Documentation:' ) ?> </label>
2009-03-15 17:14:44 +00:00
< ? php echo $docs_select ; ?>
2010-05-26 03:57:55 +00: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 17:14:44 +00:00
</ div >
2012-03-29 03:00:38 +00:00
< ? php endif ; ?>
2008-03-02 20:17:30 +00:00
2008-02-17 22:23:04 +00:00
< div >
2012-03-29 03:00:38 +00:00
< ? php if ( is_child_theme () && ! $theme -> is_child_theme () && $theme -> get_template () == get_template () ) : ?>
2010-12-04 03:52:59 +00:00
< 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 22:58:56 +00:00
< ? php endif ; ?>
2004-11-17 03:15:44 +00:00
< ? php
2010-12-03 22:58:56 +00:00
if ( is_writeable ( $file ) ) :
2010-10-28 21:56:43 +00:00
submit_button ( __ ( 'Update File' ), 'primary' , 'submit' , true , array ( 'tabindex' => '2' ) );
else : ?>
2008-02-09 20:17:49 +00: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-17 03:15:44 +00:00
< ? php endif ; ?>
2008-02-17 22:23:04 +00:00
</ div >
2006-11-19 07:56:05 +00:00
</ form >
2009-06-26 11:07:10 +00:00
< ? php
2012-03-29 03:00:38 +00:00
endif ; // $error
2009-06-26 11:07:10 +00:00
?>
< br class = " clear " />
2006-11-19 07:56:05 +00:00
</ div >
2009-08-08 07:22:19 +00:00
< script type = " text/javascript " >
/* <![CDATA[ */
jQuery ( document ) . ready ( function ( $ ){
$ ( '#template' ) . submit ( function (){ $ ( '#scrollto' ) . val ( $ ( '#newcontent' ) . scrollTop () ); });
2010-02-18 05:14:48 +00:00
$ ( '#newcontent' ) . scrollTop ( $ ( '#scrollto' ) . val () );
2009-08-08 07:22:19 +00:00
});
/* ]]> */
</ script >
2004-09-11 16:12:40 +00:00
< ? php
break ;
}
2012-03-29 03:00:38 +00:00
include ( ABSPATH . 'wp-admin/admin-footer.php' );