An e-commerce extension for Wagtail CMS
 
 
 
 
 
 
Go to file
Nick Moreton cfd2df17e0
Deals with the deprecation of request.site in wagtail 2.9 (#488)
2023-08-13 09:17:47 +01:00
.github Developer docs update (#487) 2023-07-10 11:53:55 +02:00
docs Add docs for integrating Longclaw in existing projects (#235) 2019-10-06 11:17:24 +02:00
longclaw Deals with the deprecation of request.site in wagtail 2.9 (#488) 2023-08-13 09:17:47 +01:00
vagrant Issue 219 calculated rates base class (#230) 2019-11-06 13:46:07 +01:00
website Bump qs from 6.5.2 to 6.5.3 in /website (#483) 2023-04-27 13:39:21 +02:00
.coveragerc First commit 2017-02-03 10:04:57 +00:00
.dockerignore Initial setup of docusaurus 2018-12-29 19:01:02 +01:00
.editorconfig First commit 2017-02-03 10:04:57 +00:00
.gitignore Initial testing fixes (#485) 2023-07-07 15:00:12 +02:00
.landscape.yaml Update landscape to only be py 2 2018-12-31 14:04:32 +01:00
.python-version Initial testing fixes (#485) 2023-07-07 15:00:12 +02:00
.travis.yml Fixes #256, Fixes #248 2019-09-22 12:33:34 +02:00
AUTHORS.rst Add to basket template tag & docs (#82) 2017-08-25 08:33:47 +01:00
CHANGELOG.rst Update CHANGELOG.rst 2019-12-24 17:53:33 +01:00
CONTRIBUTING.rst Longclaw 1.0 (#205) 2018-12-26 12:58:05 +01:00
Dockerfile Initial setup of docusaurus 2018-12-29 19:01:02 +01:00
Dockerfile.dev Add dockerfile for development 2019-10-06 16:41:15 +02:00
LICENSE Longclaw 1.0 (#205) 2018-12-26 12:58:05 +01:00
MANIFEST.in Force inclusion of JSON files 2019-03-28 21:11:54 +01:00
Makefile Initial testing fixes (#485) 2023-07-07 15:00:12 +02:00
README.md Developer docs update (#487) 2023-07-10 11:53:55 +02:00
codecov.yml Checkout view (#68) 2017-05-24 11:12:36 +01:00
docker-compose.yml Initial setup of docusaurus 2018-12-29 19:01:02 +01:00
manage.py Longclaw 1.0 (#205) 2018-12-26 12:58:05 +01:00
runtests.py Longclaw 1.0 (#205) 2018-12-26 12:58:05 +01:00
setup.cfg Bump version: 1.0.1 → 1.0.2 2019-03-28 21:12:42 +01:00
setup.py Initial testing fixes (#485) 2023-07-07 15:00:12 +02:00
tox.ini Initial testing fixes (#485) 2023-07-07 15:00:12 +02:00

README.md

Longclaw

Call For Maintainers

If you are interested in developing this project, please get in touch https://github.com/JamesRamm/longclaw/issues/375

Pypi Version Codecov Status Build Status Code Health

An e-commerce extension for Wagtail CMS

Checkout the documentation

Image of the dashboard

Project Status

We are working to upgrade the package for the latest versions of Django and Wagtail. While doing this we may need to change the way the package is structured as well as making breaking changes to the code. If you want to use Longclaw in a project, please use the latest release (1.0.2) until we have finished the upgrade.

Currently supported versions

We are currently running the tests against the following versions of Python, Django and Wagtail.

  • Django >= 2.2, < 3.1
  • Wagtail >= 2.11, < 2.14
  • Python >= 3.7, < 3.10

Developers

If you are interested in working on this project, please use the Development setup instructions below to get started.

Quickstart

Install Longclaw:

pip install longclaw

Setup a Longclaw project

longclaw start my_project

Go to project directory and create missing migrations

python manage.py makemigrations home catalog

Do migrations for whole project and run

python manage.py migrate
python manage.py loadcountries
python manage.py createsuperuser
python manage.py runserver

Features

  • Tightly integrated with Wagtail. Create products, manage orders, configure shipping and view statistics all from the Wagtail admin.
  • Multiple payment backends. Longclaw currently supports Stripe, Braintree and PayPal (v.zero) payments.
  • Comprehensive REST API & javascript client easily loaded via a template tag
  • Create your catalogue as Wagtail pages, with complete control over your product fields
  • Easy setup. Just run longclaw start my_project to get going
  • Simple to use, simple to change. Write your frontend as you would any other wagtail website. No complicated overriding, forking etc in order to customise behaviour.

Screenshots

Order Detail

Development setup

Work in progress

The following instructions are for setting up a development environment for Longclaw while we work on the upgrade. If you want to use Longclaw in a project, please use the latest release (1.0.2) until we have finished the upgrade.

Create a virtualenv and install the requirements

python3 -m venv venv
source venv/bin/activate
pip install -e ".[testing]"

Install and build the frontend

The frontend is built using node and webpack. The version of node required is v12 (LTS). We recommend using nvm to manage node versions.

cd longclaw/client

Optional: If you are using nvm, you can run nvm use to set the correct version of node.

Install the dependencies and build the frontend

npm install --no-save
npm run build

Run the tests

make test

Run the tests with TOX

make test-all