2004-09-11 18:12:40 +02:00
< ? php
2008-08-16 09:27:34 +02:00
/**
* Theme editor administration panel .
*
* @ package WordPress
* @ subpackage Administration
*/
/** WordPress Administration Bootstrap */
2013-09-25 02:18:11 +02:00
require_once ( dirname ( __FILE__ ) . '/admin.php' );
2006-11-18 08:31:29 +01:00
2010-12-06 16:41:19 +01:00
if ( is_multisite () && ! is_network_admin () ) {
wp_redirect ( network_admin_url ( 'theme-editor.php' ) );
exit ();
}
2009-08-08 09:22:19 +02:00
if ( ! current_user_can ( 'edit_themes' ) )
2010-04-30 03:54:32 +02:00
wp_die ( '<p>' . __ ( 'You do not have sufficient permissions to edit templates for this site.' ) . '</p>' );
2009-08-08 09:22:19 +02:00
2006-11-18 08:31:29 +01:00
$title = __ ( " Edit Themes " );
$parent_file = 'themes.php' ;
2011-11-24 01:21:39 +01:00
get_current_screen () -> add_help_tab ( array (
'id' => 'overview' ,
'title' => __ ( 'Overview' ),
2011-12-01 05:51:35 +01:00
'content' =>
2011-11-24 01:21:39 +01:00
'<p>' . __ ( 'You can use the Theme Editor to edit the individual CSS and PHP files which make up your theme.' ) . ' </ p >
2015-09-28 05:11:24 +02:00
< p > ' . __("Begin by choosing a theme to edit from the dropdown menu and clicking Select. A list then appears of the theme' s template files . Clicking once on any file name causes the file to appear in the large Editor box . " ) . '</p>
2013-02-08 17:19:04 +01:00
< 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 >
2015-03-26 23:35:27 +01:00
< 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 . In some cases the Esc key will need to be pressed twice before the Tab key will allow you to continue . ' ) . ' </ p >
2011-11-24 01:21:39 +01:00
< 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 >
2015-04-12 23:29:32 +02:00
< 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 . '), __(' https :// codex . wordpress . org / Child_Themes ') ) . ' </ p > ' .
2011-11-24 01:21:39 +01:00
( is_network_admin () ? '<p>' . __ ( 'Any edits to files from this screen will be reflected on all sites in the network.' ) . '</p>' : '' )
) );
2010-05-26 20:27:13 +02:00
2011-11-02 22:32:16 +01:00
get_current_screen () -> set_help_sidebar (
2011-11-02 06:33:53 +01:00
'<p><strong>' . __ ( 'For more information:' ) . '</strong></p>' .
2015-04-12 23:29:32 +02:00
'<p>' . __ ( '<a href="https://codex.wordpress.org/Theme_Development" target="_blank">Documentation on Theme Development</a>' ) . '</p>' .
'<p>' . __ ( '<a href="https://codex.wordpress.org/Using_Themes" target="_blank">Documentation on Using Themes</a>' ) . '</p>' .
'<p>' . __ ( '<a href="https://codex.wordpress.org/Editing_Files" target="_blank">Documentation on Editing Files</a>' ) . '</p>' .
'<p>' . __ ( '<a href="https://codex.wordpress.org/Template_Tags" target="_blank">Documentation on Template Tags</a>' ) . '</p>' .
2014-03-03 03:34:27 +01:00
'<p>' . __ ( '<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>' ) . '</p>'
2011-11-02 06:33:53 +01:00
);
2012-03-29 05:00:38 +02:00
wp_reset_vars ( array ( 'action' , 'error' , 'file' , 'theme' ) );
2004-09-11 18:12:40 +02:00
2015-10-13 16:14:24 +02:00
if ( $theme ) {
2012-09-05 00:35:12 +02:00
$stylesheet = $theme ;
2015-10-13 16:14:24 +02:00
} else {
2012-03-29 05:00:38 +02:00
$stylesheet = get_stylesheet ();
2015-10-13 16:14:24 +02:00
}
2004-11-17 04:15:44 +01:00
2012-03-29 05:00:38 +02:00
$theme = wp_get_theme ( $stylesheet );
2005-04-19 23:41:35 +02:00
2015-10-13 16:14:24 +02:00
if ( ! $theme -> exists () ) {
2012-03-29 05:00:38 +02:00
wp_die ( __ ( 'The requested theme does not exist.' ) );
2015-10-13 16:14:24 +02:00
}
2004-11-17 04:15:44 +01:00
2015-10-13 16:14:24 +02:00
if ( $theme -> errors () && 'theme_no_stylesheet' == $theme -> errors () -> get_error_code () ) {
2012-04-21 22:57:54 +02:00
wp_die ( __ ( 'The requested theme does not exist.' ) . ' ' . $theme -> errors () -> get_error_message () );
2015-10-13 16:14:24 +02:00
}
2012-04-21 22:57:54 +02:00
2012-03-29 05:00:38 +02:00
$allowed_files = $theme -> get_files ( 'php' , 1 );
2012-03-29 06:16:17 +02:00
$has_templates = ! empty ( $allowed_files );
2012-03-29 05:00:38 +02:00
$style_files = $theme -> get_files ( 'css' );
2012-04-21 22:57:54 +02:00
$allowed_files [ 'style.css' ] = $style_files [ 'style.css' ];
2015-10-13 16:14:24 +02:00
/**
* Filter the allowed files .
*
* @ since 4.4 . 0
*
* @ param array $style_files List of style files .
* @ param object $theme The current Theme object .
*/
$allowed_files += apply_filters ( 'wp_theme_editor_filetypes' , $style_files , $theme );
2004-11-17 04:15:44 +01:00
2010-12-04 05:31:55 +01:00
if ( empty ( $file ) ) {
2012-04-21 22:57:54 +02:00
$relative_file = 'style.css' ;
$file = $allowed_files [ 'style.css' ];
2012-03-29 05:00:38 +02:00
} else {
2013-03-01 19:59:54 +01:00
$relative_file = $file ;
2012-03-29 05:00:38 +02:00
$file = $theme -> get_stylesheet_directory () . '/' . $relative_file ;
2004-11-17 04:15:44 +01:00
}
2012-03-29 05:00:38 +02:00
validate_file_to_edit ( $file , $allowed_files );
$scrollto = isset ( $_REQUEST [ 'scrollto' ] ) ? ( int ) $_REQUEST [ 'scrollto' ] : 0 ;
2004-09-11 18:12:40 +02:00
2012-03-29 05:00:38 +02:00
switch ( $action ) {
2004-09-11 18:12:40 +02:00
case 'update' :
2012-03-29 05:00:38 +02:00
check_admin_referer ( 'edit-theme_' . $file . $stylesheet );
2013-03-01 18:14:09 +01:00
$newcontent = wp_unslash ( $_POST [ 'newcontent' ] );
2012-03-29 05:00:38 +02:00
$location = 'theme-editor.php?file=' . urlencode ( $relative_file ) . '&theme=' . urlencode ( $stylesheet ) . '&scrollto=' . $scrollto ;
if ( is_writeable ( $file ) ) {
2014-07-17 11:14:16 +02:00
// is_writable() not always reliable, check return value. see comments @ http://uk.php.net/is_writable
2012-03-29 05:00:38 +02:00
$f = fopen ( $file , 'w+' );
if ( $f !== false ) {
fwrite ( $f , $newcontent );
fclose ( $f );
$location .= '&updated=true' ;
2012-03-30 16:39:05 +02:00
$theme -> cache_delete ();
2008-06-27 22:14:50 +02:00
}
2004-11-17 04:15:44 +01:00
}
2012-03-29 05:00:38 +02:00
wp_redirect ( $location );
exit ;
2004-09-11 18:12:40 +02:00
default :
2006-02-12 08:53:23 +01:00
2012-03-29 05:00:38 +02:00
require_once ( ABSPATH . 'wp-admin/admin-header.php' );
2006-08-22 20:20:00 +02:00
2012-03-29 05:00:38 +02:00
update_recently_edited ( $file );
2006-02-12 08:53:23 +01:00
2012-03-29 05:00:38 +02:00
if ( ! is_file ( $file ) )
$error = true ;
2006-02-12 08:53:23 +01:00
2010-10-04 10:48:43 +02:00
$content = '' ;
2012-03-29 05:00:38 +02:00
if ( ! $error && filesize ( $file ) > 0 ) {
2009-12-01 23:03:13 +01:00
$f = fopen ( $file , 'r' );
$content = fread ( $f , filesize ( $file ));
2009-02-20 21:00:09 +01:00
2009-12-01 23:03:13 +01:00
if ( '.php' == substr ( $file , strrpos ( $file , '.' ) ) ) {
2009-02-20 21:00:09 +01:00
$functions = wp_doc_link_parse ( $content );
2009-03-06 17:17:57 +01:00
2009-02-20 21:00:09 +01:00
$docs_select = '<select name="docs-list" id="docs-list">' ;
2013-05-08 23:27:31 +02:00
$docs_select .= '<option value="">' . esc_attr__ ( 'Function Name…' ) . '</option>' ;
2009-03-06 17:17:57 +01:00
foreach ( $functions as $function ) {
2009-05-05 21:43:53 +02:00
$docs_select .= '<option value="' . esc_attr ( urlencode ( $function ) ) . '">' . htmlspecialchars ( $function ) . '()</option>' ;
2009-02-20 21:00:09 +01:00
}
$docs_select .= '</select>' ;
}
2010-11-17 18:12:01 +01:00
$content = esc_textarea ( $content );
2004-09-11 18:12:40 +02:00
}
2014-05-19 07:04:16 +02:00
if ( isset ( $_GET [ 'updated' ] ) ) : ?>
2015-04-02 00:06:28 +02:00
< div id = " message " class = " updated notice is-dismissible " >< p >< ? php _e ( 'File edited successfully.' ) ?> </p></div>
2008-03-02 21:17:30 +01:00
< ? php endif ;
2008-02-16 23:08:13 +01:00
2015-09-28 05:11:24 +02:00
$description = get_file_description ( $relative_file );
2012-03-29 06:16:17 +02:00
$file_show = array_search ( $file , array_filter ( $allowed_files ) );
2012-03-29 05:00:38 +02:00
if ( $description != $file_show )
$description .= ' <span>(' . $file_show . ')</span>' ;
2004-09-11 18:12:40 +02:00
?>
2008-02-16 23:08:13 +01:00
< div class = " wrap " >
2015-06-27 17:41:25 +02:00
< h1 >< ? php echo esc_html ( $title ); ?> </h1>
2009-06-26 13:07:10 +02:00
< div class = " fileedit-sub " >
< div class = " alignleft " >
2015-09-12 02:00:24 +02:00
< h2 >< ? php echo $theme -> display ( 'Name' ); if ( $description ) echo ': ' . $description ; ?> </h2>
2009-06-26 13:07:10 +02:00
</ div >
< div class = " alignright " >
< form action = " theme-editor.php " method = " post " >
2008-05-04 12:37:06 +02:00
< strong >< label for = " theme " >< ? php _e ( 'Select theme to edit:' ); ?> </label></strong>
2008-03-15 00:58:31 +01:00
< select name = " theme " id = " theme " >
2008-02-16 23:08:13 +01:00
< ? php
2012-03-29 06:16:17 +02:00
foreach ( wp_get_themes ( array ( 'errors' => null ) ) as $a_stylesheet => $a_theme ) {
2012-04-21 22:57:54 +02:00
if ( $a_theme -> errors () && 'theme_no_stylesheet' == $a_theme -> errors () -> get_error_code () )
continue ;
2012-03-29 05:00:38 +02:00
$selected = $a_stylesheet == $stylesheet ? ' selected="selected"' : '' ;
echo " \n \t " . '<option value="' . esc_attr ( $a_stylesheet ) . '"' . $selected . '>' . $a_theme -> display ( 'Name' ) . '</option>' ;
2008-02-16 23:08:13 +01:00
}
?>
</ select >
2010-10-28 23:56:43 +02:00
< ? php submit_button ( __ ( 'Select' ), 'button' , 'Submit' , false ); ?>
2008-02-16 23:08:13 +01:00
</ form >
</ div >
2008-03-15 00:58:31 +01:00
< br class = " clear " />
2008-02-16 23:08:13 +01:00
</ div >
2012-04-21 23:23:27 +02:00
< ? php
if ( $theme -> errors () )
echo '<div class="error"><p><strong>' . __ ( 'This theme is broken.' ) . '</strong> ' . $theme -> errors () -> get_error_message () . '</p></div>' ;
?>
2004-11-17 04:15:44 +01:00
< div id = " templateside " >
< ? php
2012-04-21 22:57:54 +02:00
if ( $allowed_files ) :
2012-04-21 23:03:23 +02:00
if ( $has_templates || $theme -> parent () ) :
2004-11-17 04:15:44 +01:00
?>
2015-09-12 02:00:24 +02:00
< h2 >< ? php _e ( 'Templates' ); ?> </h2>
2012-04-21 23:03:23 +02:00
< ? php if ( $theme -> parent () ) : ?>
2012-04-21 22:57:54 +02:00
< 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>
2010-12-04 04:52:59 +01:00
< ? php endif ; ?>
2008-02-16 23:08:13 +01:00
< ul >
2008-08-23 11:28:39 +02:00
< ? php
2012-03-29 06:16:17 +02:00
endif ;
2012-03-29 05:00:38 +02:00
foreach ( $allowed_files as $filename => $absolute_filename ) :
2012-04-21 22:57:54 +02:00
if ( 'style.css' == $filename )
2015-09-12 02:00:24 +02:00
echo " \t </ul> \n \t <h2> " . _x ( 'Styles' , 'Theme stylesheets in theme editor' ) . " </h2> \n \t <ul> \n " ;
2010-12-04 04:52:59 +01:00
2015-09-28 05:11:24 +02:00
$file_description = get_file_description ( $filename );
if ( $filename !== basename ( $absolute_filename ) || $file_description !== $filename ) {
2012-03-29 05:00:38 +02:00
$file_description .= '<br /><span class="nonessential">(' . $filename . ')</span>' ;
2015-09-28 05:11:24 +02:00
}
2010-12-04 04:52:59 +01:00
2015-09-28 05:11:24 +02:00
if ( $absolute_filename === $file ) {
2012-03-29 05:00:38 +02:00
$file_description = '<span class="highlight">' . $file_description . '</span>' ;
2015-09-28 05:11:24 +02:00
}
2012-03-29 05:00:38 +02:00
?>
< 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 04:15:44 +01:00
< ? php endif ; ?>
2006-11-19 08:56:05 +01:00
</ div >
2012-03-29 05:00:38 +02: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 08:56:05 +01:00
< form name = " template " id = " template " action = " theme-editor.php " method = " post " >
2012-03-29 05:00:38 +02:00
< ? php wp_nonce_field ( 'edit-theme_' . $file . $stylesheet ); ?>
2012-07-27 18:49:48 +02:00
< div >< textarea cols = " 70 " rows = " 30 " name = " newcontent " id = " newcontent " aria - describedby = " newcontent-description " >< ? php echo $content ; ?> </textarea>
2012-07-24 01:46:27 +02:00
< input type = " hidden " name = " action " value = " update " />
< 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 () ); ?> " />
< input type = " hidden " name = " scrollto " id = " scrollto " value = " <?php echo $scrollto ; ?> " />
</ div >
2012-03-29 05:00:38 +02:00
< ? php if ( ! empty ( $functions ) ) : ?>
2010-05-26 05:57:55 +02:00
< div id = " documentation " class = " hide-if-no-js " >
2009-03-25 17:51:08 +01:00
< label for = " docs-list " >< ? php _e ( 'Documentation:' ) ?> </label>
2009-03-15 18:14:44 +01:00
< ? php echo $docs_select ; ?>
2015-10-03 00:46:28 +02:00
< input type = " button " class = " button " value = " <?php esc_attr_e( 'Look Up' ); ?> " onclick = " if ( '' != jQuery('#docs-list').val() ) { window.open( 'https://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 18:14:44 +01:00
</ div >
2012-03-29 05:00:38 +02:00
< ? php endif ; ?>
2008-03-02 21:17:30 +01:00
2008-02-17 23:23:04 +01:00
< div >
2012-04-25 19:34:19 +02:00
< ? php if ( is_child_theme () && $theme -> get_stylesheet () == get_template () ) : ?>
2010-12-04 04:52:59 +01: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 23:58:56 +01:00
< ? php endif ; ?>
2004-11-17 04:15:44 +01:00
< ? php
2010-12-03 23:58:56 +01:00
if ( is_writeable ( $file ) ) :
2012-07-24 02:15:15 +02:00
submit_button ( __ ( 'Update File' ), 'primary' , 'submit' , true );
2010-10-28 23:56:43 +02:00
else : ?>
2015-04-12 23:29:32 +02:00
< p >< em >< ? php _e ( 'You need to make this file writable before you can save your changes. See <a href="https://codex.wordpress.org/Changing_File_Permissions">the Codex</a> for more information.' ); ?> </em></p>
2004-11-17 04:15:44 +01:00
< ? php endif ; ?>
2008-02-17 23:23:04 +01:00
</ div >
2006-11-19 08:56:05 +01:00
</ form >
2009-06-26 13:07:10 +02:00
< ? php
2012-03-29 05:00:38 +02:00
endif ; // $error
2009-06-26 13:07:10 +02:00
?>
< br class = " clear " />
2006-11-19 08:56:05 +01:00
</ div >
2009-08-08 09:22:19 +02:00
< script type = " text/javascript " >
jQuery ( document ) . ready ( function ( $ ){
$ ( '#template' ) . submit ( function (){ $ ( '#scrollto' ) . val ( $ ( '#newcontent' ) . scrollTop () ); });
2010-02-18 06:14:48 +01:00
$ ( '#newcontent' ) . scrollTop ( $ ( '#scrollto' ) . val () );
2009-08-08 09:22:19 +02:00
});
</ script >
2004-09-11 18:12:40 +02:00
< ? php
break ;
}
2012-03-29 05:00:38 +02:00
include ( ABSPATH . 'wp-admin/admin-footer.php' );