JustSo PictureWindow 3

Faq

These FAQs are based on your actual questions. I'll add more as they come in.

Is there a way to add an href link to a caption?: Sure, just type this into the Caption text field of jspw3's UserInterface: click <a href="http://www.alistapart.com" target="_blank">here</aNote that this example uses the target parameter, which is now w3c deprecated. But it is useful if the popup window is too small to display the new page nicely since it opens a new larger browser window (actuallly the size of the original browser window that called the popup.)

Also, you have to disable "click-to-close" and so might want to add a close button to the popup.

If you are using target="_blank", then you might then also want to make the popup Auto-close after some number of seconds so the jspw3 popup disappears while the user is viewing the new page.

Finally, you can then control the style of the linked text in the css file jspw3.css, e.g. .caption a:link, .caption a:visited { color: #F96; text-decoration: none; }
.caption a:hover { color:#C60; }
Can I jazz up the appearance of my Caption?: Sure you can! Here is just one example of what can be done with a caption - with the html below entered into the caption text field on the Caption tab of the UI to yield this caption:

<big>Here is the title</big>Description here - its css can be set by the UserInterface asdf asdf asdf sdaf sdaf sadf asdf<small> - Edgar Allen Poe</small> And these changes in its vwd_jspw3.css file: .caption {
color: #666666; /* set by UI - alter but do not remove */
background-color: #F4E9CC; /* set by UI - alter but do not remove */
line-height: 26px; /* set by UI - alter but do not remove */
font-family: Verdana, Arial, Helvetica, sans-serif;
font-size: 12px;
text-align: center;
padding-left: 20px;
padding-right: 20px;
}

span.captionText{
/* padding-left: 20px;
padding-right: 20px;*/
}

td.caption big {
font-size: 16px;
color: #03A;
display: block;
font-weight: 600;
}

td.caption small {
font-size: 9px;
display: block;
font-style: italic;
float: right;
}
In what browsers has Jspw3 been tested?: Jspw3 seems to work well in all these browsers, with any quirks noted below: (Thanks to Peter Parnaby for much of this information. If you find others that work, or that do not, please let me know!)

WinXP:
Mozilla 1.2.1 Netscape 7.01, 4.x
IE6.0
Firefox 0.8-1.04
Opera 7.5 with "echo" glitch, see below. v7.2 with one other glitch, see below.
(Opera 8.0, just released, has a bug - which we have reported and is now in the queue to be fixed - that makes jspw3 fail after the first popup is closed on a page. See the test case for why this happens (open it in Opera 8!.) Thanks to Frank Lindbeck for making me aware of this. Also, in Opera 8 by default the popup opens using the Browser window as it position reference rather than the entire screen so a large image may well extend off the bottom of the user's screen.)

Win2k:
Mozilla 1.2.1
Firefox
Netscape 4.x, 6.1, 7
Opera 5.12, 7.01
IE6.0

Windows 98:
IE 4.72 (fine on SERVER; fails on LOCAL machine)
5.0

Mac OS 9:
Netscape 6.1*, 7
Netscape 4.x although click-to-close fails.
IE 5.x*
Opera 6.03 *windows don't resize to fit screen

Mac OS 8 :
Netscape 4.x although click-to-close fails.
IE 4.01*, 4.5, 5.0 and 5.2

Mac OSX:
IE 5.2 (Fine on SERVER; trouble with commas in captions on LOCAL machine)
Safari 1.x
Netscape 7.1
Camino 0.7
Opera 6.03* windows don't resize to fit screen (preferences control this)
Mozilla 1.6*

* = tested on server (online), not tested locally.
How large an image should I upload to my server?: The higher the monitor res, the smaller its pixels. So, it follows that a 200 pixel wide picture will be smaller on a hi res monitor than on a low res monitor.

So, if you want users of nice monitors to see a big image, you need to upload a big image (meaning e.g. a 1000 px wide image instead of a 600 px wide image) which sure makes sense right?

Now, what jspw3 does, well let me say first what jspw3 does NOT do, is make an image *larger* to fit the screen. Rather it makes the image *smaller* to fit onto a low res monior. What that means is that if you have a 1000px wide image on the server, and a user has but an 800 px wide monitor, jspw3 will shrink the image down to 800px in width (actually less than 800px to deal with the "browser chrome") so it will all be visible without scrollbars.

But now a hard fact: realize that the number of bytes the low-res monitor user must download is still the same as for the hi res monitor, so the load time will be the same, it's just that the image is *displayed* smaller. So it would not be a good idea to serve hugely enormous images unless you are certain all your users have T1 lines! So it is good to compromise.
Can I add a border around the image in the popup?: Sure, just add a bit of css code to the jspw3.css file: .tblimg img {
border: 1px #CCCCCC solid ;
}
Help ! The Jspw3 entry in the Behaviors Window is grayed out !: An image's <a> tag, or an imagemap's <imagemap> tag must be selected first. Simply follow steps 1, 2, and 3 on the How-to page.
Can I use jspw3 in ServerSide Includes?: Its design prevents jspw3 from being used in a Server Side Include (SSI) file UNLESS that Included file is in the very same directory as the main document (this so the paths to files will be the same).
Can I make Jspw3 work in Library Items?: Jspw3 DOES work in a Library item - if you add the proper scripts to the Head of the main document (easily done by adding a jspw3 behavior to the main document) rather than to the Library item, and then have only the object with its jspw3 function call be in the Library item itself. So for example the Library item would look, in its simplest form, like this:<a href="javascript:;" onClick="jspw3('../vwd_scripts','../sub/imagename.jpg','1,,0,,a,alt ,0,0,,0,420,440,0,,,,,,0,,1.4.0.');return document.MM_returnValue">text or image</a>
Does Jspw3 REALLY protect my images from theft?: It is not possible to protect against someone who really wants to steal your image. For example: Right-clicking on the popped up image is permitted in N4.x (only 1% of users) even with click-to-close ON. (Code that had been added to prevent this actually crashed the browser on the Mac.) And on some Mac OSs it is apparently always possible to click-drag (or somesuch) to steal images. On the PC, anyone with a rudimentary knowledge of their browser can figure out how to get to your popped image despite all the built-in protections of jspw3. Bottom-line - it is NOT possible to secure your images when they are posted online. We can only make it more difficult for the majority of users. See more about this.
In Opera7 there is an "echo" of the jspw3 popup window!: A frustrating glitch in this browser is that an echo of the image and caption appear in the popup the second (and subsequent) time a particular popup is opened. The echo disappears if you slightly resize the popup. If you know of a cure for this. do let me know! (programmatic resizing of the popup fails to exorcize the ghost the way manual resizing does, fyi)
Must Opera users set their preferences to "Prefer separate windows" ?: This was true for Opera 7.2 but is no longer a problem with Opera 7.5. They fixed it!
My Caption fails in Opera7: Captions containing '/' choke Opera when viewed LOCALLY, but work fine when viewed on the SERVER - so not a problem, just a heads-up so you don't worry about this during local testing.
Can Jpsw3 be added to Templates?: Occasionally when I apply jspw3 twice or more to a DW template, Saving results in a VERY prolonged hourglass - but with patience an alert message eventually appears telling me DW was unable to update the behavior and to remove it to try again. You can ignore this message - turns out jspw3 IS applied correctly and all is well.) Also know that you CAN NOT use LOCAL-CSS FILES or EXTERNAL CAPTION FILES with templates or nested templates (unless you are willing to do some hand-coding outside DW).
Can Jspw3 be added to Child pages of Templates?: Sure, but Templates created in DW4 are always a challenge to Extension developers. Because those pages lack an important Editable Region in the document's Head, adding behaviors to the page can be problematic. The best thing to do here is to manually add the missing Head tags. Add this code to the Head of the DW4 Template: 
 Save the Template, updating all its Children. Now you can add jspw3 behaviors (and any other javascripted behaviors) - whether by using jspWindow3, jspwTo3 or jspAlbum3 - to the Children with ease!
.
My jspw3 popup is not showing a very short image nicely.: Turns out that many browsers, other than IE, do not properly handle the position of the image within a popup whose total height less than about 140 pixels. So if your image height is below 140 pixels or so, be sure to use a Hug Margin such that ImageHeight+2(Margin) >= 140.
In what languages will Jspw3 work?:: Like many of my Extensions, jspw3 will likely only work with the latin charset (charset=iso-8859-1). If you have good or bad news on this score - please let me know. Bad: Cyrillic fails, Japanese fails. Also single report that in his Spanish version of DW 7.01 the jspW3 UserInterface does not work at all. Do any other users of that version of DW have such trouble?
Some of my Jspw3 behaviors fail to work in Netscape 4.x: Netscape 4.x does not tolerate spaces in path names: Neither the folders in the path nor the imagename itself may have a spaces if you wish to support Netcape 4.x. You can replace the space with an underline (_) if you wish.
Can I make the thumbnails larger (smaller) ?: At line 155 of yoru equivalent of my C:\Documents and Settings\emb\Application Data\Macromedia\Dreamweaver 8\Configuration\commands\jspA3.htm: <td nowrap valign="middle" >
<select name="thumbsize">
<option value="36"> 36 x 36 </option>
<option value="72"> 72 x 72 </option>
<option selected value="100"> 100 x 100 </option>
<option value="144"> 144 x 144 </option>
<option value="166">166 x 166</option>
<option value="200"> 200 x 200 </option>
</select> Simply add this just before that closing </select>(substitute your desired thumb size for my 230): <option value="230"> 230 x 230 </option>
How can I change the default Event from onMouseover to onClick() ?: In the Behaviors Window, click on the + icon, and then at the bottom (at least on the PC) you'll see "Show Events for..." or the like. Select that and then choose "Version 4+ browsers". (You must now be on "Version 3," and those browsers did not support the onClick() event.) From now on, "onClick()" will be the default Event.
Windows SP2 is blocking the popups!: Both JavaScript and Flash will be blocked when you preview a local file in Internet Explorer - but the page will display normally when viewed on the internet. If you wish, and if you can accept the risks of disabling this important security feature of SP2, you can enable the preview of local Active Content by:

1. In IE, Choose Internet Options/Advanced tab
2. Scroll down to the Security Heading
3. Check the box labeled: "Allow active content to run in files on my computer."
4. Restart Internet Explorer.