Difference between revisions of "Using Second Life URLs (SLurls)"

From Second Life Wiki
Jump to navigation Jump to search
 
(65 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Help|Glossary=*|Navigation=*}}
{{#widget:Redirect|url=/t5/English-Knowledge-Base/Landmarks-and-SLurls/ta-p/700123}}
 
'''A [http://slurl.com SLURL] (Second Life [http://en.wikipedia.org/wiki/URL URL]) is a teleport link to a location in Second Life.''' If you have Second Life installed, using a SLURL will automatically transport you to that location inworld. If you don't yet have Second Life, you can '''[http://secondlife.com/join/ join us for free!]'''
 
''Watch the video tour!''
 
<videoflash>B47ojt8IMD8</videoflash>
 
Knowledge Base articles lovingly crafted by our [[:Category:Documentation_Office_Hours|Documentation Team]]!
 
* '''[http://support.secondlife.com/ics/support/default.asp?deptID=4417&task=knowledge&questionID=4208 How do I invite someone who isn't currently inworld to a specific location?]'''
* '''[http://support.secondlife.com/ics/support/default.asp?deptID=4417&task=knowledge&questionID=5556 I don't want people to use a SLURL to access my land]'''
* '''[http://support.secondlife.com/ics/support/default.asp?deptID=4417&task=knowledge&questionID=5554 I followed a SLURL and it took me to the wrong place!]'''
 
 
== How it works ==
 
Use a SLURL to direct people to inworld locations as follows:
 
* Create a SLURL, either using [http://slurl.com/build.php SLURL Builder], or "manually."
* Share the SLURL with a friend — ''sharing is caring!''
* They click the SLURL. It's a web link like any other.
* They'll see a http://slurl.com page and more info, if you provided it. Like this:
 
[[Image:SLURL-Here-example.png|512px]]
 
=== If your friend doesn't have Second Life ===
 
The page at http://www.slurl.com will display a link to [https://join.secondlife.com/ SIGN UP NOW for free].
From the signup up page, your friend can quickly register, download the Second Life Viewer, and log in.  '''When they first log in, they will initially arrive at the destination specified by the SLURL''', not the default start location on Help Island.  A quick tutorial will open upon their initial arrival to help them get started.
 
Providing new users the ability to sign up for Second Life directly from http://www.slurl.com is sometimes referred to as ''DirectSLURL''.  For more information, see the [http://blog.secondlife.com/2008/09/18/getting-a-second-life-just-got-easier-with-direct-slurl/ announcement of Direct SLURL].
 
=== If your friend has Second Life ===
[[Image:SLURL-Place-Information.png|512px|right]]
 
If the Second Life Viewer is not already running, it will start.
 
* When they log in, they'll be at the location specified by the SLURL.
* If they're already logged in, a Place Information window opens (for example, as shown at right).  When they click on the Teleport button in this window, they will be instantly teleported to the location specifeid by the SLURL.
 
== Make beautiful SLURLs ==
The first step to making beautiful SLURLs is adding explanatory text and a picture to '''give it more context and flavor'''.
 
For example, say you've got an island in Second Life you want to invite people to. This base URL works:
 
: http://slurl.com/secondlife/Here/54/105/47
 
works, but tells you nothing about what you're getting into. Compared to this (click on it!):
 
: http://slurl.com/secondlife/Here/54/105/47/?title=An%20island%20of%20fun%21
 
which is a little more descriptive.
 
'''Use [http://slurl.com/build.php SLURLBuilder] to easily make beautiful SLURLs.'''
 
=== SLURL query string parameters ===
 
Supply SLURL query string parameters to set the window title, image, and text.  Parameters are just '''name=value''' pairs.  Just like a standard URL, precede the first parameter pair with a question mark (?), and all subsequent parameter pairs with an ampersand (&).
 
 
{| border="1" cellspacing="0" cellpadding="3" rules="all" class="apitable"
|- bgcolor="#A7C1F2"
!valign="top"| Parameter
!valign="top"| Description
!valign="top"| Example
 
|--
|title
|Title text to display in the teleport window.
|To specify the window title "Come to My Island!" use <br>
'''title=Come%20To%20My%20Island'''
<br>For example: http://slurl.com/secondlife/Ahern/50/50/50/?title=Come%20To%20My%20Island
 
|--
|img
|URL of image to display in teleport window.  Must be a complete (absolute) URL, and preferably a small image of 256x256 pixels or less.
|To display this example image, use <br>
'''<nowiki>img=http://slurl.com/examples/forsale.png</nowiki>'''<br>
For example: http://slurl.com/secondlife/Ahern/50/50/50/?img=http://slurl.com/examples/forsale.png
 
|-
|msg
|Message text to display in the teleport window
|To specify the message text "Your text here", use <br>
'''msg=Your%20text%20here''' <br>
For example: http://slurl.com/secondlife/Ahern/50/50/50/?msg=Your%20text%20here.
 
|}
 
=== Shortening SLURLs ===
SLURLs, especially if they have text and a picture included ([http://slurl.com/secondlife/Here/54/105/47/?img=http%3A//torley.s3.amazonaws.com/slurlexample.jpg&title=SLURL%20TITLE%20-%20Here%20island%20%28you%20can%20click%20this%20to%20teleport%29&msg=SLURL%20DESCRIPTION%20-%20Here%20we%20are%2C%20standing%20on%20giant%20letters%21%20Come%20explore%21 see example]), can get quite lengthy. This makes them difficult to paste into places like emails, which may have line breaks that mangle the SLURL. Plus, they look unsightly!
 
You can use a 3rd-party URL-shortening service to '''condense a SLURL and make it easier to share'''. There are dozens of these out there, including:
 
* '''[http://snurl.com Snurl]''' - No relation to SLURL, but the similar URL and basic stats tracking makes it an easy choice.
* '''[http://tinyurl.com TinyURL]''' - One of the first and most popular.
 
If you have a webserver with customizable [http://en.wikipedia.org/wiki/HTTP_status_code#3xx_Redirection redirect], you can do something similar. For example, try: http://torley.com/here and watch how the SLURL expands to its full length in your web browser's address bar.
 
== Share SLURLs with postcards ==
'''You can send snapshots from Second Life to any email address.''' These are called postcards. All you need to do is:
 
* Click Snapshot button on the toolbar at the bottom of your screen.
* Select the "postcard" option
* Click Send, type your recipient's email and descriptive text, and click Send again.
 
Within minutes, they'll get it — with a SLURL!
 
<videoflash>cBDAYizCvOI</videoflash>
 
One popular popular usage is emailing them to social sites to show off! [http://www.flickr.com/photos/torley/2923114481/ See example on Flickr], and notice how the "[http://map.slbuzz.com/sim/Tiny/200/77/23/ Visit Tiny]" link is a SLURL! This is great, because the picture (said to be worth 1,000 words) gives you an idea what to expect.
 
However, emailing straight to [http://flickr.com Flickr] doesn't work as expected due to how postcard templates are arranged. To work around this, social sites like [http://slbuzz.com/ SLBuzz], [http://slpics.com Snapzilla], and [http://koinup.com Koinup] have stepped in to provide better crossposting in addition to their own dedicated hosting.
 
For more info on the wonder of Second Life snapshots and how to make the ''best'' of postcard SLURLs, see:
 
* '''[[Snapshot_Help|Torley's Guide to High-Quality Photography]]'''
* '''[http://torley.com/show-off-your-newest-second-life-postcards-automagically Show off your newest Second Life postcards automagically]'''
 
== More details ==
'''On Windows, a SLURL opens the newest-installed viewer.''' There isn't an immediate way to change which viewer launches SLURLs, so if you have the main viewer ''and'' a [[Release Candidate]], it'll start whichever was installed most recently. Altho inconvenient, you can change this by reinstalling a viewer.
 
Every SLURL page's SLURL title and Teleport Now button link to a "<nowiki>secondlife://</nowiki>" address, which is an [http://en.wikipedia.org/wiki/URI_scheme URI scheme] which opens Second Life. This is different from the familiar "http://" used for webpages.
 
The reason why it's advantageous to post "http://" SLURLs instead of direct "<nowiki>secondlife://</nowiki>" addresses in webpages and such is for the '''benefit of people who ''don't'' have Second Life yet'''. Giving them a "<nowiki>secondlife://</nowiki>" URL ''doesn't'' work, since it depends on SL being installed. A SLURL serves as a friendly intro to tell them about Second Life as-needed and where they'll be going, instead of leading them blindly.
 
=== More video tutorials ===
By [[User:Torley_Linden|Torley]].
 
'''Using SLURLs for easy travel'''
<videoflash>ceIzvl0TYVc</videoflash>
* [http://blog.secondlife.com/2008/02/21/tip-of-the-week-23-using-slurls-for-easy-travel/ Read related blog post]
* [http://vidtuts.s3.amazonaws.com/SLTotW-23-Using-SLURLs-for-easy-travel.mp4 Download high-quality version]
 
'''Changing your login location'''
<videoflash>7IQs_ljiAkQ</videoflash>
* [http://vidtuts.s3.amazonaws.com/QUICKTIP-Changing-your-login-location.mp4 Download high-quality version]
 
'''Teleport location history'''
<videoflash>DIAhBRaeNiE</videoflash>
* [http://vidtuts.s3.amazonaws.com/QUICKTIP-Teleport-location-history.mp4 Download high-quality version]
 
=== Others ===
* '''[[Template:SLurl]]''' - Need to add SLURLs to wiki pages here? This'll help!
* '''[http://www.xstreetsl.com/modules.php?name=Marketplace&file=item&ItemID=136080 Slurlblogger]''' - Useful tool by Ordinal Malaprop which "can send notes with SLurls to email, or directly to a blog".

Latest revision as of 14:01, 19 March 2012

Redirecting to http://community.secondlife.com/t5/English-Knowledge-Base/Landmarks-and-SLurls/ta-p/700123

Retrieved from "https://wiki.secondlife.com/w/index.php?title=Using_Second_Life_URLs_(SLurls)&oldid=1164286"