2
0

navigation_bars.rst 1.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243
  1. Navigation Bars
  2. ===============
  3. A representation of a navigation bar that sits at the top of your pages.
  4. Usage
  5. -----
  6. You define your content walls in the Snippets > Navigation Bars section of the admin. Once defined, your navigation bars will render on your page, stacked on top of each other.
  7. Fields
  8. ------
  9. **Name**: A unique name for your footer. It can be anything, it is just used as a personal reference to easily tell them apart.
  10. **Custom CSS class**: If you need to add a specific css class for this footer, add it here.
  11. **Custom ID**: If you need to add a specific ID for this footer, add it here.
  12. **Navigation Links**: A list of links to use for the navigation bar.
  13. Navigation Links
  14. ----------------
  15. Navigation links are a streamfield that allows you to craft different types of links in your navigation bar. All of these link types have the following fields:
  16. **Display text**: The text you want to use for the link. This is not necessary if you're using an **Image** as the link.
  17. **Image**: The image you want to use for the link. This is optional and only really used if you need some special image to be used as the link, something like a paypal donate button.
  18. **Sub-links**: Optional field to determine any dropdown links attached to this link.
  19. Page Link With Sub-Links
  20. ~~~~~~~~~~~~~~~~~~~~~~~~
  21. **Page**: The page on your site that you want to link to.
  22. **Show child pages**: Toggle to determine whether this link should automatically generate a dropdown that lists the **Page** children.
  23. External Link With Sub-Links
  24. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  25. **URL**: The URL you want to link to.
  26. Document Link With Sub-Links
  27. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  28. **Document**: The document you want to link to that will be downloaded.
  29. Site Navbars
  30. ------------
  31. In **Settings > Layout**, select which Navbars you want to display on your site under the Site Navbars section.