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

[mrmanners]

Hello again. So things are progessing with our site but I have come up with another question and I searched the thread before I decided to ask about it. We are running VBSEO. I was wondering if they are going to search through the cart as well?

If so should I be doing something specific in the programming to make sure it captures our items?

Thanks,

[micheal332001]

Originally Posted by NJHK

OK, I tested it and it did resolve showing the correct price...however it is still adding the discount when you do select the addon like so:



and the discount is still applying:


Also not sure if you saw my previous post about the 3 issues that I found afterwards...the biggest one deals with the discount again...

When you add it to your cart, no discount is given:


but as soon as you change the quantity, it adds the discount per quantity:


and then even after that, if you go to preview your order it does this:


then it automatically sends you to your statistics page...


It doesn't send them to the other page to go to paypal like it used to.

I appreciate all your help. Just wanted to give you screen shots to help resolve.

I will continue to look into this but it should still be sending you to paypal as that part was not changed.

Please make sure paypal is active and try it again if need be and let me know.

Originally Posted by mrmanners

Hello again. So things are progessing with our site but I have come up with another question and I searched the thread before I decided to ask about it. We are running VBSEO. I was wondering if they are going to search through the cart as well?

If so should I be doing something specific in the programming to make sure it captures our items?

Thanks,

I will be adding some info on how to add the VBSEO for short url very soon.

[micheal332001]

Originally Posted by NJHK

I hate to be a nuisance but after doing some more testing...I found 3 more issues.

Issue #1: When you add an item to the cart and they are not in the usergroup for a discount, no discount is applied like normal. However, if you change the quanitity, it changes the quanitity and adds the discount. I attached 2 screenshots to show you exactly what happens.

Issue #2: When you do purchase an item and hit "Preview Order", it is automatically sending you to the My Account area where it shows you your statistics instead of like before showing them their total amount and then you had the option to go to paypal so they can pay their order.

Issue #3: Unregistered users for the customer contact info...it carries over instead of being empty. For example, I'm at work and I put "test" in all the fields...then I had someone else test it unregistered and they had "test" show up pre-populated. Would there be anyway to have that empty for unregistered users?

I really do appreciate your help so far.

Issue #1 im looking into this as to why its adding the discount when you change the qty.

Issue #2 please make sure you have uploaded all files and chmod all folders within the microcart folder as well as the microcart folder to 777.

Issue #3 dont give Unregistered users the option to buy products as thats why it will show for any Unregistered user as there userid is 0.

if you are still having problems with Issue #2 please PM me with your ftp and admincp full access so i can sort this out for you.

[mrmanners]

Originally Posted by micheal332001

I will be adding some info on how to add the VBSEO for short url very soon.

I look forward to it.

[NJHK]

Originally Posted by micheal332001

Issue #1 im looking into this as to why its adding the discount when you change the qty.

Issue #2 please make sure you have uploaded all files and chmod all folders within the microcart folder as well as the microcart folder to 777.

Issue #3 dont give Unregistered users the option to buy products as thats why it will show for any Unregistered user as there userid is 0.

if you are still having problems with Issue #2 please PM me with your ftp and admincp full access so i can sort this out for you.

I tried it again, still didn't work to fix issue #2

Issue #3...no problem.

One last thing, is there a way to change the color of the font for the prices on the category pages?

I sent you a PM with the info. Thank you again.

[RcHelp]

Running great on 4.1.3. Just need to get some content in it now and start making some cash lol.

[tinyangelwings]

I have a problem, basically the product images are not showing for me in this addon.

I've checked the file structure and folder/file permissions and all appear to be exactly as they should be according to your setup guidelines. Any suggestions? Thank you.

http://www.tinyangelwings.com/community/cart.php

[dt-pain]

Nothing but problems. I just tried to go live.

1. Still get database error when trying to view Invoice.

2. When you go to buy something before you pay you preview your order and you can download the files with out even paying.

3. Clicking checkout does nothing..

I will PM you some info..

[micheal332001]

Originally Posted by dt-pain

Nothing but problems. I just tried to go live.

1. Still get database error when trying to view Invoice.

2. When you go to buy something before you pay you preview your order and you can download the files with out even paying.

3. Clicking checkout does nothing..

I will PM you some info..

problem 1: what database errors you getting i cannot help unless i know whats going on.

problem 2: When setting up the upload path for your files you should place all file outside the root folder like so.

/home/SITEUSERNAME/downloads/

This way no one can access your files with a direct link.

problem 3: Have just uploaded new files that should fix the you are having.

[micheal332001]

Originally Posted by NJHK

I tried it again, still didn't work to fix issue #2

Issue #3...no problem.

One last thing, is there a way to change the color of the font for the prices on the category pages?

I sent you a PM with the info. Thank you again.

I will add a new setting so that you can change the prices colour will sort it out within the next day or 2 as i have some privete work on.

Originally Posted by tinyangelwings

I have a problem, basically the product images are not showing for me in this addon.

I've checked the file structure and folder/file permissions and all appear to be exactly as they should be according to your setup guidelines. Any suggestions? Thank you.

http://www.tinyangelwings.com/community/cart.php

This has been looked into before and you will find the answer within these posts.
As far as i know its down to how some sites have setup there forums and servers, im very lucky as i have a VPS server that i can get anything i want installed to make it easyer for my sites to work as they should.

This problem has been looked into and has been fixed before but im sorry you would have to look through the posts as i dont have time to look at every post here as i have alot of work on.