Wiki source code of Access a wiki
Version 1.1 by Thomas Mortagne on 2011/10/25
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | By default when you connect to your wiki farm you will go to the main wiki. To be able to access other wikis XWiki supports two modes. | ||
| 2 | |||
| 3 | {{toc/}} | ||
| 4 | |||
| 5 | = The domain name based wiki access = | ||
| 6 | |||
| 7 | In virtual mode you can access any wiki by the [[domain name/alias>>http://en.wikipedia.org/wiki/Domain_Name_System]] registered in its descriptor with the field ##server## ("Alias" in the UI). | ||
| 8 | |||
| 9 | For example if the url is http://wikiname.xwiki.org/xwiki/bin/view/Space/Page XWiki will try to find "wikiname.xwiki.org" as a value of field ##server## in the objets of class XWiki.XWikiServerClass. Then it extracts the last part of the page name to get the wiki identifier: in this case it finds XWiki.XWikiServerWikiname and extracts "wikiname" as the wiki identifier to set the database to query on. | ||
| 10 | |||
| 11 | If no descriptor can be found: | ||
| 12 | |||
| 13 | * if the host is an IP (127.0.0.1, 85.65.12.36, etc.) XWiki selects the main wiki | ||
| 14 | * else, if the first part of the host name (what is before the first point) is "www" XWiki selects the main wiki | ||
| 15 | * else, if the first part of the host name match a wiki identifier XWiki selects this wiki | ||
| 16 | |||
| 17 | If after all no wiki has been found, then XWiki redirects to the URL configured in property ##xwiki.virtual.redirect## of xwiki.cfg. | ||
| 18 | |||
| 19 | So to be able to access your wiki you need to : | ||
| 20 | |||
| 21 | * configure your DNS | ||
| 22 | * or modify hosts file in your operating system; see [[Hosts file documentation on Wikipedia>>http://en.wikipedia.org/wiki/Hosts_file]] for details. | ||
| 23 | |||
| 24 | = The URL path based wiki access = | ||
| 25 | |||
| 26 | {{info}} | ||
| 27 | This mode is supported only since XWiki Platform 1.7 and XWiki Enterprise Manager 1.5 and only when enabled. | ||
| 28 | {{/info}} | ||
| 29 | |||
| 30 | By default this mode is disabled. To enable it, go to xwiki.cfg and set ##xwiki.virtual.usepath## to ##1##. | ||
| 31 | |||
| 32 | When this mode is enabled you can access a wiki using an url like: http://host/xwiki/wiki/wikialias/view/Space/Page. | ||
| 33 | The two parts of /wiki/wikialias mean: | ||
| 34 | |||
| 35 | * ##wiki##: this is used by XWiki to identify the URL as a URL path based multiwiki access. You can configure it in xwiki.cfg with the property #xwiki.virtual.usepath.servletpath#. | ||
| 36 | ((( | ||
| 37 | {{warning}}Don't forget to set the ##xwiki.authentication.logoutpage## property accordingly. Change the "wiki" part in the property value for the right alias{{/warning}} | ||
| 38 | ))) | ||
| 39 | * ##wikialias##: this is used by xwiki to find the wiki descriptor | ||
| 40 | ** first it tries to match ##wikialias## with the descriptors | ||
| 41 | ** if it can't find the descriptor this way it tries to match the wiki descriptor using ##wikialias## as the wiki identifier. This means looking whether the XWiki.XWikiServerWikialias document exists and contains an object of class XWiki.XWikiServerClass |
