1001 Postcards Love Love Love Meep Meep ZenZodiac DailyQuotation

The soul of a woman lives in love.

- LYDIA H. SIGOURNEY (1791-1865)

cpshop faq



why cpshop?




installation guide

using cpshop as your site's homepage

using cpshop filters

using cpshop hooks




download area (password required)




Please note: As of Friday, May 3, 2013, cpshop is officially retired, and is no longer for sale. details

Q. I just ordered cpshop. How long until you send it to me?

A. Okay, first things first: did you send me an , telling me which email address you want me to send the script to? If not, go ahead and do it now. I'll wait.

Ho hum.

Anyway, it's not automated, so typically you'll get it the next time I check my email, which is pretty often. The only time I usually take more than a couple of hours is when I go away for the weekend. Then you could conceivably have to wait until I get back, though I usually try to check my mail at least twice a day. (And keep in mind that I tend to get up pretty late, and stay up pretty late, Pacific Time -- so you might need to factor that into the equation.)

Q. I have two bazillion stores. (Okay, 326.) Can cpshop support that many?

Well, I don't know about two bazillion. But it can definitely support umpteen stores, and maybe even a gajillion.

Er...well actually cpshop can support a lot of stores, even though you probably wouldn't want to try to manage 326 stores with the admin screen. Instead, cpshop will accept a standard text file, formatted with one store ID per line. And here's how:

  1. Get out your trusty text editor (I recommend TextPad, but you can use Notepad or whatever), and create a new file called "cpshop.cgi.stores". (Rename it accordingly if you've renamed your cpshop.cgi file.)
  2. The important thing to know now is that each section of a line represents one of the text boxes you'd normally fill out on the admin screen. Each line represents a storefront entry. So you'd put all this on one very long line:

    [Store ID] |||| [Name] |||| [Caption] |||| [Keywords] |||| [Description] |||| [Alias]

    So an example line would be:

    mystore001,mystore0002 |||| Cat Gear |||| For cat lovers! |||| cat gear,cats,kittens,felines |||| Cat Gear: A store for cat lovers. |||| catgear

  3. When you've finished adding stores, upload the cpshop.cgi.stores file into your cpshop directory.
  4. Test your store!
Anytime you need to make changes, just edit the cpshop.cgi.stores file, and re-upload it.

Q. Where can I find more information on the filters feature?

A. You can find a fairly in-depth explanation on the using cpshop filters page.

Q. I set up my copy of cpshop, and I can't get the shopping cart "Keep Shopping" link to work correctly. When I press it I get my "Main Store Loading" page, but it just stops there. What's wrong?

A. Go back and make sure you entered your dummy store script tags correctly. If you've triple-checked them, make sure you've got javascript turned-on in your browser.

Q. Can I remove the cpshop link at the bottom of the generated pages?

A. No, that link must remain in the script at all times. I'm selling the script for a really cheap price, so this is how I generate new customers. Besides, it's really small -- what harm do you think it'd do? And beside it is a CafePress link that generates referral income for your store, not mine. (If you really, really must remove it, then you can...for a fee. You can find more info on the pricing page.)

Q. I've been getting an error saying that "the cpshop.cgi.config file has not been generated." What am I doing wrong?

A. In the "program options" section of the admin screen, change the "Use Clean Store URLs" option to "use query strings with store URLs."

Q. What happens if CafePress updates their design and the script stops working?

A. Well, you're going to need an updated version of the cppage.lib file, which you should receive by email. If you've setup the "cpcache" and "cpbackup" folders then there's a backup plan (until you receive the new files):

  1. Open up cppage.lib, and change the variable $expiretime to a large number, like 150.
  2. Log in to your server, and change the name of the "cpcache" folder to "cpold".
  3. Change the name of the "cpbackup" folder to "cpcache".
That should, at least temporarily, allow the script to function until updated. Then you should visit the cpshop page for update information. If you don't find any, email marty and let him know.

Q. I have an idea for a new feature. Can you add it for me?

A. Maybe, it depends on the feature. Add it to the Feature Requests Board.

Q. I was hacking at the perl in the script, and it stopped working. Can you fix it for me?

A. Probably. Will I? Probably not. If you have serious problems, just re-upload the script file. (You did keep a backup...didn't you?)

Q. Will the store generated by cpshop show up as coming from my domain, or will the address bar show

A. Almost every page of your store will come from your own servers, and will have your domain in the address bar. The only exceptions to that are the shopping cart, and those little pop-up info pages (like shirt sizes, shirt colors, etc.).

Q. How can I merge multiple CafePress storefronts into one store?

A. In the "Store IDs" section of the admin screen, enter as many store IDs as you want in the same store ID field, separated by commas, like this: myid1,myid2,myid3,myid4,myid5

Q. Why won't CafePress let me have more than one of each kind of product in a storefront?

A. Well...they just don't, not currently in a basic shop. It's one of the limitations of their service. You can, however, create as many storefronts as you need. If you need four white t-shirts, create 4 storefronts. Then link them all together with the multiple storeid feature (above). Or, better yet, get a premium shop. Your sales will almost definitely go up.

Q. What does "chmod" mean? How do I chmod files?

A. Quick chmod tutorial:

Permissions settings are made up of three numbers:

  • Owner: the person that owns the file (you)
  • Group: everyone in your UNIX ownership group
  • World/Other: everyone else, including web-users
Each of the three numbers is a binary code, and is the sum of three values:
  • Readable (4): The file can be opened and read.
  • Writable (2): The file can be altered or written to.
  • Executable (1): The file can be executed as a program.
So let's take the chmod setting 755 as an example.
  • 7 (4 + 2 + 1): The file's owner is able to read, write to, or execute the file.
  • 5 (4 + 1): The file's owner is able to read or execute the file.
  • 5 (4 + 1): Everyone else is able to read or execute the file.
Here are the important settings for cpshop:
  • 755
    • Owner (4 + 2 + 1): Read, Write, Execute
    • Group (4 + 1): Read, Execute
    • Other (4 + 1): Read, Execute
  • 766
    • Owner (4 + 2 + 1): Read, Write, Execute
    • Group (4 + 2): Read, Write
    • Other (4 + 2): Read, Write
  • 644
    • Owner (4 + 2): Read, Write
    • Group (4): Read
    • Other (4): Read
To chmod in WS-FTP, right click on the file, and choose "chmod (UNIX)" from the menu.

To chmod from a telnet session, simply type: chmod 755 filename.