|
|
@@ -7,41 +7,43 @@
|
|
7
|
7
|
Welcome to the documentation for django-oscar
|
|
8
|
8
|
=============================================
|
|
9
|
9
|
|
|
10
|
|
-django-oscar is a ecommerce framework for Django 1.3 for building domain-driven
|
|
11
|
|
-ecommerce sites. It is structured in way that lets any part of the core
|
|
12
|
|
-ecommerce functionality be customised to suit the needs of your project.
|
|
|
10
|
+django-oscar is an ecommerce framework for Django, designed for building
|
|
|
11
|
+domain-driven applications. It is structured in way that lets any part of the
|
|
|
12
|
+core functionality be customised to suit the needs of your project. For
|
|
|
13
|
+instance, if every product in your shop has an associated video, then
|
|
|
14
|
+django-oscar lets you add such a field to your core product model. You don't
|
|
|
15
|
+have to model your domain logic using the Entity-Attribute-Value pattern or
|
|
|
16
|
+other such meta-nastiness - your core models should reflect the specifics of
|
|
|
17
|
+your domain.
|
|
13
|
18
|
|
|
14
|
|
-It is developed by Tangent Labs, a London-based digital agency, and is based on
|
|
15
|
|
-their existing Taoshop PHP platform which currently powers several large-scale ecommerce sites.
|
|
|
19
|
+django-oscar is developed by Tangent Labs, a London-based digital agency, and
|
|
|
20
|
+is based on their existing Taoshop PHP platform which currently powers several
|
|
|
21
|
+large-scale ecommerce sites.
|
|
16
|
22
|
|
|
17
|
|
-It is still in early development, but a stable release is planned for early summer 2011.
|
|
18
|
|
-The source is on Github: https://github.com/tangentlabs/django-oscar - all contributions welcome.
|
|
|
23
|
+The source is on Github: https://github.com/tangentlabs/django-oscar.
|
|
19
|
24
|
|
|
20
|
25
|
Quick start
|
|
21
|
26
|
===========
|
|
22
|
27
|
|
|
23
|
|
-We can do this quickly. Create a virtualenv using virtualenvwrapper and install django-oscar::
|
|
|
28
|
+We can do this quickly. Create a virtualenv using virtualenvwrapper and
|
|
|
29
|
+install django and django-oscar::
|
|
24
|
30
|
|
|
25
|
31
|
mkvirtualenv --no-site-packages vanilla
|
|
26
|
32
|
pip install django django-oscar
|
|
27
|
33
|
|
|
28
|
|
-Take a copy of the example vanilla site, and copy the quickstart settings into place::
|
|
|
34
|
+Take a copy of the sameple settings file, found at::
|
|
29
|
35
|
|
|
30
|
|
- cdsitepackages
|
|
31
|
|
- cp -r
|
|
32
|
|
-
|
|
33
|
|
- cp -r ~/.virtualenvs/myshop/lib/python2.6/site-packages/src/examples/vanilla/ /tmp/vanilla
|
|
34
|
|
- cd /tmp/vanilla
|
|
35
|
|
- cp settings_quickstart.py settings.py
|
|
|
36
|
+ https://github.com/tangentlabs/django-oscar/blob/master/examples/vanilla/settings_quickstart.py
|
|
36
|
37
|
|
|
37
|
38
|
Import the sample products and images::
|
|
38
|
39
|
|
|
39
|
|
- python manage.py import_catalogue ~/.virtualenvs/myshop/src/django-oscar/examples/sample-data/books-catalogue.csv
|
|
40
|
|
- python manage.py import_images ~/.virtualenvs/myshop/src/django-oscar/examples/sample-data/book-images.tar.gz
|
|
|
40
|
+ wget https://github.com/tangentlabs/django-oscar/blob/master/examples/sample-data/books-catalogue.csv
|
|
|
41
|
+ python manage.py import_catalogue books-catalogue.csv
|
|
41
|
42
|
|
|
42
|
|
-And there you have it: a fully functional ecommerce site with a product range of 100 popular books.
|
|
|
43
|
+ wget https://github.com/tangentlabs/django-oscar/blob/master/examples/sample-data/book-images.tar.gz
|
|
|
44
|
+ python manage.py import_images book-images.tar.gz
|
|
43
|
45
|
|
|
44
|
|
-Getting started:
|
|
|
46
|
+And there you have it: a fully functional ecommerce site with a product range of 100 popular books.
|
|
45
|
47
|
|
|
46
|
48
|
.. toctree::
|
|
47
|
49
|
:maxdepth: 2
|
|
|
@@ -50,7 +52,6 @@ Getting started:
|
|
50
|
52
|
contributing
|
|
51
|
53
|
getting_started
|
|
52
|
54
|
|
|
53
|
|
-
|
|
54
|
55
|
Full contents:
|
|
55
|
56
|
|
|
56
|
57
|
.. toctree::
|