------------------
* Added rendering logic to Menu classes and refactored all existing template
tags to make use of it (massively reducing code duplication in menu_tags.py).
* Added support for several 'hooks', allowing for easier customisation of base
querysets and manipulation of menu items during rendering. For more
information and examples, see the 'Hooks' section of the documentation:
<http://wagtailmenus.readthedocs.io/en/latest/advanced_topics/hooks.html>
* Updated the 'sub_menu' tag to raise an error if used in a way that isn't
supported.
* Deprecated `get_sub_menu_items_for_page` and `prime_menu_items` methods from
`wagtailmenus.templatetags.menu_tags` (logic moved to menu classes).
* Deprecated `get_template` and `get_sub_menu_template_names` methods from
`wagtailmenus.utils.template` (logic moved to menu classes).
* Deprecated `get_attrs_from_context` method from `wagtailmenus.utils.misc`
(logic moved to menu classes).
* Deprecated the `MenuFromRootPage` class from `wagtailmenus.models.menus` in
favour of using a new `MenuFromPage` class that fits better with how it's
used in menu classes.
* Minor tidying / renaming of tests.
* Added a 'add_menu_items_for_pages()' method to the `MenuWithMenuItems` model,
which adds menu item to a menu object, linking to any pages passed in as a `PageQuerySet`.
* Added the 'autopopulate_main_menus' command, that can be run as part of the
installation process to help populate main menus based on the 'home' and
'section root' pages for each site.
* Fixed an issue with runtests.py that was causing tox builds in Travis CI
to report as successful, even when tests were failing. Contributed by
Oliver Bestwalter (obestwalter).
* Deprecated the `stop_at_this_level` argument for the `sub_menu` tag, which
hasn't worked for a few versions.
* Added support for Wagtail 1.12.
* Made the logic in menu classes 'page_children_dict' method easier to override
by moving it out into a separate 'get_page_children_dict()' method, which the
original (cached_property decorated) method calls.
* Made the logic in menu classes 'pages_for_display' method easier to override
by moving it out into a separate 'get_pages_for_display()' method, which the
original (cached_property decorated) method calls.
* Made the logic in menu classes 'top_level_items' method easier to override
by moving it out into a separate 'get_top_level_items()' method, which the
original (cached_property decorated) method calls.