Skip to main content

WYSIWYG Editor

The WYSIWYG field creates an editor to enter rich content. You can enter headings, paragraphs, lists, and insert media.

Why WYSIWYG?

"WYSIWYG" stands for What You See Is What You Get, a general term of visual editor, where you see the formatted content as you type.

Screenshots

Settings

Besides the common settings, this field has the following specific settings, the keys are for use with code:

NameKeyDescription
Save data in the raw formatrawWhether to save content in the raw format without applying wpautop(). Can be true or false (default). Optional.
Editor optionsoptionsA list of editor options, see here.

By default, the plugin uses 2 editor options:

NameDefault ValueDescription
editor_classrwmb-wysiwygJust to make CSS consistent with other fields
dfwtrueAllow to use "Distraction Free Writing" mode (full-screen mode)

This is a sample field settings array when creating this field with code:

[
'name' => 'WYSIWYG / Rich Text Editor',
'id' => 'field_id',
'type' => 'wysiwyg',
'raw' => false,
'options' => [
'textarea_rows' => 4,
'teeny' => true,
],
],

Data

If raw is true, this field saves exactly what you enter into the database. Otherwise, it saves the value after applying wpautop function.

Template usage

Displaying the content:

<h2>Content</h2>
<?php rwmb_the_value( 'my_field_id' ) ?>
Content formatting

Note that the helper function doesn't format the value of this field nor run shortcodes in the content. In case you want to make it behaves similar to the post content (e.g. format and shortcodes), use this code:

$value = rwmb_meta( 'my_field_id' );
echo do_shortcode( wpautop( $value ) );

Filters

rwmb_wysiwyg_settings

This filter is used to change the options for the editor (which is passed by $field['option']) and is applied to all wysiwyg fields.

This filter accepts 1 param - an array of editor settings.