https://github.com/LUKKIEN/oscar-wagtail-demo
A Django recipe for integrating Oscar E-commerce into a Wagtail CMS application.
https://github.com/LUKKIEN/oscar-wagtail-demo
ecommerce oscar wagtail
Last synced: about 1 month ago
JSON representation
A Django recipe for integrating Oscar E-commerce into a Wagtail CMS application.
- Host: GitHub
- URL: https://github.com/LUKKIEN/oscar-wagtail-demo
- Owner: LUKKIEN
- License: mit
- Archived: true
- Created: 2016-07-28T14:37:19.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2017-08-31T08:07:48.000Z (over 7 years ago)
- Last Synced: 2024-11-02T19:34:18.677Z (6 months ago)
- Topics: ecommerce, oscar, wagtail
- Language: Python
- Size: 5.18 MB
- Stars: 20
- Watchers: 2
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-wagtail - Oscar Wagtail demo project - A Django recipe for integrating Oscar E-commerce into a Wagtail CMS application. (Resources / Recipes)
README
Oscar Wagtail demo project
==========================
**A Django recipe for integrating [Oscar E-commerce](http://oscarcommerce.com) into a [Wagtail CMS](http://wagtail.io) application.**
*We do __not__ recommend using this project to start your own site*. This recipe is only to provide some examples of implementing common features, it is not an exemplar of Django, Oscar or Wagtail best practice.
If you're reasonably new to Python/Django, we suggest you run this project on a Virtual Machine using Vagrant, which helps resolve common software dependency issues. However instructions to start this project without Vagrant follow below.
Setup with Vagrant
------------------
### Dependencies
* [VirtualBox](https://www.virtualbox.org/)
* [Vagrant 1.5+](https://www.vagrantup.com)
### Installation
Run the following commands:
git clone https://github.com/LUKKIEN/oscar-wagtail-demo.git
cd oscar-wagtail-demo
vagrant up
vagrant ssh
(then, within the SSH session:)
./manage.py runserver 0.0.0.0:8000
The demo site will now be accessible at [http://localhost:8000/](http://localhost:8000/), the Wagtail admin interface at [http://localhost:8000/admin/](http://localhost:8000/admin/) and the Oscar dashboard interface at [http://localhost:8000/dashboard/](http://localhost:8000/dashboard/). Log into them with the credentials ``admin / changeme``.
Setup without Vagrant
-----
Don't want to set up a whole VM to try out Wagtail? No problem.
### Dependencies
* [PostgreSQL](https://www.postgresql.org) or [SQLite](https://www.sqlite.org/)
* [PIP](https://github.com/pypa/pip)
### Installation
With PostgreSQL running (and configured to allow you to connect as the 'postgres' user - if not, you'll need to adjust the `createdb` line and the database settings in wagtaildemo/settings/base.py accordingly), run the following commands:
git clone https://github.com/LUKKIEN/oscar-wagtail-demo.git
cd oscar-wagtail-demo
virtualenv .
source bin/activate
createdb -Upostgres oscarwagtaildemo
make develop
./manage.py runserver
The `make develop` command combines:
* `make clean` cleaning any compiled Python files
* `make install` installing dependencies via `pip` package manager
* `make migrations` performing `./manage migrations` to perform database migrations
* `make fixtures` load both Wagtail and Oscar fixtures and perform `update_index`
* `make superuser` create superuser (you'll be prompted for username, e-mail address and password)
The demo site will now be accessible at [http://localhost:8000/](http://localhost:8000/), the Wagtail admin interface at [http://localhost:8000/admin/](http://localhost:8000/admin/) and the Oscar dashboard interface at [http://localhost:8000/dashboard/](http://localhost:8000/dashboard/). Log into them with the credentials inserted in earlier step.
### SQLite support
SQLite is supported as an alternative to PostgreSQL - update the `DATABASES` setting in wagtaildemo/settings/base.py to use `'django.db.backends.sqlite3'` and set `NAME` to be the full path of your database file, as you would with a regular Django project.
Contributors
------------
- [Peter Govers](https://github.com/pgovers) ([Lukkien](https://www.lukkien.com))
- [Coen van der Kamp](https://github.com/allcaps) ([Four Digits](https://www.fourdigits.nl))
- [Henk-Jan van Hasselaar](https://github.com/Henk-JanVanHasselaar) ([Lukkien](https://www.lukkien.com))
- [Ludolf Takens](https://github.com/ltakens) ([Four Digits](https://www.fourdigits.nl))