SCRIPTURL -- URL of script(s)
Expands to the URL of a script, or the base URL of all scripts
Parameters
Parameter |
Description |
Default |
"$script" |
Name of script |
|
web |
Web name to add to URL |
|
topic |
Topic (or Web.Topic) to add to URL |
|
Any other parameters to the macro will be added as parameters to the URL |
Examples
-
%SCRIPTURL{"view" topic="Cartoons.EvilMonkey"}%
will expand to https://middleforkhome.us/Cartoons/EvilMonkey
-
%SCRIPTURL{"view" web="Cartoons"}%
will expand to https://middleforkhome.us/Cartoons?web=Cartoons
-
%SCRIPTURL{"view" topic="Cartoons.EvilMonkey" rev="1"}%
will expand to https://middleforkhome.us/Cartoons/EvilMonkey?rev=1
-
%SCRIPTURL{"edit" web="Cartoons" topic="EvilMonkey" t="%GMTIME{"$epoch"}%"}%
expands to https://middleforkhome.us/bin/edit/Cartoons/EvilMonkey?t=1732219335
-
%SCRIPTURL%
expands to https://middleforkhome.us/bin
-
%SCRIPTURL{script}%
expands to https://middleforkhome.us/bin/script
In most cases you should use
SCRIPTURLPATH instead, as it works much better with URL rewriting
The
edit
script should always be used in conjunction a
t="%GMTIME{"$epoch"}%"
parameter to ensure pages about to be edited are not cached in the browser
The 'old' way of building URLs using
SCRIPTURL
involved concatenating the web and topic names to the
SCRIPTURL
e.g.
%SCRIPTURL{"script"}%/Cartoons/EvilMonkey
. This practice is
strongly discouraged, as it does not correctly handle encoding of the parts of the URL. At the first opportunity you should replace all such URLs with the equivalent
%SCRIPTURL%{"script" topic="Cartoons.EvilMonkey"}%
, which will handle URL encoding for you.
The SCRIPTURL macro does NOT support building
jsonrpc
or
rest
requests with parameters. They should still use the "contatenation" method. This is expected to be fixed in Foswiki 2.2.
PUBURL,
SCRIPTNAME,
SCRIPTSUFFIX,
SCRIPTURLPATH