TinyMCE configuration and limitations

GD bbPress Toolbox Pro allows you to use WordPress integrated TinyMCE editor for editing topics and replies. The plugin includes several settings for configuring the TinyMCE integration.

GD bbPress Toolbox Pro is adding TinyMCE by enabling this feature in bbPress. This is a fully 100% bbPress feature that GD bbPress Toolbox Pro ONLY ENABLES, it doesn’t add anything to or has any control over. All the settings GD bbPress Toolbox Pro exposes are already implemented by bbPress, they are only enabled or disabled.

TinyMCE Editor Settings
TinyMCE Editor Settings

Editor Configuration

There are few things you can modify, and that can be done for the Topic and Reply editor independently. To use the TinyMCE editor, you need to enable the ‘Rich Editor’ feature from the Features panel.

After you do that, you have 4 options related to TinyMCE:

  • Compact Editor Toolbar: this is the ‘Lite’ version of the TinyMCE with only some basic buttons included.
  • Media Buttons: this will show a button for adding files and images into the editor.
  • QuickTags: display HTML along with the Visual tab.
  • WPAutoP Filter: this filter is processing the content for auto-formatting using paragraphs.
  • Editor Rows: this will configure the number of lines, or size, of the editor.

The main issue with using TinyMCE with bbPress is that bbPress limits allowed HTML tags to a very small set of tags, and because of that, after saving TinyMCE formatted content, you may end up with HTML tags converted to text. If you plan to use TinyMCE editor, make sure to enable an expanded list of HTML tags and attributes (check advanced settings below).

Advanced Settings

There are two special options that GD bbPress Toolbox Pro can use to improve the TinyMCE usability. Both options are found on the Features -> Tweaks panel.

  • Expand KSES allowed HTML tags and attributes: this will expand the list of allowed HTML tags and attributes for use in the editor. If you don’t use this, bbPress will strip out most of the HTML you may use in the TinyMCE. It is best to set this to an Expanded range of tags and attributes.
  • Allow Participants to use Media Library: this option will allow the normal user (Participants) to use Media Button and Media Library. By default, bbPress user roles allow this for keymaster and moderator roles, and normal users can’t insert media in the TinyMCE editor.

Limitations

As it is said before, GD bbPress Toolbox Pro adds TinyMCE into the topic and replies to editors, and beyond few settings, there is no other control over the way the TinyMCE works.

  • TinyMCE is added using with bbPress hidden feature using the core WordPress function, and only settings implemented through this function are supported.
  • GD bbPress Toolbox Pro can’t change buttons (add or remove them) in the TinyMCE editor toolbar.
  • GD bbPress Toolbox Pro can’t control how the Media Library is used through Media Button in the TinyMCE editor.

Other potential problems

Once the editor is added to the website front end, theme styling and theme scripts can cause problems with the editor:

  • Themes with aggressive styling selector rules can change the color of the buttons, make buttons too big or too small, make some areas of the editor unusable. GD bbPress Toolbox Pro includes an extra stylesheet to try and prevent some of these things front happening, but in the end, themes can do a lot of things beyond plugin control.
  • In rare cases, theme or other plugins can even interfere with the TinyMCE working at all due to JavaScript errors, and you can end up with missing content during the edit, popups in TinyMCE not working, and more. You can use a browser debugger to find exactly what JavaScript errors you have on your website.
  • The general rule is: fix all JavaScript errors, no matter what causes them. JavaScript can be very fragile, and breaking one JavaScript part of the code can have a negative effect on other things, especially if using jQuery (and most of the WordPress uses jQuery).
  • If you run into such issues, you need to consult your theme author to fix the issues that are causing TinyMCE problems.
  • Dev4Press can’t provide any support related to the issues with TinyMCE!
1
0
1191
Rate this article

You are not allowed to rate this post.

Leave a Comment