ckgedit Configuration Options
|guest_toolbar||Display Toolbar to Guests||true|
|guest_media||Guest Can Link to Media Files||true|
|open_upload||Guests can upload||false|
|default_fb||Default File Browsing Access||acl|
|openfb||Open File Browsing||false|
|dw_edit_display||Controls user access to dwedit features.||all|
|smiley_as_text||Display Douwiki smileys as text in editor||false|
|editor_bak||Save backup on Refresh||false|
|create_folder||Enable folder creation||n|
|dwedit_ns||Namespaces and/or files where DokuWiki Editor is activated||none|
|acl_del||Strict ACL delete||false|
|auth_ci||User login id is case insensitive||false|
|nix_style||Access data/media via userfiles (Windows)||false|
|direction||Set language direction||nocheck|
|scayt_auto||Scayt active at startup||disabled|
|scayt_lang||Set Scayt language||American English|
|complex_tables||Turn on complex tables parser.||true|
|duplicate_notes||Enable notes with same text||false|
|winstyle||Direct access to data/media||false|
|other_lang||Reset CKEditor language||default|
|color_options||Remove Color options||false|
|font_options||Remove font options||false|
|nofont_styling||Display font styles in editor as plugin markup||false|
|alt_toolbar||Items to remove from CKEditor toolbar||""|
|mfiles||Enable mfile support||false|
|extra_plugins||Comma-delimited list of user-defined tool bar items to be added to toolbar||""|
|dw_priority||Open with Dokuwiki Editor. See dw_users. Not available in farms branches. Incompatible with hogfather (removed).||ckeditor|
|dw_users|| Group whose editor defaults to the Dokuwiki editor when dw_priority is set. When this option is given a value and ||""|
|captcha_auth||ACL level at which the captcha is turned off when the captcha plugin's forusers option is set to true.||ACL_CREATE|
|htmlblock_ok|| Enable ||false|
|dblclk||Option to turn on or off double click access to the dokuwiki editor||on|
|preserve_enc||Preserve urlencoding in urls when the dokuwiki deaccent option is active||false|
|gui||Select CKEditor GUI.||moono|
|rel_links||Activate support for relative internal and image links||false|
|allow_ckg_filebrowser||Select which file/media browser(s) users can use||all|
|default_ckg_filebrowser||Select default file/media browser; overridden if the selected browser is not allowed||ckgedit|
|style_sheet||Use an alternate style sheet for the Ckeditor editing window||false|
|imgpaste||If the imgpaste plugin is installed, use the imgpaste naming system for naming your saved images.||true|
The default settings allow guests to have access to the toolbars and to the link and image tools. However, guests cannot upload, unless open_upload is set to true. Setting open_upload to true could be used to implement a completely open wiki, where anyone can edit and upload.
If “Display Toolbar to Guests” is set to false, guests are presented with a toolbar consisting of two items, About and Source.
If the toolbar is allowed and “Guests can Upload” is false, then visitors will not be able to upload files to the server by means of the image and link tools. However, they will still be able to view the contents of your data/media directories. See also guest_toolbar
The file browser is acl-compliant, but the administrator can turn off acl by changing this option to 'none'
Normally, the file browser opens in the the namespace of the page being edited or in the directory immediately above it, if the user has write/create permission in that directory. But if Open File Browsing is set to true, the user will be able to access the entire directory hierarchy; however, ACL permissions still will apply, unless they have been turned off. That means that the user will be able to read the contents of all directories for which he has Read permission but will not be able to upload to those directories for which he does not have upload permission. In the case of administrators, the browser will always open in the root directory.
This option governs the different methods of accessing the native dokuwiki editor:
- the 'DW Edit' button, located below ckgedit's editing window
- the double-click method of opening the editor for section editing
There are three options: 'all', which gives access to all users; 'admin', which restricts access to administrators; and 'none', which hides the button from all users.
This governs how Dokuwiki smileys appear in the editor window. At the initial insertion, they will be inserted as images. They are, however, saved as text. Setting this option to true will cause Dokuwiki smileys always to show up as text in the editing window. They will of course still appear as images in the browser.
If true, a copy of the current state of the editing window will be saved to a meta file in the meta directory, with the same name as the document being edited but with a .ckgedit extension.
If set to 'y', a folder creation button will appear at the bottom of the fle browser. Folder cannot be created by guests.
A comma separated list of files and namespace where the Dokuwiki editor is automatically loaded instead of the CKEditor. The code looks only for partial matches. So if you have “jack”, it will find “blackjack” and “jack_pine”.
The filebrowser has been set up with a loose intepretation of the permission to delete files from a folder. By default it allows users with upload permission in a folder to delete files from that folder. This is not consistent with Dokuwiki's ACL rules which require delete permission. When this option is set to true deletes are consistent with the Dokuwiki ACLs.
If logins are case insensitive, that is you can login as both USER and user, set this to true.
For Windows Servers (Vista and Later). This setting makes it possible to access data\media through ckgedit\fckeditor\userfiles, if links to media and file have been successfully created in userfiles. This option is helpful in some cases where the savedir has been moved.
This option controls the language direction in the CKEditor. There are three opitons: (1) 'nocheck', which in effect does nothing and is essentially the same as 'ltr'; (2) 'dokuwiki', which changes the language direction to the direction set by Dokuwiki, based on the current language selection; (3) 'ltr', which sets left-to-right, and (4) 'rtl', which enables right-to-left. It is possible, with these options, to have your browser set to one direction and the FCKeditor to another.
When set to “on” the SCAYT check-as-you-type spell checker is immediately active when the editing window is opened. When set to “off”, users can click on the spell-check toolbar button and select “enable SCAYT” to make check-as-you-type active or use the “Check spelling” option. When set to “disable” the spell checker is removed entirely. The Scayt service sends page-data back and forth between its servers for spell checking. Users concerned that this is a security risk can read the exchange of views at https://github.com/turnermm/ckgedit/issues/434.
The default language is American English.
This option applies only to the CKEditor smileys, not the Dokuwiki smileys. If you move to a new server, turn this option on until all pages with these smileys have been converted to the new server address. Turn it off when finished, otherwise it will keep re-writing URLs that have already been changed and needlessly using processing time. See the faq on smileys.
As of May 29/2016 this is set to
true by default. It turns on the complex tables parser. While aimed at tables that use multiple column and row spans, it does not incur a perceptible performance hit for simple tables.
When this option is turned off in the Configuration Manager, a checkbox will appear below the editing window enabling you to turn on the complex table parse on a per page basis. It is also possible to turn on the complex tables parser on a per page basis by placing the ~~COMPLEX_TABLES~~ macro at the top of the page.
Some tables are too complex for the complex tables parser. For these tables there are several options:
- create the table on a standard Dokuwiki page, using the Dokuwiki editor, and then include the table using the include plugin.
- or, save the table on the current page as an HTML Block.
Note: The complex tables parser is required if you are using font styles on the same page as tables.
When Dokuwiki encounters footnotes with identical texts, it merges the footnote references on a single line and displays the footnote text only once, instead of duplicating. For instance:
1), 3), 7) See development
Ckgedit needs to know if your users are creating these kinds of notes. If they do, then you must set this option to true; otherwise, the footnotes will become corrupted. With this option set to true, in the editor each of the duplicate footnotes will appear on a separate line, but when in the browser, they will appear as above.
On linux systems, data/media is normally accessed through symbolic links in fckeditor/userstyles, which link to data/media. The
winstyle option gives direct access to data/media. In order for it to work with apache servers, you must have the correct file in data/media. Current versions of ckgedit will install the correct .htaccess file to data/media when the winstyle option is selected. The reason for this is that Dokuwiki by default prevents direct access to your data. For older version copy .htaccess.security from fckeditor/userfiles to data/media and rename it .htaccess. .htaccess.security relaxes this restriction with respect to the basic image formats:
.png. See security_and_the_media_directory. Note:
Select interface language for CKEditor: defaults to language set for browser. This choice is independent of the Dokuwiki interface language option.
Removed from hogfather because of incompatibilities
In hogfather you should remove any reference to it from
By default, the editor opens with the CKEditor. Selecting this option will override the default behavior so that the Dokuwiki text-based editor will have priority. Users can still switch back and forth between the editors, but when the browser is closed and re-opened, the Dokuwiki editor will be selected. If the user logs off but does not close down the browser, the last editor to have been selected will open. This behavior can be changed using the dw_users setting either alone or in conjunction with the selection options under
Font Styling Options
color_options , font_options , nofont_styling
These options are covered on the page devoted to styling issues.
This setting provides a checkbox listing of Ckeditor toolbar items. To remove items from the toolbar, check their boxes. See ckgedit issues number 184.
The setting adds an
m-files protocol entry to the link dialog. See: https://www.m-files.com/en
You can add your own plugins to the editor by creating, or downloading from the CKEditor site, a CKEditor plugin and including it in
ckeditor/plugins*. The new plugin directory must be lower case. Use this setting to add new toolbar buttons for these additional plugins. The name(s) of the item(s) must be the name(s) that define the toolbar button. Typically they begin with an upper case letter; these names will be converted to lower case and added to the list of extra plugins.
*Note: the plugins directory can be found here: /lib/plugins/ckgedit/ckeditor/plugins
An example extra plugin is included with the ckgedit distribution. This is the
timestamp plugin; its button name is
Timestamp. Therefore this setting must be
Timestamp with the upper case
T, and not
timestamp. The language files for these plugins should conform to those found in
timestamp; they should be included in
<your_plugin/lang>, and an entry for each language file should be added to the
lang property of the plugin file (see
timestamp/plugin.js). The icons for these extra plugins will appear at the end of the toolbar. The geshi plugin is also handled as an extra plugin.
Removed from hogfather because of incompatibilities.
In hogfather you should remove any references to it from
dw_users group for use with dw_priority. There is a hierarchy of priority settings.
- If dw_priority has been set and no dw_users group has been supplied, then all users will get the dokuwiki editor as their default editor.
- If the user has not made a selection under
Update Profile, then the dw_users group determines the choice of editor.
- In all cases the editor can be switched by clicking the relevant button below the editor window.
- An admin will always get the dokuwiki editor when dw_priority is set to true, unless the admin has chosen not to using
Ckgedit's captcha support is integrated for use with the captcha plugin and will not work with other captcha plugins. When the captcha plugin's
foruser option is set to true,
ckgedit makes it possible to set the ACL level for which users will get the captcha. For this, the
captcha_auth option supplies a drop-down menu of AUTH choices.
HTML_BLOCKs either this setting or Dokuwiki's
htmlok option must be enabled.
htmlblock_ok doesn't pose the same level of security risk as
htmlok, because the parser is not designed to recognize scripted elements. But there is never absolute security. Therefore,
HTML_BLOCKs should be used only in a trusted user environment, and certainly not in an open wiki. If you are pasting HTML from an external source then htmlok must be enabled–but you do not need the
Clicking on a dokuwiki section while ckgedit is active will open that section for editing in the native dokuwiki editor. This feature is on by default and can be set to off with this option.
When links are created with the link tool, when saved ckgedit converts these to their native forms if dokuwiki's deaccent setting is set to
remove accents. For instance
%26 will be converted to
&. If you need to keep these urlencodings in your urls, set this to true.
If this option is set to true internal links, and media links will automatically be converted to relative links.
Choices are all, ckgedit, dokuwiki
Choices are ckgedit, dokuwiki
See ckgedit:style_sheets for instructions on how to create and install a style sheet for the CKEditor editing window which is based on your template.