# Editor (WYSIWYG)

Editor field renders a WYSIWYG editor. Due to complexities of the field, it does not have the switch between Text and Visual modes.

## Example configuration

```php
...
array(
    'title' => 'My editor field title',
    'id' => 'editor-option',
    'desc' => 'Short description for the field',
    'tab' => 'main',
    'type' => 'editor',
),
...
```

This will produce something similar to the following

![](https://2720448264-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LKMTiOPVR7pXWhebz7q%2Fsync%2Fc60ef6d58247e9b18fd635bd4510d69210abb47d.png?generation=1602624628926100\&alt=media)

In other words it will look like a WYSIWYG editor from the post page.

## Filters

The field uses [`wp_kses`](https://developer.wordpress.org/reference/functions/wp_kses/) to sanitize the value before storing it in the database. The following filters can be used to control it.

| Name                                                                                                           | Description                                         |
| -------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| [`alch_allowed_editor_html_tags`](https://docs.alchemy-options.com/v0.9/filters/alch_allowed_editor_html_tags) | Can be used to control which HTML tags are allowed. |
| [`alch_allowed_editor_protocols`](https://docs.alchemy-options.com/v0.9/filters/alch_allowed_editor_protocols) | Can be used to control which protocols are allowed. |

See the filters page for more details.

## Params

| Name    | Type   | Description                                                      |
| ------- | ------ | ---------------------------------------------------------------- |
| `type`  | string | `editor` **(required)**                                          |
| `id`    | string | Unique ID that will be used to retrieve the value **(required)** |
| `tab`   | string | Specifies in which tab this option will be rendered              |
| `title` | string | Shows a heading to the left of the field                         |
| `desc`  | string | Shows a description text (can have HTML)                         |