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

[Dadoo]

Originally Posted by munasbh

thank you for this important product

i have only one problem

when i export an invoice

the output is strange letters

Charset in cp for Invoices is set with utf-8


the proplem is the arabic encoding when creating pdf (only creating pdf)

Already asked, Micheal working on it

Originally Posted by micheal332001

I will sort out the problem with the charset and will also add a print button to the admincp invoices.

[peppefark]

Boys but I do not no one can help me??

[q3chap]

Originally Posted by peppefark

I installed the mod! When I go in the user groups to give permissions, after confirming I get this error message:

Are you sure it is an microcart issue? .. because in your code, i see this line:

MySQL Error   : Unknown column 'ms_imageshack_upload_permissions' in 'field list'

[peppefark]

then tell me to uninstall the mod imageshack??

[q3chap]

Hi Micheal,

I have a question. In the shop, I created categories and next to the categories, there are numbers of the Items in that category. Where can I delete this number?

in Template: microcart_main, I found this lines:

PHP Code:

{vb:raw horizontalcategories}
      <vb:if condition="$category_products">
      {vb:raw category_products} 

          <vb:if condition="$pagenav">
               <div align="right" style="margin-top:5px;">{vb:raw pagenav}</div>    
           </vb:if>

       <vb:else />
           <vb:if condition="$catid>0">
            {vb:raw category_empty}    

           <br />
            </vb:if>


            <vb:if condition="$frontpage_products">
            {vb:raw frontpage_products}<br />
            </vb:if>
      </vb:if> 


I did try to delete every single line, but I couldnt delete the numbers.

Help

Hoan

[q3chap]

Originally Posted by peppefark

then tell me to uninstall the mod imageshack??

maybe, try to deactivate it first.

[Mellow]

One thing that is strange is I'm the one getting the 'thank you for your order' email, not sure if that's a copy of one being sent to my members or the one that should be sent.

[micheal332001]

Originally Posted by peppefark

I installed the mod! When I go in the user groups to give permissions, after confirming I get this error message:

Database error
The Club Alfa Romeo Cuore Sportivo Italia database has encountered a problem.

Database error in vBulletin 4.0.8:

Invalid SQL:
UPDATE vb_usergroup SET

### UPDATE QUERY GENERATED BY fetch_query_sql() ###
    `title` = 'Amministratore',
    `description` = 'Amministratore',
    `usertitle` = 'Amministratore',
    `opentag` = '<span style=\"color: #FF0000;\">',
    `closetag` = '</span>',
    `passwordexpires` = '180',
    `passwordhistory` = '360',
    `dtogaragepermissions` = '1',
    `dtogaragesize` = '3',
    `medialibperms` = '63',
    `medialibmodperms` = '63',
    `ms_imageshack_upload_permissions` = '0',
    `vbblog_general_permissions` = '524286',
    `vbblog_customblocks` = '10',
    `vbblog_custompages` = '10',
    `vbblog_entry_permissions` = '32767',
    `vbblog_comment_permissions` = '2014',
    `dbtech_vbshoutpermissions` = '2',
    `forumpermissions` = '16777215',
    `genericpermissions` = '2147483583',
    `attachlimit` = '0',
    `pmquota` = '50',
    `pmpermissions` = '7',
    `pmsendmax` = '5',
    `pmthrottlequantity` = '0',
    `calendarpermissions` = '63',
    `wolpermissions` = '31',
    `adminpermissions` = '3',
    `genericpermissions2` = '1',
    `genericoptions` = '55',
    `profilepicmaxwidth` = '100',
    `profilepicmaxheight` = '100',
    `profilepicmaxsize` = '65535',
    `avatarmaxwidth` = '80',
    `avatarmaxheight` = '80',
    `avatarmaxsize` = '20000',
    `signaturepermissions` = '245759',
    `sigpicmaxwidth` = '500',
    `sigpicmaxheight` = '100',
    `sigpicmaxsize` = '10000',
    `sigmaxrawchars` = '0',
    `sigmaxchars` = '0',
    `sigmaxlines` = '0',
    `sigmaxsizebbcode` = '7',
    `sigmaximages` = '0',
    `albumpermissions` = '255',
    `albumpicmaxwidth` = '600',
    `albumpicmaxheight` = '600',
    `albummaxpics` = '100',
    `albummaxsize` = '0',
    `usercsspermissions` = '63',
    `visitormessagepermissions` = '63',
    `socialgrouppermissions` = '262143',
    `maximumsocialgroups` = '5',
    `groupiconmaxsize` = '65535',
    `microcart` = '7'
WHERE usergroupid=6;

MySQL Error   : Unknown column 'ms_imageshack_upload_permissions' in 'field list'
Error Number  : 1054
Request Date  : Sunday, January 30th 2011 @ 04:16:34 PM
Error Date    : Sunday, January 30th 2011 @ 04:16:34 PM
Script        : http://www.clubcuoresportivo.it/admincp/usergroup.php?do=update
Referrer      : http://www.clubcuoresportivo.it/admincp/usergroup.php?do=edit&usergroupid=6
IP Address    : 79.3.169.152
Username      : peppefark
Classname     : vB_Database
MySQL Version : 5.0.91-enterprise-gpl-log

Please help me to solve this problem!

Thanks

this is your problem here

MySQL Error : Unknown column 'ms_imageshack_upload_permissions' in 'field list'

this table is not there it might be form an old mod you have installed and then removed or it was never added when you installed this mod.
I can tell you this is not down to the microcart system.

Originally Posted by jgt58

could you add in a PM notification to a selectable admin when a new order is created?

and is there a paid version where I could take your copyright off?

Yes this can be sorted out so it will PM/Email an admin.

Originally Posted by Halfhidden

This is a superior product... I love it.
We use Paypal a lot here in the UK because it is the cheapest gateway for payment. I set up my paypal email address in the admin section and tried a test purchase.
I noticed that after a member has filled in the personal details for the sale and click on check out they are redirected to PayPal. Here they are asked to either log in or fill out the exact same details as they did on the VB site. Can the personal details be populated to the PayPal checkout?
Also is there any way to set up either "express check out" or "Website payment Pro" with PayPal. Both need to have API's set up with the cart but members who buy don't actually leave the site and everything integrates very well.
I'll happily pay for this extra integration if need be

This is a wonderful script and I would like to thank you for ALL of your hard work and dedication to supporting it... Thank You!:up::up:

I do see what you mean and will be sorting out some sort of system for this at some time.

[micheal332001]

Originally Posted by q3chap

Thx micheal,

I looked at my system and there, I installed Microcart 1.1.4 (without a) .. there I have no problems with the charset. In Gerneral Options of Microcart, my Charset for Invoices is set with utf-8.

Hoan

The pdf system thats there at the moment is messing a few things up with the invoices this will be fixed very soon but im having to recode it so might take alittle time.

Originally Posted by Raffaele

Hello Micheal, i think i found another bug in this cart if you add an item in to the cart and do a refresh it will add another item into the cart...

This can happen on most shopping systems as well as other addons.
But there is no simple fix for this.

Originally Posted by munasbh

thank you for this important product

i have only one problem

when i export an invoice

the output is strange letters

Charset in cp for Invoices is set with utf-8


the proplem is the arabic encoding when creating pdf (only creating pdf)

This is being looked at and a fix will be coming soon

Originally Posted by q3chap

Hi Micheal,

I have a question. In the shop, I created categories and next to the categories, there are numbers of the Items in that category. Where can I delete this number?

in Template: microcart_main, I found this lines:

PHP Code:

{vb:raw horizontalcategories}
      <vb:if condition="$category_products">
      {vb:raw category_products} 

          <vb:if condition="$pagenav">
               <div align="right" style="margin-top:5px;">{vb:raw pagenav}</div>    
           </vb:if>

       <vb:else />
           <vb:if condition="$catid>0">
            {vb:raw category_empty}    

           <br />
            </vb:if>


            <vb:if condition="$frontpage_products">
            {vb:raw frontpage_products}<br />
            </vb:if>
      </vb:if> 


I did try to delete every single line, but I couldnt delete the numbers.

Help

Hoan

The template you want to edit would be microcart_subcategories_bit then remove this ({vb:raw totalsubproducts})

Originally Posted by Mellow

One thing that is strange is I'm the one getting the 'thank you for your order' email, not sure if that's a copy of one being sent to my members or the one that should be sent.

There is always 2 emails sent out one for the buyer and one for the store owner.

[micheal332001]

Have changed the pdf part of the invoices so it will support utf-8 so no more problems on that part i hope