1
|
/**
|
2
|
* @module ckeditor
|
3
|
* @version see info.php of this module
|
4
|
* @authors Michael Tenschert, Dietrich Roland Pehlke, Dietmar Woellbrink
|
5
|
* @copyright 2010-2012 Michael Tenschert, Dietrich Roland Pehlke, Luisehahne
|
6
|
* @license GNU General Public License
|
7
|
* @license terms see info.php of this module
|
8
|
* @platform see info.php of this module
|
9
|
* @requirements PHP 5.2.x and higher
|
10
|
*/
|
11
|
|
12
|
################################################
|
13
|
|
14
|
--- WebsiteBaker CKEditor module ---
|
15
|
--- FAQ: How to use customization ---
|
16
|
|
17
|
################################################
|
18
|
################################################
|
19
|
|
20
|
|
21
|
# Question: #
|
22
|
|
23
|
What files are there to customize CKEditor for WebsiteBaker?
|
24
|
|
25
|
# Answer: #
|
26
|
|
27
|
All default files in CKEditor modules are in the folder: _yourwbinstallation_/modules/ckeditor/wb_config
|
28
|
|
29
|
There are four different files. Please look inside each file with your FTP-Browser / AddonFileEditor / on your local computer:
|
30
|
|
31
|
+ wb_ckconfig.js: Here are most of the configuration issues defined.
|
32
|
Toolbar-Configuration, behavior on Enter / Shift+Enter, default language and so on.
|
33
|
|
34
|
+ editor.css: The default look of the WYSIWYG textarea and the preview.
|
35
|
You can also put an editor.css in any frontend template,
|
36
|
it will be loaded automatically for each page instead of the default one.
|
37
|
|
38
|
+ editor.styles.js: The default styles you can choose from a dropdown in the CKEditor toolbar.
|
39
|
You can also put an editor.styles.js in any frontend template,
|
40
|
it will be loaded automatically for each page instead of the default one.
|
41
|
|
42
|
+ editor.templates.js: The default CKE templates you can choose of a button in CKEditor toolbar.
|
43
|
Please note: We recommend not to use CKE templates, because the WebsiteBaker template
|
44
|
should define the different blocks and the template.
|
45
|
|
46
|
Furthermore this files and some other configurations (we recommend you shouldn't change unless you really know what you are doing) are stored in:
|
47
|
_yourwbinstallation_/modules/ckeditor/include.php
|
48
|
|
49
|
|
50
|
################################################
|
51
|
|
52
|
|
53
|
# Question: #
|
54
|
|
55
|
Why back to the roots and not different folders anymore?
|
56
|
|
57
|
# Answer: #
|
58
|
|
59
|
All four configuration files (wb_ckconfig.js, editor.css, editor.styles.js, editor.templates.js) are available in
|
60
|
_yourwbinstallation_/modules/ckeditor/wb_config
|
61
|
|
62
|
The wb_config is loaded and recognized by the CKEditor module unless you copy the folder "wb_config."!
|
63
|
|
64
|
As an example you have two possibilities to call the configuration files
|
65
|
|
66
|
1) copy the wb_config to the folder _yourwbinstallation_/templates and all changes in config files are for all templates
|
67
|
2) copy the wb_config to your _yourdefaulttemplate_: _yourwbinstallation_/templates/_yourdefaulttemplate_
|
68
|
rename folder wb_config to editor, your changes are only for _yourdefaulttemplate_
|
69
|
|
70
|
Change the configfiles with your FTP-Browser / AddonFileEditor / ...
|
71
|
|
72
|
You should never change the files in _yourwbinstallation_/modules/ckeditor/wb_config, as they are overwritten with any update of CKEditor module and / or WebsiteBaker!
|
73
|
You never have any problems when upgrading CKEditor module to another version.
|
74
|
|
75
|
|
76
|
################################################
|
77
|
|
78
|
|
79
|
# Question: #
|
80
|
|
81
|
How is the workflow of reading CKEditor files?
|
82
|
|
83
|
# Answer: #
|
84
|
|
85
|
Note: The workflow is defined inside _yourwbinstallation_/modules/ckeditor/include.php
|
86
|
|
87
|
1) is called as first if available, 2) is the next one, and so on.
|
88
|
|
89
|
search order for CKEditor files
|
90
|
|
91
|
editor.css
|
92
|
|
93
|
1) _yourwbinstallation_/templates/_yourdefaulttemplate_/editor.css
|
94
|
2) _yourwbinstallation_/templates/_yourdefaulttemplate_/css/editor.css
|
95
|
3) _yourwbinstallation_/templates/_yourdefaulttemplate_/editor/editor.css
|
96
|
4) _yourwbinstallation_/templates/wb_config/editor.css
|
97
|
5) _yourwbinstallation_/modules/ckeditor/wb_config/editor.css
|
98
|
|
99
|
wb_ckconfig.js,editor.styles.js,editor.templates.js
|
100
|
|
101
|
1) _yourwbinstallation_/templates/_yourdefaulttemplate_/wb_ckconfig.js
|
102
|
2) _yourwbinstallation_/templates/_yourdefaulttemplate_/js/wb_ckconfig.js
|
103
|
3) _yourwbinstallation_/templates/_yourdefaulttemplate_/editor/wb_ckconfig.js
|
104
|
4) _yourwbinstallation_/templates/wb_config/wb_ckconfig.js
|
105
|
5) _yourwbinstallation_/modules/ckeditor/wb_config/wb_ckconfig.js
|
106
|
|
107
|
etc...
|
108
|
|