Creating and editing custom content

Custom content allows Administrators to customise the style/appearance of Tablion using either HTML or CSS. Custom content requires skills in HTML/CSS.

How to create and edit custom content

1. Select 'Admin tools' from your username dropdown.

1. Select 'Custom content'.

1. If you wish to create new custom content, select 'Create'. If you wish to edit existing custom content, select 'Edit' from the relevant custom content's row.

Note: Custom content cannot be deleted after creation, only edited (with the exception of the 'Name' field).

1. Populate the 'Name' field in accordance to the custom content you wish to use. The following is a list of all custom content inputs recognised by Tablion, along with images of what part of Tablion they will affect:

• 'custom_links.html': Configures header links available to all users (custom links will appear in the highlighted space below)

• 'email_wrapper.html': Configures the header, footer and general template that Tablion emails will be 'wrapped' in when '{% db_template 'email_wrapper.html' %}' is used in the HTML of an email notification template. This is an alternative to using 'email_header.html' and 'email_footer.html' (see below) in tandem

• 'custom.css': Configures site appearance using Bootstrap 5 in order to align Tablion's styling to corporate and other style guidelines as required. This input is the only input which should use the 'CSS' option from the 'Content type' dropdown.

Note: Do not use this input if you are unfamiliar with CSS. If you are unfamiliar with CSS, consult a member of your organisation's IT staff who is familiar.

• 'crown.html': Configures the topmost section of Tablion's header (if left unconfigured, the crown will not appear)

• 'neck.html': Configures the bottommost section of Tablion's header (if left unconfigured, the neck will not appear)

• 'ankle.html': Configures the topmost section of Tablion's footer (if left unconfigured, the ankle will not appear)

• 'custom_footer.html': Configures the middle section of Tablion's footer

• 'sole.html': Configures the bottommost section of Tablion's footer (if left unconfigured, the sole will not appear)

• 'user_summaries_pdf_head.html': Configures the header of user summaries downloaded from the 'Members' tab of a data request

• 'email_header.html': Configures the header of Tablion emails when '{% db_template 'email_header.html' %}' is used in the HTML of an email notification template

• 'email_footer.html': Configures the footer of Tablion emails when '{% db_template 'email_footer.html' %}' is used in the HTML of an email notification template

• 'home.html': Configures the homepage accessed via the 'Home' link in Tablion's header

• 'register-account-top.html': Configures the 'top' of the 'Register an account' page that appears when a user selects 'Register' from Tablion's header

• 'robots.txt': Configures a txt page accessible via https://[your-data-portal]/robots.txt

• 'mfa_setup_msg.html': Configures the message displayed when a user enables Multi-Factor Authentication (MFA)

• 'mfa_disable_msg.html': Configures the message displayed when a user disables MFA

Note: The 'Name' field cannot be edited after creation.

1. Select the desired content type using the 'Content type' dropdown.

Note: The 'custom.css' input is the only custom content input that uses the 'CSS' content type.

Note: For the custom content to work correctly, the content type must align to the file extension used in the 'Name' field.

1. Populate the 'Content' field with the custom content you wish to create.

1. Select 'Save'. Your custom content will now appear on the 'Custom content' tab, and will be applied to your site.