You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566
  1. ======================
  2. Playing in the sandbox
  3. ======================
  4. Oscar ships with a 'sandbox' site, which is a vanilla install of Oscar using the
  5. default templates and styles. It is useful for exploring Oscar's functionality
  6. and developing new features.
  7. It only has two customisations on top of Oscar's core:
  8. * Two shipping methods are specified so that the shipping method step of
  9. checkout is not skipped. If there is only one shipping method (which is true of core
  10. Oscar) then the shipping method step is skipped as there is no choice to be
  11. made.
  12. * A profile class is specified which defines a few simple fields. This is to
  13. demonstrate the account section of Oscar, which introspects the profile class
  14. to build a combined User and Profile form.
  15. Note that some things are deliberately not implemented within core Oscar as they
  16. are domain-specific. For instance:
  17. * All tax is set to zero
  18. * No shipping methods are specified. The default is free shipping.
  19. * No payment is required to submit an order as part of the checkout process
  20. The sandbox is, in effect, the blank canvas upon which you can build your site.
  21. Browse the external sandbox site
  22. ================================
  23. An instance of the sandbox site is build hourly from master branch and made
  24. available at http://latest.oscarcommerce.com
  25. .. warning::
  26. It is possible for users to access the dashboard and edit the site content.
  27. Hence, the data can get quite messy. It is periodically cleaned up.
  28. .. warning::
  29. Since this site is built from the unstable branch, occasionally things won't
  30. be fully stable. A more stable 'demo' site is in preparation, which will be
  31. more suitable for impressing clients/management.
  32. Running the sandbox locally
  33. ===========================
  34. It's pretty straightforward to get the sandbox site running locally so you can
  35. play around with the source code.
  36. Install Oscar and its dependencies within a virtualenv::
  37. $ git clone git@github.com:tangentlabs/django-oscar.git
  38. $ cd django-oscar
  39. $ mkvirtualenv oscar
  40. $ make sandbox
  41. $ sites/sandbox/manage.py runserver
  42. The sandbox site (initialised with a sample set of products) will be available
  43. at: http://localhost:8000. A sample superuser is installed with credentials::
  44. username: superuser
  45. email: superuser@example.com
  46. password: testing