########################################################### # # closedShop - Open Source Shopping - v2.2 # Shipped - February 2006 # # Homepage: # http://closedshop.sourceforge.net/ # # Lead Developer: # Chris Fleizach - chris@fleizach.com # ########################################################## closedShop is a collection of Perl Scripts which work to make a complete shopping cart. Currently, it only will utilize mySQL, and has not been tested under NT. It was initially started way back in 2001 and has been under development since then. We try to do updates every 5 to 6 months depending on suggestions If there are bugs or problems, or you need special modifications, we can usually help quickly. Send email. This readme is fairly inaccurate on all the features that you can use. Look at the history for a full list of features from each release. Also go to the administration page and you will see what kind of things you can do. Also if anyone wants to do translation, send me the translated files. Installation: 1. Put the closedShop files in your cgi-bin and chmod each file to 755. This means that the permissions on each file should be set to read-write-exectute for the owner, read-execute for the group and read-execute for everyone else. Make sure that the file closedShop.vars is writeable by the webserver. This is the file that contains all the variables for your program, and when you type in information in the webbrowser, the server must be able to write into this file. What you can do is change the owner to be the user running the webserver (like apache). You will not be able to proceed unless this is done. 2. You will need to create an image folder where closedShop will save the images of items. This needs to be in your html directory and not your cgi-bin. You need to make sure this image folder is writeable by the webserver because the webserver will have to create images in the folder. If you have trouble finding this real path, utilize the findpath.php file, which can help you out. See Common Problems. 3. Make sure now that you have access to a mySQL database for this program. Many web hosters will provide access to a SQL database (sometimes you must ask). If you have your own server, you can create a blank database that closedShop will use during its lifetime. Make sure you have a username and password and be prepared to enter these during the Install.pl file 4a. FOR NEW INSTALL ... Go to your web browser, and type in the url to the closedShop folder and go to the Install.pl file, thus http://www.YOURURL.com/cgi-bin/closedShop/Install.pl Problems: If you get an "Internal Server Error" immediately, it might be because your server wants the warning switch on for perl, so open up all the files and add " -w" after the first line in every file. Like: #!/usr/bin/perl -w It might also be because the path to perl is different. Change the line mentioned above. It may also be because you have not set permissions correctly. 5. If you have already installed closedShop, you will be redirected to the Admin.pl file. If you have not installed closedShop as of yet, you will have to fill in a few variables to get started. To start installation over again remove the file "closedShop.vars" in the cgi-bin which is where the data is saved and make sure Admin.pl is set to be executable. 6. Install will ask you to fill out various settings. Later when you need to change these, you can go to the Administration and "Change Variables" and you will see a plethora of more variables to customize closedShop. 7. Press Install!! If there are errors and Installation was not able to complete, the program will try to determine the error and notify you as what to do. 8. Check Out the program!! Go to your Admininstration. Go to the Admin.pl and enter your username and password. Here you see your list of controls. This is where you add, edit and remove items, all very straightforward, and where you process orders. You can view old processed orders and process new ones. When you have clicked on 'process' the customer will be emailed with information that the product has been shipped. You can also view customers who have signed up and change the variables you set in the install part of installation. There are also Category variables to edit. This means for every category you create, you can add intro text to appear at the top of every category and you can also choose whether to display the category as a list of links in text, or as thumbnail pictures, and also how many thumbnail pictures should be displayed per page. Templates are a good option for totally customizing the site. Read the file on TEMPLATE_INSTRUCTIONS for more info. Sales Affiliates are now available and can be created through the corresponding button. Notice for this feature, affiliates can sign up themselves, but require your approval. Also you set the commission level yourself. The affiliates cannot login to see their sales, but rather enter their email address and receive an email with their sales reports. You should definetly look at "View Important Links" which will guide you with the approprate URLs for all the pieces you may want to find. For example, on your site you may want to make a link to the "Widgets" category on everypage. You can find that link in this section. 9. Questions, bugs, comments, blatant and disrepectful security holes should be sent to chris@fleizach.com or visit the homepage at http://closedshop.sourceforge.net/ Upgrading: If you need to upgrade from an earlier version of closedShop, you should make a new closedShop folder in your cgi-bin. Upload all the files from the new closedShop release file. Then copy your closedShop.vars file from the old folder to the new folder. Then go to http://www.YOURURL.com/cgi-bin/closedShop/Upgrade.pl and follow instructions. Notes: You might have to play around with some things to get the secure scripts set up, especially if your web hoster sets your secure server to another server. See the notes above regarding referencing images in the template files. For instance, by putting " -w" after the first line in each file, or uncommenting the "use CGI::Carp" lines a few lines down from the top Right now there is online credit card processing for Authorize.NET only. closedShop will store credit cards in the database and display them for the admin. The program can be readily modified to accept other payment options. It will also integrate with PayPal, in which case the credit card is not stored. closedShop can also be used to post items automatically from your store to eBay. Check the variables page to enable. closedShop is integrated with PreCharge, a pay service that can check the validity of credit cards and give you an idea if it's a fraud or not. You have to sign up with them in order to enable it. closedShop can export and import items. Exporting will output your items, orders and customers in comma delimited format. Importing can take an Excel worksheet (if your server supports the Excel::Worksheet module for Perl) or from a regular text file. In a similar vein, closedShop can backup the whole SQL database for the paranoid and will place it all in a file closedShop works with Gift Certificates. You generate a specific amount, then when someone buys one you have to manually enable the gift certificate, which can then be used and will automatically deduct prices from orders. ############################### # CODE statistics from `wc` ############################### Lines Words Chars FileName 4371 14788 187857 Admin.pl 1840 6029 70467 Cart.pl 1114 3631 41785 Item.pl 290 831 9590 Upgrade.pl 777 2495 31888 User.pl 1595 5066 58311 closedShop.pm 9987 32840 399898 total ########################################################### # closedShop - Open Source Shopping # http://closedshop.sourceforge.net/ ###########################################################