Linden Lab Official:Map API SLurl Technical Details - Revision history

Rand Linden: /* What happens when a person clicks on the Teleport button */

2012-01-17T23:23:38Z

What happens when a person clicks on the Teleport button

← Older revision		Revision as of 16:23, 17 January 2012
Line 28:		Line 28:
	# 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 ''' Map''' to display the target location on the {{win\|World Map}}, or close the sidebar 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 ''' Map''' to display the target location on the {{win\|World Map}}, or close the sidebar if they don't want to be teleported.

	=== What happens when a person clicks on the Teleport button ===		=== What happens when a person clicks on the Teleport Now button ===

	When someone clicks on the '''Teleport No'''w button in the SLurl.com page, the most recently installed Viewer starts.		When someone clicks on the '''Teleport Now''' button in the SLurl.com page, the most recently installed Viewer starts and immediately telports them to the specified location in Second Life.

	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.		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.

Rand Linden: /* What happens when a person clicks on a SLurl */

2012-01-17T23:22:46Z

What happens when a person clicks on a SLurl

← Older revision		Revision as of 16:22, 17 January 2012
Line 28:		Line 28:
	# 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 ''' Map''' to display the target location on the {{win\|World Map}}, or close the sidebar 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 ''' Map''' to display the target location on the {{win\|World Map}}, or close the sidebar if they don't want to be teleported.

	=== What happens when a person clicks on ~~a SLurl~~ ===		=== What happens when a person clicks on the Teleport button ===

	'''~~On Windows~~, ~~a SLurl opens~~ the most recently installed Viewer.~~'''~~		When someone clicks on the '''Teleport No'''w button in the SLurl.com page, the most recently installed Viewer starts.

	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.		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 "<code><nowiki>secondlife://</nowiki></code>" address, which is an [http://en.wikipedia.org/wiki/URI_scheme URI scheme] which opens Second Life. This is different from the familiar "<code>http://</code>" used for webpages.		Every SLurl page's SLurl title and '''Teleport Now''' button link to a "<code><nowiki>secondlife://</nowiki></code>" address, which is an [http://en.wikipedia.org/wiki/URI_scheme URI scheme] which opens Second Life. This is different from the familiar "<code>http://</code>" used for webpages.

	{{KBtip\|The reason why it's advantageous to post "<code>http://</code>" SLurls instead of direct "<code><nowiki>secondlife://</nowiki></code>" 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.}}		{{KBtip\|The reason why it's advantageous to post "<code>http://</code>" SLurls instead of direct "<code><nowiki>secondlife://</nowiki></code>" 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.}}

Rand Linden: /* Expected behavior */

2012-01-17T23:20:55Z

Expected behavior

← Older revision		Revision as of 16:20, 17 January 2012
Line 28:		Line 28:
	# 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 ''' Map''' to display the target location on the {{win\|World Map}}, or close the sidebar 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 ''' Map''' to display the target location on the {{win\|World Map}}, or close the sidebar if they don't want to be teleported.

	=== ~~Expected behavior~~ ===		=== What happens when a person clicks on a SLurl ===

	'''On Windows, a SLurl opens the most recently installed Viewer.'''		'''On Windows, a SLurl opens the most recently installed Viewer.'''

Rand Linden at 23:17, 17 January 2012

2012-01-17T23:17:00Z

← Older revision		Revision as of 16:17, 17 January 2012
Line 1:		Line 1:
			{{Supported API}}
	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].		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].

Rand Linden: moved Linden Lab Official:Map API/SLurl Technical Details to Linden Lab Official:Map API SLurl Technical Details

2012-01-17T23:16:33Z

moved Linden Lab Official:Map API/SLurl Technical Details to Linden Lab Official:Map API SLurl Technical Details

← Older revision	Revision as of 16:16, 17 January 2012
(No difference)

Rand Linden at 23:16, 17 January 2012

2012-01-17T23:16:24Z

← Older revision		Revision as of 16:16, 17 January 2012
Line 1:		Line 1:
	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].		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].

	~~<noinclude>~~{{:API Portal/navigation}}~~</noinclude>~~		{{:API Portal/navigation\|map}}

	== How it works ==		== How it works ==

Rand Linden: moved Map API/SLurl Technical Details to Linden Lab Official:Map API/SLurl Technical Details

2012-01-17T23:14:47Z

moved Map API/SLurl Technical Details to Linden Lab Official:Map API/SLurl Technical Details

← Older revision	Revision as of 16:14, 17 January 2012
(No difference)

Rand Linden: /* How it works */

2012-01-17T23:14:05Z

How it works

← Older revision		Revision as of 16:14, 17 January 2012
Line 7:		Line 7:
	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 within the Viewer ~~(as detailed above)~~ or using [http://SLurl.com/build.php SLurlBuilder] ~~(which as of January 2011, hasn't changed in years)~~.		# Create a SLurl, either within the Viewer or using [http://SLurl.com/build.php SLurlBuilder].
	# 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.
Line 21:		Line 21:
	=== If the person has Second Life ===		=== If the person has Second Life ===

	If the Second Life Viewer is not already running, it~~'ll~~ start.		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.		# When they log in, they'll be at the location specified by the SLurl.

Rand Linden: Created page with "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 websit…"

2012-01-17T23:12:41Z

Created page with "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 websit…"

New page

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].

<noinclude>{{:API Portal/navigation}}</noinclude>

== How it works ==

Use a SLurl to direct people to inworld locations like this:

# Create a SLurl, either within the Viewer (as detailed above) or using [http://SLurl.com/build.php SLurlBuilder] (which as of January 2011, hasn't changed in years).
# 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.
#: [[Image:SLURL-Here-example.png|240px]]

=== If the person doesn't have Second Life ===

The SLurl page (either http://maps.secondlife.com or http://slurl.com) displays a link to join Second Life.

From the signup 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 [[Welcome Island]]. A quick tutorial opens upon their initial arrival to help them get started.

=== 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, the '''Place Profile''' opens in the Second Life Viewer's sidebar.
# 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 ''' Map''' to display the target location on the {{win|World Map}}, or close the sidebar if they don't want to be teleported.

=== Expected behavior ===

'''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 "<code><nowiki>secondlife://</nowiki></code>" address, which is an [http://en.wikipedia.org/wiki/URI_scheme URI scheme] which opens Second Life. This is different from the familiar "<code>http://</code>" used for webpages.

{{KBtip|The reason why it's advantageous to post "<code>http://</code>" SLurls instead of direct "<code><nowiki>secondlife://</nowiki></code>" 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:

<nowiki>http://SLurl.com/secondlife/<region>/<x>/<y>/<z>?param=value&param=value...</nowiki>

Where:

* <code><region></code> is the name of the destination Region
* <code><x></code> and <code><y></code> are the east/west and north/south [[coordinate]]s of the destination; <code><z></code> 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 SLurl.com page; see [[#Query string parameters|Query string parameters]] for more information.

==== Query string parameters ====

{{KBnote|In Linden Lab's official showcasing of SLurls, this has somewhat been deprecated by the [[Destination Guide]].}}

You can use the [http://slurl.com/build.php SLurlBuilder] to make the following easier.

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 (<code>?</code>), and all subsequent parameter pairs with an ampersand (<code>&</code>).

{| 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 
'''title=Come%20To%20My%20Island'''
 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 
'''<nowiki>img=http://slurl.com/examples/forsale.png</nowiki>''' 
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 
'''msg=Your%20text%20here''' 
For example: http://slurl.com/secondlife/Ahern/50/50/50/?msg=Your%20text%20here.

|}

==== Shortening SLurls ====

SLurls with string parameters can get quite long and ugly. This makes them difficult to paste into places like emails, which may have line breaks that mangle the SLurl.

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://bit.ly bit.ly]''' - Twitter's default, one of the most popular. Has stats-tracking.
* '''[http://snurl.com Snurl]''' - No relation to SLurl.
* '''[http://tinyurl.com TinyURL]''' - One of the first.

If you have a webserver with a customizable [http://en.wikipedia.org/wiki/HTTP_status_code#3xx_Redirection redirect], you can do something similar.

== See also ==

Some of the below is outdated and kept for historical purposes.

* '''[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].
* '''[http://blog.secondlife.com/2008/09/18/getting-a-second-life-just-got-easier-with-direct-SLurl/ Historical Direct SLurl announcement]'''
* '''[[Changing your login location]]'''
* '''[[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-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!
* '''[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]]