SimpleCaddy plugin parameters

Ok, nice to have lots of plugin types, but many of them need additional parameters to do exactly what you expect them to do. One of the key features in this version of SimpleCaddy is the nextcid= parameter. It will lead your client from one screen to another.

nextcid=contentid

Most of the plugin types support the nextcid= parameter. This parameter will lead your visitors from one page to another. It does require that the article in question has been created. The basic way to go through the development of your shop with SimpleCaddy is to create all the pages you need, before even starting to add any plugins to them. Let’s assume you have 3 product pages, want to show and EditCart page, a Details page and straight to checkout, no taxes or shipping.

You will need the following pages created, with imaginary content IDs or cid :

Shop page 1 (cid=74)
Shop page 2 (cid=79)
Shop page 3 (cid=95) – this page is for upsell from Page 2
EditCart page (cid=78)
Details page (cid=81)
Checkout page or payment page (cid=83)

Shop page 1 and 3 would go EditCart so they will each take a nextcid=78 as parameter
Shop page 2 goes for an upsell and uses nextcid=95
EditCart is the “landing” page for all shop pages and needs a nextcid=81 to have everybody go to the Details page
Details collects all necessary info of your clients and leads them to the payment page so gets a nextcid=83 parameter

Where do I find the content ID?

You find it in the article list in Joomla. It’s the last column in the list:

image

If you do not specify a nextcid= parameter, the plugin will redirect to the page where it came from, thus staying on the same page. The redirect will be performed in any case, which will allow for an eventual cart display update.

 

classsfx=class_suffix

All types accept the classsfx= parameter. A class suffix is appended to any defined class name (css) in your plugins. If you want all your plugins to look the same, then you simply use the css file provided. However, if you need one or a few plugins to look radically different from the rest, you can specify the classsfx= parameter to style your individual plugins.

The standard plugin for sox001 looks like this:

{ simplecaddy code=sox001 }

Product
sox001
Sweaty socks
Price/Unit
15.00 CAD
Qty
Available quantity
0

but the altered plugin may look like this with a little extra css:

Product
sox001
Sweaty socks
Price/Unit
15.00 CAD
Qty
Available quantity
0

where the css looks like this:

/** demo for high visiblity ***/
.sccart-highvis {
    font-family: sans-serif;
    font-style: normal;
    font-size: 10px;
    background-color: yellow;
    border: 1px solid purple;
}

I admit that this css is not the most flattering for your site, but it does show the possibility to get a different plugin where you need it Smile .

defqty=number

This will set the default quantity in the Qty text box in the buynow plugin type. While by default you have 1 entered in that textbox, you could set it to any other number as a preferred quantity. If you sell bottled water by the dozen, you may want to set the default quantity to 12 like this:

{ simplecaddy type=buynow code=sox001 defqty=12 }

Product
sox001
Sweaty socks
Price/Unit
15.00 CAD
Qty
Available quantity
0

qties=list

If you need to sell specific quantities of your product because they are packaged that way, there are two ways of making sure you don’t need to sell half a pack. You can either sell the package as a single product, which seems most likely. Or you can define a list of quantities to be displayed. You can do that in the following way:

{ simplecaddy type=buynow code=sox001 qties=2,4,6,8,9,13,15 }

Product
sox001
Sweaty socks
Price/Unit
15.00 CAD
Qty
Available quantity
0

Preselecting one of the quantities in that list is done by adding the defqty= paramter to the plugin call as well like this:

{ simplecaddy type=buynow code=sox001 qties=2,4,6,8,9,13,15 defqty=8 }

Product
sox001
Sweaty socks
Price/Unit
15.00 CAD
Qty
Available quantity
0

You do want to make sure that your default quantity is part of your predefined values in the list though…

checkoos=1

By default you will be selling and selling and selling. However, sometimes you need to be able to stop selling a specific product in case it is out of stock (oos). Add this parameter to your plugin call to check the stock before you offer it for sale. In case there is no product in store, your plugin will show a message rather than an Add to Cart button.

{ simplecaddy type=buynow code=sox001 checkoos=1 }

Product
sox001
Sweaty socks
Price/Unit
15.00 CAD
Qty
Available quantity
0

picname=something

This parameter is added to your plugin calls when used in conjunction with Phoca Gallery. There is no visual return for this parameter, but the picture name will be added to the cart display so you can easily see what photo you have sold and what picture you will have to deliver.