Last updated February 23, 2014. Created by joachim on February 9, 2009.
Edited by Ashford, Funkymoses, joshuajabbour, silverwing. Log in to edit this page.

Before reading on, you should ensure you have downloaded the proper versions of modules.

Installing Wysiwyg module

  • Download, extract, and place Wysiwyg module in the modules folder like any other Drupal module.

Installing client-side editors

Wysiwyg module does not do anything useful until there is at least one editor library, such as TinyMCE, FCKeditor, or NicEdit. These need to be downloaded from third-party web sites and put into the Wysiwyg module folder. admin/settings/wysiwyg/profile provides a list of compatible third-party editor libraries along with links to their respective websites and download pages, as well as detailed on-screen installation instructions.

2/23/2014 -TinyMCE version 4 is not yet compatible. The WYSiWYG module developers are trying to find all the differences to make it work properly. Read more and help test the plugins: https://drupal.org/node/1968318. Until they find all the changes, download an earlier version.

  1. Follow the download link for an editor.
  2. Extract the package.
  3. The settings page tells you where to place the extracted files. Some editors come wrapped in an additional folder, some others do not.

    In general, editor library folders are all lowercase, and use the editor's short-name without any version number or additions.

    • If the editor comes in a wrapper folder that equals its short-name, then you can put the entire wrapper folder straight into Wysiwyg's folder:

      /sites/all/libraries/[editorname]

      Make sure that the resulting structure is NOT like /sites/all/libraries/[editorname]/[editorname].

    • If the editor comes in a wrapper folder with additional characters (e.g. version number), then you can put the entire wrapper folder into the sites/all/libraries folder, but need to rename it to its short-name:

      /sites/all/libraries/[editorname]

      Make sure that the resulting structure is NOT like /sites/all/libraries/[editorname]/[editorname-version].

    • If the editor comes without a wrapper folder, then you need to create the editor's short-name folder yourself and copy the editor library files into that folder:

      /sites/all/libraries/[editorname]

  4. Go to admin/settings/wysiwyg/profile and reload the page. The newly installed editor should be marked as "installed" in the installation instructions now. If not, see the FAQ
  5. As a starting point and preliminary test whether the editor itself works, you can now associate the installed editor with an input format. Go to admin/settings/filters and determine your default input format. Then go back to admin/settings/wysiwyg/profile and associate the editor with that format. Then go to node/add/page, where the editor should appear. If it doesn't check under the body text area to see if you have a different input format selected. If it's the right input format go back to the WYSYWIG configuration page and edit the settings for the default format. Some editors (like CKEditor) default to showing nothing. Add a few buttons and try again.
  6. If you prefer, you can now create a new input format and associate the editor with that or just leave it using the default.
  7. Now head back to admin/settings/wysiwyg/profile one more time and click on the edit link beside your format/editor combination and fine tune the editor.

Pathing

Pathing is not always easy to figure out.

Extract the archive and copy its contents into a new folder in the following location:
sites/all/libraries/tinymce

So the actual library can be found at:
sites/all/libraries/tinymce/jscripts/tiny_mce/tiny_mce.js

Language selection

Be sure the language dropdown menu on Basic settings on page /admin/settings/wysiwyg/profile/2/edit is set correctly. For example, if RU-UTF8 is selected rather than RU, it will not work. Double check your language selection.

It just won't load.

In a nutshell, the wysiwyg module assumes that your theme uses the closure variable, if you don't then wysiwyg.js won't load!

To make it work, insert the following in your theme's page.tpl.php, just before the closing body tag......
print $closure

This will result in a script tag added to the bottom of your page that refers to the wysiwyg source, e.g., "/xxx/sites/all/modules/downloaded/wysiwyg/wysiwyg.js?q"

Looking for support? Visit the Drupal.org forums, or join #drupal-support in IRC.

Comments

print $closure is in page.tpl.php and it just won't load. I've tried about half of the editors listed on the page. Fresh D6 install (6.20).

I would change the world, if God would give me the source code.

Sorry, there is no God, can't help with that, however
<?php  print $styles ?> needs to be on top of page.tpl.php too, unfortunately, that could be the problem.

Awesomeness! I personally recommend TinyMCE. Easy to install and use, not to mention it's open source!

Perfecting web standards one page at a time.

admin/settings/wysiwyg/profile provides a list of compatible third-party editor libraries along with links to their respective websites and download pages

No, it doesn't. How do I navigate to this in the admin UI?

It's at admin/config/content/wysiwyg (under the pull-down section labeled "Installation" part way down the page).

These instructions say:
"If the editor comes in a wrapper folder that equals its short-name, then you can put the entire wrapper folder straight into Wysiwyg's folder:
/sites/all/libraries/[editorname]"

This path doesn't seem to fit with what this instruction says (and putting the editor's wrapper folder into Wisiwig's folder, at say - sites/all/modules/wisiwyg/ - doesn't seem to work, either). I think maybe this is supposed to say that in this case you can put the entire wrapper folder into the libraries folder in the same sites path that you've got the Wisiwyg module in. (That is, if you've got that in sites/all/modules, then you can put the editor folder into sites/all/libraries, and if you've got that in sites/default/modules, you could put it in sites/default/libraries. Of course, it would work in sites/all/libraries too...)

FCKEditor has now been replaced by CKEditor, and the installation instructions aren't very clear about how to deal with the editor's directory structure that download now gives you. It looks like ckeditor/ckeditor plus a bunch of other files, but the included ckeditor folder also contains a pile of files, including ckeditor.js. Both the ckeditor folders contain a folder called images and one called plugins, with files in them. I moved all the files in ckeditor/ckeditor into the top ckeditor directory, and put the images and plugins that were in ckeditor/ckeditor/images and in ckeditor/ckeditor/plugins into ckeditor/images and ckeditor/plugins along with the images and plugins that were already there. This does install the editor, and it seems to work so far.

The instructions on this page are lame. But once you install the WYSIWYG module there are more current instructions in Admin on installing editors.

Go into Admin/Modules and activate WYSIWYG. Come back to Admin/Modules. At WYSIWYG, click Configure. Installation Instructions for the editors appear.

I installed TinyMCE without problems.

Make sure the PATH is correct.

This was my old PATH:
public_html/drupal/sites/libraries/ckeditor

Took me like an hour to figure out I missed the "all" directory.

Correct PATH:
public_html/drupal/sites/all/libraries/ckeditor

I Installed Wysiwyg module v7.x-2.2 and CKEditor library version 4.0.1 , but Wysiwyg cannot detect library.
so i downgrade CKEditor to 3.6.6 working with Wysiwyg module v7.x-2.2.

Thanks, m a r t i n

Check out this thread if you are having trouble.

http://drupalthread.blogspot.com/2012/08/before-we-start-how-to-install-...

IMPORTANTLY

If you seem to have everything set up and it seems to be installed but no editor is appearing on your pages, you must enable the plugins you selected with install here: admin/config/content/wysiwyg/profile/filtered_html/edit > BUTTONS AND PLUGINS

Peace!
Odisey

Works for me most of the plugins, but some of them do not even appear in the list (Table checkboxses). For example there is no possibility to include plug-in Youtube and smileys. Why can this be?

Note that -- I am told -- if you install an editor that is of a version newer than the version of wysiwyg you're using, that it may not detect it, and you'll need to either use an older editor, use the -dev version of wysiwyg, or hack.

This appears to be what's troubling me, with the latest versions of both TinyMCEjq, and wysiwyg, though I don't have the cPanel password to the shared site, and can't confirm til tomorrow.

I just updated to d 7.24 and can't get the tinymce to work with either the tinymce or tinymce+jq

Just resolved this.... download and unzip the older version of tinymce version 3.5.10