Important: this tutorial is no longer supported. It is based on addons that require Django 1.11 and will not work with later versions.
If you don’t already have a free Divio Account, head over to the Divio website and create one, now.
Before we begin
Before we create a project, please familiarise yourself with the basics of Divio Cloud. Some key topics and resources:
- General overview of the Control Panel
More information about your account, project settings and more.
- How to create a new Divio Cloud project
Additional detail about project creation options.
- Frequently Asked Questions
You might find answers to your questions here.
- Developer tutorials
More experienced developers should be aware of the material in our Developer Handbook.
Some of these guides will make more sense and be most useful once you have already dived in and are working with Divio Cloud.
Create a new project
Create a new project with the following configuration:
- Platform: Python 3.6.x
- Type: django CMS
- Boilerplate: HTML5 Boilerplate
What are Boilerplates?
Click on Continue after you settled on a name to get to the subscription page. For this tutorial you don't need any features that are not included in the Free plan, so just click Skip for now at the bottom of the page and then Continue in the modal to get to the project’s Dashboard.
On the Project's Dashboard, you’ll find multiple options to manage your django CMS project on Divio. For this tutorial, we’ll only be focusing on these two sections:
First, navigate to the Addons section. This section allows you to install certain Addons published on Divio.
We want to install two additional addons for this tutorial:
- django CMS Bootstrap 4
- Aldryn News & Blog
In the top-right area of the Addons section, find the search box and type in "django CMS Bootstrap 4". The result should look something like this:
Click the ellipsis on the right side and then on Install for free. This will bring you to the installation page of the Addon.
Certain Addons require configuration before they can be added. For now, leave these settings as-is. Then, click Install in the lower right corner.
Next, search for "Aldryn News & Blog" and repeat the same steps as the previous Addon.
In the same Interface, search for "django CMS Link", "django CMS Picture" and "django CMS File". On each click Uninstall.
django CMS Bootstrap 4 already provides a bootstrap enhanced link, picture and file plugin, no need to overcomplicate the choices.
You will see an uninstalling progress bar, after the checks are done, click Uninstall to remove the Addon from your project.
On the next deployment these changes will take effect.
What’s Bootstrap 4?
Bootstrap (http://getbootstrap.com/) is a popular web framework, which comes with many built-in web components such as Carousels, Dropdown Buttons and Navigation Bars, and handles responsive and mobile-driven websites out of the box.
At last hit the Deploy button for the "Test server" on the Dashboard to setup your project. Once this has finished you are ready to go to the next step:
Let’s move on to the next step and install the Divio App.