Additional Admin Notes

This page contains additional notes and tips on managing the wiki content.

#Project Groups

Pages are grouped into projects using the Tags field. For example all Landcare Tasmania documents must have the Tags field set to Landcare Tasmania. Top level admin pages should have the page tag.

Sidebar Customisation

Pages can be adjusted and nested in the sidebar by changing the Navivation values. It is possible to override the page Title, set the Parent page to nest the page below another, and set the Order the page appears in the sidebar.

Adding Client Themes

• Please refer to this page on Client Themes

Adding Permalinks

A permalink (slug) can be added to a client landing page to give a cleaner URL.

You can add a permalink via the GUI by editing the Permalink field on shown to the left of the main page editor. Enclose the slug with slashes, for example:

/my-permalink-slug/

You can then access the page at https://mauhanga.forpurpose.nz/my-permalink-slug/

Important notes

• Permalinks should be used sparingly (mainly for client landing pages). The wiki will raise an error if two permalinks with the same slug exist.
• Setting a permalink URL on an existing document might break the relative links on that page. It is important to check all the links on a page after setting a permalink.
• If this happens, click the link to see where the URL is attempting to send you.
• The sidebar links are auto generated so should be correct. Click the link in the sidebar to see what a good link to the page looks like.
• Usually the correction requires adding a prefix to the URL of links on the page. For example:

Incorrect link after adding permalink to page:

https://mauhanga.forpurpose.nz/first-alaskans-institute/core-elements/navbar-nav-menu/

Correct link from Sidebar:

https://mauhanga.forpurpose.nz/docs/first-alaskans-institute/core-elements/navbar-nav-menu/

The fix: Prefix the path of relative links in contents page document with /docs/

Update Logo URL

• This assumes the Client Theme has been set up. If not, refer to the Client Theme documentation above.
• To set the logo to point to the new permalink, the URL can be set in relevant Client Theme settings. (Site settings → Theme palette → Client Theme)
• Click on the Logo Image, then change the Logo URL setting.