Documentation

Settings Page

The Ditty Settings page can be found in your dashboard, in the main menu, at Ditty > Settings.

General Settings

Some basic settings for Ditty.

  • Live Refresh Rate – If your Ditty are set to live refresh, this will set the amount of time (in minutes) between refresh.
  • Edit Links – Toggle quick Ditty edit links on the front-end of your site. These links will only be visible to logged in users who have permission to edit Ditty.
  • Font Awesome – Ditty comes packaged with Font Awesome, which will load on the front-end of your site. If there are conflicting versions of Font Awesome running on your site, you can disabled Ditty from loading it.
  • Ditty News Ticker – If you are a legacy user of Ditty and are still using Ditty News Ticker, this setting needs to be Enabled. For everyone else, this setting should be Disabled as it will load unnecessary assets on the front-end of your site.

Global Ditty

Use the fields on this page to render a Ditty anywhere on your site using javascript. You’ll need to provide an html selector, which will be used for placement of the Ditty.

  • HTML Selector – Add an HTML element selector to target for rendering your Ditty.
  • Position – Select the position of the Ditty in relation to the HTML selector.
  • Ditty – Select a Ditty you want to display globally.
  • Display – Optional: Select a specific display template to use with the Ditty.
  • Custom ID – Optional: Add a custom ID attribute to the Ditty.
  • Custom Classes – Optional: Add custom classes to the Ditty.
  • Add More – Click this button to add more global Ditty.

View the following article for more information on adding a global Ditty: https://www.metaphorcreations.com/article/ditty/general/global-ditty-rendering/

Layout Defaults

All item types will render with a default, hard-coded layout template. Use this screen to set a new default layout template for each item type using a saved Layout Template on your site.

Permissions

Ditty posts, Layout posts, and Display posts all have custom permissions to limit access and functionality based on user roles. Use this page to customize these permissions to the needs of your site.