Major Additions - microCART: Shopping System for vB4

microCART is a fully featured Shopping Cart for vBulletin 4.x, with support for Downloadable & Pysical Products, Subscriptions and Services, without missing any feature even from commercial scripts. Installation is very easy, you just need sometime for the initial configuration.

Edit: Please note - Currently this mod is only compatible with vBulletin 4.1.9 and below, if your using vBulletin 4.1.10 then the modifications current version released here (1.1.4) is not suggested for use. - TheLastSuperman

1.- Highlights

• Supports Downloadable products
• Since version 1.0.3 supports Physical products too!!
• Supports Subscriptions (Even Reccuring)
• Supports Services
• Ability to upgrade usergroup per product
• Unlimited depth levels of categories
• Unlimited Products
• Supports Renewals
• Ability to Add Orders manually
• PayPal & 2CO payments
• Since version 1.0.4 support payments with ccBill (Credits to kastak)
• Supports AddOns
• Support Special Deals
• Unlimited Screenshoots per product
• Unlimited Files per product, so the customers can download previous versions
• Unlimited Agreements
• Customers (and only those who have bought that product) can rate and review it.
• Admin can turn On/Off the Reviews per product
• Uses HTML Editor.
• Since version 1.0.5 support multiple Tax levels.
• Since version 1.0.5 support Shipping Zones with unlimited shipping choices per zone.
• Since version 1.0.5 supports Delivery locations (unlimited depth, eg Country, State, Area with different setup for Tax and Shipping per category.
• Since version 1.0.5 customer must enter his details to finalize the order.
• NEW!! Since version 1.0.6 supports Auto Tax calculation.
• NEW!! Since version 1.0.6 supports Auto Shipping calculation.
• NEW!! Since version 1.0.5 supports Invoice creation.
• NEW!! Comming Soon Block.

2.- Installation

• Download and unzip microCART.zip file
• Upload all the files in your site keeping the same structure. eg cart.php must be on the same level as your forum.php
• CMOD 777 the directories:
  • microcart
  • microcart/photos
  • microcart/photos/thumbs
  • microcart/photos/tmp
  • microcart/editor/files
  • microcart/editor/flash
  • microcart/editor/media
  • microcart/editor/photos
  • microcart/pdf
  • microcart/fonts
  • microcart/images
• Login to your admincp and import product-microcart.xml

3.- Configuration

• First of all you need to setup microCART General Options. The most important option is to set the path to the directory where you'll store the files. For security reasons you must create a directory over the public area. Then write the full path in the options. Don't forget the trailing slash at the end. Example:
  • /home/username/downloads/
• Setup Usergroup permissions. Available options are:
  • Can access the store
  • Can order
  • Can Moderate. Please note that, as a way to bypass the limitation of having vB editor in admincp, I've moved the product descriprion, system messages and agreements to fronend. But only those who can moderate can access this area, and only for modifying the text. Nothing more.
• Setup Categories and Subcategories for your store.
• Setup your Agreements (at least one)
• Start adding products but from AddOns and Services. It will helps you to save time, as when at a later time you add a main product, you can choose the addons.
• To work properly with HTML editor you need to edit settings.php locating at: microcart/editor/assetmanager/ and set the corrects paths.

4.- Product Options (Configurations)

In version 1.0.3 has been added support for configurable options. Not just simple text choices, but options that can increase/decrease the total price. That's why you need to pay extra attention on entering these options to avoid pricing mess.

First of all, you can find these options as "Extra Options" on the droplist on the right of each product (AdminCP). By choosing it you'll get a list of all available configurable options for the specific product. You can Edit and Delete it, or you can change the display order. Click "New Extra Option" to add one.

There is no need for explanation of title. Write there anything that you want. Examples of configuration options are: Color, Size, Ram, Hard disk etc. So let's write Size. In the box below you must add all the available options keeping the format:
Amount|Name

Examples:

• 0|Normal : This option dosen't changes the product's price and it will appears as: Normal
• 15.30|Large : This option increases the price by 15.30 and it will appears as: Large (+$15.30) ... The currency symbol is the one that you've setup. DON'T NEED TO ENTER CURRENCY SYMBOL HERE
• -7.50|Mini : This option decreases the price by 7.50 and it will appears as: Mini (-$7.50). ONCE MORE: DONT ADD CURRENCY SYMBOL.

5.- Product Terminology

• Price: Is the normal price that you're selling a product (eg 49.95)
• Discount: Is the amount that you're giving as discount. eg if you place 4.95 here the price will appear as $49.95 $45.00
• Special (Bundle) price. Currently not in use
• AddOns. Are products that someone can order in the same form (eg Installation, Brand Free etc).
• Special Bundle. Currently not in use

6.- Understanding Shipping Zones
To understand Shipping fields (Base weight, Base fare, Extra weight, Extra fare), you must know how the companies (at least the most of them) are working. They're saying: Till 3 kilos the rate is $15. More than 3 kilos you must add $3 per 500gr (1/2 kilos). In this example you must setup:

1. Base weight 3000 (in grammars) or 3 (in kilos)
2. Base fare 15.00
3. Extra weight 500 (in grammars) or 0.5 (in kilos)
4. Extra fare 3.00
5. Please note to use the same as the definied in the general option weight unit. Setting in options kgr and here grammars is the best way to mess your shop.

7.- Friedly notes

• Please let my copyright link in place. Thank you.
• When rating, please remember that you're rating the script and not me as a person. Thank you.
• Don't spam this thread with comments about my personality. Comment my work only. Thank you.

8.- Demo

• http://www.totally-scripts.com
• This is not a demo but shop in action.

9.- Warning

The included HTML Editor is commercial, so you can use it ONLY within microCART directory.


UPGRADING

To upgrade just upload the new files then follow 2.- Installationwith Allow Overwrite set to YES


CHANGE LOG

• Added Comming Soon Block
• Added view users invoice within admincp
• Added usergroup controled discounts
• Added stock level control
• Added coupon system
• Changed the invoice system to work better.
• Added forum home side block. (Download the product-microcart_forum_block.xml and Install like a new product)
• MICROCART_114_01022011.zip has no affects added to my account
• MICROCART_114_240211.zip has a fade in affect on my accounts pages.
• added some java for the my accounts page and the product view page. So you dont have to re-fresh the page all the time. Updated: 28/02/2011
• Fixed the problem with the euro within the add-on options.

BUG FIX

• Fixed error within the admin php file on line 23.
• Updated the forum side block ( Please let me know if you are still having problems with this. Updated Date 22nd Fed 2011)
• fixed problem with the prices. UPDATED Date 22nd Apr 2011 to upgrade just upload the files as its only the cart.php and microcart/functions.php files that have been updated.
• Fixed problem with the add-ons prices. Updated 25th Apr 2011 to upgrade just upload the cart.php file
• cart.php updated again to fix the problem with the add-ons when changing the qty within the cart.
• Fixed problem with edit invoices in admincp
• Fixed a problem with large price formats.
• Fixed problem with option prices (11-05-2011)
• Updated the files for the new editor not tested Updated 13/06/2011.

Arabic Language File Download Here

[JimboSlice]

I only sale physical items, dont need downloads. It hasnt been an issue but at times I forget to set it to physical.

I still want the sideblock to work properly. Any updates?

[dale09]

Can someone please help. I have installed everything and it seem's to have installed without a hitch. I have a few products added. However, I get some error about a security token missing when trying to add to cart. The usergroup has permission to purchase.

I should have mentioned I downloaded the MICROCART_114_2802011.zip version.


I also notice when clicking the "add to cart" button, it's taking me to http://www.mysite.com/search.php?do=process

Why? Please help

[mikem164]

Can you elaborate a little on how this works, as this may be the reason my Screenshots aren't working.
* /home/username/downloads/
Do I put an actual username in there? in the file it's listed as: /home/***username***/downloads/
Do I need the *'s??
Thanks, Mike

[dale09]

Mike, you need to put your path there. The path to the directory that you are using for the downloads. You don't need the *'s in there, they did that to give folks to the idea it needed to be changed with your actual username on the server.

[mikem164]

ok, created it without the *'s and it's one folder under my forum and used my username like this: home/forum/username/files and I still can't get my screenshots or thumbnails to appear.
Thanks for the input. Folders are chmodd to 777 I'm out of guess's

UPdate: I found that the Thumbnail for the screen shot is going to forum/microcart/photos/thumbs. The thumbnail is there. The Screenshots are ending up the photo's folder but... Size is 0kb. This tells me that the ABOVE path is for Downloadable files for purchase on a per user basis and not for pics.

So, why would the images get uploaded but at 0kb? What's holding it up? yikes

Thanks for the help... hope developer hops on here tonite!

[mikem164]

UPDATE:
If I manually up a thumb to my photos/thumbs with the name that failed to upload then it appears.
Screenshots fail uploading as well, but source showed where it was looking for the image of the screenshot here: microcart/photos/thumbs/6155b071b57f091add071aaa4c48a2c7.jpg

All I need to do is figure why the upload is failing. When I upload a folder, it hangs on the blank Vb screen. I tried this on another forum with Vb 4.0.2 and exact same result.

[Arseynimz]

Great mod here michael - thanks heaps!

I'm trying to go about modifying it a touch here and there though, but thought I'd ask you first in case you were already on to it. I would like to show tax inclusive pricing in the shop (i.e. before going through to the cart - is there any plan for this?

Also, can you direct me to where I can modify the pdf invoice output? I am trying to add a few lines to the invoice, and also modify some of the tables that are created - all help appreciated!

Edit: Also any way to get rid of the funky psychadelic background on the pdf's?!

[micheal332001]

Originally Posted by stationar

Tried to install, but it errored: Internal Server Error


Tried reinstall, and got this error:

Product: MICROCART_114_01022011

Looks like to did not remove all the tables for the microcart system and thats why you have this error.
goto your mysql and remove all microcart_ tables then try and re-install.
If you are still having problems please pm me with admincp and cpanel access and ill install it for you.

Originally Posted by Raffaele

Yes, micheal332001....as i only would sell only Services and for the others if i would sell skins or documents yes i would like it to be turned on. this would be very beneficial for many users/clients.

Thank you for your reply,
Raffaele

I will see about an option per product to turn on or off some options.

Originally Posted by JimboSlice

I only sale physical items, dont need downloads. It hasnt been an issue but at times I forget to set it to physical.

I still want the sideblock to work properly. Any updates?

I will put a new option in to turn off the downloads tab, as for the forum block im working on this and will have a new update when i have time.
Im very busy at the moment with privet work at the moment and that comes before any free scripts.

Originally Posted by dale09

Can someone please help. I have installed everything and it seem's to have installed without a hitch. I have a few products added. However, I get some error about a security token missing when trying to add to cart. The usergroup has permission to purchase.

I should have mentioned I downloaded the MICROCART_114_2802011.zip version.


I also notice when clicking the "add to cart" button, it's taking me to http://www.mysite.com/search.php?do=process

Why? Please help

There are no security token missing as i have looked into the add to cart button and as for it taking you to http://www.mysite.com/search.php?do=process i cannot get this version to do that.
Please send me your site url and login details so that i can try it out on your site.

Originally Posted by mikem164

Can you elaborate a little on how this works, as this may be the reason my Screenshots aren't working.
* /home/username/downloads/
Do I put an actual username in there? in the file it's listed as: /home/***username***/downloads/
Do I need the *'s??
Thanks, Mike

when you got your webhost account you used a username to setup the account in most casses this would be put in where it says ***username***

[micheal332001]

Originally Posted by mikem164

UPDATE:
If I manually up a thumb to my photos/thumbs with the name that failed to upload then it appears.
Screenshots fail uploading as well, but source showed where it was looking for the image of the screenshot here: microcart/photos/thumbs/6155b071b57f091add071aaa4c48a2c7.jpg

All I need to do is figure why the upload is failing. When I upload a folder, it hangs on the blank Vb screen. I tried this on another forum with Vb 4.0.2 and exact same result.

please make sure your folder microcart and all folders within this folder are chmodded to 777

Originally Posted by Arseynimz

Great mod here michael - thanks heaps!

I'm trying to go about modifying it a touch here and there though, but thought I'd ask you first in case you were already on to it. I would like to show tax inclusive pricing in the shop (i.e. before going through to the cart - is there any plan for this?

Also, can you direct me to where I can modify the pdf invoice output? I am trying to add a few lines to the invoice, and also modify some of the tables that are created - all help appreciated!

Edit: Also any way to get rid of the funky psychadelic background on the pdf's?!

to remove or modify the background look at line 2060 to 2089

to edit the PDF out put you will need to look for this

PHP Code:

if ($_REQUEST['do'] == 'invoice')
{ 


and change it the way you like here.
to add a new line use this

PHP Code:

$pdf->ezText('<b><u>'.$vbphrase["microcart_invoice_to"].'</u></b>'); 


[micheal332001]

Originally Posted by razvy64

# CMOD 777 the directories:

* microcart
* microcart/photos
* microcart/photos/thumbs
* microcart/photos/tmp
* microcart/editor/files
* microcart/editor/flash
* microcart/editor/media
* microcart/editor/photos
* microcart/pdf
* microcart/fonts
* microcart/images


I cannot find this:
* microcart/fonts

Should this be a problem?

this folder is no longer required microcart/fonts
all fonts are now in the pdf folder