Integrating the Vringo
Widget and Vringo Bookmark into your system

The Vringo Widget and Bookmark allow the website developer to easily integrate Vringo's ability to:

  • Enroll users in the Vringo Service (including sending them an installation link via text message)
  • Add existing Vringo content to a user's Vringo collection
  • Import new content from a partnering site into a user's collection.

The following examples show how to integrate the Vringo Widget to perform these tasks.

Basic Widget Operation: Using the Vringo Widget to enroll a new user into the Vringo Service (including sending them an installation link via text message).

Just add the following code to your page in the location you want the widget to appear. Make sure that you have a space of 550hX70w pixels on your page for the fully opened widget.

<script src="http://www.vringo.com/widget/vringothis.js" type="text/javascript"></script>

The widget when closed will appear like this:

And when opened, the widget will appear like this:

If you would like the Vringo widget to begin in the opened configuration, you can simply specify an additional parameter (vringo_start_open) to the widget like this:

<script type="text/javascript">
vringo_start_open = "1";
</script>
<script src="http://www.vringo.com/widget/vringothis.js" type="text/javascript"></script>

In order to provide tracking information for registrations with Vringo, vringo may provide you with a referrer parameter. This can be specified with the parameter (vringo_referrer) like this: 

<script type="text/javascript">
vringo_referrer = "abc123";
</script>
<script src="http://www.vringo.com/widget/vringothis.js" type="text/javascript"></script>

Advanced Widget operation: Using the Vringo Widget to enroll a user to the Vringo Service AND add content to their account.

In this case the widgets will appear exactly as above.

A. When the content is existing Vringo content, you will need to get a Vringo Clip ID from the system. You can then specify that clip to the system by adding an additional parameter to the widget like this (assuming the clip ID in this case is 123):

<script type="text/javascript">
vringo_clip_id = "123";
</script>
<script src="http://wwww.vringo.com/widget/vringothis.js" type="text/javascript"></script>

B. When the content is not yet part of the Vringo system, you can specify the clip using a URL (vringo_content_url) and give the clip a title (vringo_userclip_title). The Vringo system will retrieve the content from the remote location and import it into the user's collection. The next time the user's phone synchronizes with the Vringo system, it will retrieve the new clip and make it accessible via the Vringo Mobile Client. The Vringo system can process many standard including GIF and JPG images, along with MPG, MP4, AVI, MOV, WMV, 3GP, 3G2 and FLV video formats.

<script type="text/javascript">
vringo_content_url = "http://www.myserver.com/videos/video.3gp";
vringo_userclip_title = "A great new clip";
</script>
<script src="http://www.vringo.com/widget/vringothis.js" type="text/javascript"></script>

Bookmark Widget

The bookmark widget is designed for sites that want to minimize the amount of screen real estate that the bookmark comprises. This widget uses only a 20X20 pixel area on the screen:

When the bookmark is clicked, however, it will open up a layer on top of the screen with the same functionality as the Vringo Widget above. The semantics are only slightly different (difference in bold):

<script src="http://www.vringo.com/widget/vringobookmark.js" type="text/javascript"></script>

All parameters used above are also valid with the Vringo Bookmark widget.