Wiki source code of Configuration

Version 47.1 by Marius Dumitru Florea on 2009/09/04

Show last authors
1 1 Configuration
2
3 One you have XWiki [installed>Installation] you'll want to configure it. Configuration can be done in 2 ways:
4
5 * by stopping the XWiki instance and editing the <tt>xwiki/WEB-INF/xwiki.cfg</tt> file, and then restarting XWiki
6 * by logging in as a user with admin rights and going to the Administration page (when using the XWiki 1.0 skin, there's a an "Administration" link in the top right corner of the screen - You can also go directly to <tt>http://localhost:8080/xwiki/bin/admin/XWiki/XWikiPreferences</tt>). This allows to keep the Server running while making the changes.
7
8 Note that some configurations are only accessible from the <tt>xwiki.cfg</tt> file and have no equivalent on the Administration page.
9
10 You can verify some basic settings of your XWiki install (on Tomcat, MySQL) using the [check Config and Indexes application>code:Applications.CheckConfigAndIndexesApplication].
11
12 There are various things you can configure:
13
14 #toc("" "" "")
15
16 1.1 Enable superadmin account
17
18 Edit the <tt>xwiki.cfg</tt> file and enable the <tt>xwiki.superadminpassword</tt> property. For example:
19
20 {code:none}
21 # Enable to allow superadmin. It is disabled by default as this could be a security breach if
22 # it were set and you forgot about it.
23 xwiki.superadminpassword=system
24 {code}
25
26 When logging in, the username will be "superadmin" and the password will be the one you set in the <tt>xwiki.superadminpassword</tt> property.
27
28 1.1 Language settings
29
30 To define the default language for your wiki go to the Administration page and in the Preferences tag locate the "Default Language" field and enter the language code for the language you wish to use. For example: "en" for English, "fr" for French, "de" for German, etc.
31
32 In addition you can configure you wiki to be multilingual. See the [I18 user page>Features.I18N] for more information.
33
34 Last, you can also force your wiki to display only in one of the languages specified in the settings, by editing your <tt>WEB-INF/xwiki.cfg</tt> file. Search for the "Internationalization" section, and you should see two commented settings that you can uncomment and set to 1:
35
36 {code:none}
37 #-# By default, XWiki chooses the language specified by the client (browser) in the Accept-Language HTTP header. This
38 #-# allows to use the default language of the wiki when the user didn't manually choose a language.
39 # xwiki.language.preferDefault=0
40
41 #-# Force only one of the supported languages to be accepted.
42 # xwiki.language.forceSupported=0
43 {code}
44
45 1.1 Date format
46
47 To define the date format used in the interfaces, go to ~~Administration~~ / ~~General~~, locate the "Date format" field and enter the date format you wish to use. Examples:
48
49 {table}
50 Format | Result
51 MMMM dd, HH:mm | January 27, 12:27
52 yyyy/MM/dd, HH:mm | 2009/01/27, 12:27
53 dd/MM/yyyy, HH:mm | 27/01/2009, 12:27
54 {table}
55
56 [More information about date formatting>http://java.sun.com/j2se/1.5.0/docs/api/java/text/SimpleDateFormat.html].
57
58
59 1.1 Wiki Access Configuration
60
61 The first thing you will want to do is configure a policy access for your wiki. Depending on what you intend to use your wiki for, you have several options:
62
63 * [Open Wiki>#HOpenWiki]: anyone can edit pages (including non registered users)
64 * [Public Wiki>#HPublicWiki]: only registered users can edit pages but registration is open to anyone. This is the default configuration of the default wiki (the wiki provided as a XAR on the [download page>xwiki:Main.Download]).
65 * [Private Wiki with password>#HPrivateWikiwithpassword]: registration is closed
66 * [Private Wiki with token for registering>#HPrivateWikiwithtoken]: registration is closed but users knowing the token can register
67
68 1.1.1 Open Wiki
69
70 TODO
71
72 1.1.1 Public Wiki
73
74 Nothing to do. This is the default Way.
75 If you want that only people with a verified Email Address can edit pages, you have to set
76 "Use email verification" AND "Check Active fields for user authentication" to "Yes" in Administration/Registration.
77
78 1.1.1 Private Wiki with password
79 1.1.1.1 Global rights
80
81 In [Global rights>http://localhost:8080/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globalrights&global=1] set *User:XWikiGuest, Groups:, Level:register, Allow-Deny:Allow*.
82
83 1.1.1.1 Registration
84
85 In [Preferences>http://localhost:8080/xwiki/bin/admin/XWiki/XWikiPreferences] under *Registration* set *Use email verification:yes*. fill the other fields appropriately.
86
87 1.1.1 Private Wiki with token
88
89 TODO
90
91 * *[Find out more about XWiki access rights here>Access Rights]*
92
93 1.1 Enabling/Disabling Statistics
94
95 To disable [the Statistics feature>code:Applications.StatisticsApplication], edit your ~~xwiki.cfg~~ file and replace the following properties as shown here:
96 {code:xml}
97 xwiki.stats=0
98 xwiki.stats.default=0
99 {code}
100
101 where:
102
103 * ~~xwiki.stats~~ controls whether Statistics are on or off
104 * ~~xwiki.stats.default~~ controls whether Statistics are on or off by default for the current Wiki. This is useful in [Virtual Wiki mode>AdminGuide.Virtualization]. A wiki can decide whether Statistics is on/off by setting the "statistics" field in XWiki.XWikiPreferences. If no such field is defined the the default value ~~xwiki.stats.default~~ is used.
105
106 To enable Statistics, change "0" to "1".
107
108 1.1 Optional Store Features
109
110 XWiki stores all document attachment versions by default. This is very memory consuming (both RAM and HDD).
111 If you need only latest versions of attachments, you can disable attachment version control by editing your ~~xwiki.cfg~~ and adding:
112 {code:xml}
113 xwiki.store.attachment.versioning=0
114 {code}
115
116
117 1.1 Customizing the Skin
118
119 See the [Skin Guide>AdminGuide.Skins].
120
121 1.1 Security configuration
122
123 See the [Security Guide>AdminGuide.Security].
124
125 1.1 Customizing Menus
126
127 The first thing to understand is that menus depend on the skin you're using. If you're using the 1.0 skin it's likely you're using the [Panels Application>code:Applications.PanelsApplication] to provide the different menu panels you see on the left or right of your wikis. Check the [Panels Application>code:Applications.PanelsApplication] to know more on how to configure/modify them.
128
129 1.1 Encoding
130
131 See the [Encoding Guide>AdminGuide.Encoding].
132
133 1.1 User Authentication
134
135 See the [Authentication Guide>AdminGuide.Authentication].
136
137 1.1 Customizing the registration page
138
139 The default registration page is defined as a template on the file system (named <tt>registerinline.vm</tt>). However it's possible to easily override it by creating a page named <tt>XWiki.Registration</tt>.
140
141 See [more details about configuring the registration page>AdminGuide.User Management#HCustomizingtheRegistrationpage].
142 1.1 Logging
143
144 See the [Logging page>Logging].
145
146 1.1 Configuring Interwiki links
147
148 [Interwiki linking>http://en.wikipedia.org/wiki/InterWiki] is a short hand syntax for linking to pages on other websites. For example, you could link to http://en.wikipedia.org/wiki/InterWiki just by typing \[InterWiki@WikiPedia\].
149
150 Since XWiki renders wiki syntax using the [Radeox>http://radeox.org] engine, it supports Interwiki links in [much the same way as SnipSnap>http://snipsnap.org/space/InterWiki+HowTo].
151
152 To configure Interwiki links on your wiki:
153
154 * Create a file named <tt>\[location from where you start your container\]/conf/*intermap.txt*</tt>
155 * Fill <tt>intermap.txt</tt> with content like:
156 {code}
157 IMDB http://us.imdb.com/Title?
158 OpenWiki http://openwiki.com/?
159 SourceForge http://sourceforge.net/
160 TWiki http://twiki.org/cgi-bin/view/
161 Why http://clublet.com/c/c/why?
162 Wiki http://c2.com/cgi/wiki?
163 WikiPedia http://www.wikipedia.com/wiki/
164 {code}
165
166 You can of course add your own entries.
167
168 * Note that Radeox's parser for intermap.txt is [very fragile>http://snipforge.org/jira/browse/RADEOX-49]. A blank line at the bottom of the file is enough to make it fall over.
169 * Restart XWiki (you'll need to restart XWiki every time you change <tt>intermap.txt</tt>) and try out an Interwiki link.
170 * If it does not work, check your <tt>xwiki.log</tt> file. You'll see if <tt>conf/intermap.txt</tt> could not be found, or if there was an error parsing it.
171
172 1.1 Setting the default editor to use (Wiki or WYSIWYG)
173
174 Go the Administration screen, then click on the "General" icon and select the default editor to use, as shown on the following screenshot:
175
176 {image:defaulteditor.png}
177
178 1.1 Configure the WYSIWYG editor
179
180 See [WYSIWYG Editor Configuration>WysiwygEditor] page to find out how you can enable or disable editing features.
181
182 1.1 Short URLs
183
184 It's possible to [configure XWiki so that is uses shorter URLs>Main.ShortURLs].
185
186 1.1 Configure the names of database schemas (since 1.6M1)
187
188 Sometimes, especially in enterprise environment, we need control names of database schemes, other than default.
189
190 * xwiki.db -- name of database scheme of main wiki.
191 * xwiki.db.prefix -- usefull mainly for [virtual wikies>Virtualization], where we have database scheme for each virtual wiki. This prefix is added to database scheme name after usual mapping between wiki names and schemes. Note that this is also applying to main wiki database name.
192
193
194 1.1 Turning off comments or attachments
195
196 You need to change the XWiki.XWikiPreferences class like this:
197
198 * Go to <tt>\<server\>/xwiki/bin/edit/XWiki/XWikiPreferences?editor=class</tt>
199 * Add a new property called <tt>showcomments</tt> (or <tt>showattachments</tt> for turning off attachments) of type String Class
200 * Go to <tt>\<server\>/xwiki/bin/edit/XWiki/XWikiPreferences?editor=object&classname=XWiki.XWikiPreferences</tt> and write no in the <tt>showcomments</tt> (or <tt>showattachments</tt>) field
201
202 That's it, the comments (or attachments) are gone. If you want to re-enable them, replace the "no" value with "yes".
203
204 1.1 Configure edit comment behavior
205
206 When page editing you can add a comment of changes in special comment field by default (Look at [Features.PageEditing#HCommoneditactions]).
207 You can disable this feature by set ~~xwiki.editcomment=0~~ in ~~xwiki.cfg~~.
208
209 When edit comment feature is enabled, you also can set edit comment mandatory by set ~~xwiki.editcomment.mandatory=1~~ in ~~xwiki.cfg~~. This will show popup window with the request to set edit comment if there is no comment entered. It doesn't allow to set empty comment.
210 If you want a popup, but want to be able to set empty edit comment, set ~~xwiki.editcomment.suggested=1~~ in ~~xwiki.cfg~~
211
212 If you set edit comment as mandatory or suggested, you can also remove comment field from page editing form and use only popup window for set edit comment. Set ~~xwiki.editcomment.hidden=0~~ in ~~xwiki.cfg~~ to do this.
213
214 You can use the special fields in ~~XWikiPreferences~~ object instead of edit ~~xwiki.cfg~~.
215 These fields are: ~~editcomment~~, ~~editcomment_mandatory~~, ~~editcomment_suggested~~ and ~~editcomment_hidden~~.
216
217 1.1 Configuring the SMTP server
218
219 If you're planning to use XWiki's feature that send emails you'll need to configure the SMTP server used and the email address under which XWiki will send emails.
220
221 To configure these go to the Administration page (<tt>http://\<server\>/xwiki/bin/admin/XWiki/XWikiPreferences</tt>), click on the "general" icon and modify the <tt>Admin email</tt> field to set the email under which XWiki emails will be sent and modify the <tt>Outgoing SMTP Server</tt> field to set the SMTP server to use, as shown on the figure below.
222
223 {image:emailconfiguration.png}
224
225 1.1.1 Configuring authentication for SMTP
226
227 By default, the username/password fields are not available in the preferences. In order to configure the SMTP authentication, you must:
228
229 - Edit the <tt>XWiki.XWikiPreferences</tt> class (<tt>/xwiki/bin/edit/XWiki/XWikiPreferences?editor=class</tt>) and add two <tt>String</tt> fields, named <tt>smtp_server_username</tt> and <tt>smtp_server_password</tt>.
230 - Edit the <tt>XWiki.XWikiPreferences</tt> object (<tt>/xwiki/bin/edit/XWiki/XWikiPreferences?editor=object&amp;classname=XWiki.XWikiPreferences&amp;nb=0&amp;property=smtp_server_username,smtp_server_password</tt>) and enter the required username and password in the newly added fields.
231
232 1.1.1 Configuring TLS for the connection to the server
233
234 In order to enable TLS, you must:
235 - Edit the <tt>XWiki.XWikiPreferences</tt> class (<tt>/xwiki/bin/edit/XWiki/XWikiPreferences?editor=class</tt>) and add a <tt>TextArea</tt> field, named <tt>javamail_extra_props </tt>.
236 - Edit the <tt>XWiki.XWikiPreferences</tt> object (<tt>/xwiki/bin/edit/XWiki/XWikiPreferences?editor=object&amp;classname=XWiki.XWikiPreferences&amp;nb=0&amp;property=javamail_extra_props</tt>) and enter: <tt>mail.smtp.starttls.enable=true</tt>
237
238 1.1 Configuring WebDAV (since 1.7)
239
240 WebDAV support has been added to XWiki beginning from XWiki Enterprise 1.7. It is very important to note that WebDAV is enabled by default.
241
242 1.1.1 Securing WebDAV Server
243
244 XWiki's WebDAV implementation only supports [Basic Access Authentication>http://en.wikipedia.org/wiki/Basic_access_authentication] scheme for authenticating WebDAV clients. Because of this reason it is highly recommended that you employ a transport level security mechanism like SSL to protect your clients. You may consult your web application container's documentation to see how this can be achieved.
245
246 1.1.1 Disabling WebDAV
247
248 To disable WebDAV support in your XWiki server, simply edit your web.xml file and remove the url-mapping element for mapping webdav requests. The url-mapping element for WebDAV looks something like:
249
250 {code}
251 <servlet-mapping>
252 <servlet-name>webdav</servlet-name>
253 <url-pattern>/webdav/*</url-pattern>
254 </servlet-mapping>
255 {code}
256
257
258
259 1.1 Redirections
260
261 XWiki supports defining redirections for incoming requests. To activate this feature modify your <tt>xwiki.cfg</tt> file and set the following property:
262 {code:none}
263 xwiki.preferences.redirect=1
264 {code}
265
266 Then for each redirection you want to add, add a <tt>XWiki.GlobalRedirect</tt> object to your main wiki's <tt>XWiki.XWikiPreferences</tt> document. The <tt>XWiki.GlobalRedirect</tt> object has 2 fields: <tt>pattern</tt> and <tt>destination</tt>. The URL received is matched on <tt>pattern</tt> and if there's a match it's replaced with the value from <tt>destination</tt>. XWiki then redirects to the new URL.
267
268 1.1 Customizing the PDF export Look & Feel
269
270 #info("In the future we'll want to rewrite the PDF/RTF exports as Renderers in the new [Rendering Module architecture>code:Modules.RenderingModule]. When this happens this section will be upgraded.")
271
272 Here's how the PDF and RTF exports currently work:
273
274 {image:XWikiExport200805192259.png}
275
276 As shown in the diagram you can customize 3 parts:
277 * The CSS used to render the content as PDF/RTF
278 * The XHTML2FO XSL transformation
279 * The FOP XSL transformation
280
281 In order to provide your own customization you need to start by creating a new [XWiki Class>platform:DevGuide.DataModel]. To do that simply create a new page and edit it in Class mode (for ex: <tt>http:/yourserver.com/xwiki/bin/edit/XWiki/PDFClass?editor=class</tt>). Add the following Text Area properties as needed (they are all optional so you only need to define the ones you need to use):
282 * <tt>style</tt>: contains the CSS information that will be overriding the default <tt>pdf.css</tt> values.
283 * <tt>xhtmlxsl</tt>: contains the XHTML to FO XSL overriding the default one.
284 * <tt>fopxsl</tt>: contains the FOP to PDF/RTF XSL overriding the default one.
285
286 Then create a new page (say <tt>XWiki.PDFTemplate</tt>) and add the <tt>XWiki.PDFClass</tt> object to it.
287
288 Last use that page when calling the PDF/RTF export using the <tt>pdftemplate</tt> parameter as in <tt>http://yourserver/xwiki/bin/export/Space/Page?format=pdf&language=en&pdftemplate=XWiki.PDFTemplate</tt>.
289
290 #warning("As mentioned the <tt>style</tt> property stores CSS code. Don't add blank line between the rules. The field is parsed and rendered, so a blank line causes a paragraph to appear there, which breaks the CSS. You must use this... {code}
291 h2 {
292 margin-left: 2cm;
293 margin-bottom: 1cm;
294 color: red;
295 }
296 h3 {
297 margin: 3cm;
298 color: yellow;
299 }
300 {code} And not... {code}
301 h2 {
302 margin-left: 2cm;
303 margin-bottom: 1cm;
304 color: red;
305 }
306
307 h3 {
308 margin: 3cm;
309 color: yellow;
310 }
311 {code}")
312
313 #info("Even though RTF export is expected to work the same way, there are still some isues to be solved affecting how CSS properties control the final layout.")
314
315
316 1.1 Configuring Wiki Syntaxes and default Syntax
317
318 Starting with XWiki Enterprise 1.6 it's possible to configure the [Wiki syntaxes>platform:Main.XWikiSyntax] that are available to the user. To do so edit the *<tt>WEB-INF/xwiki.cfg</tt>* file and configure the <tt>xwiki.rendering.syntaxes</tt> property. It's a comma-separated list of syntax ids. For example:
319
320 {code:none}
321 xwiki.rendering.syntaxes = xwiki/1.0, xwiki/2.0, confluence/1.0, jspwiki/1.0, creole/1.0, mediawiki/1.0, xhtml/1.0, twiki/1.0
322 {code}
323
324 In addition starting with XWiki Enterprise 1.8 it's possible to set the default syntax to be used when creating new documents. To do so edit the *<tt>WEB-INF/xwiki.properties</tt>* file and configure the <tt>core.defaultDocumentSyntax</tt> property. For example to use XWiki Syntax 2.0 by default:
325
326 {code:none}
327 #-# Specifies the default syntax to use when creating new documents.
328 #-# Default value is xwiki/1.0.
329 core.defaultDocumentSyntax = xwiki/2.0
330 {code}
331
332 #warning("Hint: If it doesn't work check that you've edited the correct configuration file.")
333
334 1.1 Sample xwiki.cfg
335
336 {code}
337 xwiki.base=../../
338
339 xwiki.store.class=com.xpn.xwiki.store.XWikiHibernateStore
340 xwiki.store.hibernate.path=/WEB-INF/hibernate.cfg.xml
341 xwiki.store.hibernate.updateschema=1
342 xwiki.store.hibernate.custommapping=1
343 xwiki.store.cache=1
344 xwiki.store.cache.capacity=100
345 xwiki.store.migration=1
346
347 xwiki.monitor=1
348
349 # List of active plugins.
350 xwiki.plugins=\
351 com.xpn.xwiki.monitor.api.MonitorPlugin,\
352 com.xpn.xwiki.plugin.calendar.CalendarPlugin,\
353 com.xpn.xwiki.plugin.skinx.JsSkinExtensionPlugin,\
354 com.xpn.xwiki.plugin.skinx.CssSkinExtensionPlugin,\
355 com.xpn.xwiki.plugin.feed.FeedPlugin,\
356 com.xpn.xwiki.plugin.ldap.LDAPPlugin,\
357 com.xpn.xwiki.plugin.google.GooglePlugin,\
358 com.xpn.xwiki.plugin.flickr.FlickrPlugin,\
359 com.xpn.xwiki.plugin.mail.MailPlugin,\
360 com.xpn.xwiki.plugin.packaging.PackagePlugin,\
361 com.xpn.xwiki.plugin.query.QueryPlugin,\
362 com.xpn.xwiki.plugin.svg.SVGPlugin,\
363 com.xpn.xwiki.plugin.charts.ChartingPlugin,\
364 com.xpn.xwiki.plugin.fileupload.FileUploadPlugin,\
365 com.xpn.xwiki.plugin.image.ImagePlugin,\
366 com.xpn.xwiki.plugin.captcha.CaptchaPlugin,\
367 com.xpn.xwiki.plugin.userdirectory.UserDirectoryPlugin,\
368 com.xpn.xwiki.plugin.usertools.XWikiUserManagementToolsImpl,\
369 com.xpn.xwiki.plugin.zipexplorer.ZipExplorerPlugin,\
370 com.xpn.xwiki.plugin.autotag.AutoTagPlugin,\
371 com.xpn.xwiki.plugin.lucene.LucenePlugin,\
372 com.xpn.xwiki.plugin.diff.DiffPlugin,\
373 com.xpn.xwiki.plugin.rightsmanager.RightsManagerPlugin,\
374 com.xpn.xwiki.plugin.jodatime.JodaTimePlugin,\
375 com.xpn.xwiki.plugin.scheduler.SchedulerPlugin,\
376 com.xpn.xwiki.plugin.mailsender.MailSenderPlugin,\
377 com.xpn.xwiki.plugin.watchlist.WatchListPlugin, \
378 com.xpn.xwiki.wysiwyg.server.plugin.WysiwygPlugin
379
380 # [Since 1.6RC1] Defines the list of supported syntaxes
381 # Available syntaxes are:
382 # xwiki/1.0, xwiki/2.0, confluence/1.0, jspwiki/1.0, creole/1.0,
383 # mediawiki/1.0, xhtml/1.0, twiki/1.0
384 xwiki.rendering.syntaxes = xwiki/1.0, xwiki/2.0, confluence/1.0, jspwiki/1.0, creole/1.0, mediawiki/1.0, xhtml/1.0, twiki/1.0
385
386 # This parameter allows XWiki to operate in Hosting mode allowing to create
387 # multiple wikis having their own database and responding to different URLs
388 xwiki.virtual=0
389
390 xwiki.virtual.redirect=http://127.0.0.1:9080/xwiki/bin/Main/ThisWikiDoesNotExist
391
392 # This parameter will activate the eXo Platform integration
393 xwiki.exo=0
394
395 xwiki.authentication=form
396 xwiki.authentication.validationKey=totototototototototototototototo
397 xwiki.authentication.encryptionKey=titititititititititititititititi
398 xwiki.authentication.cookiedomains=xwiki.com,wiki.fr
399
400 # This allows logout to happen for any page going through the /logout/ action, regardless of the document or the servlet.
401 # Comment-out if you want to enable logout only for /bin/logout/XWiki/XWikiLogout
402 xwiki.authentication.logoutpage=(/[^/]+/|/)logout/*
403
404 # Stats configuration allows to globally activate/deactivate stats module (launch storage thread, register events...)
405 xwiki.stats=1
406 # When statistics are globally enabled, storage can be enabled/disabled by wiki using the XWikiPreference property "statistics".
407 # Note: Statistics are disabled by default for improved performances/space.
408 xwiki.stats.default=0
409 # It is also possible to choose a different stats service to record statistics separately from XWiki.
410 xwiki.stats.class=com.xpn.xwiki.stats.impl.XWikiStatsServiceImpl
411
412 xwiki.encoding=ISO-8859-1
413
414 xwiki.backlinks=1
415
416 xwiki.tags=1
417
418 # Use edit comments
419 xwiki.editcomment=1
420
421 # Hide editcomment field and only use Javascript
422 xwiki.editcomment.hidden=0
423
424 # Make edit comment mandatory
425 xwiki.editcomment.mandatory=0
426
427 # Make edit comment suggested (asks 1 time if the comment is empty.
428 # 1 shows one popup if comment is empty.
429 # 0 means there is no popup.
430 # This setting is ignored if mandatory is set
431 xwiki.editcomment.suggested=0
432
433 # GraphViz plugin configuration. The GraphViz plugin is not configured by default.
434 # To enable it, add "com.xpn.xwiki.plugin.graphviz.GraphVizPlugin" to the list of plugins
435 # in the xwiki.plugins property.
436 # Uncomment and set the locations of the Dot and Neato executables
437 #xwiki.plugin.graphviz.dotpath=c:/Program Files/ATT/GraphViz/bin/dot.exe
438 #xwiki.plugin.graphviz.neatopath=c:/Program Files/ATT/GraphViz/bin/neato.exe
439
440 xwiki.plugin.laszlo.baseurl=/openlaszlo/xwiki/
441 xwiki.plugin.laszlo.path=c:/Program Files/Apache Software Foundation/Tomcat 5.0/webapps/openlaszlo/xwiki/
442
443 xwiki.plugin.image.cache.capacity=30
444
445 xwiki.plugin.captcha=0
446
447
448 # Enable to allow superadmin. It is disabled by default as this could be a security breach if
449 # it were set and you forgot about it.
450 #xwiki.superadminpassword=system
451
452 #-------------------------------------------------------------------------------------
453 # LDAP
454 #-------------------------------------------------------------------------------------
455
456 #-# new LDAP authentication service
457 # xwiki.authentication.authclass=com.xpn.xwiki.user.impl.LDAP.XWikiLDAPAuthServiceImpl
458
459 #-# Turn LDAP authentication on - otherwise only XWiki authentication
460 #-# 0: disable
461 #-# 1: enable
462 # xwiki.authentication.ldap=1
463
464 #-# LDAP Server (Active Directory, eDirectory, OpenLDAP, etc.)
465 xwiki.authentication.ldap.server=127.0.0.1
466 xwiki.authentication.ldap.port=389
467
468 #-# LDAP login, empty = anonymous access, otherwise specify full dn
469 #-# {0} is replaced with the username, {1} with the password
470 xwiki.authentication.ldap.bind_DN=cn={0},department=USER,department=INFORMATIK,department=1230,o=MP
471 xwiki.authentication.ldap.bind_pass={1}
472
473 #-# Force to check password after LDAP connection
474 #-# 0: disable
475 #-# 1: enable
476 xwiki.authentication.ldap.validate_password=0
477
478 #-# only members of the following group will be verified in the LDAP
479 #-# otherwise only users that are found after searching starting from the base_DN
480 # xwiki.authentication.ldap.user_group=cn=developers,ou=groups,o=MegaNova,c=US
481
482 #-# [Since 1.5RC1, XWikiLDAPAuthServiceImpl]
483 #-# only users not member of the following group can autheticate
484 # xwiki.authentication.ldap.exclude_group=cn=admin,ou=groups,o=MegaNova,c=US
485
486 #-# base DN for searches
487 xwiki.authentication.ldap.base_DN=
488
489 #-# Specifies the LDAP attribute containing the identifier to be used as the XWiki name (default=cn)
490 # xwiki.authentication.ldap.UID_attr=cn
491
492 #-# [Since 1.5M1, XWikiLDAPAuthServiceImpl]
493 #-# Specifies the LDAP attribute containing the password to be used "when xwiki.authentication.ldap.validate_password" is set to 1
494 # xwiki.authentication.ldap.password_field=userPassword
495
496 #-# [Since 1.5M1, XWikiLDAPAuthServiceImpl]
497 #-# The potential LDAP groups classes. Separated by commas.
498 # xwiki.authentication.ldap.group_classes=group,groupOfNames,groupOfUniqueNames,dynamicGroup,dynamicGroupAux,groupWiseDistributionList
499
500 #-# [Since 1.5M1, XWikiLDAPAuthServiceImpl]
501 #-# The potential names of the LDAP groups fields containings the members. Separated by commas.
502 # xwiki.authentication.ldap.group_memberfields=member,uniqueMember
503
504 #-# retrieve the following fields from LDAP and store them in the XWiki user object (xwiki-attribute=ldap-attribute)
505 #-# ldap_dn=dn -- dn is set by class, caches dn in XWiki.user object for faster access
506 xwiki.authentication.ldap.fields_mapping=last_name=sn,first_name=givenName,fullname=fullName,email=mail,ldap_dn=dn
507
508 #-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]
509 #-# on every login update the mapped attributes from LDAP to XWiki otherwise this happens only once when the XWiki account is created.
510 xwiki.authentication.ldap.update_user=1
511
512 #-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]
513 #-# mapps XWiki groups to LDAP groups, separator is "|"
514 # xwiki.authentication.ldap.group_mapping=XWiki.XWikiAdminGroup=cn=AdminRole,ou=groups,o=MegaNova,c=US|\
515 # XWiki.Organisation=cn=testers,ou=groups,o=MegaNova,c=US
516
517 #-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]
518 #-# time in s after which the list of members in a group is refreshed from LDAP (default=3600*6)
519 # xwiki.authentication.ldap.groupcache_expiration=21800
520
521 #-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]
522 #-# - create : synchronize group membership only when the user is first created
523 #-# - always: synchronize on every login
524 # xwiki.authentication.ldap.mode_group_sync=always
525
526 #-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]
527 #-# if ldap authentication fails for any reason, try XWiki DB authentication with the same credentials
528 xwiki.authentication.ldap.trylocal=1
529
530 #-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]
531 #-# SSL connection to LDAP server
532 #-# 0: normal
533 #-# 1: SSL
534 # xwiki.authentication.ldap.ssl=0
535
536 #-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]
537 #-# The keystore file to use in SSL connection
538 # xwiki.authentication.ldap.ssl.keystore=
539
540 #-# [Since 1.5M1, XWikiLDAPAuthServiceImpl]
541 #-# The java secure provider used in SSL connection
542 # xwiki.authentication.ldap.ssl.secure_provider=com.sun.net.ssl.internal.ssl.Provider
543
544 #-------------------------------------------------------------------------------------
545 # Cache
546 #-------------------------------------------------------------------------------------
547
548 #-# [Since 1.5M2]
549 #-# The cache component implementation to use as "normal" (can be local or distributed depending on the implementation)
550 #-# cache component.
551 # xwiki.cache.cachefactory.hint=jbosscache
552
553 #-# [Since 1.5M2]
554 #-# The cache component to use as local cache component.
555 # xwiki.cache.cachefactory.local.hint=jbosscache/local
556
557 #-------------------------------------------------------------------------------------
558
559
560 xwiki.authentication.unauthorized_code=200
561
562 # This parameter will activate the sectional editing
563 xwiki.section.edit=1
564
565 # Uncomment if you want to ignore requests for unmapped actions, and simply display the document
566 # xwiki.unknownActionResponse=view
567
568
569 # You can configure the toolbars you wish to see in the WYSIWYG editor by defining the
570 # xwiki.wysiwyg.toolbars property.
571 # When not defined it defaults to:
572 # xwiki.wysiwyg.toolbars=texttoolbar, listtoolbar, indenttoolbar, undotoolbar, titletoolbar, \
573 # styletoolbar, horizontaltoolbar, attachmenttoolbar, macrostoolbar, \
574 # tabletoolbar, tablerowtoolbar, tablecoltoolbar, linktoolbar
575 # The full list of toolbars includes the one defined above and the following ones:
576 # subtoolbar, findtoolbar, symboltoolbar
577
578
579 xwiki.defaultskin=toucan
580 xwiki.defaultbaseskin=albatross
581
582 # Calendar Prev/Next Month bounds.
583 # The calendar generates links to the previous/next months for a limited range, by default 6 months back and 12 months after.
584 # A value of 0 means that there is no limit in that direction.
585 # xwiki.calendar.bound.prev=6
586 # xwiki.calendar.bound.next=12
587
588 # xwiki.temp.dir=/tmp/xwiki
589 # xwiki.work.dir=/usr/local/xwiki
590
591 # xwiki.plugins.lucene.indexdir=/usr/local/xwiki/lucene
592 # xwiki.plugins.lucene.analyzer=org.apache.lucene.analysis.standard.StandardAnalyzer
593 # xwiki.plugins.lucene.indexinterval=20
594
595 #-# [Since 1.6M1]
596 #-# Force the database name for the main wiki in virtual mode and for the wiki itself in non virtual mode
597 # xwiki.db=xwiki
598
599 #-# [Since 1.6M1]
600 #-# Add a prefix to all databases names of the wikis in virtual mode and to the wiki name in non virtual mode
601 # xwiki.db.prefix=
602
603 xwiki.work.dir=work
604 {code}

Get Connected