Created by Stephen McDonald
Overview
Cartridge is a shopping cart application built using the Django framework. It is BSD licensed, and designed to provide a clean and simple base for developing e-commerce websites. It purposely does not include every conceivable feature of an e-commerce website; instead, Cartridge focuses on providing core features common to most e-commerce websites.
This specific focus stems from the idea that every e-commerce website is different, is tailored to the particular business and products at hand, and should therefore be as easy to customize as possible. Cartridge achieves this goal with a code-base that is as simple as possible and implements only the core features of an e-commerce website.
Cartridge extends the Mezzanine content management platform. A live demo of Cartridge can be found by visiting the Mezzanine live demo.
Features
Hierarchical categories
Easily configurable product options (colours, sizes, etc.)
Hooks for tax/shipping calculations and payment gateways
Sale pricing
Promotional discount codes
PDF invoice generation (for packing slips)
Stock control
Product popularity
Thumbnail generation
Built-in test suite
Separation of presentation (no embedded markup)
Smart categories (by price range, colour, etc)
Registered or anonymous checkout
Configurable number of checkout steps
Denormalised data for accessibility and performance
Authenticated customer accounts with transaction history
Dependencies
Cartridge is designed as a plugin for the Mezzanine content management platform, and therefore requires Mezzanine to be installed. The integration of the two applications should occur automatically by following the installation instructions below.
Installation
The easiest method is to install directly from PyPI using pip by running the command below, which will also install the required dependencies mentioned above:
$ pip install -U cartridge
Otherwise, you can download Cartridge and install it directly from source:
$ python setup.py install
Once installed, the command mezzanine-project can be used to create a new Mezzanine project, with Cartridge installed, in similar fashion to django-admin.py:
$ mezzanine-project -a cartridge project_name $ cd project_name $ python manage.py createdb --noinput $ python manage.py runserver
Here we specify the -a switch for the mezzanine-project command, which tells it to use an alternative package (cartridge) for the project template to use. Both Mezzanine and Cartridge contain a project template package containing the settings.py and urls.py modules for an initial project. If you’d like to add Cartridge to an existing Mezzanine or Django project, you’ll need to manually configure these yourself. See the FAQ section of the Mezzanine documentation for more information.
You should then be able to browse to http://127.0.0.1:8000/admin/ and log in using the default account (username: admin, password: default). If you’d like to specify a different username and password during set up, simply exclude the --noinput option included above when running createdb.
Contributing
Cartridge is an open source project managed using both the Git and Mercurial version control systems. These repositories are hosted on both GitHub and Bitbucket respectively, so contributing is as easy as forking the project on either of these sites and committing back your enhancements.
Please note the following guidelines for contributing:
Contributed code must be written in the existing style. For Python (and to a decent extent, JavaScript as well), this is as simple as following the Django coding style and (most importantly) PEP 8. Front-end CSS should adhere to the Bootstrap CSS guidelines.
Contributions must be available on a separately named branch based on the latest version of the main branch.
Run the tests before committing your changes. If your changes cause the tests to break, they won’t be accepted.
If you are adding new functionality, you must include basic tests and documentation.
Here’s a quick start to hacking on Cartridge after forking it on GitHub, by using the internal “project_template” as your current project:
$ git clone https://github.com/your-github-username/cartridge/
$ cd cartridge
$ git checkout -b your-new-branch-name
$ cp cartridge/project_template/project_name/local_settings.py{.template,}
$ python setup.py develop
$ python cartridge/project_template/manage.py createdb --noinput
$ python cartridge/project_template/manage.py runserver
"hack hack hack"
$ python setup.py test
$ git commit -am "A message describing what you changed."
$ git push origin your-new-branch-name
Language Translations
Cartridge makes full use of translation strings, which allow Cartridge to be translated into multiple languages using Django’s internationalization methodology. Translations are managed on the Transiflex website but can also be submitted via GitHub or Bitbucket. Consult the documentation for Django’s internationalization methodology for more information on creating translations and using them.
Third-party Modules
The following modules have been developed outside of Cartridge. If you have developed a module to integrate with Mezzanine or Cartridge, and would like it listed in the documentation, send an email to the mezzanine-users mailing list. You can also add modules to the Mezzanine Grid on djangopackages.com.
cartridge_braintree - Payment processor for Braintree.
cartridge-external-payment - Allows payment on an external provider platform.
cartridge-tax - Implements a handful of sales tax models.
cartridge-stripe - Alternative payment backend for Stripe.
cartridge-pinpayments - PIN payments integration.
Donating
If you would like to make a donation to continue development of Cartridge, you can do so via the Mezzanine Project website.
Support
To report a security issue, please send an email privately to core-team@mezzaninecms.com. This gives us a chance to fix the issue and create an official release prior to the issue being made public.
For all other Cartridge support, the primary channel is the mezzanine-users mailing list. Questions, comments, and all related discussions take place here amongst knowledgeable members of the community.
If you’re certain you’ve come across a bug, then please use the GitHub issue tracker. It’s crucial that enough information is provided to reproduce the bug. This includes things such as the Python stack trace generated by error pages, as well as other aspects of the development environment used, such as operating system, database, Python version, etc. If you’re not sure you’ve found a reproducable bug, then please try the mailing list first.
Finally, feel free to drop by the #mezzanine IRC channel on Freenode, for a chat!
Communications in all Cartridge and Mezzanine spaces are expected to conform to the Django Code of Conduct.
Sites Using Cartridge
2 maintainers
Release files for Cartridge 1.3.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| Cartridge-1.3.4.tar.gz | 2.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| Cartridge-1.3.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.5 MB
Release files / Cartridge-1.3.4.tar.gz
| Download URL | Cartridge-1.3.4.tar.gz |
|---|---|
| Size | 2.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
badcb3f08c7be1c0d371195fcf017562b95898cad8931c49fa7faff7a5ef78ae
|
|
BLAKE2b-256 checksum How to use checksums |
dc0835ebbf815c4d87c5b2856714289ff35f74992583ab7b5fe07f222870784c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.9.13
|
Release files / Cartridge-1.3.4-py3-none-any.whl
| Download URL | Cartridge-1.3.4-py3-none-any.whl |
|---|---|
| Size | 548.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c019fa4ac8847719997577eab7b60bbcddc624dc5b47133723fb3593b44bb373
|
|
BLAKE2b-256 checksum How to use checksums |
9f44b508c645914241924806b54cbf93ecc303738df62ce3304f541b105e6295
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.9.13
|
