1. Home
  2. How to launch SureFox from other apps on iPads and iPhones?

How to launch SureFox from other apps on iPads and iPhones?

KB ID: 42G2103892
Views: 116
Updated: May 2021

With SureFox App Scheme, it is possible to launch SureFox from another app, and by providing an URL after the scheme, SureFox will launch and open the URL. The URL will load if it’s in the list of allowed websites, else an error page will be shown.

SureFox can be launched using three ways:

1.  By using Safari or an app that can open URL’s

2.  By using UIApplication class’s OpenURL method at the required location in your app

3.  By passing the URL’s with scheme as surefox:// for SureFox and surefoxlite:// for SureFox Lite

1. Using Safari to launch SureFox:

In the iOS device’s Safari address bar enter surefox:// for SureFox or surefoxlite:// for SureFox Lite.

To launch SureFox and open a specific website enter the URL as below. 

surefox://www.yourwebsite.com for SureFox and surefoxlite://www.yourwebsite.com for SureFox Lite.

Some more examples:

•  If the Allow Sub-Domain option is Enabled in SureFox settings, then for a website www.yourwebsite.com admin can use the URL as shown below.

  • surefox://yourwebsite.com
  • surefoxlite://yourwebsite.com

or

  • surefox://mail.yourwebsite.com
  • surefoxlite://mail.yourwebsite.com

•  If Allow Sub-Domain options is Disabled then sub-domain has to be mentioned: Examples mentioned below.

  • surefox://www.yourwebsite.com
  • surefoxlite://www.yourwebsite.com

•  If Allow only this URL is enabled for http://www.yourwebsite.com/abc, then the URL in Safari has to be as shown below.

  • surefox://http://www.yourwebsite.com/abc
  • surefoxlite://http://www.yourwebsite.com/abc

•  If you wish to give the scheme of the URL as well then it can be done by following the below convention.

  • surefox://http://www.yourwebsite.com
  • surefoxlite://http://www.yourwebsite.com

2. Using the OpenURL method in your app:

To launch SureFox from another app, it is necessary to use the UIApplication class’s OpenURL method at the required location as shown below.

Calling this method simply launches SureFox/SureFox Lite

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:@“surefox://“]];

or

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:@“surefox://“]];

In case of website, http://www.yourwebsite.com added in SureFox Allowed Websites, call the method in these formats when

  • Allow Sub-Domain is enabled.
[[UIApplication sharedApplication] openURL:[NSURL URLWithString:@“surefox://www.yourwebsite.com”]]

or

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:@“surefox://mail.yourwebsite.com“]];

or

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:@“surefox://yourwebsite.com”]];

or

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:@“surefox://http://yourwebsite.com”]];

or

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:@“surefox://http://www.yourwebsite.com”]];

or

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:@“surefox://http://mail.yourwebsite.com”]];
  • Allow Sub-Domain is Disabled
[[UIApplication sharedApplication] openURL:[NSURL URLWithString:@“surefox://www.yourwebsite.com”]];

or

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:@“surefox://http://www.yourwebsite.com”]];

3. By Passing the URL in links with prefix as surefox:// or surefoxlite:// :

If it requires that a link be opened in SureFox, the URL must be edited to include prefix as surefox:// or surefoxlite://

Example: If the link is http://www.yourwebsite.com, edit it to surefox://http://www.yourwebsite.com to open it in SureFox.

For more details on our products, click here 
If you need further assistance, please submit a ticket here