New in v1.0.1: Virtual items, that allow you to sell downloadable files.
New in v1.0.2: Plugin support. You can now install compatible plugins for your version. Also you can change the delivery cost.
New in v1.0.3: You can now accept orders from all countries. Alphabetising the product listing on the home page, as well as most recent order. Choosing how many products are shown on the homepage. Support for auto pagination on the home page.
New in v1.0.4: Support for Moneybookers as a payment processor.
This manual is for the people who have found their initial experience of Cartcake bewildering, or the User Guide not to be sufficent enough in helping them understand Cartcake.
This manual will cover everything that Cartcake can do, and provide a suitable guide of how to get started.
You can return to where you previously was, by navigating the contents on the left.
This manual will assume that Cartcake is already installed.
If it is installed, you'll be able to go to the
So if you installed Cartcake at
When you try to access the admin panel, you should see something like this.
When you are finally are logged in, you should see something like this.
If you have just installed Cartcake and/or your site is blank, the first thing you should do is change the settings. If you create products and have them on sale, with wrongly configured settings, this will cause you problems later on that you will not want.
Once you're on the settings page, you'll see a bunch of things that'll need changing, which can be confusing if you don't know what will happen once you've changed those settings. Those settings will now be explained in their entirety.
Firstly the miscellaneous settings will be explained.
Secondly it's time for the design settings.
Now for some other settings.
Finally for the custom content settings.
Cartcake has support for
The benefit of this is that it keeps coding things simple for the web developers that actually code the Cartcake script, whilst the other web developers can create functionality and modifications for Cartcake that the original developers don't have the time or will to create.
On the left hand side there is a link to the plugins page. If you have installed any plugins installed, this will be of use to you.
Once you are on the plugins page, you should see something like this.
New installations of Cartcake don't come with any plugins, so you can click the add button to find new plugins.
Once you have a plugin uploaded, you'll see it listed on the plugins page with the light bulb turned off. You can click the light bulb to turn plugins on and off. Clicking it for the first time will install the plugin.
When plugins are installed, you can edit their settings by clicking its corresponding cog button. It is important that you edit a plugin's settings straight away after installing it.
If you are unsure what a plugin's settings does, refer to the author's website and look for the web page that hosts the plugin there. If you need any more help with plugins, contact the person on Twitter.
What you type into a plugin's settings is not currently validated in version 1.0.4, so if you break anything by typing anything wrong, that is your fault.
Once you've happily changed all your settings, the next step is to add products to your store. You are going to want to know what you're doing, as you're doing this. If you get this wrong and have to delete your product because of it, you're not going to be happy.
If you have an empty website, when you access your products page, you should see something like this.
You cannot add any products on this page, only in categories, so you'll have to use the add icon to add a new category, to house your first product.
Once you have a new category setup, you should see something like this.
You can be confident enough to click the add button, to type in your product name and price. Go ahead! It won't bite.
What you are about to read next, is the most confusing part of Cartcake, and you might be completely confused by it. If you don't get it at first, be sure to look at the images again, and try to figure out what correlates the products in the admin panel, to how they are presented on the shopping website.
On some other shopping websites, you may find variations (of products, think catalogue fashion stores) to have different images, different prices, but the same product description, for the same product. Cartcake doesn't. With Cartcake, variations aren't anything but a word. If there is only one variation, the product is treated as having none. Also, a product must have a variation to be sold. Below are some images to illustrate this.
Everything else should be self explanatory. ;)
Whenever products are low on stock, the email specified under
After your customers make orders, the email specified under
If you have configured the settings correctly, you will (or should have) received emails once your customers have made orders. If this does not happen, check your email logs records before wondering if it's a bug in the script. If you have cpanel, you'll find it under "email logs".
When you have had new orders made recently, you should see something like this.
If you click the clock icon, the item will be marked as dispatched and will go green.
FAQsWhy can't I upload things?
This is either because your webhost's firewall, is using rules that are too strict, making the ajax uploader not work, or because certain .htaccess files need to be wiped out for certain conditonal rules (designed for firewalls) not working (for being blocked).
The first thing you should do is go to admin/fileuploader/server/ make the .htaccess file uncommented, by removing the hashes. This will cancel the Error 500 Internal Server error for SecRuleEngine not allowed here that stops the server/ folder from being displayed in a web browser.Try uploading again, to see if the problem is now fixed. If it's still not working, follow these instructions...
Comment the .htaccess file again, so put back those hashes!.
If you're using mod_security, ask your webhost to turn it off for your domain, or you can check which rules are violated.
If you're using Suhosin, you can check violated rules here, by turning on simulation mode.
The workaround is to upload using the web browser, and then use ftp to place that file inside the uploads/ folder afterwards.
What happens when I click dispatch this? What if if it's virtual items?
The order will be marked as dispatched, to say that you've sent it.
If the order only has virtual items and you click dispatch this, nothing will happen.