Changes for page CKEditor Integration

Summary

• Objects (1 modified, 0 added, 0 removed)
  • ExtensionCode.ExtensionClass[0]

Details

ExtensionCode.ExtensionClass[0]

Description

...	...	@@ -35,9 +35,13 @@
35	35
36	36	XWiki integrates CKEditor. However XWiki doesn't offer by default all the options you'll find in CKEditor by default. The reason is that we want to offer a simple editor suited for a wiki and there are some features that are less useful in a wiki. In addition we'd like users to be able to focus on writing content and less about style. However you can tune the configuration if you wish to enable those options.
37	37
38		-For the moment the CKEditor doesn't provide a [[configuration section>>http://jira.xwiki.org/browse/CKEDITOR-32]] in the [[Wiki Administration>>extensions:Extension.Administration Application]], but you can still configure the editor. You have the following options:
	38	+Starting with version 1.9 the recommended way to configure the CKEditor is through the dedicated "WYSIWYG Editor" section in the [[Wiki Administration>>extensions:Extension.Administration Application]].
39	39
40		-1. You can edit the ##CKEditor.EditSheet## page using the Object editor, expand the first ##JavaScriptExtension## object ("CKEditor Loader") and look for the ##ckeditor.replace## line. You'll notice there the configuration options. Check out the [[CKEditor documentation>>http://docs.ckeditor.com/#!/api/CKEDITOR.config]] for more configuration options.
	40	+{{image reference="wysiwyg-editor-config.png" /}}
	41	+
	42	+If you have an older version of the CKEditor Integration extension installed (<1.9) and you cannot upgrade, you can still configure the editor. You have the following options:
	43	+
	44	+1. You can edit the ##CKEditor.EditSheet## page using the Object editor, expand the first ##JavaScriptExtension## object ("CKEditor Loader") and look for the ##ckeditor.replace## line. You'll notice there the configuration options.
41	41	1. On XWiki 8.1M1+ you can create a [[JavaScript extension>>platform:DevGuide.SkinExtensionsTutorial]] with the following code:(((
42	42	{{code language="js"}}
43	43	require(['deferred!ckeditor'], function(ckeditorPromise) {
...	...	@@ -61,22 +61,8 @@
61	61	Don't forget to set "Use this extension" to "On this wiki".
62	62	)))
63	63
64		-=== Setting Link Targets ===
	68	+See the [[full list of configuration options in the CKEditor documentation>>http://docs.ckeditor.com/#!/api/CKEDITOR.config]].
65	65
66		-If you wish to have a link dialog tab to be able to set link targets (open link in new page, etc) then you should set the ##linkShowTargetTab## config option to ##true##. For example, using the construct defined above you'd use:
67		-
68		-{{code language="js"}}
69		-...
70		- ckeditor.tools.extend(event.editor.config, {
71		- linkShowTargetTab: true
72		- }, true);
73		-...
74		-{{/code}}
75		-
76		-=== Setting other configuration options ===
77		-
78		-See the [[list of configuration options in the CKEditor documentation>>http://docs.ckeditor.com/#!/api/CKEDITOR.config]].
79		-
80	80	== Replace the Default Editor (before XWiki 8.2) ==
81	81
82	82	{{info}}
...	...	@@ -133,7 +133,6 @@
133	133
134	134	The following is not yet supported but we plan to implement in the future:
135	135
136		-* Configure the editor from the administration
137	137	* Import office documents
138	138	* Image preview in the attachment picker
139	139	* Automatically create an attachment link when dropping a file (that is not an image) over the editing area