How do I install or integrate the STW Preview Verification code?

11 posts / 0 new

Last post

Mon, 03/21/2011 - 19:36

puravida

Jedi Warrior

Offline

Joined: 09/01/2007

Update: The content in this post maybe out of date or inaccurate.

If you are looking for more information on what this code does and why, please read:
*** Outdated Link Removed***

Basically, there are just two steps:

First is to install the following line of code into the header* of your page(s):
<script type="text/javascript" src="http://www.shrinktheweb.com/scripts/pagepix.js"></script>
Then in the body of the page (wherever you want to show a screenshot), you just put:
<script type="text/javascript">stw_pagepix('domain.tld', 'stwaccesskey', 'stwsize', 'language', 'stwargs');</script>
*The header of your page is between the <head> and </head> tags

Legend:

domain.tld = the domain you want to show
stwaccesskey = your STW Access Key (found in the HOME/LOBBY area)
stwsize = the output size you want to show (tny, mcr, xsm, sm, lg, xlg)
[OPTIONAL] language = English (EN) is the only language currently supported
[OPTIONAL] stwargs = the pro features in a single string (i.e. &stwfull=1&stwxmax=400)
- If &stwxmax is specified, it will override the stwsize value

Basic Example:

<script type="text/javascript">
stw_pagepix('http://bing.com', 'abcdefghijklmno', 'xlg');
</script>

The code above would show the extra-large (320x200) screenshot of http://bing.com and link to the preview page automatically. It can be all on one line or separated (as shown).

Advanced Example:

<script type="text/javascript">
stw_pagepix('http://bing.com', 'abcdefghijklmno', '', 'en', '&stwfull=1&stwxmax=400');
</script>

The code above would show a custom size (400xFULL) screenshot of http://bing.com and link to the preview page automatically. If the account does not have the requested PRO features enabled, then an error image will be shown.

DEVELOPER NOTE: There is an stwhash parameter associated with the PVP method and you should NOT try to hardcode that value EVER. It will change each minute and your integration will be broken. This also means to be sure that pagepix.js is NEVER cached for performance reasons, which is common with CMS scripts. If the pagepix.js gets cached, users will most likely see "Account Problem" errors intermittently. The best way to avoid this is by using "Phantom Querystrings" (i.e. putting "?" and a timestamp on the js file).

Theming / Styling PVP Screenshot Images
If you want to fully integrate the thumbnails into your theme or style, then you can use the following CSS tag:

<style>
.stwpvp {
	border:3px dashed #333;
}
</style>

The CSS tag support was added due to user requests. As always, suggestions are welcome!

Mon, 03/21/2011 - 22:01

puravida

Jedi Warrior

Offline

Joined: 09/01/2007

IMPORTANT NOTE: The "Advanced API" method (typically used for caching images locally) will no longer be supported for non-paying accounts.

Even though our 250,000 fetches per month is plenty for 95% of users, many non-paying customers will fear that this will cause them to have to pay. However, this is not a trick to get them to pay, so we will help offset the lack of caching by doubling the default fetch limit to 500,000 per month at no charge.

Sun, 04/17/2011 - 18:57

puravida

Jedi Warrior

Offline

Joined: 09/01/2007

The PRO feature support is not live yet, but we wanted to proactively announce the format.

We should have this tested and released within the next week or two and will update this thread when it's ready for integration testing.

Several integrators are still not ready for launch, so we have delayed the PVP launch a bit. Currently, we are shooting for a May 1 go live date.

Thu, 05/05/2011 - 06:41

(Reply to #3) #4

bigmoneyweb (not verified)

I just found your site through Google. I wanted to ask you sir, Am building a new wordpress listing directory and i want to know how can i add this pluggin there so that instead of people to be attaching their website photo on it, they can only use your pluggin by typing their url and after the submission, their site will be displaying just like it was here. So how do i add at at wordpress?

Sun, 10/30/2011 - 23:55

3dom

Offline

Joined: 07/28/2008

Thumbnails usually used to click them and I don't see any way to add link into this JS. Add URL option somewhere.

Mon, 10/31/2011 - 00:51

catchpen

Offline

Joined: 12/09/2008

I was just notified today via email that I need to use this method by Nov 1 (1 day from now) or STW will stop working on my site. Yes I guess I was one of the members that never got email notifications until the last month or so. Is there anyway you can extend this deadline? This is not fair, I've been a member for almost 3 years now and have recommended STW to other webmasters. Plus I was just in an accident and can only type with one hand right now so 1 day notice isn't sufficient.

Thanks.

Mon, 10/31/2011 - 01:02

(Reply to #6) #7

puravida

Jedi Warrior

Offline

Joined: 09/01/2007

Hi catchpen,

Sorry to hear about your accident.

Unfortunately, we cannot delay any longer. This has all been in progress, delayed for far too long, and announced many times over the past several months.

However, if you open a support ticket, Frank would most likely be willing to manually upgrade your "very long time" account for a short time --assuming he doesn't get flooded with such requests. Users with newer accounts (this year, for instance) will not be able to bypass this planned & announced change.

Mon, 10/31/2011 - 13:25

(Reply to #6) #8

puravida

Jedi Warrior

Offline

Joined: 09/01/2007

@catchpen
We have been listening to our users since the announcement and discussing with many of them and amongst ourselves. We are leaning towards delaying again, after all. It's a big hassle for us, but it seems like it's best because we don't want people to feel like we're trying to coerce them into upgrading.

Ultimately, it's not OUR fault that users haven't been receiving our emails but the fact is, it's also not THEIR fault either. It's the unfair, overzealous spam filters to blame. In my 15 years in business online, I HAVE NEVER SENT SPAM, but my biggest headache has always been the spam filters.

Anyway, stay tuned. We will most likely make a follow-up announcement to buy folks some time. And we will be refunding the flood of upgrades that came in, for those that want one.

Tue, 11/01/2011 - 21:19

(Reply to #9) #9

catchpen

Offline

Joined: 12/09/2008

Thank you sir, you're truly are a Jedi Warrior.

Mon, 10/31/2011 - 07:21

#10

megapedia

Offline

Joined: 02/17/2011

Hy puravida

I don`t understand how to put this code on my web directory http://megapedia.ro , sorry about the link, the script for this directory is freeglobes,i put the code for screen shot manually, but this code I take this code with headache.
I have a pannel administration there i put the old code manualy, for each website
This code if i put overturns the wholle website

Then in the body of the page (wherever you want to show a screenshot), you just put:
<script type="text/javascript">stw_pagepix('domain.tld', 'stwaccesskey', 'stwsize', 'language', 'stwargs');</script>

Please respond

Soryy about the english i`m romanian

Mon, 10/31/2011 - 13:26

(Reply to #8) #11

puravida

Jedi Warrior

Offline

Joined: 09/01/2007

Don't worry about the English. We can use Google translator if we need to, but your English is good enough.

However, for technical issues, please open a support ticket.

How do I install or integrate the STW Preview Verification code?

Exclusive PRO Features

Website Screenshot Plugins

Helpful Documentation