jazkarta.shop 2.0.6

Shopping Cart

Users can add items to their cart while browsing products on the website. They can then click the cart icon to view and adjust the contents of their shopping cart.

Pluggable Payment Processors

Currently available:

• Stripe (Stripe Elements)

• Authorize.net SIM (legacy)

• Authorize.net Accept.js

Pluggable Shipping Providers

Currently available:

• USPS

• UPS (Python 2.x only)

Pluggable Sales Tax APIs

For calculating US state and local taxes. Currently available:

• Washington state handler

• Taxjar handler (a commercial service for automated sales tax calculation based on address)

• NoTax handler for disabling sales tax calculation entirely

Purchasable Content Types

Types can be Dexterity or Archetypes. Make your own content type purchasable using a behavior or schema extender. (Note: Archetypes support in Python 2.x only)

Recommended Products

A product can have other products related to it so that they can be recommended at the time of purchase. When users review their cart, they will be presented with a list of recommended products populated from the Recommended Products fields of all the products they’re about to purchase.

Cart Stored in ZODB

Shopping cart data is stored in the ZODB rather than in sessions even for anonymous users. This makes it easier to deploy when running multiple Zope instances.

Form Integration

PloneFormGen integration provided by jazkarta.pfg.jazshop.

Easyform integration provided by jazkarta.easyformplugin.jazshop.

Compatible With

• Plone 4.3

• Plone 5.0.x, 5.1.x on Python 2.7

• Plone 5.2.x on Python 2.7, 3.6, 3.7, 3.8

Jazkarta Shop Settings

This control panel allows configuration of:

• Which payment processor to use

• Payment processor keys or login information for development and production use

• Subject and introduction for receipt emails

• Product categories

• Minimum stock level

• Shipped from name and address

• Shipping handler keys or login information

• Which tax handler to use

• Optional Taxjar API token

• Optional after-checkout callback URL

jazkarta.shop requires the environment variable JAZKARTA_SHOP_PRODUCTION to be set to True when it is running in production mode. eg:

[buildout]

...

parts +=
    client1

[client1]

...

environment-vars +=
    JAZKARTA_SHOP_PRODUCTION True

Jazkarta Shop Shipping Methods

Named shipping methods can be added and edited. Each shipping method specifies the geographical areas it is used for, the shipping fee calculation method, minimum and maximum weights, and optionally a minimum purchase amount.

If using UPS or USPS shipping methods, please make sure the revelevant API keys are added in the “Jazkarta Shop Settings” control panel.

Jazkarta Shop Orders

This control panel provides a table of order information such as date, items, shipping information and price. Orders can be filtered by date and exported to CSV.

Basic Notes on Use

For each content type that has the “Jazkarta Shop Product” behavior enabled, an “Add to Cart” button shown when viewing the content type. This allows the user to add an item to the cart. A clickable cart viewlet “My Cart” is used to display the shopping cart in the site header. It contains a “Checkout” link to the /review-cart view. /review-cart and /checkout views can be used to modify/update cart contents.

The basic use flow:

Click “Add to Cart” button -> Click “Checkout” in viewlet -> /review-cart -> /shipping -> /checkout -> Complete purchase

Events

Clicking on the “Add to Cart” button fires an item-added jquery event, which can optionally be used as a hook for custom js code to alert the user that the cart contents have changed.

Authors

• David Glick (initial author)

• Carlos de la Guardia

• Alec Mitchell

• Witek

• Fulvio Casali

• Silvio Tomatis

• Alessandro Ceglie

• Jesse Snyder