Additional Admin Notes

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

#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.