Getting Started with WURFL Cloud

Introduction

Welcome to the WURFL Cloud Client! This is your interface to the WURFL Device Description Repository (DDR) which contains detailed definitions for thousands of mobile devices.  With it, you can build a mobile website that functions across all mobile platforms including smart phones, feature phones, tablets, and game consoles. Using the WURFL Cloud Client is simple and all that is needed is a few lines of code to query the DDR which will return the latest device definition. By using the device definition you can then generate the appropriate markup to create an optimized mobile experience for your visitors. The WURFL Cloud Client is currently available for PHP, Java, .Net, Ruby, Perl, Python and Node.js environments.

Create an Account

A WURFL Cloud account lets you access the most up-to-date WURFL Device Description Repository. There are 2 plans to choose from: WURFL Cloud Lite and WURFL Cloud. Pick the one that best meets your needs.

1. Go to /www.scientiamobile.com/cloud and click the “Sign Up” button below the plan you would like to purchase. The Cloud Lite and Cloud plans use a cookie-cache method on the device. The Cloud plan use server side cache and allows you to look in the cache for a detection of a similar device before going to the WURFL Cloud. Whereas the free plan must go to the WURFL Cloud for every new device request.

screenshot_AccountSettings

2. Complete the Sign Up form and click the “Complete Order” button. If you are signing up for the WURFL Cloud Lite plan you will not need to provide any credit card information.

Important Note: Subscribers to the WURFL Cloud Lite plan should be aware that the operation of the service involves a substantial investment and that ScientiaMobile offers Free Accounts at a loss as a public service to the hobbyist, non-profit, micro-business, and similar communities. While there is no requirement that you certify you belong to such a community, we request you consider purchasing an account if your website is a significant source of revenue generation.

You are not allowed to open more than one free account for yourself in your individual capacity or more than one free account for any other person or entity, even if you or such other person or entity operate multiple distinct websites.

SignUpPage

3. You will receive a confirmation email from ScientiaMobile which will contain a link to activate your account. Click on the link to activate your account and you will then be directed to the “Account Settings” page.

Screenshot

 

Cloud Client Installation

The next step is to download the WURFL Cloud Client software. This software is available for most development environments.  To get the software, click on the “Download Client Code” button on the “Account Settings” page and select the version you wish to use.  You will be directed to the appropritate GitHub repository for your specific development environment.  Follow the instructions on the ReadMe. The system requirements are also listed here.

After you download the WURFL Cloud Client software you need to configure it and add it to your project. The way that this is done will vary depending on which version of the software you downloaded and what software development tools you use.  Within each repository, we provide instructions on configuration options, example code, and useful testing resources.

Note: You will need to set your API Key within your WURFL Cloud Client to access the WURFL Cloud Service. Your API Key section can be found in the API Key section of your Account.

API

Additional Help

For additional help you can visit the following sites:

ScientiaMobile Forums: http://www.scientiamobile.com/forum/
ScientiaMobile FAQ: http://www.scientiamobile.com/page/faq