| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566 |
- Customize Navbar and Footer
- ===========================
- Navbar
- ------
- The navbar (also known as Navigation Bar, Header, or Menu) is a shared piece
- navigation. Wagtail CRX shows an area for the navbar at the top of most pages on
- the site. The logo and style of the navbar can be customized under **Settings >
- Layout**. The links shown in the navbar can be customized by creating a "Navbar"
- snippet under **Snippets > Navbar**.
- .. note::
- Each Navbar snippet is rendered sequentially in the navbar area. This currently
- does not support multi-site, i.e. all Navbar snippets are present on all sites.
- Customizing the design of the stock navbar can be accomplished by baked in
- Django template overrides.
- Create a ``templates\wagtailcrx\snippets`` directory in your project,
- most likely in the ``website`` directory.
- In that directory create a file called ``navbar.html``. This file will then
- override the ``navbar.html`` file included with Wagtail CRX.
- It is advisable to initially copy the contents of `Wagtail CRX navbar.html`_, but
- not necessary.
- .. _Wagtail CRX navbar.html: https://github.com/coderedcorp/wagtailcrx/blob/dev/wagtailcrx/templates/wagtailcrx/snippets/navbar.html
- Footer
- ------
- The footer is a shared piece of content shown at the bottom of every page on the
- site. Content can be added to the footer by creating a "Footer" snippet under
- **Snippets > Footer**.
- .. note::
- Each Footer snippet is rendered sequentially in the footer area. This
- currently does not support multi-site, i.e. all Footer snippets are present
- on all sites.
- Customizing the design of the sock footer can be accomplished similarly to the
- navbar, by overriding the Django template.
- Create a ``templates/wagtailcrx/snippets/`` directory in your project,
- most likely in the ``website`` directory.
- In that directory create a filed named ``footer.html``. This file will then
- override the ``footer.html`` file included with Wagtail CRX.
- Similarly, it is advisable to initially copy the contents of `Wagtail CRX
- footer.html`_, but not necessary.
- .. note::
- You can now create more than one navbar menu or footer and choose which ones to render on your site. In **Settings > Layout**,
- select your navbars in **Site Navbars**. Select your footers in **Site Footers**. The Site Navbar Layout includes settings for the whole
- navbar, while the Site Navbar chooser allows you to choose which menu you want for your site. This features allows you to
- select a different navbar/footer per site in a multisite installation OR render several navbars/footers in selected order
- on a single site.
- .. _Wagtail CRX footer.html: https://github.com/coderedcorp/wagtailcrx/blob/dev/wagtailcrx/templates/wagtailcrx/snippets/footer.html
|
