Difference between revisions of "Using Second Life URLs (SLurls)"
Jump to navigation
Jump to search
(SLurl) |
|||
| Line 6: | Line 6: | ||
You can't get to a webpage without knowing its URL (Uniform Resource Locator), commonly called a "link". Just like your web browser has bookmarks, in Second Life, we have landmarks. Since our virtual world is three-dimensional, landmarks contain a Region name and 3 positioning coordinates ''within'' that region. But what happens '''when you want to share a landmark outside of Second Life to promote your home, business, or other place?''' | You can't get to a webpage without knowing its URL (Uniform Resource Locator), commonly called a "link". Just like your web browser has bookmarks, in Second Life, we have landmarks. Since our virtual world is three-dimensional, landmarks contain a Region name and 3 positioning coordinates ''within'' that region. But what happens '''when you want to share a landmark outside of Second Life to promote your home, business, or other place?''' | ||
'''A Second Life [http://en.wikipedia.org/wiki/URL URL] ([http:// | '''A Second Life [http://en.wikipedia.org/wiki/URL URL] ([http://SLurl.com SLurl]) 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, just click the [http://secondlife.com/join '''SIGN UP''' link] to go to a simple registration page. After registering and downloading the Second Life Viewer, you'll automatically start at the specified location. Watch this fun video tour to understand more: | 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, just click the [http://secondlife.com/join '''SIGN UP''' link] to go to a simple registration page. After registering and downloading the Second Life Viewer, you'll automatically start at the specified location. Watch this fun video tour to understand more: | ||
| Line 12: | Line 12: | ||
{{KBvideo|1747404}} | {{KBvideo|1747404}} | ||
The '''[http://maps.secondlife.com maps.secondlife.com]''' and '''[http:// | The '''[http://maps.secondlife.com maps.secondlife.com]''' and '''[http://SLurl.com SLurl.com]''' websites are implemented using the Second Life [[Map API]]. If you have a website, you can use it as well to embed Second Life maps on your pages, in the same way you can embed [http://maps.google.com/ Google Maps]. | ||
== How it works == | == How it works == | ||
| Line 18: | Line 18: | ||
Use a SLurl to direct people to inworld locations like this: | Use a SLurl to direct people to inworld locations like this: | ||
# Create a SLurl, either using [http:// | # Create a SLurl, either using [http://SLurl.com/build.php SLurl Builder], or "manually." | ||
# Share the SLurl with a person who you want to tell about something in Second Life. | # Share the SLurl with a person who you want to tell about something in Second Life. | ||
# They click the SLurl. It's a web link like any other. | # They click the SLurl. It's a web link like any other. | ||
# They'll see a http:// | # They'll see a http://SLurl.com page and more info, if you provided it. Like this: | ||
#: [[Image: | #: [[Image:SLurl-Here-example.png|640px]] | ||
=== If the person doesn't have Second Life === | === If the person doesn't have Second Life === | ||
The page at http://www. | The page at http://www.SLurl.com will display a link to [http://join.secondlife.com/ SIGN UP NOW for free]. | ||
From the sign-up up page, they 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. | From the sign-up up page, they 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. | Providing new users the ability to sign up for Second Life directly from http://www.SLurl.com is sometimes referred to as "Direct SLurl". 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 the person has Second Life === | === If the person has Second Life === | ||
| Line 37: | Line 37: | ||
# When they log in, they'll be at the location specified by the SLurl. | # 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 in the Second Life Viewer: | # If they're already logged in, a Place Information window opens in the Second Life Viewer: | ||
#: [[Image: | #: [[Image:SLurl-Place-Information.png|640px]] | ||
# When they click the '''Teleport''' button in this window, they'll be instantly teleported to the location specified by the SLurl. Alternatively, they can click '''Show on Map''' to display the target location on the inworld map, or close the window if they don't want to be teleported. | # When they click the '''Teleport''' button in this window, they'll be instantly teleported to the location specified by the SLurl. Alternatively, they can click '''Show on Map''' to display the target location on the inworld map, or close the window if they don't want to be teleported. | ||
| Line 54: | Line 54: | ||
The basic format for a SLurl is: | The basic format for a SLurl is: | ||
<nowiki>http:// | <nowiki>http://SLurl.com/secondlife/<region></code>/<x>/<y>/<z>?param=value¶m=value...</nowiki> | ||
Where: | Where: | ||
* <code><region></code> is the name of the destination Region | * <code><region></code> is the name of the destination Region | ||
* <code><x></code> and <code><y></code> are the east/west and north/south coordinates of the destination; <z> is the vertical (height) coordinate. | * <code><x></code> and <code><y></code> are the east/west and north/south coordinates of the destination; <z> is the vertical (height) coordinate. | ||
* The <code>?</code> and the parameters that follow it are optional and provide additional information to be displayed in the | * The <code>?</code> and the parameters that follow it are optional and provide additional information to be displayed in the SLurl.com page; see [[#Query string parameters|Query string parameters]] for more information. | ||
=== Making beautiful SLurls === | === Making beautiful SLurls === | ||
| Line 67: | Line 67: | ||
For example, say you've got an island in Second Life you want to invite people to. This base URL works: | For example, say you've got an island in Second Life you want to invite people to. This base URL works: | ||
http:// | http://SLurl.com/secondlife/Here/54/105/47 | ||
But it tells nothing about the destination. Compare this to the following: | But it tells nothing about the destination. Compare this to the following: | ||
http:// | http://SLurl.com/secondlife/Here/54/105/47/?title=An%20island%20of%20fun%21 | ||
Click on the link to to see that it provides more descriptive information. | Click on the link to to see that it provides more descriptive information. | ||
'''[http:// | '''[http://SLurl.com/build.php Use SLurlBuilder] to easily make beautiful SLurls.''' | ||
=== Query string parameters === | === Query string parameters === | ||
| Line 92: | Line 92: | ||
|To specify the window title "Come to My Island!" use <br> | |To specify the window title "Come to My Island!" use <br> | ||
'''title=Come%20To%20My%20Island''' | '''title=Come%20To%20My%20Island''' | ||
<br>For example: http:// | <br>For example: http://SLurl.com/secondlife/Ahern/50/50/50/?title=Come%20To%20My%20Island | ||
|-- | |-- | ||
| Line 98: | Line 98: | ||
|URL of image to display in teleport window. Must be a complete (absolute) URL, and preferably a small image of 256x256 pixels or less. | |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> | |To display this example image, use <br> | ||
'''<nowiki>img=http:// | '''<nowiki>img=http://SLurl.com/examples/forsale.png</nowiki>'''<br> | ||
For example: http:// | For example: http://SLurl.com/secondlife/Ahern/50/50/50/?img=http://SLurl.com/examples/forsale.png | ||
|- | |- | ||
| Line 106: | Line 106: | ||
|To specify the message text "Your text here", use <br> | |To specify the message text "Your text here", use <br> | ||
'''msg=Your%20text%20here''' <br> | '''msg=Your%20text%20here''' <br> | ||
For example: http:// | For example: http://SLurl.com/secondlife/Ahern/50/50/50/?msg=Your%20text%20here. | ||
|} | |} | ||
| Line 112: | Line 112: | ||
=== Shortening SLurls === | === Shortening SLurls === | ||
SLurls, especially if they have text and a picture included ([http:// | 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: | 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: | ||
| Line 123: | Line 123: | ||
== Further information == | == Further information == | ||
* '''[http://blogs.secondlife.com/community/community/tnt/blog/2009/10/08/whats-a- | * '''[http://blogs.secondlife.com/community/community/tnt/blog/2009/10/08/whats-a-SLurl-and-why-you-should-care What's a SLurl? ... and why you should care]''' - 2009-10-08 post from [http://secondlife.com/tnt Second Life Tips & Tricks]. | ||
* '''[[Changing your login location]]''' | * '''[[Changing your login location]]''' | ||
* '''[[Video_Tutorial/Teleport_location_history|Teleport_location_history]]''' - Video tutorial. | * '''[[Video_Tutorial/Teleport_location_history|Teleport_location_history]]''' - Video tutorial. | ||
* '''[http://blogs.secondlife.com/community/features/blog/2008/02/21/tip-of-the-week-23-using- | * '''[http://blogs.secondlife.com/community/features/blog/2008/02/21/tip-of-the-week-23-using-SLurls-for-easy-travel Using SLurls for easy travel]''' 2008-02-21 blog post and older video tutorial. | ||
* '''[[Template:SLurl]]''' - Need to add SLurls to a wiki page here? This will help! | * '''[[Template:SLurl]]''' - Need to add SLurls to a wiki page here? This will help! | ||
* '''[http://www.xstreetsl.com/modules.php?name=Marketplace&file=item&ItemID=136080 | * '''[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". | ||
[[Category:SLurl]] | [[Category:SLurl]] | ||
Revision as of 06:16, 9 December 2009
Unofficial APIs
What is a SLurl?
You can't get to a webpage without knowing its URL (Uniform Resource Locator), commonly called a "link". Just like your web browser has bookmarks, in Second Life, we have landmarks. Since our virtual world is three-dimensional, landmarks contain a Region name and 3 positioning coordinates within that region. But what happens when you want to share a landmark outside of Second Life to promote your home, business, or other place?
A Second Life URL (SLurl) 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, just click the SIGN UP link to go to a simple registration page. After registering and downloading the Second Life Viewer, you'll automatically start at the specified location. Watch this fun video tour to understand more:
<videoflash type="vimeo">1747404|640|480</videoflash>
The maps.secondlife.com and SLurl.com websites are implemented using the Second Life Map API. If you have a website, you can use it as well to embed Second Life maps on your pages, in the same way you can embed Google Maps.
How it works
Use a SLurl to direct people to inworld locations like this:
- Create a SLurl, either using SLurl Builder, or "manually."
- Share the SLurl with a person who you want to tell about something in Second Life.
- 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:
If the person doesn't have Second Life
The page at http://www.SLurl.com will display a link to SIGN UP NOW for free. From the sign-up up page, they 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 "Direct SLurl". For more information, see the announcement of Direct SLurl.
If the person has Second Life
If the Second Life Viewer is not already running, it'll 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 in the Second Life Viewer:
- When they click the Teleport button in this window, they'll be instantly teleported to the location specified by the SLurl. Alternatively, they can click Show on Map to display the target location on the inworld map, or close the window if they don't want to be teleported.
Details
On Windows, a SLurl opens the most recently installed Viewer.
There isn't an immediate way to change which Viewer launches SLurls, so if you have the current released Viewer and a Release Candidate, whichever was installed most recently will start. You can change this by reinstalling the Viewer.
Every SLurl page's SLurl title and Teleport Now button link to a "secondlife://" address, which is an URI scheme which opens Second Life. This is different from the familiar "http://" used for webpages.
 |
Tip: The reason why it's advantageous to post "http://" SLurls instead of direct "secondlife://" addresses in webpages is for the benefit of people who don't have Second Life yet. Giving them the latter 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. |
Constructing SLurls
The basic format for a SLurl is:
http://SLurl.com/secondlife/<region></code>/<x>/<y>/<z>?param=value¶m=value...
Where:
<region>is the name of the destination Region<x>and<y>are the east/west and north/south coordinates of the destination; <z> is the vertical (height) coordinate.- The
?and the parameters that follow it are optional and provide additional information to be displayed in the SLurl.com page; see Query string parameters for more information.
Making beautiful SLurls
The first step to making beautiful SLurls is adding explanatory text and a picture to give it more context and information.
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
But it tells nothing about the destination. Compare this to the following:
http://SLurl.com/secondlife/Here/54/105/47/?title=An%20island%20of%20fun%21
Click on the link to to see that it provides more descriptive information.
Use SLurlBuilder to easily make beautiful SLurls.
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 (&).
| Parameter | Description | Example |
|---|---|---|
| title | Title text to display in the teleport window. | To specify the window title "Come to My Island!" use 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 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 msg=Your%20text%20here |
Shortening SLurls
SLurls, especially if they have text and a picture included (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:
- bit.ly - Twitter's default, one of the most popular. Has stats-tracking.
- Snurl - No relation to SLurl.
- TinyURL - One of the first.
If you have a webserver with a customizable redirect, you can do something similar.
Further information
- What's a SLurl? ... and why you should care - 2009-10-08 post from Second Life Tips & Tricks.
- Changing your login location
- Teleport_location_history - Video tutorial.
- Using SLurls for easy travel 2008-02-21 blog post and older video tutorial.
- Template:SLurl - Need to add SLurls to a wiki page here? This will help!
- SLurlblogger - Useful tool by Ordinal Malaprop which "can send notes with SLurls to email, or directly to a blog".