Difference between revisions of "Template:SLurl"

From Second Life Wiki
Jump to navigation Jump to search
(clarify applies to two fields)
m (tweaky tweaky. making slurl template moar flexible)
(42 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[http://slurl.com/secondlife/{{{1}}}/{{{2}}}/{{{3}}}/{{{4}}}/?title={{{5}}} {{{5}}}]
<includeonly><span class="plainlinks">{{ #ifeq: {{{display-url}}}|enabled||[}}{{{prefix|http://slurl.com/secondlife/}}}{{urlencode:{{{region|{{{1}}}}}}}}/{{{x|{{{2|128}}}}}}/{{{y|{{{3|128}}}}}}/{{{z|{{{4|0}}}}}}/?{{ #if: {{{width|}}} |&x={{{width}}}|}}{{ #if: {{{height|}}} |&y={{{height}}}|}}{{ #if: {{{title|}}} |&title={{urlencode:{{{title}}}}}|}}{{ #if: {{{image|}}}|&img={{urlencode:{{{image}}}}}|}}{{ #if: {{{message|}}} |&msg={{urlencode:{{{message}}}}}|}}{{ #if: {{{iframe|}}}|&iframe={{urlencode:{{{iframe}}}}}|}}{{ #ifeq: {{{display-url}}}|enabled||{{ #ifeq: {{{no-title}}}|enabled||<nowiki> </nowiki>{{{title|{{{region|{{{1}}}}}} ({{{x|{{{2|128}}}}}}, {{{y|{{{3|128}}}}}}, {{{z|{{{4|0}}}}}})}}}|}}]|}}<sup>[secondlife://{{#replace:{{{region|{{{1}}}}}}| |%20}}/{{{x|{{{2|128}}}}}}/{{{y|{{{3|128}}}}}}/{{{z|{{{4|0}}}}}} D]</sup></span></includeonly><noinclude>
<noinclude>
This template permits the easy inclusion of a '''[http://slurl.com/ SLurl]''' as a link without the need to create them manually or via ''tinyurl'' or similar external service (which is open to spamming problems)


This template permits the easy inclusion of an '''SLurl''' as a link without the need to create them manually or via ''tinyurl'' or similar (which is open to spamming problems)
== Templates based on [[Template:SLurl]] ==


===Usage===
This template might be overkill to use directly in some cases. The following templates might be easier to use:
<nowiki>{{Template:SLurl | <region name> | <x> | <y> | <z> | <target description}}</nowiki>
 
* [[Template:SLurl/simple|'simple' SLurl]]
* [[Template:SLurl/Infohub|SLurls for Infohubs]]
* [[Template:SLurl/WA|SLurls for Welcome Areas]]
* [[Template:SLurl/extended|SLurls with extended info]]
 
== Usage ==
'''Minimum Requirements'''
 
<div style="font-size:140%"><code><pre><nowiki>{{SLurl|<REGION>}}</nowiki></pre></code></div>
 
'''Example:'''
 
<div style="font-size:140%"><code><pre><nowiki>{{SLurl|Help Island Public}}</nowiki></pre></code></div>
 
'''Full Options'''
 
All the options found in the template are as described on the [http://slurl.com/build.php SLurl Builder], with a few exceptions:
 
* '''Window Width'' and '''Window Height''' are referred to as '''''width''''' and '''''height''''' respectively, in order to avoid confusing conflicts with the region co-ordinates.
* '''no-title''' disables the display of the title in the wiki link. This should be set to '''''enabled''''' if you intend to use it.
* '''display-url''' outputs the link as a full URL, instead of a numbered or titled link. This should be set to '''''enabled''''' if you intend to use it. This option forces the ''''no-title'''' option to be ignored.
* Remark: The variable names ''region'', ''x'', ''y'' and ''z'' aren't needed. <nowiki>{{SLurl|Help Island Public|10|15|30}}</nowiki> works as well.
 
<div style="font-size:140%"><code><pre><nowiki>{{SLurl
|region=
|x=
|y=
|z=
|title=
|no-title=
|image=
|message=
|iframe=
|width=
|height=
}}</nowiki></pre></code></div>
 
== Examples ==
'''Basic'''
 
{{SLurl
|region=Ahern
|x=18
|y=11
|z=20
|title=Ahern Welcome Area
}}
<div style="font-size:140%;"><code><pre><nowiki>{{SLurl
|region=Ahern
|x=18
|y=11
|z=20
|title=Ahern Welcome Area
}}</nowiki></pre></code></div>
 
'''Basic, no title'''
 
{{SLurl
|region=Ahern
|x=18
|y=11
|z=20
|title=Ahern Welcome Area
|no-title=enabled
}}
<div style="font-size:140%;"><code><pre><nowiki>
{{SLurl
|region=Ahern
|x=18
|y=11
|z=20
|title=Ahern Welcome Area
|no-title=enabled
}}</nowiki></pre></code></div>
 
'''Basic, displayed as URL'''
 
{{SLurl
|region=Ahern
|x=18
|y=11
|z=20
|title=Ahern Welcome Area
|display-url=enabled
}}
<div style="font-size:140%;"><code><pre><nowiki>
{{SLurl
|region=Ahern
|x=18
|y=11
|z=20
|title=Ahern Welcome Area
|display-url=enabled
}}</nowiki></pre></code></div>


Any spaces in the ''<region name>'' and ''<target description>'' '''must''' be replaced by the code for a space - %20 - as otherwise the URL will not work correctly.
</noinclude>
</noinclude>

Revision as of 11:41, 4 July 2009

This template permits the easy inclusion of a SLurl as a link without the need to create them manually or via tinyurl or similar external service (which is open to spamming problems)

Templates based on Template:SLurl

This template might be overkill to use directly in some cases. The following templates might be easier to use:

Usage

Minimum Requirements

{{SLurl|<REGION>}}

Example:

{{SLurl|Help Island Public}}

Full Options

All the options found in the template are as described on the SLurl Builder, with a few exceptions:

  • Window Width and Window Height' are referred to as width and height respectively, in order to avoid confusing conflicts with the region co-ordinates.
  • no-title disables the display of the title in the wiki link. This should be set to enabled if you intend to use it.
  • display-url outputs the link as a full URL, instead of a numbered or titled link. This should be set to enabled if you intend to use it. This option forces the 'no-title' option to be ignored.
  • Remark: The variable names region, x, y and z aren't needed. {{SLurl|Help Island Public|10|15|30}} works as well.
{{SLurl
|region=
|x=
|y=
|z=
|title=
|no-title=
|image=
|message=
|iframe=
|width=
|height=
}}

Examples

Basic

Ahern Welcome AreaD

{{SLurl
|region=Ahern
|x=18
|y=11
|z=20
|title=Ahern Welcome Area
}}

Basic, no title

[1]D

{{SLurl
|region=Ahern
|x=18
|y=11
|z=20
|title=Ahern Welcome Area
|no-title=enabled
}}

Basic, displayed as URL

http://slurl.com/secondlife/Ahern/18/11/20/?&title=Ahern+Welcome+AreaD

{{SLurl
|region=Ahern
|x=18
|y=11
|z=20
|title=Ahern Welcome Area
|display-url=enabled
}}