|home | manual | premium service | open source download | forum | contact us|
wIMG stands for web <IMG>. wIMG is a free system that can show a picture of any webpage in a variety of sizes and styles. Example
Simply append the URL of the webpage that you want to show after
This will work with any URL starting with http:// or https:// that does not contain a pound character (#).
If you use this method with an URL that contains a pound character, the part of the URL that is after the pound character will be ignored (this is because what is after the pound in an URL is not sent to the server by the browser). In order to use display an URL that contains a pound character correcty you must provide the URL url-encoded and mention it in the options. like in this example:
click here to use the URL encoder/decoder
wIMG images and every service are available both in regular HTTP or HTTPS (SSL secure connection) for free. So you can use all of our services on your HTTPS webpages without breaking your security.
When a screenshot for a webpage is requested, the system verifies in its memory to see if it already has a picture for this URL and if yes, displays it.
However, if a screenshot for the requested webpage is not found, the system will add the URL of the webpage to the "queue" and instead of the screenshot of the requested webpage (which is not yet available) it will show a picture that contains textual information about the lenght of the queue and the position of the requested screenshot in the queue.
As soon as a new URL is entered in the queue it will stay there until it has finished its process, the user does not need to keep the image opened for the process to complete.
The wait in the queue could last from a few seconds to several minutes depending on the current state of the queue. When the requested screenshot finishes going through the queue and gets shot the picture is placed in the library and becomes available, next time the image at the exact same url is loaded, it will now display the actual requested completed screenshot.
The screenshot of this webpage will then be kept in the server for a certain amount of months on the server and will also be re-shot every once in a while.
The wIMG Integration Tools allow you to efficiently integrate wIMG in your website without having to code anything, we did all the coding for you.
When you try to show a webpage screenshot with wIMG, but there is no picture for that webpage yet, wIMG will need to queue the screenshot to be taken first. So at this point the picture will show information explaining that the image is queued and giving the position in the queue instead of showing the actual screenshot which is not ready yet. And when that happens the picture will actually reload itself as long as the image is still queued, but it will stop reloading when the image is ready, it will also not reload in case of an error. So that is pretty convenient but while this works when the image is loaded alone in the browser, it does not appear to work when the image is embeded on a HTML page with an <IMG> tag. It appears that the src of an <IMG> tag is not able to reload itself!! but the src of an <IFRAME> can. And that is why we have created this simple iframe mode, by setting wIMG to be in iframe mode the resulting screenshot will be a small webpage instead of a PNG image and all you have to do is embed it in your site with an <IFRAME> tag instead of an <IMG> tag. The result will look exactly the same but in case a screenshot on the page is not ready it will not only show *next time you reload the page, but it will instead come up on its own as soon as its ready whitout needing for the user to reload the page. It will also keep showing updated information about the queue process until the image is ready. Example
To use the Auto-Reloading Iframe Mode, simply add the options "mode" with "4" or "iframe" for value in your wIMG URL.
Since the result will be an iframe and not an image, it needs to be placed in an <iframe> tag on your page instead of an <img> tag.
Also because an <iframe>does not automatically adapt to the dimensions of its content like an <img> does, it is necessary to specify the desired image dimensions both in the attributes of the <iframe> and in the options of the wIMG URL.
And finally for this to actually look as good as an actual picture, you should also specify a few extra style attributes on your <iframe> tag, such as no scrolling and no borders.example:
Note that you can also still use all the options of the basic wIMG system.
By default, the image in the iframe will be a link to the actual page shown in the image and it will open in a new window. But you can change or remove the link and change it's target by using the options specific to the Auto-Reloading Iframe Mode
These Options apply to the Auto-Reloading Iframe Mode. The options of the Auto-Reloading Iframe Mode are specified like normal HTTP GET variables (in the URL after the ? like http://test.com/test?test=1&test=2&test=3). For this reason not only the values of these variables must be URL-encoded but the URL of the main wIMG request must be URL-encoded as well and it must be specified in the wIMG options.
You can place this HTML code virtually anywhere in the HTML of a page (It will work either in the <head> or in the <body> tag) and the wIMG Link Previews will automatically appear on certain or all of the links on the page depending on the selected options.
The example above will place a Link Preview on all the links on the page and sets the default size to the smallest. You can change the values of the variables in the "options" section of the code to make a more specific selection of links to be previewed or to change the default size. I believe that the option names are rather self-explanatory, but just to be sure the following paragraph will explain in detail each of these options.
By default the Link Previews script will add previews to links matching the selection on page load. If you want the script to add previews to links matching the selection that appear on the page after the page has finished loading (example, ajax content) you can do it by calling the wimg_putpreviews() function (this function takes no arguments).
The wIMG service is available to all for free, with all of its options and without any restritcion. But for the purpose of making wIMG a viable business model that can survive, wIMG offers two levels of service; The free service and the "Premium service". While the free service displays a wimg.ca signature in the corner of each screenshot, the Premium service does not. Additionally elements queued by the Premium service are given priority in the queue.
The code to use either the free or the Premium service is the same; instead wIMG looks at the domain on which the screenshot is requested to decide if the screenshot should be signed or not. If the domain is registered to the Premium Service, then the signature will be omitted. The signature will also be ommited if the referer is blank. So that means that if your browser has some addon that blanks the referer, the signature would never display for you, even on websites that are not registered to the Premium service. But keep in mind that most browsers do transmit the referer correctly, so most visitors will see the signature on websites which are not registered. Note also that since no change in the code is required, you can start by using the free wIMG service and register to the Premium service later, that will cause the signature to stop appearing without requiring you to change anything on your site and your requests to start being prioritised in the queue. Also if you are using the Premium service and your subscription expires, the worst that can happen is the signature will start showing and you will wait a bit longer in the queue, the screenshots will always continue to work the same.Click here to sign up your domain for the wIMG Premium Service.