v3 first release

Author: Dipu Raj

CONTRIBUTING.md

@@ -0,0 +1,36 @@
+# Contributing
+
+## What can I contribute?
+- Fix a bug you found or already reported on the [GitHub Issues Tracker](https://github.com/techlab/SmartCart/issues/). 
+- Add new features to the project.
+- Add new test cases.
+- Add documentation  
+- Add a demo page
+- [Donate](https://www.paypal.me/dipuraj) money for the project on [Paypal](https://www.paypal.me/dipuraj)
+
+## How to contribute code
+Here are the basic steps to get started contributing:
+
+1. Fork the [repo](https://github.com/techlab/SmartCart/) and get development running on your computer.
+2. Replicate the issue you're trying to fix or spec out the feature you're trying to add.
+3. Change the code to fix the bug or add the feature. All changes should happen in the relevant `src/js/*.js` and `src/css/*.css` files.
+4. Build the code by running `npm run build` or `gulp build`
+5. Run the test cases by running `npm test` or `gulp test`, you can also add more test cases based on your new change.
+6. Verify that your fix or feature works. 
+7. Commit your changes with an informative description
+8. Open a pull request to the [repo](https://github.com/techlab/SmartCart/) with your new commit and a descriptive message about what the PR does.
+
+## Reporting bugs
+### Make sure it is a bug related to this project
+Before reporting the bug, please make sure that the bug is in the project and not from your own code or any other library used.
+
+### Try the latest version
+Bugs in the older versions of the project may have already been fixed. 
+In order to avoid reporting known issues, make sure you are always testing against the latest release. 
+Also make sure the problem hasn't already been reported on the [GitHub Issues Tracker](https://github.com/techlab/SmartCart/issues/). 
+If not, create a new issue there and include your test case.
+
+### Notes for pull request
+- Follow the same code style as the library.
+- Run the test suites in the `test` directory first by running `npm test` or `gulp test`.
+- Don't modify any files in the `dist` directory.

README.md

@@ -1,22 +1,72 @@
-# jQuery SmartCart 3
+# jQuery Smart Cart 3
 #### The smart interactive jQuery Shopping Cart plugin with PayPal payment support.
 
-[GitHub Issues](https://github.com/techlab/SmartCart/issues/)
+jQuery Smart Cart is the smart interactive *jQuery Shopping Cart plugin* with *PayPal* payment support. It can create an interactive and user friendly shopping cart with minimal code. It has built-in support for *Form* submit, *Ajax* submit and *PayPal* submit of the cart items. A lot of customization options and custom events makes it easy to implement your requirements. It can integrate with your existing shopping list very easily and you can use your own css or use the default *Bootstrap*.
 
-+ [First Look Demo](http://techlaboratory.net/demos/jquery-SmartCartv3Alpha/examples/index.html)
+The new version *jQuery Smart Cart 3* is completely rewritten from scratch and adopted the modern patterns. It is more powerful, robust, scalable and customizable. A lot of features is added like Bootstrap support, theme support, customizable toolbars, customization options, public methods, event support and a lot more.
+See the list of [features](http://techlaboratory.net/smartcart#features), [demos](http://techlaboratory.net/smartcart/demo) and [documentation](http://techlaboratory.net/smartcart/documentation) for more details.  
 
++ [Homepage](http://techlaboratory.net/smartcart)
++ [Documentation](http://techlaboratory.net/smartcart/documentation)
++ [Demos](http://techlaboratory.net/smartcart/demo)
 
-![First shot](http://techlaboratory.net/assets/media/products/SmartCartv3.0.1-alpha.png)
+Demos
+-----
+  + [Basic Example](http://techlaboratory.net/smartcart/demo/basic)
+  + [PayPal Cart Example](http://techlaboratory.net/smartcart/demo/paypal)
+
+Screenshots
+-----
+![Smart Cart Screenshot1](http://techlaboratory.net/assets/media/products/SmartCart3-Normal.png?v1)
+![Smart Cart Screenshot2](http://techlaboratory.net/assets/media/products/SmartCart3-PayPal.png?v1)
+![Smart Cart Screenshot3](http://techlaboratory.net/assets/media/products/SmartCart3-Cart.png?v1)
 
 Requirements
 -----
   + [Bootstrap 3+](http://getbootstrap.com/getting-started/#download)
-  + [jQuery](http://jquery.com/)
+  + [jQuery](http://jquery.com/) (supports jQuery 1.9+, jQuery 2+, jQuery 3+)
+
+Installation and usage 
+-----
+
+### [NPM](https://www.npmjs.com/package/jquery-smartcart)
+    npm install jquery-smartcart
+    
+### Bower
+    bower install jquery-smartcart
+    
+### [Composer](https://packagist.org/packages/techlab/jquery-smartcart)
+    composer require techlab/jquery-smartcart
+    
+### Download
+#### [Download from GitHub](https://github.com/techlab/SmartCart/archive/master.zip)    
+###  
+ Please see the [documentation](http://techlaboratory.net/smartcart/documentation) for more deatils on implementation and usage.
+
+Features
+-----
+  + In-built PayPal, Ajax and form submit methods
+  + Bootstrap support
+  + Heavily customizable toolbar, option to add extra buttons
+  + Theme support
+  + Customizable css styles
+  + Public methods for external function call
+  + Enhanced event support
+  + Compatible with latest jQuery versions (jQuery 1.9+, jQuery 2+, jQuery 3+)
+  + Easy to implement, Minimal HTML required
+  + Clean and compact design
+  + Automatically calculates subtotal
+  + Quantity is editable from the cart list
+  + Product Image display
+  + Customizable cart templates
+  + Customizable currency formatting option
+  + Pre-populate products on cart on load
+  + and a lot more...
 
 Version
 -----
-**SmartCart v3-Beta1**
+**SmartCart v3.0.1**
 
 License
 ----
-[MIT License](https://github.com/techlab/SmartCart/blob/v3-beta/LICENSE)
+[MIT License](https://github.com/techlab/SmartCart/blob/master/LICENSE)

bower.json

@@ -0,0 +1,39 @@
+{
+    "name": "jquery-smartcart",
+    "version": "v3.0.1",
+    "homepage": "http://techlaboratory.net/smartcart",
+    "authors": [
+        "Dipu Raj <[email protected]>"
+    ],
+    "description": "The smart interactive jQuery Shopping Cart plugin with PayPal payment support",
+    "main": [
+        "./dist/css/smart_cart.css",
+        "./dist/js/jquery.smartCart.js"
+    ],
+    "keywords": [
+        "jquery",
+        "cart",
+        "paypal",
+        "shopping",
+        "bootstrap",
+        "ui",
+        "jquery-plugin"
+    ],
+    "dependencies": {
+        "jquery": ">= 1.9.0",
+        "bootstrap": ">= 3.0.0"
+    },
+    "license": "MIT",
+    "ignore": [
+        "**/.*",
+        "node_modules",
+        "composer.json",
+        "examples",
+        "bower_components",
+        ".git*",
+        ".travis*",
+        "*bower.json",
+        "*jquery.json",
+        "test"
+    ]
+}

composer.json

@@ -0,0 +1,31 @@
+{
+    "name": "techlab/jquery-smartcart",
+    "description": "The smart interactive jQuery Shopping Cart plugin with PayPal payment support",
+    "homepage": "http://techlaboratory.net/smartcart",
+    "license": "MIT",      
+    "support": {
+        "source": "https://github.com/techlab/SmartCart",
+        "issues": "https://github.com/techlab/SmartCart/issues",
+        "docs": "http://techlaboratory.net/smartcart/documentation"
+        },
+    "keywords": [
+        "jquery",
+        "cart",
+        "paypal",
+        "shopping",
+        "bootstrap",
+        "ui",
+        "jquery-plugin"
+    ],
+    "authors": [
+        {
+            "name": "Dipu Raj",
+            "email": "[email protected]",
+            "homepage": "http://dipuraj.me"
+        }
+    ],
+    "require": {
+        "components/jquery": ">=1.9",
+        "components/bootstrap": ">=3.0.0" 
+    }
+}

dist/js/jquery.smartCart.js

@@ -15,8 +15,8 @@
     // Default options
 
     var defaults = {
-        cart: [], // initial products in cart
-        resultName: 'cart_list',
+        cart: [], // initial products on cart
+        resultName: 'cart_list', // Submit name of the cart parameter
         theme: 'default', // theme for the cart, related css need to include for other than default theme
         combineProducts: true, // combine similar products on cart
         highlightEffect: true, // highlight effect on adding/updating product in cart
@@ -315,7 +315,7 @@
                     }
                     mi._addUpdateCartItem(mi.cart[i]);
                     // Trigger "quantityUpdate" event
-                    this._triggerEvent("quantityUpdate", [mi.cart[i], qty]);
+                    this._triggerEvent("quantityUpdated", [mi.cart[i], qty]);
                     return false;
                 }
             });