User Tools

Site Tools


developer_center:articles:nightingale_protocol_handler

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

developer_center:articles:nightingale_protocol_handler [2012/07/05 06:11]
geekshadow
developer_center:articles:nightingale_protocol_handler [2014/07/08 07:33] (current)
geekshadow change nightingale: by ngale:
Line 1: Line 1:
 ====== Introduction ====== ====== Introduction ======
  
-Web developers often have visitors viewing their site in their default web browser (Firefox, Safari, etc.) but may wish to redirect a link to open inside Nightingale. ​ For instance, music blogs or stores may wish to have users view their site within Nightingale to utilise Webpage API features, or Nightingale'​s media-scraping features. ​ In order to support this,  Nightingale 1.8.1 and higher will register a [[nightingale://|nightingale://]] protocol handler with the operating system to enable webpages to redirect links to open within Nightingale. ​ The exact format looks like:+Web developers often have visitors viewing their site in their default web browser (Firefox, Safari, etc.) but may wish to redirect a link to open inside Nightingale. ​ For instance, music blogs or stores may wish to have users view their site within Nightingale to utilise Webpage API features, or Nightingale'​s media-scraping features. ​ In order to support this,  Nightingale 1.8.1 and higher will register a [[ngale://|ngale://]] protocol handler with the operating system to enable webpages to redirect links to open within Nightingale. ​ The exact format looks like:
  
-  ​nightingale:<​command>?​value=pair&​value=pair+  ​ngale:<​command>?​value=pair&​value=pair
  
 Of course, if the user doesn'​t have Nightingale installed, then no protocol handler will have been registered. ​ To remedy this, the Nightingale website will have a Web Launch Redirection service to facilitate Nightingale detection. ​ The Web Redirector will attempt to detect whether the user has Nightingale installed (by use of a cookie installed from the Nightingale download page, or by sniffing the user-agent to see if the user is already within Nightingale ), and forward the user through (depending on the command), or will prompt the user to download and install Nightingale. Of course, if the user doesn'​t have Nightingale installed, then no protocol handler will have been registered. ​ To remedy this, the Nightingale website will have a Web Launch Redirection service to facilitate Nightingale detection. ​ The Web Redirector will attempt to detect whether the user has Nightingale installed (by use of a cookie installed from the Nightingale download page, or by sniffing the user-agent to see if the user is already within Nightingale ), and forward the user through (depending on the command), or will prompt the user to download and install Nightingale.
Line 25: Line 25:
  
 The following example would cause a new tab to open in Nightingale,​ loading http://​libre.fm/​ The following example would cause a new tab to open in Nightingale,​ loading http://​libre.fm/​
-   nightingale:​open?​url=http%3A%2F%2Flibre.fm ​+   ngale:​open?​url=http%3A%2F%2Flibre.fm ​
  
 ====== Web Launch Redirector ====== ====== Web Launch Redirector ======
-Of course, the [[nightingale://]] protocol handler is only effective if Nightingale is installed. ​ To facilitate this, Nightingale'​s website provides a Web Launch Redirector at http://​launch.getnightingale.com free for any web developer to use.  You can construct a link to look like:+Of course, the [[ngale://]] protocol handler is only effective if Nightingale is installed. ​ To facilitate this, Nightingale'​s website provides a Web Launch Redirector at http://​launch.getnightingale.com free for any web developer to use.  You can construct a link to look like:
    ​http://​launch.getnightingale.com/<​nightingale_PATH_INFO>​    ​http://​launch.getnightingale.com/<​nightingale_PATH_INFO>​
-The URL to redirect to should be a [[nightingale://]] URL in the form of one of the above valid commands. ​ For instance, to provide a link to the Web Redirector to launch a new tab open to http://​libre.fm,​ the link should look like:+The URL to redirect to should be a [[ngale://]] URL in the form of one of the above valid commands. ​ For instance, to provide a link to the Web Redirector to launch a new tab open to http://​libre.fm,​ the link should look like:
    ​http://​launch.getnightingale.com/?​url=http://​libre.fm/​    ​http://​launch.getnightingale.com/?​url=http://​libre.fm/​
-   nightingale:​open?​url=http://​libre.fm/​+   ngale:​open?​url=http://​libre.fm/​
 If the user doesn'​t have Nightingale installed, then they will be prompted to download and install Nightingale by the launch.getnightingale.com site. If the user doesn'​t have Nightingale installed, then they will be prompted to download and install Nightingale by the launch.getnightingale.com site.
  
developer_center/articles/nightingale_protocol_handler.txt ยท Last modified: 2014/07/08 07:33 by geekshadow