This documentation is intended to provide all of the technical information required to install the MYOMW links/buttons/icons to your website. We have designed the application and it's pop up link to be quick and simple, while ensuring the security of the provided image files. You are not required to host or maintain any applications on your systems or servers.
We will make technical staff available to answer questions that you may have during the installation process. Certain technical specifications about the client system will be necessary to ensure that the most appropriate set up is used to achieve the desired commercial results. The Set Up coding is very simple and easy to implement.
This document is designed to help you understand the "visitors experience" in conjunction with what happens "behind the screen". There are several steps the user must follow in order to create personalised ringtones:
The visitor browse your website, looking at your image gallery. The user exeperience may vary from site to site, depending on how your image collection is organized (by categories/author/date/promotions/etc).
To help you understand where the MYOMW links/buttons/icons must be placed, you can see below an example of a fictive/generic website called "ABC Image Download" that offers digital images downloads:
As you can see, next to each image and on the "Image details" section/page, there is a link/button/icon reading "Send to phone" (or "Make mobile wallpaper", etc). For details on adding this links/buttons/icons to your website, please read below.
In this section, you get to know the requrements/instructions for adding the "Send to phone" link to your website, thus making your image catalog (or any part of it) available to the MYOMW application.
First of all, in the HEAD section of all* pages that contain links/buttons/icons to MYOMW, you will have to include the following piece of code:
<script language="JavaScript">
function myomw(iorg){
var w = 720;
var h = 570;
var ww = Math.floor((screen.width-w)/2);
var hh = Math.floor((screen.height-h)/2);
var adr = "http://www.myomw.com/index.php";
adr += "?iorg=" + iorg;
if(myomw.arguments.length == 2) adr += "&iurl=" + myomw.arguments[1];
window.open(adr, "myomw", "status=no,resizable=no,width=" + w + ",height=" + h + ",top=" + hh + ",left=" + ww);
}
</script>
To cut down the page loading time, you can save the above piece of code to a file, say "myomw.js", and then include it in all* pages that contain links/buttons/icons to MYOMW. This way, the "myomw.js" file is cached by the visitor's browser and the MYOMW code does not need to be downloaded each time a page loads. See example:
(*) Note: If your website has, say, over 50,000 images/pages you probably won't need to repeat the above actions 50,000 times. As long as your website pages are projected dynamically using PHP/ASP/JSP/etc technologies (which usually happens nowadays), you will only have to write the code once in your website, not for every image/page.
In order to start the MYOMW application when the visitor clicks on the "Send to phone" link/button/icon, you will have to call the "myomw()" JavaScript function defined above, providing the following parameters:
iorg - Affiliate ID or Organization ID
A number that we will provide you upon installation. This parameter is required in order to instruct MYOMW that the visitor is coming from your website.
iurl - The address to the actual image file
A string that will instruct MYOMW where to get actual image file (GIF/JPEG/PNG formated). This URL address should point to a medium size (under 800x600) image file.
To make sure that the image file cannot be accesed and used by the visitor (outside MYOMW), this parameter can be secured as follow:
If all image files share the same location or are dynamically served by a script on your servers, you can provide MYOMW only the last part of this URL address. As an example, if the preview files URL location look like this:
- http://www.yoursite.com/previews/image_1.gif
- http://www.yoursite.com/previews/image_2.gif
- http://www.yoursite.com/previews/another_image_3.gif
- http://www.yoursite.com/previews/{SOMETHING}
Or are dynamically served by a server-side script:
- http://www.yoursite.com/get.php?key=image_1
- http://www.yoursite.com/get.php?key=image_2
- http://www.yoursite.com/get.php?key=another_image_3
- http://www.yoursite.com/get.php?key={SOMETHING}
You can setup the common first part of the URL address in your MYOMW acccount: http://www.yoursite.com/previews/ in the first case and: http://www.yoursite.com/get.php?key= for the second example, and then send only the last part of the URL address as the "iurl" parameter.
To get the actual URL address to the image file (where the application will download the GIF/JPEG/PNG file from), MYOMW concatenates the provided two parts: the common URL part, that was setup into your account, and the last part of the URL address, specified by the "iurl" parameter, sent when the user click on the "Send to phone" link/button/icon.
Please note that this parameter is optional. If the "myomw()" JavaScript function is called with only one parameter (the Affiliate ID), then MYORMR won't know what image to process; if this is the case, the visitor will have to select an image either from their computer or from the Internet (providing the URL address of that image). MYOMW will run in the "Global Link" mode. Please refer to the "Live demo" section for details.
An example of a valid request to MYOMW would then look like as follow:
<a href="#" onClick="myomw(1234, 'image_1')">Send to phone</a>
or:
<input type="button" value="Send to phone" onClick="myomw(1234, 'image_1')">
Where the parameters have the following semnification:
1234
The Affiliate or Organization Id, provided by us upon your account installation. Please not that "1234" is a dummy Affiliate ID, used only for this example. This parameter is required.
image_1
The key or last part of the URL address that uniquely identifies the image file to be processed by MYORMR. This parameter is optional.
Once the above simple instructions are implemented into your website, you account becomes active and, when the "Send to phone" link/button/icon is clicked, the MYOMW popup should come up. Nothing else is required from your side, from now on, the application will interact with the visitor and will take over the mobile wallpaper creation process.
To create a customized wallpaper for his mobile phone, the visitor will have to follow 3 easy steps within the MYOMW popup:
Select phone model & mobile carrier
Edit (resize/crop/optimize) image
Order the newly created wallpaper
Please refer to the "Live demo" section in order to "live" the visitor experience while running MYOMW.
For further informations, don't hesitate to contact us.
Printable version