In this short guide we will show you how to set up an Oscar Project on Divio Cloud.
Create the project
Click on Add new Project.
This will redirect you to the "Add new Project" creation screen. In addition to choosing a Name for your project, the following options are required to get started with the guide:
- Creation: New
- Region: Choose United States or European Union
- Python: Python 2.7.x
- Type: Oscar
- Boilerplates: Blank Boilerplate
Click Create Project and continue to the Project’s Dashboard.
Set up and run the project locally
Install and launch the Divio App.
Select your project and hit Setup to get started. The Divio App will run through a number of processes to set up the local project. It all happens automatically and takes just a few minutes.
Once this process has completed, you can actually start the local site by getting the local server running. Select Start to launch it. To open the local site in your browser, click the eye icon.
This will open your project in your default browser, and take you to the Django admin.
To get to the Oscar welcome page, visit
/shop on your site.
shop is the default URL prefix for Django Oscar, but you can change this by setting the
ALDRYN_DJANGO_OSCAR_URL_PREFIX in your
Login to the Django admin (by appending
/admin to the site's URL in the usual way). Create a new user by hitting Add user and then sign in. (Learn more about how this works.)
Add a "not found" image
Oscar expects a "not found" image. Add a file called image_not_found.jpg (download Oscar's image) to your project's /data/media directory.
Set an environment variable on your test and/or live server for MEDIA_ROOT to '/app/data/media/'.
Make sure that you remove the data folder from your .gitignore file before you push your changes.
Important - where the Oscar guide refers to:
- http://127.0.0.1:8000/, use your site's local address (usually http://0.0.0.0:8000/) instead
- python manage.py, use docker-compose run --rm web python manage.py
- pip install <package>, install requirements via the requirements.in file
You've now created a new Django Oscar project on Divio Cloud, deployed it locally in the Divio Cloud environment, configured it at the Python level, and started editing it. The next step is to publish it on the web, using the Divio Cloud.
It's worth following our Get Started guide in its entirety to become properly familiar with the system and what you can do with it, but in the meantime, if you want to do it the quick way with a minimum of explanation, go straight to Step 5: Push changes to your server of that article - it'll show you how to push all your changes to the cloud and deploy the project live on the web.