New Wagtail Course! 🥳 The Ultimate Wagtail Developers Course

Tutorial Wagtail Version: 2.x

Upgrading Wagtail (to 2.5.1), Django (to 2.2.2) and Django Debug Toolbar

In this video we'll go over upgrading your Wagtail website from v2.4 to v2.5.1 and we'll upgrade Django from 2.1.5 to 2.2.2. As a bonus, we'll explore an issue with Django Debug Toolbar.

To upgrade your own project, you can simply run these commands:

  1. pip install wagtail==2.5.1
    This will give you Wagtail v2.5.1
  2. pip install Django==2.2.2
    This will give you Django 2.2.2
  3. pip install django-debug-toolbar==2.0a1 (Debug Toolbar is optional)
    This will upgrade DDT (Django Debug Toolbar, if you're using it)
  4. python manage.py migrate
    Wagtail 2.5.1 and Django 2.2.2 have migrations to run. So let's apply them.
  5. python manage.py runserver 0.0.0.0:8000
    Re-run your server to make sure there are no problems
The Git Commit

The requirements.txt and Pipfile were updated. And I've added a Pipfile.lock to the repo. We also disabled Django Debug Toolbar because it's ultra slow.

https://github.com/CodingForEverybody/learn-wagtail/commit/4efc0639b89261cdb99ca6fdf3c4a974a4ad2493

Related tutorials

Installing Django Debug Toolbar

Posted on

Learn how to add one of the most useful Django debugging tools into your new Wagtail project. We'll go through the installation docs, learn how base.py, dev.py and production.py work together, and how to install Django Debug Toolbar.

View lesson, Installing Django Debug Toolbar

How to Register a Django Model with Wagtails ModelAdmin

Posted on

In the land of Django and Wagtail, sometimes you need custom Django Models but Wagtail doesn't let you edit these models by default. And personally, I don't believe in giving a client 2 admin dashboards to operate in. So let's add a custom Django Model to our Wagtail website using a Wagtail ModelAdmin.

View lesson, How to Register a Django Model with Wagtails ModelAdmin

Setting up Django Shell, Shell Plus and IPython

Posted on

Django comes with a python shell where you can import your models and test things out. It's not great out of the box, but we can make it better by using shell_plus (installation instructions are inside) and letting IPython take care of interactivity. This is all helpful for learning Wagtail.

View lesson, Setting up Django Shell, Shell Plus and IPython

Registering Snippets using Django Models

Posted on

Snippets are Wagtails way of re-using existing data. For example, being able to select a Blog Author (or multiple authors) instead of having to add a name, image and website for every blog author in every blog post you make; instead you can simply fill out a form once, and re-use the final data with a couple of clicks.

View lesson, Registering Snippets using Django Models

The Ultimate Wagtail Developers Course

This course covers everything from basic installation to advanced features like custom blocks and API integration, it's perfect for developers looking to enhance their skills with this powerful CMS.

Ultimate Wagtail Developers Course Logo