Difference between revisions of "Template:SLurl"

From Second Life Wiki
Jump to navigation Jump to search
(testing full SLurl support)
m (tweaky tweaky. making slurl template moar flexible)
(38 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<includeonly>{{
<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>
#if: {{{region|}}} && {{{x|}}} && {{{y|}}} && {{{z|}}}
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)
|[http://slurl.com/secondlife/{{urlencode:{{{region}}}}}/{{{x}}}/{{{y}}}/{{{z}}}/{{
#if: {{{title|}}}  
|?title={{urlencode:{{{title}}}}}|}}{{
#if: {{{image|}}}
|?img={{urlencode:{{{image}}}|}}{{
#if: {{{message|}}}
|?msg={{urlencode:{{{message}}}|}}{{
#if: {{{iframe|}}}
|?iframe={{urlencode:{{{iframe}}}|}}{{
#if: {{{title|}}}
| {{{title}}}|}}]| <strong style="color:red;">Region name as well as X, Y and Z co-ordinates are required fields.</strong>


}}</includeonly><noinclude>
== Templates based on [[Template:SLurl]] ==
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 might be overkill to use directly in some cases. The following templates might be easier to use:
 
* [[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 ==
== Usage ==
<div style="font-size: 140% ;"><code><nowiki>{{SLurl
'''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
|region=Ahern
|x=18
|x=18
Line 23: Line 59:
|z=20
|z=20
|title=Ahern Welcome Area
|title=Ahern Welcome Area
}}</nowiki></code></div>
}}</nowiki></pre></code></div>


== Example ==
'''Basic, no title'''


{{SLurl
{{SLurl
Line 33: Line 69:
|z=20
|z=20
|title=Ahern Welcome Area
|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>


</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
}}