Recommended Setup

We recommend centralizing the Pickle files on both your local machine and your server.

In the example to the right, we've created a folder called "pickle" on the "root" of our website, which would be accessible with the following "absolute" URLs:

and:

(The first character "/" is like saying "start from the root").

The benefit of using the "start from the root" shorthand is that sometimes people visit your website without using the "www" sub.domain. Example:

Under certain circumstance, URLs to images or media files can get blocked because there may be a discrepancy between specified file locations. Where one file is requested from the "www" subdomain, and the other request is not using the "www" subdomain.

So to avoid any number of security features installed either on the web server, or the clients browser, using the "/pickle/ shorthand alleviates these kinds of security problems.

Media Files

Media files can be located anywhere throughout your site (they do not have to be located within the Pickle Installation Folder).

In our example to the right, you can see that we've set up a "media" folder on the root of our site, which will make things easier to deal with when we enter URLs to media files.

For example, we can use the shorthand:

... to load up the media file, which will allow that file to load up on any page throughout our site.

Skin Files

By default, skin _PREVIEW.html files are set up to use "relative" URLs to pickle.js and the stylesheet.css in the form of:

We've done this for the following reasons:

1. We're assuming that you're using the recommended setup, where the Pickle Installation Folder contains a sub-folder named "skins"

2. We're assuming that any new skins you create will eventually be placed in the "skins" sub-folder within the Pickle Installation Folder.

3. Because the Pickle Installation Folder is not required to be named "pickle" and because we don't know your domain name, we had to use relative URLs so the the _PREVIEW.html file could actually get wired up to the Pickle Engine and an example media file.

Local Pickle Files

Likewise, we recommend establishing a Local Pickle Folder on your PC which mirrors your setup on your web server.