Springboard Shopping Cart

Shopping Cart module for Springboard

Include this module definition on all pages utilizing the shopping cart. Include the springboardCart.css above your custom styles, and include the springboardCart.js file above your custom scripts. They will not interfere with the existing page's css or scripts(and nothing will happen if you don't initialize it with .shop(), as seen below). Utilize the SbCart API methods to Initialize, Add, Remove, Checkout, etc., in your custom scripts:

**Arguments in brackets are [optional]*

Initialize Cart: SbCart.shop({options});

Dev's option to use the default cart, but you'll have to set and reuse the sessionName on every cart initilization, aka, on every page in which you hope to use the shopping cart.

	SbCart.shop({
		sessionName: 'testSession', //A session name is required
		usingDefaultCart: true, 
		brandName: 'Swan & Son',  //I would at least set to blank unless you like my name 
		txtColor: '#ffffff',  
		brandLogo: 'https://artic.gospringboard.com/files/artic/swan_crop2.png',
		bgColor: '#0A004D',
		secondaryColor: '#d8d8d8',
	});

Add Products: SbCart.add(productId, productName, quantity, price [,callback]);

	SbCart.add('aic_member_plus_161.50','Member Plus', 1, 161.50);

Remove Products: SbCart.remove(productId, productName, quantity [,callback]);

	SbCart.remove('aic_member_plus_161.50', 1, function(products){
		//do something with products()
	});

Checkout: SbCart.checkout([callback]);

	SbCart.checkout(function(products){
		//returns products
		//do something with products
	});

Empty the Cart:

Use this on the thank you page after a successful transaction.

	SbCart.emptyCart();

Return Total:

	SbCart.total();

Return Products:

	SbCart.products();

Return quantity of items in Cart:

	SbCart.quantTotal();

Notes

The key to this thing comes from unique(emphasis on unique) ID's attached to the different products. A 'Member-Plus' Membership, selling at $161.50 for instance, could have an ID of `aic_member_plus_80.75`. This will be sold as a 'Ticket' through a Springboard 'Ticketed Event' E-commerce form. In this case, the 'Checkout' form(Form ID 1451). All possible tickets sold by this organization(AIC for example), should be available through this form. The springboardCart module user will be required to add new options to this checkout form, via Ticketed Event >> Checkout(form) >> Tickets >> Tickets >> Add Ticket Type.

The module, on SbCart.checkout(), will scan these available 'tickets' on the Checkout form, and select all that are in the cart with the proper quantity. The user shouldn't see the available tickets at all, and the module user can display the items in the cart as they see fit, as the product object gets returned to them(Or they can simply keep the defaultCart dropdown open).