Voxel More Advanced Text Editor
The {CODICTS} Voxel More Advanced Text Editor plugin enhances the Voxel Theme’s built-in “WP Editor — Advanced” text editor field with additional formatting controls and rich paste support. It adds underline, text alignment, indent/outdent buttons and lets users paste formatted content from Word or Google Docs without losing their styling.
Installation & Activation
Start by downloading the plugin from the Downloads page on your dashboard on the CoDicts website.
After downloading, install and activate the plugin in WordPress by navigating to “Plugins” > “Add New” > “Upload Plugin” and selecting the downloaded zip file. Click “Install Now” and then “Activate”.
That’s it — no configuration needed. The enhanced editor is immediately active for all “WP Editor — Advanced” text editor fields across all your Voxel post types.
What This Plugin Solves
Voxel’s built-in “WP Editor — Advanced” text editor provides only a basic set of formatting buttons: headings, bold, italic, lists, links, strikethrough, and horizontal rule. It also forces paste-as-text behavior, which strips all formatting when users paste content from Word, Google Docs, or other rich-text applications.
This is frustrating for users who compose content externally and expect their headings, bold text, lists, and links to be preserved when they paste into the editor.
What’s Enhanced
New Toolbar Buttons
The plugin adds these buttons to the advanced editor toolbar:
| Button | Function |
|---|---|
| Underline | Underline selected text. |
| Align Left | Align text to the left. |
| Align Center | Center-align text. |
| Align Right | Align text to the right. |
| Justify | Justify text (even left and right edges). |
| Outdent | Decrease text indentation. |
| Indent | Increase text indentation. |
All existing buttons (headings, bold, italic, strikethrough, lists, links, horizontal rule) are preserved.
Rich Paste Support
The plugin disables Voxel’s paste-as-text restriction. Users can now paste content from Word, Google Docs, and other rich-text sources and retain their formatting — including bold, italic, headings, lists, links, and underline.
| Aspect | Default Voxel Behavior | With This Plugin |
|---|---|---|
| Paste from Word/Docs | All formatting stripped — plain text only | Formatting preserved (bold, italic, headings, lists, links, etc.) |
| Inline styles | Stripped on paste | Retained on paste |
| HTML elements preserved | None | Bold, italic, headings (H1–H3), underline, paragraphs, lists, links, line breaks, spans |
Note on security: Even with rich paste enabled, all content is sanitized by WordPress’s
wp_kses_post()function before saving. Dangerous elements like scripts, iframes, and event handlers are always stripped. The enhanced paste only allows safe formatting elements through.
Which Fields Are Affected
The plugin only enhances text editor fields set to the “WP Editor — Advanced” mode. Other editor modes are not changed:
| Editor Type | Affected? | Description |
|---|---|---|
| Plain Text | No | Simple textarea with no formatting — unchanged. |
| WP Editor — Basic | No | Minimal editor with bold, italic, lists, and links — unchanged. |
| WP Editor — Advanced | Yes | Gets the extended toolbar and rich paste support. |
To use the enhanced editor on a field, go to the Voxel post type editor and set the text editor field’s editor type to “WP Editor — Advanced”.
How It Works
The plugin uses Voxel’s template override system — the same pattern WordPress uses for child themes. When activated, it copies an enhanced version of the text editor field file into your Voxel child theme. Voxel automatically loads this enhanced version instead of its default.
On activation: The enhanced template file is copied into your child theme automatically.
On deactivation or uninstall: The template file is removed from your child theme, restoring Voxel’s default behavior.
On plugin update: The template file is automatically refreshed in your child theme to match the latest plugin version.
This is why a Voxel child theme is required — without one, there’s no location for the override file.
Do I Need a Voxel Child Theme?
Yes. This plugin requires an active Voxel child theme. If you don’t have one, create a child theme with at minimum a style.css file that references Voxel as the parent template. The Voxel documentation provides instructions for creating a child theme.
If the child theme is missing, you’ll see this admin notice:
{CODICTS} Voxel More Advanced Text Editor Error: Voxel Child Theme Not Detected, please install and activate the Voxel Child Theme.
Full Enhanced Toolbar
Here is the complete toolbar in order, with new buttons highlighted:
| Button | New? |
|---|---|
| Format Select (Paragraph, H1–H6, Pre) | — |
| Bold | — |
| Italic | — |
| Underline | ✅ New |
| Strikethrough | — |
| Bulleted List | — |
| Numbered List | — |
| Align Left | ✅ New |
| Align Center | ✅ New |
| Align Right | ✅ New |
| Justify | ✅ New |
| Insert / Edit Link | — |
| Remove Link | — |
| Horizontal Rule | — |
| Outdent | ✅ New |
| Indent | ✅ New |
Troubleshooting
“Voxel Theme Not Detected” Error
Ensure the Voxel Theme is installed and set as the active parent theme. Go to Appearance → Themes to verify.
“Voxel Child Theme Not Detected” Error
A Voxel child theme must be active. If you don’t have one, create a child theme that references Voxel as its parent template. The plugin cannot function with only the Voxel parent theme active.
Enhanced Editor Not Appearing
| Cause | Solution |
|---|---|
| Field not set to advanced mode | In the Voxel post type editor, change the text editor field’s editor type to “WP Editor — Advanced”. The plugin does not affect “Plain Text” or “WP Editor — Basic” fields. |
| Template file not copied | Deactivate and reactivate the plugin to force the template to be re-installed into your child theme. |
| Page cache showing old version | Clear any page caching or object caching on your site. |
Toolbar Buttons Overlapping or Clipped
The plugin includes CSS fixes for toolbar layout, but in very narrow form containers, toolbar buttons will wrap to multiple lines — this is expected. If buttons appear clipped, check for conflicting CSS from other plugins or themes that override the editor’s container styles.
Pasted Content Still Loses Formatting
| Cause | Solution |
|---|---|
| Field is using “Plain Text” mode | Plain text mode strips all HTML by design. Switch the field to “WP Editor — Advanced” in the post type editor. |
| Using Ctrl+Shift+V | Ctrl+Shift+V (or Cmd+Shift+V) is the “paste without formatting” shortcut. Use Ctrl+V (or Cmd+V) to paste with formatting. |
| Certain HTML elements stripped after save | WordPress’s server-side sanitization (wp_kses_post) removes elements not in its allowed list. This is a security feature and cannot be bypassed. |
Template Files Remain After Deactivation
The plugin automatically removes its template file from your child theme on deactivation. If the file remains (which can happen due to file permissions), manually delete app/post-types/fields/texteditor-field.php from your child theme folder.
Plugin Updated but Editor Unchanged
The plugin automatically refreshes the template file in your child theme when it detects a version change. If the update doesn’t take effect, deactivate and reactivate the plugin to force a fresh template installation.
For further support, visit codicts.com or contact us at support@codicts.com.