Wiki source code of Standard URL Format

Last modified by Anca Luca on 2023/11/10

Hide last authors
Manuel Smeria 50.2 1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
Thomas Mortagne 1.1 4
Vincent Massol 57.2 5 The general format of XWiki URLs is {{code language="none"}}<protocol>://<server>/<context path>/<type>/<path>{{/code}}, where:
Vincent Massol 56.2 6
Thomas Mortagne 90.1 7 * ##<protocol>##: by default it's ##http##. It's possible to use ##https##. It's generally deduced from the URL used by the client but it's possible to control it using [[the wiki descriptor>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Wiki+Application#HConfigureWiki]]
Simon Urli 110.2 8 * ##<server>##: the XWiki instance address and port, e.g. ##localhost:8080##, ##xwiki.org##. In domain-mode the server also contains the subwiki name. See [[Accessing a wiki>>xwiki:Documentation.AdminGuide.AccessWiki]]. In path-based mode, the server is the address of the main wiki. Since 10.7 it's possible to customize the port to use in the [[the wiki descriptor>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Wiki+Application#HConfigureWiki]].
9 * ##<context path>##: the name under which the XWiki web application is deployed in your Servlet Container, e.g. ##xwiki##. See [[Short URLs>>xwiki:Documentation.AdminGuide.ShortURLs#HI.Applicationname]] if you wish to deploy XWiki as ROOT.
Vincent Massol 56.2 10 * ##<type>##: the type of URL depending on the XWiki subsystem accessed. The following types are supported:
Vincent Massol 56.5 11 ** ##bin##: points to a dynamic resource. Examples: an Entity to display (wiki, page, space, attachment, object, property, etc), a dynamic skin resource (image, css, js), a dynamic template resource (image, js, css, icon, etc) and more. By dynamic we mean that some computation needs to happen to compute the resource (for example some Velocity needs to be evaluated).
Simon Urli 110.2 12 ** ##wiki##: this is similar to ##bin## but specifying the subwiki to access, in path-based mode (See [[Accessing a wiki>>xwiki:Documentation.AdminGuide.AccessWiki]]).
13 ** ##rest##: points to a [[REST Resource>>xwiki:Documentation.UserGuide.Features.XWikiRESTfulAPI]]
Vincent Massol 57.4 14 ** ##skins##: points to a static filesystem skin resource (image, js, css, etc), i.e. a resource located inside a skin directory on the filesystem.
15 ** ##resources##: points to a static template resource (image, js, css, etc) on the filesystem.
Vincent Massol 75.3 16 ** ##xmlrpc##: points to the now deprecated XMLRPC API (see [[extensions:Extension.XML-RPC Integration]] for more details).
Simon Urli 110.2 17 ** ##webdav##: points to a WebDAV resource (see [[Web DAV>>xwiki:Documentation.UserGuide.Features.WebDAV]] for more details).
Vincent Massol 56.2 18 * ##<path>##: the path completely depends on the ##<type>## used. See below for more details.
19
Vincent Massol 56.10 20 {{info}}
Marius Dumitru Florea 89.1 21 If you're interested in configuring the XWiki URLs, check the [[URL Architecture page>>Documentation.DevGuide.Architecture.URL Architecture.WebHome]].
Vincent Massol 56.10 22 {{/info}}
23
Vincent Massol 56.9 24 = Type: ##bin## =
Vincent Massol 56.2 25
Eduard Moraru 64.2 26 {{info}}
27 XWiki 7.2: Added support for Nested Spaces
28 {{/info}}
Vincent Massol 62.1 29
Thomas Mortagne 102.1 30 There are various ##bin## URLs. The generic format of ##bin## URLs is ##bin/<action>/<path>##.
31 There is two ways to inject actions:
Vincent Massol 56.2 32
Mohammad Humayun Khan 107.1 33 * by implementing an [[Entity Resource Reference Handler>>extensions:Extension.Resource API#HAddinganewEntityResourceTypeHandler]]
Thomas Mortagne 102.1 34 * {{warning}}deprecated{{/warning}} implementing a ##com.xpn.xwiki.internal.web.LegacyAction## since 13.0 or before 13.0 by listing a Struts action in the Strut Configuration file (located in ##WEB-INF/struts-config.xml##).
35
Vincent Massol 56.5 36 Here are some well-known actions:
Eduard Moraru 57.7 37
Simon Urli 110.2 38 * [[##skin##>>#HAction:skin]]: Dynamic Skin resource, e.g. ##http:~/~/<server>/xwiki/bin/skin/resources/uicomponents/search/searchSuggest.css##
39 * ##jsx##: [[Javascript Skin Extension>>xwiki:Documentation.DevGuide.Tutorials.SkinExtensionsTutorial]] URL, e.g. ##http:~/~/<server>/xwiki/bin/jsx/AnnotationCode/Settings?language=en##
40 * ##ssx##: [[StyleSheet Skin Extension>>xwiki:Documentation.DevGuide.Tutorials.SkinExtensionsTutorial]] URL, e.g. ##http:~/~/<server>/xwiki/bin/ssx/AnnotationCode/Style?language=en##
41 * [[##download##>>#HAction:download]]: URL to access an attachment from a wiki page, e.g. ##http:~/~/<server>/xwiki/bin/download/XWiki/JohnDoe/john.png?width=30&height=30&keepAspectRatio=true##
42 * [[##view##>>#HAction:view]]: Display Entity content (wiki, page, space, attachment, object, property, etc) with the skin applied, e.g. ##http:~/~/<server>/xwiki/bin/view/Sandbox/WebHome##
Mathieu Pace 111.1 43 * [[##edit##>>#HAction:edit]]: Edits wiki content (page, object, property, etc), e.g. ##http:~/~/<server>/xwiki/bin/edit/Sandbox/WebHome##
Simon Urli 110.2 44 * [[##get##>>#HAction:get]]: Accessing Entity content (wiki, page, space, attachment, object, property, etc) without any skin applied, e.g. ##http:~/~/<server>/xwiki/bin/get/Main/WebHome?xpage=xpart&vm=commentsinline.vm##. The ##get## action should be used to render the content of the page and nothing else (mainly used for code pages). This action is similar to the ##view## action, but without the UI and with "text/plain" mime type set by default for the response.
45 * ##export##: Exports wiki pages to various formats (PDF, HTML, etc). See [[xwiki:Documentation.UserGuide.Features.Exports]].
46 * [[##create##>>#HAction:create]]: Provides the UI for creating new documents, e.g. ##http:~/~/<server>/xwiki/bin/create/Space/NewDocument##
47 * [[##objectadd##>>#HAction:objectadd]]: Adds an XObject, e.g. ##http:~/~/<server>/xwiki/bin/objectadd/Space/Page?classname=Some.XClass##
Vincent Massol 56.5 48
Vincent Massol 56.9 49 == Action: ##view## ==
Vincent Massol 56.7 50
Vincent Massol 62.1 51 The additional URL paths for the ##view## action is ##<space1>/.../<spaceN>/<page>?<query string>## or ##<space1>/.../<spaceN>?<query string>##
Vincent Massol 56.7 52
53 Examples:
Eduard Moraru 57.7 54
Vincent Massol 57.6 55 * ##http:~/~/<server>/xwiki/bin/view/Sandbox/WebHome##: Views the ##Sandbox.WebHome## page.
Vincent Massol 62.1 56 * ##http:~/~/<server>/xwiki/bin/view/Sandbox##: Views the ##Sandbox.WebHome## page.
Eduard Moraru 86.1 57 * ##http:~/~/<server>/xwiki/bin/view/Space1/Space2##: Views the ##Space1.Space2.WebHome## page (if the ##Space2## page doesn't exist. If it exists then it views the ##Space1.Space2## page).
58 * ##http:~/~/<server>/xwiki/bin/view/Space1/Space2/##: Force to always views the ##Space1.Space2.WebHome## page (even if the ##Space2## page exists in the ##Space1## space. Note the ##/## at the end).
Eduard Moraru 86.2 59 * ##http:~/~/<server>/xwiki/bin/view/Space1/Space2?spaceRedirect=false##: Force to always view the ##Space1.Space2## terminal page (even if the ##Space1.Space2.WebHome## page exists and even if the ##Space1.Space2## page may not exist).
Vincent Massol 56.7 60
Vincent Massol 56.8 61 Here are some of the supported query string parameters.
Vincent Massol 56.2 62
Vincent Massol 56.9 63 === Parameter: ##xpage## ===
Vincent Massol 56.2 64
Vincent Massol 77.1 65 * ##plain##: this value indicates that only the content of the page is printed (no UI). With a document that's not using the XWiki Syntax 1.0 you can control the output syntax using ##outputSyntax## and ##outputSyntaxVersion##. You can also pass other parameters to allow fine-grained control:
Vincent Massol 50.1 66 ** ##raw=1##: Returns the page source as is without any formatting but XML-escaped
67 ** ##raw=2##: Returns the page source as is without any formatting (without any escaping)
Guillaume Delhumeau 55.1 68 ** ##htmlHeaderAndFooter=true##: {{info}}Since 6.3RC1{{/info}} Display the HTML headers (##<html>##,##<head>##,##<body>##, etc...) and footers (##</body>##, ##</html>##, etc...).
Vincent Massol 77.1 69 ** ##outputTitle##: {{info}}Since 7.3M2{{/info}} If ##true## then also display the title in addition to the content. Defaults to ##false## if not specified.
Vincent Massol 50.1 70 * ##xml##: print the exported form of a document. This is what you can find in the xar for each document.
Vincent Massol 51.1 71 * ##rev##: when specified, redirects to the ##viewrev## action (see below)
Guillaume Delhumeau 74.1 72 * ##children##: {{info}}Since 7.2M3{{/info}} display a page that lists all the children of the document. You can also add the following parameters:
Guillaume Delhumeau 71.1 73 ** ##hierarchy=parentchild##: do the same but display the children according to the (old) parent/child mechanism
Guillaume Delhumeau 74.1 74 ** ##displayHidden=true##: display the hidden documents (no matter what the user's configuration is)
75 * ##backlinks##: {{info}}Since 7.2M3{{/info}} display a page that lists all the documents having a link to the current document. You can also add the following parameters:
76 ** ##displayHidden=true##: display the hidden documents (no matter what the user's configuration is)
Guillaume Delhumeau 75.1 77 * ##siblings##: {{info}}Since 7.2RC1{{/info}} display a page that lists all the children of the parent of the document. You can also add the following parameter:
78 ** ##displayHidden=true##: display the hidden documents (no matter what the user's configuration is)
Guillaume Delhumeau 78.1 79 * ##hierarchy_reference##: {{info}}Since 7.3M2{{/info}} display the hierarchy of the page, as raw HTML, without any style. You can also add the following parameters:
Guillaume Delhumeau 76.1 80 ** ##id=someId##: add an HTML id to the hierarchy breadcrumb.
Guillaume Delhumeau 78.1 81 ** ##displayTitle=true|false##: display the title of the elements in the breadcrumb (default: true)
Guillaume Delhumeau 80.1 82 ** ##excludeSelf=true|false##: display the hierarchy without the page itself (default: false)
83 ** ##limit=##: maximum number of hierarchy elements displayed (default: none)
84 ** ##local=true|false##: do not display the main wiki reference for documents located in sub-wikis. (default: false)
Thomas Mortagne 44.1 85
Vincent Massol 56.9 86 === Parameter: ##outputSyntax## and ##outputSyntaxVersion## ===
Thomas Mortagne 44.1 87
Vincent Massol 56.8 88 With a document that's not using the XWiki 1.0 syntax it's possible to explicitly indicate the renderer to use for the page content. For example with ##outputSyntax=plain## you will get the result in plain text. ##outputSyntaxVersion## is an optional parameter, if it's not provided XWiki will search for the last version of the renderer for the given ##outputSyntax## syntax name. Note that ##outputSyntax## controls only the document content output syntax. If you only want the document content you can use ##xpage=plain##.
Thomas Mortagne 48.1 89
Manuel Smeria 50.2 90 See [[extensions:Extension.Rendering Module]] for more details on renderers.
Thomas Mortagne 45.1 91
Guillaume Delhumeau 70.1 92 === Parameter: ##viewer## ===
93
Guillaume Delhumeau 72.1 94 Note: if the document does not exist, you will have a 404 error page, and the following parameters will not be taken into account. Use ##xpage## if you need to have the desired behavior even if the document does not exist.
Guillaume Delhumeau 71.1 95
Vincent Massol 89.2 96 * ##attachments##: Display the attachment list (e.g. ##http:~/~/playground.xwiki.org/xwiki/bin/view/Sandbox/?viewer=attachments##)
97 * ##history##: Display the version history (e.g. ##http:~/~/playground.xwiki.org/xwiki/bin/view/Sandbox/?viewer=history##)
98 * ##comments##: Display the comments (e.g. ##http:~/~/playground.xwiki.org/xwiki/bin/view/Sandbox/?viewer=comments##)
99 * ##information##: Display the page information (e.g. ##http:~/~/playground.xwiki.org/xwiki/bin/view/Sandbox/?viewer=information##)
Guillaume Delhumeau 74.1 100 * ##children##: {{info}}Since 7.2RC1{{/info}} display a page that lists all the children of the document. You can also add the following parameters:
Guillaume Delhumeau 70.1 101 ** ##hierarchy=parentchild##: do the same but display the children according to the (old) parent/child mechanism
Guillaume Delhumeau 74.1 102 ** ##displayHidden=true##: display the hidden documents (no matter what the user's configuration is)
103 * ##backlinks##: {{info}}Since 7.2RC1{{/info}} display a page that lists all the documents having a link to the current document. You can also add the following parameter:
104 ** ##displayHidden=true##: display the hidden documents (no matter what the user's configuration is)
Guillaume Delhumeau 75.1 105 * ##siblings##: {{info}}Since 7.2RC1{{/info}} display a page that lists all the children of the parent of the document. You can also add the following parameter:
106 ** ##displayHidden=true##: display the hidden documents (no matter what the user's configuration is)
Guillaume Delhumeau 70.1 107
Eduard Moraru 86.1 108 === Parameter: ##spaceRedirect## ===
109
110 Accepted values:
Vincent Massol 88.1 111
Eduard Moraru 86.1 112 * ##true## (default): By default, an URL not ending in ##/## resolves to a non-terminal page, unless the equivalent terminal page already exists.
113 * ##false##: An URL not ending in ##/## will always resolve to a terminal page.
114
115 Not applicable (i.e. no effect) for top-level pages and URLs ending in ##/##.
116
117 Examples:
Vincent Massol 88.1 118
Eduard Moraru 86.1 119 * ##http:~/~/<server>/xwiki/bin/view/Space1/Space2[?spaceRedirect=true]##: Views the ##Space1.Space2.WebHome## page (if the ##Space2## page doesn't exist. If it exists then it views the ##Space1.Space2## page).
Eduard Moraru 86.2 120 * ##http:~/~/<server>/xwiki/bin/view/Space1/Space2?spaceRedirect=false##: Force to always view the ##Space1.Space2## terminal page (even if the ##Space1.Space2.WebHome## page exists and even if the ##Space1.Space2## page may not exist).
Eduard Moraru 86.1 121 * ##http:~/~/<server>/xwiki/bin/view/Space1[?spaceRedirect=false|?spaceRedirect=true|/]##: Will always view the ##Space1.WebHome## non-terminal page because it is a top level page and we can never have a top-level terminal page.
122
Simon Urli 92.1 123 === Parameter: ##restricted## ===
124
Thomas Mortagne 102.1 125 {{info}}
126 Since 11.5RC1
127 {{/info}}
Simon Urli 94.1 128
Simon Urli 92.1 129 Accepted values:
Simon Urli 93.1 130
Simon Urli 92.1 131 * ##false## (default): the macro transformations are normally executed
132 * ##true##: macro transformations are executed in degraded mode or not executed at all, depending on the macro implementation.
133
Simon Urli 93.1 134 In particular, various scripting macro such as [[Velocity Macro>>extensions:Extension.Velocity Macro]] or [[Groovy Macro>>extensions:Extension.Groovy Macro]] are not executed in restricted mode.
Simon Urli 92.1 135 This parameter might be then use to check if a page is well displayed for user who cannot execute those scripts for example.
136
Thomas Mortagne 98.1 137 === Parameter: ##rev## ===
138
Thomas Mortagne 102.1 139 {{info}}
140 Since 13.0.
141 {{/info}}
Thomas Mortagne 98.1 142
143 The version to get, e.g. ##2.3## in ##http:~/~/<server>/xwiki/bin/viewrev/MySpace/MyPage?rev=2.3##
144
Vincent Massol 105.1 145 === Parameter: ##transformations## ===
146
147 {{version since="12.10.4,13.1RC1"}}
148 Allows controlling precisely which Rendering Transformations to execute.
149
150 For example to only execute the Macro transformation: ##http:~/~/localhost:8080/xwiki/bin/view/Sandbox/WebHome?transformations=macro##
151 {{/version}}
152
Marius Dumitru Florea 106.1 153 === Special Anchors ===
154
155 When viewing a wiki page you can also specify an anchor ([[fragment identifier>>https://en.wikipedia.org/wiki/URI_fragment]]) in the URL to trigger some browser or JavaScript behavior. Here's a list of known anchors for view action:
156
157 * ##Hxxx##: anchors that start with ##H## are normally used to scroll the page to the specified heading (section of the page content)
Mohammad Humayun Khan 107.1 158 * ##edit##: triggers the [[in-place editor>>Documentation.UserGuide.Features.PageEditing#HIn-placeeditingmode]] on page load, if in-place editing is enabled
Marius Dumitru Florea 106.1 159 * ##translate##: triggers the in-place editor for a missing page translation; the wiki needs to be multilingual and in-place editing enabled
160
Vincent Massol 56.9 161 == Action: ##viewrev## ==
Thomas Mortagne 45.1 162
Vincent Massol 56.9 163 === Parameter: ##rev## ===
Silvia Macovei 49.1 164
Thomas Mortagne 102.1 165 {{warning}}
166 Deprecated since 13.0. Use ##view## action instead.
167 {{/warning}}
Silvia Macovei 49.1 168
Thomas Mortagne 98.1 169 The version to get, e.g. ##2.3## in ##http:~/~/<server>/xwiki/bin/viewrev/MySpace/MyPage?rev=2.3##
170
Jean SIMARD 56.11 171 == Action: ##save## ==
172
173 The additional URL paths for the ##save## action is ##<space>/<page>?<query string>##.
174
175 Examples:
Eduard Moraru 57.7 176
Vincent Massol 57.6 177 * ##http:~/~/<server>/xwiki/bin/save/Sandbox/WebHome##: Save the ##Sandbox.WebHome## page.
Jean SIMARD 56.11 178
179 Here are some of the supported query string parameters.
180
181 === Parameter: ##creator## ===
Eduard Moraru 57.7 182
Jean SIMARD 56.11 183 Change the creator of the current page. Should be a string as a Document Reference like ##JohnDoe##, ##XWiki.JohnDoe## or ##xwiki:XWiki.JohnDoe## which is a page containing an ##XWiki.Users## object.
184
185 === Parameter: ##language## ===
Eduard Moraru 57.7 186
Simon Urli 110.2 187 Will target a specific language. You must use a specific 2-letters code (see [[I18N>>xwiki:Documentation.UserGuide.Features.I18N]]).
Jean SIMARD 56.11 188
Jean SIMARD 56.12 189 === Parameter: ##objectPolicy## ===
Eduard Moraru 57.7 190
Simon Urli 110.2 191 {{info}}Since 7.1M1{{/info}} The ##objectPolicy## parameter is a request configuration parameter that will decide how to handle custom query string parameters (see [[Custom Parameters>>#HCustomParameters]]):
Jean SIMARD 56.12 192
Eduard Moraru 57.7 193 * ##update##
194 ** Each custom parameter will update a property in an existing object of the current page.
195 ** If the custom parameter refers to a property or an object that don't exist, it will simply ignore it.
196 * ##updateOrCreate##
197 ** Each custom parameter will update a property in an existing object of the current page.
198 ** If the custom parameter refers to a property that doesn't exist, it will ignore it.
199 ** If the custom parameter refers to an object that doesn't exist, it will create it (and pad will ##null## objects if needed).(((
200 //Example//: If there is already 2 objects ##XWiki.XWikiRights## in the page, ##XWiki.XWikiRights_0_levels## and ##XWiki.XWikiRights_1_levels## will update these existing objects. ##XWiki.XWikiRights_2_levels## and ##XWiki.XWikiRights_3_levels## will create 2 new objects. ##XWiki.XWikiRights_42_levels## will be created and 37 empty objects too (42 minus the 4 already existing and minus the 42th which will be created).
201 //Note//: All this information about empty/null objects is currently an implementation detail of how we currently handle object numbers and it may be subject to future change so, as much as possible, do not rely on it and, instead, use the public available APIs to handle these things.
202 )))
203
Simon Urli 97.1 204 === Parameter: ##addedObjects## ===
205
206 {{info}}Since XWiki 12.4RC1{{/info}} The ##addedObjects## parameter allows to create new xobjects in a document without having to specify the value of its properties contrary to ##updateOrCreate## ##objectPolicy##. It can be useful in particular to create xobjects that don't have any property values (special xclass AppWithinMinutes.Content for example). The value of this parameter is an array of xobjects name on the form ##xclass_xobjectNumber##: for example, ##XWiki.XWikiRights_2##.
207
208 === Parameter: ##deletedObjects## ===
209
210 {{info}}Since XWiki 12.4RC1{{/info}} The ##deletedObjects## parameter allows to delete xobjects in a document while saving. The value of this parameter is an array of xobjects name on the form ##xclass_xobjectNumber##: for example, ##XWiki.XWikiRights_2##.
211
Jean SIMARD 56.11 212 === Parameter: ##parent## ===
Eduard Moraru 57.7 213
Jean SIMARD 56.11 214 Allows you to set the parent of the page. Should be a string as a Document Reference like ##WebHome##, ##Main.WebHome## or ##xwiki:Main.WebHome##.
215
216 === Parameter: ##syntaxId## ===
Eduard Moraru 57.7 217
Jean SIMARD 56.11 218 Specify which syntax is used for the content of the current page (see [[Supported syntaxes>>http://rendering.xwiki.org/xwiki/bin/view/Main/#HSupportedSyntaxes]]).
219
220 === Parameter: ##template## ===
Eduard Moraru 57.7 221
Jean SIMARD 56.11 222 Allows you to have a specific template to apply for the current page. Should be a string as a Document Reference like ##MyTemplate##, ##Main.MyTemplate## or ##xwiki:Main.MyTemplate##.
223
224 === Parameter: ##title## ===
Eduard Moraru 57.7 225
Jean SIMARD 56.11 226 Allows you to modify the title of the page.
227
Mathieu Pace 111.1 228 === Parameter: ##form_token## ===
229
Mathieu Pace 113.1 230 A mandatory anti-CSRF token string which can be provided by the [[CSRF API>>extensions:Extension.XWiki Platform - CSRF.WebHome]].
Mathieu Pace 111.1 231
Jean SIMARD 56.14 232 === Custom Parameters ===
Eduard Moraru 57.7 233
Jean SIMARD 56.14 234 Custom parameters have the format ##<Space>.<ClassPage>_<number>_<propertyname>## (e.g. ##XWiki.XWikiUsers_0_password## or ##XWiki.WatchListClass_3_interval##):
Eduard Moraru 57.7 235
Jean SIMARD 56.14 236 * ##<Space>## must refer to an existing space of the wiki
237 * ##<ClassPage>## must refer to a class
238 * ##<number>## is a positive number
239 * ##<propertyname>## is a name of a property of the class ##<Space>.<ClassPage>##
240
Mathieu Pace 111.1 241 == Action: ##edit## ==
242
243 === Parameter: ##editor## ===
244
Anca Luca 115.1 245 The type of editor to be used on the page:
Mathieu Pace 111.1 246
247 * ##inline##: to edit as an inline form
248 * ##class##: to open the class editor
249 * ##object:## to open the object editor
250 * ##wiki##: to open the wiki editor
251 * ##wysiwyg##: to open the WYSIWYG editor
252
Anca Luca 115.1 253 When the editor parameter is not set, the default editor is automatically computed based on the type of page that is being edited.
254
Anca Luca 114.1 255 === Parameter: ##template## ===
Anca Luca 113.2 256
Anca Luca 116.1 257 Optional, only applies if the page does not already exist: Allows you to have a specific template to apply for the current page, before it's loaded in edit mode.  Should be a string as a Document Reference like ##MyTemplate##, ##Main.MyTemplate## or ##xwiki:Main.MyTemplate##.
Anca Luca 114.1 258
259 === Parameter: ##title## ===
260
Anca Luca 116.1 261 Optional, allows to have the passed title loaded in the title field of the edit form, if present.
Anca Luca 114.1 262
Anca Luca 115.1 263 === Parameter: (% style="font-family:Menlo,Monaco,Consolas,Courier New,monospace; white-space:pre" %)content(%%) ===
Anca Luca 114.1 264
Anca Luca 116.1 265 Optional, allows to have the passed title loaded in the title field of the edit form, if present.
Anca Luca 114.1 266
Mathieu Pace 111.1 267 === Parameter: ##section## ===
268
Anca Luca 116.1 269 Optional, number allowing to [[edit a specific section>>Documentation.UserGuide.Features.PageEditing#HSectionEditing]] of the document. Applies to edit modes wiki and wysiwyg.
Mathieu Pace 111.1 270
Anca Luca 117.1 271 === Custom Parameters ===
272
273 Opitional custom parameters have the format ##<Space>.<ClassPage>_<number>_<propertyname>## (e.g. ##XWiki.XWikiUsers_0_password## or ##XWiki.WatchListClass_3_interval##):
274
275 * ##<Space>## must refer to an existing space of the wiki
276 * ##<ClassPage>## must refer to a class
277 * ##<number>## is a positive number
278 * ##<propertyname>## is a name of a property of the class ##<Space>.<ClassPage>##
279
280 If these parameters are set and the edit form contains form inputs for the properties of these classes, the edit form will load the passed values in the form inputs (like for title or content).
281
Anca Luca 118.1 282 === Parameter: ##form_token## ===
283
284 Optional; the anti-CSRF token string which can be provided by the [[CSRF API>>extensions:Extension.XWiki Platform - CSRF.WebHome]]. The token is mandatory when any of the content-modifying parameters above are used (template, title, content or any of the custom parameters), in order to enable full display of the template, title or content used. When no parameters are sent to the edit action, this parameter is not mandatory.
285
Jean SIMARD 56.15 286 == Action: ##inline## ==
Eduard Moraru 57.7 287
Thomas Mortagne 102.1 288 {{warning}}
289 Deprecated since 3.2.
290 {{/warning}}
Thomas Mortagne 98.1 291
Jean SIMARD 56.15 292 The additional URL paths for the ##inline## action is ##<space>/<page>?<query string>##.
293
294 Examples:
Eduard Moraru 57.7 295
Vincent Massol 57.6 296 * ##http:~/~/<server>/xwiki/bin/inline/Sandbox/WebHome##: Edit in inline mode the ##Sandbox.WebHome## page.
Jean SIMARD 56.15 297
Simon Urli 110.2 298 For the supported query string parameters, you can refer to the [[##save## action>>#HAction:save]].
Jean SIMARD 56.15 299
Vincent Massol 56.9 300 == Action: ##get## ==
Vincent Massol 51.1 301
Vincent Massol 56.9 302 === Parameter: ##htmlHeaderAndFooter## ===
Oana Florea 52.1 303
Vincent Massol 56.8 304 {{info}}Since 6.3RC1{{/info}} If ##htmlHeaderAndFooter=true## is passed then display the HTML headers (##<html>##,##<head>##,##<body>##, etc...) and footers (##</body>##, ##</html>##, etc...).
Guillaume Delhumeau 53.1 305
Vincent Massol 61.1 306 == Action: ##download## ==
307
Vincent Massol 63.1 308 The additional URL paths for the ##download## action is ##<space1>/.../<spaceN>/<page>/<attachment>?<query string>##.
309
310 Example:
311
312 * ##http:~/~/<server>/xwiki/bin/download/Space1/Space2/WebHome/image.png##: Views the ##image.png## attachment located in the ##Space1.Space2.WebHome## page.
313
Vincent Massol 61.1 314 === Parameter: ##force-download## ===
315
316 If set, force the attachment to be downloaded instead of being opened in the browser (it sets the ##Content-Disposition## header to ##attachment## instead of ##inline##).
317
Simon Urli 91.1 318 == Action: ##downloadrev## ==
319
320 The additional URL paths for the ##downloadrev## action is ##<space1>/.../<spaceN>/<page>/<attachment>?<query string>##.
321
322 Example:
323
324 * ##http:~/~/<server>/xwiki/bin/downloadrev/Space1/Space2/WebHome/image.png?rev=1.2##: Views the revision ##1.2## of ##image.png## attachment located in the ##Space1.Space2.WebHome## page.
325
326 === Parameter: ##rev## ===
327
328 The version to get, e.g. ##1.2## in ##http:~/~/<server>/xwiki/bin/downloadrev/Space1/Space2/WebHome/image.png?rev=1.2##
329
330 === Parameter: ##force-download## ===
331
332 If set, force the attachment to be downloaded instead of being opened in the browser (it sets the ##Content-Disposition## header to ##attachment## instead of ##inline##).
333
Eduard Moraru 64.1 334 == Action: ##create## ==
335
336 The additional URL paths for the create action is ##<space1>/.../<spaceN>/<page>?<query string>##.
337
338 Examples:
339
340 http:~/~/<server>/xwiki/bin/create/Space1/Space2/NewPage: UI for creating the Space1.Space2.NewPage document (also known as a terminal document).
341 http:~/~/<server>/xwiki/bin/create/Space1/Space2/WebHome: UI for creating the Space1.Space2.WebHome document (which is also known as a space homepage or a non-terminal document).
Eduard Moraru 85.2 342 http:~/~/<server>/xwiki/bin/create/Main/WebHome: Generic UI for creating a new document (asking for location and document name since Main.WebHome already exists)
Eduard Moraru 64.1 343
344 Here are some of the supported query string parameters.
345
346 === Parameter: ##spaceReference## ===
347
348 {{info}}Since 7.2M1{{/info}} A local reference string serialization of the space in which to create the new document, e.g. "Space1.Space2"
349
Eduard Moraru 64.2 350 //Note//: Since it's a serialized string reference, entity names need to be already escaped. For a space name "A.B", the equivalent local space reference would be "A\.B". Another example of serialized local space reference would be "A\.B.C\.D", meaning space "C.D" inside space "A.B". See the [[extensions:Extension.Model Module]]'s documentation for more information on EntityReferences.
Eduard Moraru 64.1 351
352 === Parameter: ##name## ===
353
Eduard Moraru 64.3 354 {{info}}Since 7.2M1{{/info}} A string representing the name of the new entity, e.g. "NewDocument".
Eduard Moraru 64.1 355
Eduard Moraru 64.3 356 Depending on the type of document to create, this will be used as:
357
358 * a space name, when creating non-terminal documents, e.g. spaceReference=Space&name=Page results in creating "Space.Page.WebHome"
359 * a document name, when creating terminal documents, e.g. spaceReference=Space&name=Page&tocreate=terminal results in creating "Space.Page"
360
Eduard Moraru 64.1 361 === Parameter: ##tocreate## ===
362
363 Accepted values:
Eduard Moraru 64.2 364
Eduard Moraru 64.3 365 * empty or not specified:
Eduard Moraru 64.5 366 ** if the current document does not exist, a terminal document will be created having the current document's reference, e.g. ##/create/Space/NewPage## creates "Space.NewPage"
367 ** if the current document exists, the new document (specified using the ##spaceReference## + ##name## parameters pair) is created as a non-terminal document, e.g. ##/create/Main/WebHome?spaceReference=Space&name=NewPage## creates "Space.NewPage.WebHome".
368 ** {{warning}}Deprecated since 7.2M1{{/warning}} if the current document exists, the new document (specified using the deprecated ##space## + ##pageName## parameters pair) is created as a terminal document, e.g. ##/create/Main/WebHome?space=Space&page=NewPage## creates "Space.NewPage".
Eduard Moraru 64.1 369 * "terminal" - forces the new document to be a terminal document.
370 ** Example: If "Space1.Space2.Page" is to be created, then it is already a terminal document and is not affected in any way by this setting, but if "Space1.Space2.WebHome" is to be created then it would be a non-terminal document by default. In this later case, specifying the tocreate=terminal parameter would force the creation of a terminal document instead, result in the creation of ##Space1.Space2## (i.e. the page named "Space2" in the space "Space1"), effectively going up one level in the Nested Spaces hierarchy.
371 ** In the case of a top level space's WebHome document (e.g. "Space.WebHome"), this setting is ignored, since the top limit of the hierarchy is reached and there is nowhere else to go up. The resulting document to be created is thus "Space.WebHome".
Eduard Moraru 64.4 372 * "space" - {{warning}}Deprecated since 7.2M1{{/warning}} The document to be created will always be a space WebHome (a.k.a a non-terminal document). This value is considered only when used in conjunction with the deprecated ##space## parameter. In this case, the deprecated ##page## parameter is completely ignored. For example: ##tocreate=space&space=MySpace## will result in "MySpace.WebHome".
Eduard Moraru 64.1 373
Eduard Moraru 64.6 374 === Parameter: ##template## ===
375
376 A string serialized document reference of the document to use as template when creating the new document.
377
378 If empty, the new document will be a blank page.
379
380 If not specified, and existing template providers are available to choose from in the current space and the ##templateprovider## parameter is also not specified, no document will be created yet and the create UI will show up asking the user to choose a template provider from a list.
381
382 This parameter has precedence over the ##templateprovider## parameter, meaning that if both are specified, the ##templateprovider## will be ignored.
383
384 === Parameter: ##templateprovider## ===
385
386 A string serialized document reference of the template provider document to use when creating the new document. The actual template document to use will be extracted from the specified template provider.
387
388 If the specified template provider is not allowed to be used in the space where the new document is created, then the create UI will be displayed with an error.
389 //Note//: This check is done for the ##spaceReference## of the new document to be created. Example: If we are creating the terminal document "Space.NewPage", the check is done for the space "Space". However, if we are creating the non-terminal document "Space.NewPage.WebHome", the check is done for the non-terminal document's space "Space" and not for actual document's reference space "NewPage".
390
391 If empty, the new document will be a blank page.
392
Mohammad Humayun Khan 107.1 393 If not specified, and existing template providers are available to choose from in the current space and the ##template parameter is also not specified, no document will be created yet and the create UI will show up asking the user to choose a template provider from a list.##
Eduard Moraru 64.6 394
395 If both this parameter and the ##template## parameter are specified, the ##template## parameter will be used instead of and this parameter will be ignored.
396
Eduard Moraru 64.7 397 === Parameter: ##title## ===
398
399 A string to use as the title of the new document.
400
Mathieu Pace 111.1 401 === Parameter: ##form_token## ===
402
Mathieu Pace 113.1 403 A mandatory anti-CSRF token string which can be provided by the [[CSRF API>>extensions:Extension.XWiki Platform - CSRF.WebHome]].
Mathieu Pace 111.1 404
Eduard Moraru 64.7 405 === Parameter: ##parent## ===
406
407 {{warning}}Deprecated since 7.2M1{{/warning}} A string serialized document reference of the document to use as parent for the new document.
408
Eduard Moraru 64.1 409 === Parameter: ##space## ===
410
411 {{warning}}Deprecated since 7.2M1{{/warning}} A string representing an unescaped space name where the new document will be created, Example: "MySpace", "SpaceNameWith.Dots", etc.
412
Eduard Moraru 64.2 413 //Note//: Because this is just a space name and not a space local reference, only top level space documents can be created, i.e. "TopLevelSpace.Document" is possible but not "TopLevelSpace.SecondLevelSpace.Document".
Eduard Moraru 64.1 414
415 === Parameter: ##pageName## ===
416
417 {{warning}}Deprecated since 7.2M1{{/warning}} A string representing the name of the new document. Example: "NewDocument"
418
Eduard Moraru 64.2 419 //Note//: When using ##tocreate=space## in conjunction with the ##space## parameter, this parameter will be ignored and the document "<space>.WebHome" will be created.
Eduard Moraru 64.1 420
Vincent Massol 65.1 421 == Action: ##skin## ==
422
Thomas Mortagne 87.1 423 Right now dynamic Skin Resources are handled as Entity Resources ([[which is not correct>>https://jira.xwiki.org/browse/XWIKI-12449]]).
Vincent Massol 65.1 424
Vincent Massol 66.1 425 The additional URL paths for the ##skin## action is
Guillaume Delhumeau 68.1 426
Vincent Massol 66.1 427 * ##<filesystem path to resource>?<optional query string>## for Filesystem-based Skins
428 * ##<space1>/.../<spaceN>/<page>/<attachment name>## for a resource attached to a wiki page. Note that Velocity is executed only if the attachment has a CSS or Javascript extension name.
429 * ##<space1>/.../<spaceN>/<page>/<xobject property name>## for Skins defined in wiki pages and having an ##XWiki.XWikiSkins## xobject with a property named ##<xobject property name>##. Note that Velocity is executed only if the ##<xobject property name>## name has a CSS or Javascript extension name.
Vincent Massol 65.1 430
431 Examples:
432
Vincent Massol 67.1 433 * ##http:~/~/<server>/xwiki/bin/skin/skins/flamingo/style.css?skin=XWiki.DefaultSkin&colorTheme=playground%3AFlamingoThemes.Charcoal##: Points to the ##style.css## resource located in the ##[xwiki webapp location]/skins/flamingo## directory on the filesystem (and if not found look for the resource in the base skin and default base skin).
Vincent Massol 65.1 434 * ##http:~/~/<server>/xwiki/bin/skin/resources/uicomponents/search/searchSuggest.css##: Points to the ##searchSuggest.css## resource located in the ##[xwiki webapp location]/resources/uicomponents/search## directory on the filesystem.
Vincent Massol 67.1 435 * ##http:~/~/<server>/xwiki/bin/skin/uicomponents/search/searchSuggest.css##: Similar as just above except that the ##resources## part has been omitted and if the resource doesn't exist in ##[xwiki webapp location]/uicomponents/search## then it's also searched for in ##[xwiki webapp location]/resources/uicomponents/search##
436 * ##http:~/~/<server>/xwiki/bin/skin/XWiki/DefaultSkin/somefile.css##: Points to the ##somefile.css## attachment in the ##XWiki.DefaultSkin## wiki page (and if not found look for the resource in the base skin and default base skin).
437 * ##http:~/~/<server>/xwiki/bin/skin/XWiki/DefaultSkin/edit.vm##: Points to the content of the ##edit.vm## property in the ##XWiki.XWikiSkins## xobject in the ##XWiki.DefaultSkin## wiki page (and if not found look for the resource in the base skin and default base skin).
Vincent Massol 65.1 438
Thomas Mortagne 102.1 439 == Action: ##objectadd## ==
Vincent Massol 96.1 440
441 Adds an XObject to the referenced page.
442
443 Examples:
Thomas Mortagne 102.1 444
Vincent Massol 96.1 445 * ##http:~/~/<server>/xwiki/bin/objectadd/Space/Page?classname=Some.XClass##
446 * ##http:~/~/<server>/xwiki/bin/objectadd/Space/Page?classname=XWiki.XWikiGroups&XWiki.XWikiGroups_member=XWiki.JohnDoe##
447
448 === Parameter: ##classname## ===
449
450 The full name of the document that holds the class which the object to be added should be instance of. Example: ##XWiki.XWikiGroups##.
451
452 === Parameter: ##<classname>_<fieldname>## ===
453
454 This is an optional parameter. You can initialize the XObject properties by passing parameter names of the form ##<classname>_<fieldname>##, where ##classname## is the value given in the ##classname## parameter above and ##fieldname## is the name of the xproperty field to initialize. For example: ##XWiki.XWikiGroups_member## (provided that ##XWiki.XWikiGroups## has been given for the mandatory ##classname## parameter).
455
Mathieu Pace 111.1 456 === Parameter: ##xredirect## ===
Vincent Massol 109.1 457
458 Optional parameter indicating the URL to redirect to once the object has been added.
459
460 For example: ##xredirect=/xwiki/bin/view/SomeSpace/SomePage##.
461
462 When not specified, you're redirected to the current page (the page specified in the URL) and using the object editor (##edit## action and ##editor=object## parameter).
463
Mathieu Pace 111.1 464 === Parameter: ##form_token## ===
465
Mathieu Pace 113.1 466 A mandatory anti-CSRF token string which can be provided by the [[CSRF API>>extensions:Extension.XWiki Platform - CSRF.WebHome]].
Mathieu Pace 111.1 467
Vincent Massol 108.1 468 == Action: ##objectremove## ==
469
470 Removes an XObject from the referenced page.
471
472 Examples:
473
474 * ##http:~/~/<server>/xwiki/bin/objectremove/Space/Page?classname=Some.XClass##
475 * ##http:~/~/<server>/xwiki/bin/objectremove/Space/Page?classname=XWiki.XWikiGroups&XWiki.XWikiGroups_member=XWiki.JohnDoe##
476
477 === Parameter: ##classname## ===
478
479 The full name of the document that holds the class which the object to be removed should be instance of. Example: ##XWiki.XWikiGroups##.
480
481 === Parameter: ##classid## ===
482
483 The number of the object to remove from the class (starts at 0).
484
Mathieu Pace 111.1 485 === Parameter: ##xredirect## ===
Vincent Massol 108.1 486
487 Optional parameter indicating the URL to redirect to once the object has been removed.
488
489 For example: ##xredirect=/xwiki/bin/view/SomeSpace/SomePage##.
490
491 When not specified, you're redirected to the current page (the page specified in the URL) in ##edit## mode (##/edit/## action).
492
Mathieu Pace 111.1 493 === Parameter: ##form_token## ===
494
Mathieu Pace 113.1 495 A mandatory anti-CSRF token string which can be provided by the [[CSRF API>>extensions:Extension.XWiki Platform - CSRF.WebHome]].
Mathieu Pace 111.1 496
Vincent Massol 101.1 497 = Type: ##vfs## =
498
499 See [[VFS Resource>>extensions:Extension.VFS API]].
500
501 = Type: ##webjars## =
502
503 See [[WebJar Resource>>extensions:Extension.WebJars Integration]]
504
Vincent Massol 56.9 505 = Type: ##wiki## =
Vincent Massol 56.8 506
Eduard Moraru 64.2 507 {{info}}
508 XWiki 7.2: Added support for Nested Spaces
509 {{/info}}
Vincent Massol 62.1 510
Vincent Massol 56.8 511 The format is ##wiki/<wiki name>/<bin subpath>## where:
Eduard Moraru 57.7 512
Vincent Massol 56.8 513 * ##<wiki name>##: the name of the subwiki, e.g. ##platform##.
Sergiu Dumitriu 81.1 514 * ##<bin subpath>##: the same path as for the ##bin## action (see above). For example, if you use ##http:~/~/<main wiki server>/xwiki/bin/download/XWiki/JohnDoe/john.png## you would use ##http:~/~/<main wiki server>/xwiki/wiki/<subwiki name>/download/XWiki/JohnDoe/john.png## to access the same attachment but located in a subwiki named ##<subwiki>##.
Vincent Massol 56.8 515
Vincent Massol 56.9 516 = Type: ##resources## =
Vincent Massol 56.8 517
Vincent Massol 57.6 518 Static template resources, e.g. ##http:~/~/<server>/xwiki/resources/js/prototype/prototype.js##.
Vincent Massol 56.8 519
Vincent Massol 56.9 520 = Type: ##skins## =
Vincent Massol 56.8 521
Vincent Massol 57.6 522 Static skin resources, e.g. ##http:~/~/<server>/xwiki/skins/flamingo/logo.png##.
Sergiu Dumitriu 81.1 523
524 = Type: ##temp## =
525
Thomas Mortagne 102.1 526 {{warning}}
527 Deprecated since 8.3. Use the ##tmp## resource handler instead.
528 {{/warning}}
Thomas Mortagne 98.1 529
Sergiu Dumitriu 81.1 530 Dynamic temporary resources, bound to a specific document and a specific module.
531
532 The format is ##temp/<Space>/<Document>/<module>/<file.ext>##, where:
533
534 * ##<Space>## and ##<Document>## identify the target document; currently only the last part of the space is supported
535 * ##<module>## is the name of the module that generated the resource, a short string used for avoiding conflicts between different modules generating temporary files with the same name
536 * ##<file.ext>## is the name of the temporary file
537
538 == Parameter: ##force-download## ==
539
540 If set to ##1##, force the file to be downloaded instead of being opened in the browser (it sets the ##Content-Disposition## header to ##attachment##).
Thomas Mortagne 84.1 541
542 == Parameter: ##force-filename## ==
543
544 [since 9.0RC1]
545
546 If ##force-download## is set, the value of ##force-filename## is used in the ##Content-disposition## HTTP header to indicate the name of the file to the browser.
Thomas Mortagne 85.1 547
Vincent Massol 101.1 548 = Type: ##tmp## =
Thomas Mortagne 85.1 549
Vincent Massol 101.1 550 See [[Temporary Resource>>extensions:Extension.Temporary Resource API]]
Simon Urli 104.1 551
552 = Type: ##authenticate## =
553
554 {{version since="13.1RC1"}}
555 See [[Authentication Security Module>>extensions:Extension.Authentication Security Module||anchor="HAuthenticateURLresourcetype"]]
556 {{/version}}

Get Connected