private static $has_medialib = false;
private static $editor_buttons_css = true;
private static $drag_drop_upload = false;
+ private static $old_dfw_compat = false;
private function __construct() {}
/**
* Parse default arguments for the editor instance.
*
+ * @static
* @param string $editor_id ID for the current editor instance.
* @param array $settings {
* Array of editor arguments.
* @type string $tabfocus_elements The previous and next element ID to move the focus to
* when pressing the Tab key in TinyMCE. Defualt ':prev,:next'.
* @type string $editor_css Intended for extra styles for both Visual and Text editors.
- * Should include <style> tags, and can use "scoped". Default empty.
+ * Should include `<style>` tags, and can use "scoped". Default empty.
* @type string $editor_class Extra classes to add to the editor textarea elemen. Default empty.
* @type bool $teeny Whether to output the minimal editor config. Examples include
* Press This and the Comment editor. Default false.
- * @type bool $dfw Whether to replace the default fullscreen with "Distraction Free
- * Writing". DFW requires specific DOM elements and css). Default false.
+ * @type bool $dfw Deprecated in 4.1. Since 4.3 used only to enqueue wp-fullscreen-stub.js for backwards compatibility.
* @type bool|array $tinymce Whether to load TinyMCE. Can be used to pass settings directly to
* TinyMCE using an array. Default true.
* @type bool|array $quicktags Whether to load Quicktags. Can be used to pass settings directly to
$settings = apply_filters( 'wp_editor_settings', $settings, $editor_id );
$set = wp_parse_args( $settings, array(
- 'wpautop' => true,
- 'media_buttons' => true,
- 'default_editor' => '',
- 'drag_drop_upload' => false,
- 'textarea_name' => $editor_id,
- 'textarea_rows' => 20,
- 'tabindex' => '',
- 'tabfocus_elements' => ':prev,:next',
- 'editor_css' => '',
- 'editor_class' => '',
- 'teeny' => false,
- 'dfw' => false,
- 'tinymce' => true,
- 'quicktags' => true
+ 'wpautop' => true,
+ 'media_buttons' => true,
+ 'default_editor' => '',
+ 'drag_drop_upload' => false,
+ 'textarea_name' => $editor_id,
+ 'textarea_rows' => 20,
+ 'tabindex' => '',
+ 'tabfocus_elements' => ':prev,:next',
+ 'editor_css' => '',
+ 'editor_class' => '',
+ 'teeny' => false,
+ 'dfw' => false,
+ '_content_editor_dfw' => false,
+ 'tinymce' => true,
+ 'quicktags' => true
) );
self::$this_tinymce = ( $set['tinymce'] && user_can_richedit() );
if ( self::$this_quicktags )
self::$has_quicktags = true;
+ if ( $set['dfw'] ) {
+ self::$old_dfw_compat = true;
+ }
+
if ( empty( $set['editor_height'] ) )
return $set;
// A cookie (set when a user resizes the editor) overrides the height.
$cookie = (int) get_user_setting( 'ed_size' );
- // Upgrade an old TinyMCE cookie if it is still around, and the new one isn't.
- if ( ! $cookie && isset( $_COOKIE['TinyMCE_content_size'] ) ) {
- parse_str( $_COOKIE['TinyMCE_content_size'], $cookie );
- $cookie = $cookie['ch'];
- }
-
if ( $cookie )
$set['editor_height'] = $cookie;
}
/**
* Outputs the HTML for a single instance of the editor.
*
+ * @static
* @param string $content The initial content of the editor.
* @param string $editor_id ID for the textarea and TinyMCE and Quicktags instances (can contain only ASCII letters and numbers).
* @param array $settings See the _parse_settings() method for description.
*/
public static function editor( $content, $editor_id, $settings = array() ) {
-
$set = self::parse_settings( $editor_id, $settings );
- $editor_class = ' class="' . trim( $set['editor_class'] . ' wp-editor-area' ) . '"';
+ $editor_class = ' class="' . trim( esc_attr( $set['editor_class'] ) . ' wp-editor-area' ) . '"';
$tabindex = $set['tabindex'] ? ' tabindex="' . (int) $set['tabindex'] . '"' : '';
- $switch_class = 'html-active';
+ $default_editor = 'html';
$toolbar = $buttons = $autocomplete = '';
+ $editor_id_attr = esc_attr( $editor_id );
if ( $set['drag_drop_upload'] ) {
self::$drag_drop_upload = true;
}
- if ( ! empty( $set['editor_height'] ) )
- $height = ' style="height: ' . $set['editor_height'] . 'px"';
- else
- $height = ' rows="' . $set['textarea_rows'] . '"';
+ if ( ! empty( $set['editor_height'] ) ) {
+ $height = ' style="height: ' . (int) $set['editor_height'] . 'px"';
+ } else {
+ $height = ' rows="' . (int) $set['textarea_rows'] . '"';
+ }
- if ( !current_user_can( 'upload_files' ) )
+ if ( ! current_user_can( 'upload_files' ) ) {
$set['media_buttons'] = false;
+ }
- if ( ! self::$this_quicktags && self::$this_tinymce ) {
- $switch_class = 'tmce-active';
- $autocomplete = ' autocomplete="off"';
- } elseif ( self::$this_quicktags && self::$this_tinymce ) {
- $default_editor = $set['default_editor'] ? $set['default_editor'] : wp_default_editor();
+ if ( self::$this_tinymce ) {
$autocomplete = ' autocomplete="off"';
- // 'html' is used for the "Text" editor tab.
- if ( 'html' === $default_editor ) {
- add_filter('the_editor_content', 'wp_htmledit_pre');
- $switch_class = 'html-active';
+ if ( self::$this_quicktags ) {
+ $default_editor = $set['default_editor'] ? $set['default_editor'] : wp_default_editor();
+ // 'html' is used for the "Text" editor tab.
+ if ( 'html' !== $default_editor ) {
+ $default_editor = 'tinymce';
+ }
+
+ $buttons .= '<button type="button" id="' . $editor_id_attr . '-tmce" class="wp-switch-editor switch-tmce"' .
+ ' data-wp-editor-id="' . $editor_id_attr . '">' . __('Visual') . "</button>\n";
+ $buttons .= '<button type="button" id="' . $editor_id_attr . '-html" class="wp-switch-editor switch-html"' .
+ ' data-wp-editor-id="' . $editor_id_attr . '">' . _x( 'Text', 'Name for the Text editor tab (formerly HTML)' ) . "</button>\n";
} else {
- add_filter('the_editor_content', 'wp_richedit_pre');
- $switch_class = 'tmce-active';
+ $default_editor = 'tinymce';
}
-
- $buttons .= '<a id="' . $editor_id . '-html" class="wp-switch-editor switch-html" onclick="switchEditors.switchto(this);">' . _x( 'Text', 'Name for the Text editor tab (formerly HTML)' ) . "</a>\n";
- $buttons .= '<a id="' . $editor_id . '-tmce" class="wp-switch-editor switch-tmce" onclick="switchEditors.switchto(this);">' . __('Visual') . "</a>\n";
}
+ $switch_class = 'html' === $default_editor ? 'html-active' : 'tmce-active';
$wrap_class = 'wp-core-ui wp-editor-wrap ' . $switch_class;
- if ( $set['dfw'] ) {
+ if ( $set['_content_editor_dfw'] ) {
$wrap_class .= ' has-dfw';
}
- echo '<div id="wp-' . $editor_id . '-wrap" class="' . $wrap_class . '">';
+ echo '<div id="wp-' . $editor_id_attr . '-wrap" class="' . $wrap_class . '">';
if ( self::$editor_buttons_css ) {
- wp_print_styles('editor-buttons');
+ wp_print_styles( 'editor-buttons' );
self::$editor_buttons_css = false;
}
- if ( !empty($set['editor_css']) )
+ if ( ! empty( $set['editor_css'] ) ) {
echo $set['editor_css'] . "\n";
+ }
- if ( !empty($buttons) || $set['media_buttons'] ) {
- echo '<div id="wp-' . $editor_id . '-editor-tools" class="wp-editor-tools hide-if-no-js">';
+ if ( ! empty( $buttons ) || $set['media_buttons'] ) {
+ echo '<div id="wp-' . $editor_id_attr . '-editor-tools" class="wp-editor-tools hide-if-no-js">';
if ( $set['media_buttons'] ) {
self::$has_medialib = true;
- if ( !function_exists('media_buttons') )
- include(ABSPATH . 'wp-admin/includes/media.php');
+ if ( ! function_exists( 'media_buttons' ) )
+ include( ABSPATH . 'wp-admin/includes/media.php' );
- echo '<div id="wp-' . $editor_id . '-media-buttons" class="wp-media-buttons">';
+ echo '<div id="wp-' . $editor_id_attr . '-media-buttons" class="wp-media-buttons">';
/**
* Fires after the default media button(s) are displayed.
echo "</div>\n";
}
+ $quicktags_toolbar = '';
+
+ if ( self::$this_quicktags ) {
+ if ( 'content' === $editor_id && ! empty( $GLOBALS['current_screen'] ) && $GLOBALS['current_screen']->base === 'post' ) {
+ $toolbar_id = 'ed_toolbar';
+ } else {
+ $toolbar_id = 'qt_' . $editor_id_attr . '_toolbar';
+ }
+
+ $quicktags_toolbar = '<div id="' . $toolbar_id . '" class="quicktags-toolbar"></div>';
+ }
+
/**
* Filter the HTML markup output that displays the editor.
*
*
* @param string $output Editor's HTML markup.
*/
- $the_editor = apply_filters( 'the_editor', '<div id="wp-' . $editor_id . '-editor-container" class="wp-editor-container">' .
- '<textarea' . $editor_class . $height . $tabindex . $autocomplete . ' cols="40" name="' . $set['textarea_name'] . '" ' .
- 'id="' . $editor_id . '">%s</textarea></div>' );
+ $the_editor = apply_filters( 'the_editor', '<div id="wp-' . $editor_id_attr . '-editor-container" class="wp-editor-container">' .
+ $quicktags_toolbar .
+ '<textarea' . $editor_class . $height . $tabindex . $autocomplete . ' cols="40" name="' . esc_attr( $set['textarea_name'] ) . '" ' .
+ 'id="' . $editor_id_attr . '">%s</textarea></div>' );
+
+ // Prepare the content for the Visual or Text editor
+ if ( self::$this_tinymce ) {
+ add_filter( 'the_editor_content', 'format_for_editor', 10, 2 );
+ }
/**
* Filter the default editor content.
*
* @param string $content Default editor content.
*/
- $content = apply_filters( 'the_editor_content', $content );
+ $content = apply_filters( 'the_editor_content', $content, $default_editor );
+
+ // Back-compat for the `htmledit_pre` and `richedit_pre` filters
+ if ( 'html' === $default_editor && has_filter( 'htmledit_pre' ) ) {
+ // TODO: needs _deprecated_filter(), use _deprecated_function() as substitute for now
+ _deprecated_function( 'add_filter( htmledit_pre )', '4.3.0', 'add_filter( format_for_editor )' );
+ $content = apply_filters( 'htmledit_pre', $content );
+ } elseif ( 'tinymce' === $default_editor && has_filter( 'richedit_pre' ) ) {
+ _deprecated_function( 'add_filter( richedit_pre )', '4.3.0', 'add_filter( format_for_editor )' );
+ $content = apply_filters( 'richedit_pre', $content );
+ }
+
+ if ( false !== stripos( $content, 'textarea' ) ) {
+ $content = preg_replace( '%</textarea%i', '</textarea', $content );
+ }
printf( $the_editor, $content );
echo "\n</div>\n\n";
- self::editor_settings($editor_id, $set);
+ self::editor_settings( $editor_id, $set );
}
+ /**
+ * @static
+ *
+ * @global string $wp_version
+ * @global string $tinymce_version
+ *
+ * @param string $editor_id
+ * @param array $set
+ */
public static function editor_settings($editor_id, $set) {
+ global $wp_version, $tinymce_version;
+
$first_run = false;
if ( empty(self::$first_init) ) {
if ( empty($qtInit['buttons']) )
$qtInit['buttons'] = 'strong,em,link,block,del,ins,img,ul,ol,li,code,more,close';
- if ( $set['dfw'] )
- $qtInit['buttons'] .= ',fullscreen';
+ if ( $set['_content_editor_dfw'] ) {
+ $qtInit['buttons'] .= ',dfw';
+ }
/**
* Filter the Quicktags settings.
'wordpress',
'wpautoresize',
'wpeditimage',
+ 'wpemoji',
'wpgallery',
'wplink',
'wpdialogs',
- 'wpview',
+ 'wptextpattern',
+ 'wpview'
);
if ( ! self::$has_medialib ) {
$url = set_url_scheme( $url );
$mce_external_plugins[ $name ] = $url;
$plugurl = dirname( $url );
- $strings = $str1 = $str2 = '';
+ $strings = '';
// Try to load langs/[locale].js and langs/[locale]_dlg.js
if ( ! in_array( $name, $loaded_langs, true ) ) {
}
}
- if ( $set['dfw'] )
- $plugins[] = 'wpfullscreen';
-
self::$plugins = $plugins;
self::$ext_plugins = $ext_plugins;
'theme' => 'modern',
'skin' => 'lightgray',
'language' => self::$mce_locale,
- 'formats' => "{
- alignleft: [
- {selector: 'p,h1,h2,h3,h4,h5,h6,td,th,div,ul,ol,li', styles: {textAlign:'left'}},
- {selector: 'img,table,dl.wp-caption', classes: 'alignleft'}
- ],
- aligncenter: [
- {selector: 'p,h1,h2,h3,h4,h5,h6,td,th,div,ul,ol,li', styles: {textAlign:'center'}},
- {selector: 'img,table,dl.wp-caption', classes: 'aligncenter'}
- ],
- alignright: [
- {selector: 'p,h1,h2,h3,h4,h5,h6,td,th,div,ul,ol,li', styles: {textAlign:'right'}},
- {selector: 'img,table,dl.wp-caption', classes: 'alignright'}
- ],
- strikethrough: {inline: 'del'}
- }",
+ 'formats' => '{' .
+ 'alignleft: [' .
+ '{selector: "p,h1,h2,h3,h4,h5,h6,td,th,div,ul,ol,li", styles: {textAlign:"left"}},' .
+ '{selector: "img,table,dl.wp-caption", classes: "alignleft"}' .
+ '],' .
+ 'aligncenter: [' .
+ '{selector: "p,h1,h2,h3,h4,h5,h6,td,th,div,ul,ol,li", styles: {textAlign:"center"}},' .
+ '{selector: "img,table,dl.wp-caption", classes: "aligncenter"}' .
+ '],' .
+ 'alignright: [' .
+ '{selector: "p,h1,h2,h3,h4,h5,h6,td,th,div,ul,ol,li", styles: {textAlign:"right"}},' .
+ '{selector: "img,table,dl.wp-caption", classes: "alignright"}' .
+ '],' .
+ 'strikethrough: {inline: "del"}' .
+ '}',
'relative_urls' => false,
'remove_script_host' => false,
'convert_urls' => false,
'entities' => '38,amp,60,lt,62,gt',
'entity_encoding' => 'raw',
'keep_styles' => false,
+ 'cache_suffix' => 'wp-mce-' . $tinymce_version,
// Limit the preview styles in the menu/toolbar
'preview_styles' => 'font-family font-size font-weight font-style text-decoration text-transform',
+ 'end_container_on_empty_block' => true,
'wpeditimage_disable_captions' => $no_captions,
'wpeditimage_html5_captions' => current_theme_supports( 'html5', 'caption' ),
'plugins' => implode( ',', $plugins ),
);
if ( ! empty( $mce_external_plugins ) ) {
- self::$first_init['external_plugins'] = json_encode( $mce_external_plugins );
+ self::$first_init['external_plugins'] = wp_json_encode( $mce_external_plugins );
}
- $suffix = defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ? '' : '.min';
- $version = 'ver=' . $GLOBALS['wp_version'];
+ $suffix = SCRIPT_DEBUG ? '' : '.min';
+ $version = 'ver=' . $wp_version;
$dashicons = includes_url( "css/dashicons$suffix.css?$version" );
// WordPress default stylesheet and dashicons
$mce_buttons = apply_filters( 'teeny_mce_buttons', array('bold', 'italic', 'underline', 'blockquote', 'strikethrough', 'bullist', 'numlist', 'alignleft', 'aligncenter', 'alignright', 'undo', 'redo', 'link', 'unlink', 'fullscreen'), $editor_id );
$mce_buttons_2 = $mce_buttons_3 = $mce_buttons_4 = array();
} else {
+ $mce_buttons = array( 'bold', 'italic', 'strikethrough', 'bullist', 'numlist', 'blockquote', 'hr', 'alignleft', 'aligncenter', 'alignright', 'link', 'unlink', 'wp_more', 'spellchecker' );
+
+ if ( $set['_content_editor_dfw'] ) {
+ $mce_buttons[] = 'dfw';
+ } else {
+ $mce_buttons[] = 'fullscreen';
+ }
+
+ $mce_buttons[] = 'wp_adv';
/**
* Filter the first-row list of TinyMCE buttons (Visual tab).
* @param array $buttons First-row list of buttons.
* @param string $editor_id Unique editor identifier, e.g. 'content'.
*/
- $mce_buttons = apply_filters( 'mce_buttons', array('bold', 'italic', 'strikethrough', 'bullist', 'numlist', 'blockquote', 'hr', 'alignleft', 'aligncenter', 'alignright', 'link', 'unlink', 'wp_more', 'spellchecker', 'fullscreen', 'wp_adv' ), $editor_id );
+ $mce_buttons = apply_filters( 'mce_buttons', $mce_buttons, $editor_id );
+
+ $mce_buttons_2 = array( 'formatselect', 'underline', 'alignjustify', 'forecolor', 'pastetext', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo' );
+
+ if ( ! wp_is_mobile() ) {
+ $mce_buttons_2[] = 'wp_help';
+ }
/**
* Filter the second-row list of TinyMCE buttons (Visual tab).
* @param array $buttons Second-row list of buttons.
* @param string $editor_id Unique editor identifier, e.g. 'content'.
*/
- $mce_buttons_2 = apply_filters( 'mce_buttons_2', array( 'formatselect', 'underline', 'alignjustify', 'forecolor', 'pastetext', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help' ), $editor_id );
+ $mce_buttons_2 = apply_filters( 'mce_buttons_2', $mce_buttons_2, $editor_id );
/**
* Filter the third-row list of TinyMCE buttons (Visual tab).
}
}
+ $body_class .= ' locale-' . sanitize_html_class( strtolower( str_replace( '_', '-', get_locale() ) ) );
+
if ( !empty($set['tinymce']['body_class']) ) {
$body_class .= ' ' . $set['tinymce']['body_class'];
unset($set['tinymce']['body_class']);
}
- if ( $set['dfw'] ) {
- // replace the first 'fullscreen' with 'wp_fullscreen'
- if ( ($key = array_search('fullscreen', $mce_buttons)) !== false )
- $mce_buttons[$key] = 'wp_fullscreen';
- elseif ( ($key = array_search('fullscreen', $mce_buttons_2)) !== false )
- $mce_buttons_2[$key] = 'wp_fullscreen';
- elseif ( ($key = array_search('fullscreen', $mce_buttons_3)) !== false )
- $mce_buttons_3[$key] = 'wp_fullscreen';
- elseif ( ($key = array_search('fullscreen', $mce_buttons_4)) !== false )
- $mce_buttons_4[$key] = 'wp_fullscreen';
- }
-
$mceInit = array (
'selector' => "#$editor_id",
'resize' => 'vertical',
'body_class' => $body_class
);
- if ( $first_run )
- $mceInit = array_merge( self::$first_init, $mceInit );
+ // Merge with the first part of the init array
+ $mceInit = array_merge( self::$first_init, $mceInit );
if ( is_array( $set['tinymce'] ) )
$mceInit = array_merge( $mceInit, $set['tinymce'] );
* before tinyMCE.init. Setting "valid_elements", "invalid_elements"
* and "extended_valid_elements" can be done through this filter. Best
* is to use the default cleanup by not specifying valid_elements,
- * as TinyMCE contains full set of XHTML 1.0.
+ * as TinyMCE checks against the full set of HTML 5.0 elements and attributes.
*/
if ( $set['teeny'] ) {
} // end if self::$this_tinymce
}
+ /**
+ *
+ * @static
+ * @param array $init
+ * @return string
+ */
private static function _parse_init($init) {
$options = '';
return '{' . trim( $options, ' ,' ) . '}';
}
+ /**
+ *
+ * @static
+ */
public static function enqueue_scripts() {
- wp_enqueue_script('word-count');
-
if ( self::$has_tinymce )
wp_enqueue_script('editor');
wp_enqueue_script('wplink');
}
- if ( in_array('wpfullscreen', self::$plugins, true) || in_array('fullscreen', self::$qt_buttons, true) )
- wp_enqueue_script('wp-fullscreen');
+ if ( self::$old_dfw_compat ) {
+ wp_enqueue_script('wp-fullscreen-stub');
+ }
if ( self::$has_medialib ) {
add_thickbox();
) );
}
- public static function wp_mce_translation() {
+ /**
+ * Translates the default TinyMCE strings and returns them as JSON encoded object ready to be loaded with tinymce.addI18n().
+ * Can be used directly (_WP_Editors::wp_mce_translation()) by passing the same locale as set in the TinyMCE init object.
+ *
+ * @static
+ * @param string $mce_locale The locale used for the editor.
+ * @param bool $json_only optional Whether to include the JavaScript calls to tinymce.addI18n() and tinymce.ScriptLoader.markDone().
+ * @return string Translation object, JSON encoded.
+ */
+ public static function wp_mce_translation( $mce_locale = '', $json_only = false ) {
$mce_translation = array(
// Default TinyMCE strings
'Blockquote' => __( 'Blockquote' ),
'Div' => _x( 'Div', 'HTML tag' ),
'Pre' => _x( 'Pre', 'HTML tag' ),
+ 'Preformatted' => _x( 'Preformatted', 'HTML tag' ),
'Address' => _x( 'Address', 'HTML tag' ),
'Inline' => _x( 'Inline', 'HTML elements' ),
'Insert/edit link' => __( 'Insert/edit link' ),
'Remove link' => __( 'Remove link' ),
+ 'Color' => __( 'Color' ),
+ 'Custom color' => __( 'Custom color' ),
+ 'Custom...' => _x( 'Custom...', 'label for custom color' ),
+ 'No color' => __( 'No color' ),
+
// Spelling, search/replace plugins
'Could not find the specified string.' => __( 'Could not find the specified string.' ),
'Replace' => _x( 'Replace', 'find/replace' ),
'Finish' => _x( 'Finish', 'spellcheck' ),
'Ignore all' => _x( 'Ignore all', 'spellcheck' ),
'Ignore' => _x( 'Ignore', 'spellcheck' ),
+ 'Add to Dictionary' => __( 'Add to Dictionary' ),
// TinyMCE tables
'Insert table' => __( 'Insert table' ),
'Table properties' => __( 'Table properties' ),
'Row properties' => __( 'Table row properties' ),
'Cell properties' => __( 'Table cell properties' ),
+ 'Border color' => __( 'Border color' ),
'Row' => __( 'Row' ),
'Rows' => __( 'Rows' ),
'Width' => __( 'Width' ),
'Caption' => __( 'Caption' ),
'Alignment' => __( 'Alignment' ),
+ 'H Align' => _x( 'H Align', 'horizontal table cell alignment' ),
'Left' => __( 'Left' ),
'Center' => __( 'Center' ),
'Right' => __( 'Right' ),
'None' => _x( 'None', 'table cell alignment attribute' ),
+ 'V Align' => _x( 'V Align', 'vertical table cell alignment' ),
+ 'Top' => __( 'Top' ),
+ 'Middle' => __( 'Middle' ),
+ 'Bottom' => __( 'Bottom' ),
'Row group' => __( 'Row group' ),
'Column group' => __( 'Column group' ),
/* translators: word count */
'Words: {0}' => sprintf( __( 'Words: %s' ), '{0}' ),
'Paste is now in plain text mode. Contents will now be pasted as plain text until you toggle this option off.' => __( 'Paste is now in plain text mode. Contents will now be pasted as plain text until you toggle this option off.' ) . "\n\n" . __( 'If you’re looking to paste rich content from Microsoft Word, try turning this option off. The editor will clean up text pasted from Word automatically.' ),
- 'Rich Text Area. Press ALT-F9 for menu. Press ALT-F10 for toolbar. Press ALT-0 for help' => __( 'Rich Text Area. Press ALT-F9 for menu. Press ALT-F10 for toolbar. Press ALT-0 for help' ),
+ 'Rich Text Area. Press ALT-F9 for menu. Press ALT-F10 for toolbar. Press ALT-0 for help' => __( 'Rich Text Area. Press Alt-Shift-H for help' ),
'You have unsaved changes are you sure you want to navigate away?' => __( 'The changes you made will be lost if you navigate away from this page.' ),
'Your browser doesn\'t support direct access to the clipboard. Please use the Ctrl+X/C/V keyboard shortcuts instead.' => __( 'Your browser does not support direct access to the clipboard. Please use keyboard shortcuts or your browser’s edit menu instead.' ),
'Format' => _x( 'Format', 'TinyMCE menu' ),
// WordPress strings
- 'Keyboard Shortcuts' => __( 'Keyboard Shortcuts' ),
'Toolbar Toggle' => __( 'Toolbar Toggle' ),
'Insert Read More tag' => __( 'Insert Read More tag' ),
+ 'Insert Page Break tag' => __( 'Insert Page Break tag' ),
'Read more...' => __( 'Read more...' ), // Title on the placeholder inside the editor
- 'Distraction Free Writing' => __( 'Distraction Free Writing' ),
+ 'Distraction-free writing mode' => __( 'Distraction-free writing mode' ),
+ 'No alignment' => __( 'No alignment' ), // Tooltip for the 'alignnone' button in the image toolbar
+ 'Remove' => __( 'Remove' ), // Tooltip for the 'remove' button in the image toolbar
+ 'Edit ' => __( 'Edit' ), // Tooltip for the 'edit' button in the image toolbar
+
+ // Shortcuts help modal
+ 'Keyboard Shortcuts' => __( 'Keyboard Shortcuts' ),
+ 'Default shortcuts,' => __( 'Default shortcuts,' ),
+ 'Additional shortcuts,' => __( 'Additional shortcuts,' ),
+ 'Focus shortcuts:' => __( 'Focus shortcuts:' ),
+ 'Inline toolbar (when an image, link or preview is selected)' => __( 'Inline toolbar (when an image, link or preview is selected)' ),
+ 'Editor menu (when enabled)' => __( 'Editor menu (when enabled)' ),
+ 'Editor toolbar' => __( 'Editor toolbar' ),
+ 'Elements path' => __( 'Elements path' ),
+ 'Ctrl + Alt + letter:' => __( 'Ctrl + Alt + letter:' ),
+ 'Shift + Alt + letter:' => __( 'Shift + Alt + letter:' ),
+ 'Cmd + letter:' => __( 'Cmd + letter:' ),
+ 'Ctrl + letter:' => __( 'Ctrl + letter:' ),
+ 'Letter' => __( 'Letter' ),
+ 'Action' => __( 'Action' ),
+ 'To move focus to other buttons use Tab or the arrow keys. To return focus to the editor press Escape or use one of the buttons.' =>
+ __( 'To move focus to other buttons use Tab or the arrow keys. To return focus to the editor press Escape or use one of the buttons.' ),
+ 'When starting a new paragraph with one of these formatting shortcuts followed by a space, the formatting will be applied automatically. Press Backspace or Escape to undo.' =>
+ __( 'When starting a new paragraph with one of these formatting shortcuts followed by a space, the formatting will be applied automatically. Press Backspace or Escape to undo.' ),
+ 'The following formatting shortcuts are replaced when pressing Enter. Press Escape or the Undo button to undo.' =>
+ __( 'The following formatting shortcuts are replaced when pressing Enter. Press Escape or the Undo button to undo.' ),
);
/**
* Url
*/
- $baseurl = self::$baseurl;
- $mce_locale = self::$mce_locale;
+ if ( ! $mce_locale ) {
+ $mce_locale = self::$mce_locale;
+ }
/**
* Filter translated strings prepared for TinyMCE.
$mce_translation = apply_filters( 'wp_mce_translation', $mce_translation, $mce_locale );
foreach ( $mce_translation as $key => $value ) {
+ // Remove strings that are not translated.
+ if ( $key === $value ) {
+ unset( $mce_translation[$key] );
+ continue;
+ }
+
if ( false !== strpos( $value, '&' ) ) {
$mce_translation[$key] = html_entity_decode( $value, ENT_QUOTES, 'UTF-8' );
}
$mce_translation['_dir'] = 'rtl';
}
- return "tinymce.addI18n( '$mce_locale', " . json_encode( $mce_translation ) . ");\n" .
+ if ( $json_only ) {
+ return wp_json_encode( $mce_translation );
+ }
+
+ $baseurl = self::$baseurl ? self::$baseurl : includes_url( 'js/tinymce' );
+
+ return "tinymce.addI18n( '$mce_locale', " . wp_json_encode( $mce_translation ) . ");\n" .
"tinymce.ScriptLoader.markDone( '$baseurl/langs/$mce_locale.js' );\n";
}
+ /**
+ *
+ * @static
+ * @global string $wp_version
+ * @global string $tinymce_version
+ * @global bool $concatenate_scripts
+ * @global bool $compress_scripts
+ */
public static function editor_js() {
- global $tinymce_version, $concatenate_scripts, $compress_scripts;
+ global $wp_version, $tinymce_version, $concatenate_scripts, $compress_scripts;
/**
* Filter "tiny_mce_version" is deprecated
'language' => self::$mce_locale
);
- $suffix = ( defined('SCRIPT_DEBUG') && SCRIPT_DEBUG ) ? '' : '.min';
+ $suffix = SCRIPT_DEBUG ? '' : '.min';
/**
* Fires immediately before the TinyMCE settings are printed.
$baseurl = self::$baseurl;
// Load tinymce.js when running from /src, else load wp-tinymce.js.gz (production) or tinymce.min.js (SCRIPT_DEBUG)
- $mce_suffix = false !== strpos( $GLOBALS['wp_version'], '-src' ) ? '' : '.min';
+ $mce_suffix = false !== strpos( $wp_version, '-src' ) ? '' : '.min';
if ( $tmce_on ) {
if ( $compressed ) {
?>
( function() {
- var init, edId, qtId, firstInit, wrapper;
+ var init, id, $wrap;
if ( typeof tinymce !== 'undefined' ) {
- for ( edId in tinyMCEPreInit.mceInit ) {
- if ( firstInit ) {
- init = tinyMCEPreInit.mceInit[edId] = tinymce.extend( {}, firstInit, tinyMCEPreInit.mceInit[edId] );
- } else {
- init = firstInit = tinyMCEPreInit.mceInit[edId];
- }
-
- wrapper = tinymce.DOM.select( '#wp-' + edId + '-wrap' )[0];
-
- if ( ( tinymce.DOM.hasClass( wrapper, 'tmce-active' ) || ! tinyMCEPreInit.qtInit.hasOwnProperty( edId ) ) &&
- ! init.wp_skip_init ) {
+ for ( id in tinyMCEPreInit.mceInit ) {
+ init = tinyMCEPreInit.mceInit[id];
+ $wrap = tinymce.$( '#wp-' + id + '-wrap' );
- try {
- tinymce.init( init );
+ if ( ( $wrap.hasClass( 'tmce-active' ) || ! tinyMCEPreInit.qtInit.hasOwnProperty( id ) ) && ! init.wp_skip_init ) {
+ tinymce.init( init );
- if ( ! window.wpActiveEditor ) {
- window.wpActiveEditor = edId;
- }
- } catch(e){}
+ if ( ! window.wpActiveEditor ) {
+ window.wpActiveEditor = id;
+ }
}
}
}
if ( typeof quicktags !== 'undefined' ) {
- for ( qtId in tinyMCEPreInit.qtInit ) {
- try {
- quicktags( tinyMCEPreInit.qtInit[qtId] );
+ for ( id in tinyMCEPreInit.qtInit ) {
+ quicktags( tinyMCEPreInit.qtInit[id] );
- if ( ! window.wpActiveEditor ) {
- window.wpActiveEditor = qtId;
- }
- } catch(e){};
- }
- }
-
- if ( typeof jQuery !== 'undefined' ) {
- jQuery('.wp-editor-wrap').on( 'click.wp-editor', function() {
- if ( this.id ) {
- window.wpActiveEditor = this.id.slice( 3, -5 );
- }
- });
- } else {
- for ( qtId in tinyMCEPreInit.qtInit ) {
- document.getElementById( 'wp-' + qtId + '-wrap' ).onclick = function() {
- window.wpActiveEditor = this.id.slice( 3, -5 );
+ if ( ! window.wpActiveEditor ) {
+ window.wpActiveEditor = id;
}
}
}
if ( in_array( 'wplink', self::$plugins, true ) || in_array( 'link', self::$qt_buttons, true ) )
self::wp_link_dialog();
- if ( in_array( 'wpfullscreen', self::$plugins, true ) || in_array( 'fullscreen', self::$qt_buttons, true ) )
- self::wp_fullscreen_html();
-
/**
* Fires after any core TinyMCE editor instances are created.
*
do_action( 'after_wp_tiny_mce', self::$mce_settings );
}
+ /**
+ *
+ * @static
+ * @global int $content_width
+ */
public static function wp_fullscreen_html() {
- global $content_width;
- $post = get_post();
-
- $width = isset( $content_width ) && 800 > $content_width ? $content_width : 800;
- $width = $width + 22; // compensate for the padding and border
- $dfw_width = get_user_setting( 'dfw_width', $width );
- $save = isset( $post->post_status ) && $post->post_status == 'publish' ? __('Update') : __('Save');
-
- ?>
- <div id="wp-fullscreen-body" class="wp-core-ui<?php if ( is_rtl() ) echo ' rtl'; ?>" data-theme-width="<?php echo (int) $width; ?>" data-dfw-width="<?php echo (int) $dfw_width; ?>">
- <div id="fullscreen-topbar">
- <div id="wp-fullscreen-toolbar">
- <div id="wp-fullscreen-close"><a href="#" onclick="wp.editor.fullscreen.off();return false;"><?php _e('Exit fullscreen'); ?></a></div>
- <div id="wp-fullscreen-central-toolbar" style="width:<?php echo $width; ?>px;">
-
- <div id="wp-fullscreen-mode-bar">
- <div id="wp-fullscreen-modes" class="button-group">
- <a class="button wp-fullscreen-mode-tinymce" href="#" onclick="wp.editor.fullscreen.switchmode( 'tinymce' ); return false;"><?php _e( 'Visual' ); ?></a>
- <a class="button wp-fullscreen-mode-html" href="#" onclick="wp.editor.fullscreen.switchmode( 'html' ); return false;"><?php _ex( 'Text', 'Name for the Text editor tab (formerly HTML)' ); ?></a>
- </div>
- </div>
-
- <div id="wp-fullscreen-button-bar"><div id="wp-fullscreen-buttons" class="mce-toolbar">
- <?php
-
- $buttons = array(
- // format: title, onclick, show in both editors
- 'bold' => array( 'title' => __('Bold (Ctrl + B)'), 'both' => false ),
- 'italic' => array( 'title' => __('Italic (Ctrl + I)'), 'both' => false ),
- 'bullist' => array( 'title' => __('Unordered list (Alt + Shift + U)'), 'both' => false ),
- 'numlist' => array( 'title' => __('Ordered list (Alt + Shift + O)'), 'both' => false ),
- 'blockquote' => array( 'title' => __('Blockquote (Alt + Shift + Q)'), 'both' => false ),
- 'wp-media-library' => array( 'title' => __('Media library (Alt + Shift + M)'), 'both' => true ),
- 'link' => array( 'title' => __('Insert/edit link (Alt + Shift + A)'), 'both' => true ),
- 'unlink' => array( 'title' => __('Unlink (Alt + Shift + S)'), 'both' => false ),
- 'help' => array( 'title' => __('Help (Alt + Shift + H)'), 'both' => false ),
- );
-
- /**
- * Filter the list of TinyMCE buttons for the fullscreen
- * 'Distraction Free Writing' editor.
- *
- * @since 3.2.0
- *
- * @param array $buttons An array of TinyMCE buttons for the DFW editor.
- */
- $buttons = apply_filters( 'wp_fullscreen_buttons', $buttons );
-
- foreach ( $buttons as $button => $args ) {
- if ( 'separator' == $args ) {
- continue;
- }
-
- $onclick = ! empty( $args['onclick'] ) ? ' onclick="' . $args['onclick'] . '"' : '';
- $title = esc_attr( $args['title'] );
- ?>
-
- <div class="mce-widget mce-btn<?php if ( $args['both'] ) { ?> wp-fullscreen-both<?php } ?>">
- <button type="button" aria-label="<?php echo $title; ?>" title="<?php echo $title; ?>"<?php echo $onclick; ?> id="wp_fs_<?php echo $button; ?>">
- <i class="mce-ico mce-i-<?php echo $button; ?>"></i>
- </button>
- </div>
- <?php
- }
-
- ?>
-
- </div></div>
-
- <div id="wp-fullscreen-save">
- <input type="button" class="button button-primary right" value="<?php echo $save; ?>" onclick="wp.editor.fullscreen.save();" />
- <span class="wp-fullscreen-saved-message"><?php if ( $post->post_status == 'publish' ) _e('Updated.'); else _e('Saved.'); ?></span>
- <span class="wp-fullscreen-error-message"><?php _e('Save failed.'); ?></span>
- <span class="spinner"></span>
- </div>
-
- </div>
- </div>
- </div>
- <div id="wp-fullscreen-statusbar">
- <div id="wp-fullscreen-status">
- <div id="wp-fullscreen-count"><?php printf( __( 'Word count: %s' ), '<span class="word-count">0</span>' ); ?></div>
- <div id="wp-fullscreen-tagline"><?php _e('Just write.'); ?></div>
- </div>
- </div>
- </div>
-
- <div class="fullscreen-overlay" id="fullscreen-overlay"></div>
- <div class="fullscreen-overlay fullscreen-fader fade-300" id="fullscreen-fader"></div>
- <?php
+ _deprecated_function( __FUNCTION__, '4.3' );
}
/**
*
* @since 3.1.0
*
+ * @static
* @param array $args Optional. Accepts 'pagenum' and 's' (search) arguments.
- * @return array Results.
+ * @return false|array Results.
*/
public static function wp_link_query( $args = array() ) {
$pts = get_post_types( array( 'public' => true ), 'objects' );
* Dialog for internal linking.
*
* @since 3.1.0
+ *
+ * @static
*/
public static function wp_link_dialog() {
$search_panel_visible = '1' == get_user_setting( 'wplink', '0' ) ? ' search-panel-visible' : '';
<div id="link-options">
<p class="howto"><?php _e( 'Enter the destination URL' ); ?></p>
<div>
- <label><span><?php _e( 'URL' ); ?></span><input id="url-field" type="text" name="href" /></label>
+ <label><span><?php _e( 'URL' ); ?></span><input id="wp-link-url" type="text" /></label>
</div>
- <div>
- <label><span><?php _e( 'Title' ); ?></span><input id="link-title-field" type="text" name="linktitle" /></label>
+ <div class="wp-link-text-field">
+ <label><span><?php _e( 'Link Text' ); ?></span><input id="wp-link-text" type="text" /></label>
</div>
<div class="link-target">
- <label><span> </span><input type="checkbox" id="link-target-checkbox" /> <?php _e( 'Open link in a new window/tab' ); ?></label>
+ <label><span> </span><input type="checkbox" id="wp-link-target" /> <?php _e( 'Open link in a new window/tab' ); ?></label>
</div>
</div>
<p class="howto"><a href="#" id="wp-link-search-toggle"><?php _e( 'Or link to existing content' ); ?></a></p>
<div class="link-search-wrapper">
<label>
<span class="search-label"><?php _e( 'Search' ); ?></span>
- <input type="search" id="search-field" class="link-search-field" autocomplete="off" />
+ <input type="search" id="wp-link-search" class="link-search-field" autocomplete="off" />
<span class="spinner"></span>
</label>
</div>