How to launch SureFox from other apps on iPads and iPhones

With the 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; otherwise, an error page will be shown.

Purpose

The purpose of this knowledge article is to provide a guide on how to launch SureFox from other apps on iPads and iPhones.

Prerequisites

SureFox can be launched in three ways:

• By using Safari or an app that can open URLs.
• By using the UIApplication class’s OpenURL method at the required location in your app.
• By passing the URLs with schemes such as surefox:// for SureFox and surefoxlite:// for SureFox Lite.

Steps

Step 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 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 at www.yourwebsite.com, the 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-domains have to be mentioned: Examples are 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

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

This method simply launches SureFox or SureFox Lite.

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

                         OR

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

• 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”]];

Step 3: Pass the URL in links with a prefix such as surefox:// or surefoxlite://

If it requires that a link be opened in SureFox, the URL must be edited to include a prefix such 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.

Need more help? Here’s how to get help from our experts. 

CONTACT US