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

[micheal332001]

Originally Posted by ckgreenman

PM Sent. Thanks for taking a look

Sent you a PM back please check.

Originally Posted by iwaa

Hello again,

After installing the new version I get the following error:

Fatal error: Class 'MYPDF' not found in /home/iwa/public_html/4x4off-road.ro/admincp/microcart_admin.php on line 1574

When trying to view an invoice from AdminCP. Editing seems to work.

Also when trying to view the invoice as the user you get the following error:

Warning: fopen(./microcart/pdf/fonts/php_Helvetica.afm) [function.fopen]: failed to open stream: Permission denied in [path]/microcart/pdf/class.pdf.php on line 1419

Warning: fwrite() expects parameter 1 to be resource, boolean given in [path]/microcart/pdf/class.pdf.php on line 1420

Warning: fclose() expects parameter 1 to be resource, boolean given in [path]/microcart/pdf/class.pdf.php on line 1421

Warning: Cannot modify header information - headers already sent by (output started at [path]/includes/class_core.php:5317) in [path]/microcart/pdf/class.pdf.php on line 1937

Warning: Cannot modify header information - headers already sent by (output started at [path]/includes/class_core.php:5317) in [path]/microcart/pdf/class.pdf.php on line 1938

Warning: Cannot modify header information - headers already sent by (output started at [path]/includes/class_core.php:5317) in [path]/microcart/pdf/class.pdf.php on line 1939

Also I can translate the hole thing to Romanian if you provide me the lang file.

Please chmod these folders

CMOD 777 the directories:

• microcart

and all folders within this folder.

[iwaa]

Thanks,

After chmod-ing everything from the users side seems to work. Unfortunatly I still have the issue from the admincp.

I even tried adding a new invoice, but unfortunatly the issue persists.

[Lomak]

got another mail from paypal - you had any luck?

Hello Lomak,

Please check your server that handles PayPal Instant Payment Notifications (IPN). IPNs sent to the following URL(s) are failing:

http://mysite.com/cart_gateway.php?method=paypal

If you do not recognize this URL, you may be using a service provider that is using IPN on your behalf. Please contact your service provider with the above information. If this problem continues, IPNs may be disabled for your account. 

Thank you for your prompt attention to this issue.


Thanks,

PayPal

and this SQL error still persist.. (as I updated to the latest version to test)

Invalid SQL:
UPDATE microcart_usercoupon SET valid=0 WHERE userid=;

MySQL Error   : You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '' at line 1
Error Number  : 1064
Request Date  : Wednesday, January 14th 2011 @ 10:28:43 AM
Error Date    : Wednesday, January 14th 2011 @ 10:28:44 AM
Script        : http://mysite.com/cart_gateway.php?method=paypal
Referrer      : 
IP Address    : 66.211.170.66
Username      : 
Classname     : vB_Database
MySQL Version :

I also cannot now View invoices in AdminCP (But Can edit)

Just to be clear..

all people must be registered and logged in to access the store.
required Customer data is turned on.
We do not have any active coupons.

All help is very much appreciated.

Regards

[Raffaele]

Originally Posted by micheal332001

Your versy welcome as i dont want this to be wrong in any way.
I want a quality product for others to use and not have problems with.

We are here to help you to archive your goal:up:

I have replyed to your PM and had alook at your site,
but i cannot make this happen in any way.

I was wondering if this is a caching issue

The cart or cart block will only show products you have added to the cart and will not show anyone elses orders.

I will uninstall everything and try again maybe it will fix the problem than.

Yes if i have alled a product to the cart it will show there till i delete the product from my cart as this info is stored within the database.
Even if you logout and then log back in it will still be there.

I think this is a great idea... maybe in your next version you could create an empty cart button...just an idea.

Here are some things for the future that I would like to see in this cart on/off switch in the
General Option... License, Downloads and Stock Levels as I don't use it. But leave it in the Individual Product. :erm:

Thank you again for your help.
Raffaele

[micheal332001]

Originally Posted by Lomak

got another mail from paypal - you had any luck?

Hello Lomak,

Please check your server that handles PayPal Instant Payment Notifications (IPN). IPNs sent to the following URL(s) are failing:

http://mysite.com/cart_gateway.php?method=paypal

If you do not recognize this URL, you may be using a service provider that is using IPN on your behalf. Please contact your service provider with the above information. If this problem continues, IPNs may be disabled for your account. 

The cart_gateway.php file is the only file that needs to be uploaded if you already have verion 1.1.4 installed.

Thank you for your prompt attention to this issue.


Thanks,

PayPal

and this SQL error still persist.. (as I updated to the latest version to test)

Invalid SQL:
UPDATE microcart_usercoupon SET valid=0 WHERE userid=;

MySQL Error   : You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '' at line 1
Error Number  : 1064
Request Date  : Wednesday, January 14th 2011 @ 10:28:43 AM
Error Date    : Wednesday, January 14th 2011 @ 10:28:44 AM
Script        : http://mysite.com/cart_gateway.php?method=paypal
Referrer      : 
IP Address    : 66.211.170.66
Username      : 
Classname     : vB_Database
MySQL Version :

I also cannot now View invoices in AdminCP (But Can edit)

Just to be clear..

all people must be registered and logged in to access the store.
required Customer data is turned on.
We do not have any active coupons.

All help is very much appreciated.

Regards

Have re-uploaded the files for this with a small fix to the cart_gateway.php file.

Please try this and let me know if that error have gone for you.

[Lomak]

Originally Posted by micheal332001

Have re-uploaded the files for this with a small fix to the cart_gateway.php file.

Please try this and let me know if that error have gone for you.

Tried it. I uploaded the one file: cart_gateway.php

I now do not get the SQL error. But the invoices are still not getting updated.. it says 'Unpaid'

I also cannot go in to the invoices (Via AdminCP) to see what 'options' the customer chose. Therefore I cannot ship any goods.

Thanks in advance

[micheal332001]

Originally Posted by Lomak

got another mail from paypal - you had any luck?

Hello Lomak,

Please check your server that handles PayPal Instant Payment Notifications (IPN). IPNs sent to the following URL(s) are failing:

http://mysite.com/cart_gateway.php?method=paypal

If you do not recognize this URL, you may be using a service provider that is using IPN on your behalf. Please contact your service provider with the above information. If this problem continues, IPNs may be disabled for your account. 

Thank you for your prompt attention to this issue.


Thanks,

PayPal

and this SQL error still persist.. (as I updated to the latest version to test)

Invalid SQL:
UPDATE microcart_usercoupon SET valid=0 WHERE userid=;

MySQL Error   : You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '' at line 1
Error Number  : 1064
Request Date  : Wednesday, January 14th 2011 @ 10:28:43 AM
Error Date    : Wednesday, January 14th 2011 @ 10:28:44 AM
Script        : http://mysite.com/cart_gateway.php?method=paypal
Referrer      : 
IP Address    : 66.211.170.66
Username      : 
Classname     : vB_Database
MySQL Version :

I also cannot now View invoices in AdminCP (But Can edit)

Just to be clear..

all people must be registered and logged in to access the store.
required Customer data is turned on.
We do not have any active coupons.

All help is very much appreciated.

Regards

Originally Posted by Lomak

Tried it. I uploaded the one file: cart_gateway.php

I now do not get the SQL error. But the invoices are still not getting updated.. it says 'Unpaid'

I also cannot go in to the invoices (Via AdminCP) to see what 'options' the customer chose. Therefore I cannot ship any goods.

Thanks in advance

Hi there m8

Im trying to sort out your problem but will need your help to do this.

open the cart_gateway.php file and find this.

PHP Code:

$tax = doubleval($_REQUEST['tax']);

    $query[] = 'cmd=_notify-validate';
    foreach($_POST AS $key => $val) {
        if(!empty($val))
            $query[] = $key . '=' . urlencode ($val);
    }
    $query = implode('&', $query); 


Replace it with this.

PHP Code:

$tax = doubleval($_REQUEST['tax']);
      $text = '['.date('m/d/Y g:i A').'] - '; 

      $text .= "IPN POST Vars from Paypal:\n";
    $query[] = 'cmd=_notify-validate';
    foreach($_POST AS $key => $val) {
        $text .= "$key=$val, \n";
        if(!empty($val))
            $query[] = $key . '=' . urlencode ($val);
    }
      $text .= "\nIPN Response from Paypal Server:\n ";
    $fp=fopen('microcart_paypal_ipn_log.txt','a');
      fwrite($fp, strtolower($text) . "\n\n"); 

      fclose($fp);  // close file
      
    $query = implode('&', $query); 


Then put it back to the way it was i just need you to do this so that i can see the reply from paypal once an order has been passed back.

PM me with the results as this will show info you dont want to be seen by enyone.

Also remove the file microcart_paypal_ipn_log.txt when done.

Thanks m8

[Lomak]

done that ...where are the results?

where is microcart_paypal_ipn_log.txt meant to be written to? as I cannot find it.

[Smiler2009]

I'm at the latest revision of MicroCart. Everything seems to work except I cannot view users invoices from the AdminCP.

Any ideas?

[Lomak]

Originally Posted by Smiler2009

I'm at the latest revision of MicroCart. Everything seems to work except I cannot view users invoices from the AdminCP.

Any ideas?

if you read the thread .. this has already been logged. posts 63 & 66 for example