Natural Edit Plugin


The NatEdit is an wiki editor that helps in learning the TML Language by providing a GUI. By design, this is not a wysiwyg editor that tries to generate the correct TML in the background. Instead, the user is still in charge of writing correct wiki markup but with a bit more of assistance as a plain browser textarea. Therefor this editor helps to lower the learning curve but will not get in your way once you are aware of wiki markup.

NatEdit is implemented as a jquery plugin, called jquery.natedit, and thus heavily depends on javascript. Hence browsers without javascript are not supported. You will need to install the JQueryPlugin to use NatEdit.

Caution: Unlikely previous versions (pre 2.0), theming has been disabled in the current version. So you are "stuck" with one and the same button layout for now.


jquery.natedit docu




To enable the NatEditPlugin add the identifier natedit to the SKIN variable in SitePreferences or WebPreferences, e.g.

   * Set SKIN = natedit,pattern

No extra configuration steps are needed in case you are using NatSkin. NatEditPlugin is the default editor for NatSkin, that is the normal

   * Set SKIN = nat

is sufficient.

Plugin Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. "Extensions Operation and Maintenance" Tab -> "Install, Update or Remove extensions" Tab. Click the "Search for Extensions" button. Enter part of the extension name or description and press search. Select the desired extension(s) and click install. If an extension is already installed, it will not show up in the search results.

You can also install from the shell by running the extension installer as the web server user: (Be sure to run as the webserver user, not as root!)
cd /path/to/foswiki
perl tools/extension_installer <NameOfExtension> install

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See for more help.

Copyright ©: 2007-2017 Michael Daum
Change History:  
| 04 May 2017 | Foswikitask:Item14388: NatEditPlugin does not honor the ScriptSuffix setting, and doesn't accommodate short URLs.
Foswikitask:Item14404: NatEdit Save and Continue action fails on mod_perl systems. |
20 Jan 2017 Foswikitask:Item14265: NatEdit plugin leaves UI blocked after some save errors
Foswikitask:Item14285: fixed error clicking on disabled toolbar buttons
06 Jan 2016 Add helper to insert a data form table header.
08 Sep 2015 Remove RevCommentPlugin hooks from templates, Hide TopicTitle when unused.
30 Aug 2015 fixed default implementation for topictitle
29 Jul 2015 added missing image in documentation
06 Mar 2015 fixed permissions editor
25 Sep 2014 move templating to new jsrender replacing deprecated jquery.tmpl
12 Dec 2013 rewrite all of the js code; make it themable using jquery-ui
01 Nov 2013 working around IE10 incompatibility of its own proprietary edit api for textareas
07 Aug 2013 fixed generation of a new validation key in a save+continue
17 Jul 2013 added support for CaptchaPlugin
18 Jun 2013 removed dependency on SetVariablePlugin
28 Mar 2013 fixed storing the TopicTitle changing during a rename action only to the topic being renamed
27 Feb 2013 re-fixed strikeone-protected save+continue; improved error handling dealing with AntiWikiSpamPlugin-alike error messages
20 Feb 2013 fixed character encoding when previewing a topic on a non-utf8 site
25 Jan 2013 fixed auto-start feature
18 Jan 2013 improved compatibility with PatternSkin
15 Jan 2013 added work-around for an IE8 bug in textareas
21 Dec 2012 added in-edit upload support using Foswiki:Extensions/TopicInteractionPlugin
29 Oct 2012 removed local button styles to allow theming via jquery-ui; use of NATEDIT_THEME is deprecated from now on
22 Oct 2012 implemented improved list editing; rewrite of modal dialogs to use jquery-ui-dialog instead of the old simplemodal library
10 Jul 2012 fixed character encoding when saving a topic on a non-utf8 site using a REST handler
21 Feb 2012 only add one strikeone nonce to the http header
20 Feb 2012 moved missing javascript code over from NatSkin to NatEditPlugin; fixed save+continue on a strikeone-protected foswiki; added compatibility wrapper for older APIs to Foswiki::Validate
17 Feb 2012 added interface to set permissions from within edit (only with Foswiki:Extensions/SetVariablePlugin installed)
11 Jan 2012 added support for Foswiki:Extensions/WorkflowPlugin
10 Jan 2012 added german translation; fixed css when used with PatternSkin
30 Sep 2011 fixed autoresize of wysiwyg editor; improved toggle button switching between raw and wysiwyg editor; improved integration of validation code; using ui::autocomplete instead of deprecated jquery.autocomplete plugin now
04 Apr 2011 using a modal dialog for preview; save+continue is done in the background async'ly now
24 Mar 2011 added specific css classes for each button box
17 Feb 2011 fixed insert table in IE7+8
22 Dec 2010 fixed some errors reported by jslint; improved the way forms are submitted to be more jquery-friendly
06 Dec 2010 Foswikitask:Item2304: fixes for Google Chrome
01 Dec 2010 fixed compatibility with newest foswiki; improved TopicTitle feature not to set a title under certain conditions; Foswikitask:Item9006: disabling preview button on IE6,7,8; shipping compressed and minified css+js
12 Feb 2010 Foswikitask:Item8486, Foswikitask:Item8385: fixing edit and settings screen on PatternSkin
04 Dec 2009 Foswikitask:Item2453: Form data not saved when edit is invoked with ?action=form ('Edit data form of this topic' link)
18 Nov 2009 Foswikitask:Item2373: improve XHTML validation