-
Notifications
You must be signed in to change notification settings - Fork 4
3. Configure site wide settings
Dashpilot edited this page Jul 14, 2022
·
8 revisions
You can easily create site-wide settings, that users will be able to change via the interface. To create a new setting, just add a key/value pair under settings
in data.json
, for example:
"website_tagline": "Not Just Another Wordpress site"
Note that currently all settings will appear as a single-line input field in the interface.
Some settings come pre-configured with the CMS:
- site_title - (optional) The website's title
- preview_url - (optional) Link to the live site. Shown when the user clicks the "view site"-button. Leave empty if you don't want the "view site" button to show.
- image_width - (required for image upload) Width that images should be resized to. The aspect ratio of the original image is preserved
- gallery_image_width - (required for image upload) Width that gallery images should be resized to. The aspect ratio of the original image is preserved
Unlike the site-wide settings above, the UI settings can not be edited by the user. You can edit them directly in data.json
> ui_settings
.
- add_category - Defines if the user is allowed to add new categories (Boolean)
- delete_category - Defines if the user is allowed to delete categories (Boolean)
- add_post - Defines if the user is allowed to add new posts (Boolean)
- delete_post - Defines if the user is allowed to delete posts (Boolean)
- edit_content_types - Enable or disable the option to edit content types (forms and fields) through the UI (Boolean)
- image_title: - Defines if gallery images can have a title. Optionally you can give the field a different name. Leave empty to hide the field (String)
- image_alt: - Defines if gallery images can have an alt text. Optionally you can give the field a different name. Leave empty to hide the field (String)
- saving_duration - Defines for how long the saving-spinner should be shown after pressing "save". This can be useful if publishing your site involves Git integration and/or a build step. Set it to the average time a each build step takes. Default 2000 (ms)
- rte_buttons - Configure the button-toolbar of the TipTap rich text editor. Current options: ["bold", "italic", "link", "list", "h1", "h2", "h3", "image"] (Array)
- custom_button and custom_button2 - add custom buttons in the left sidebar. Define as an object with properties title, link and (optional) icon. The icon can be any Font Awesome icon class. Example:
"custom_button": {
"title": "My Custom Button",
"link": "#",
"icon": "fas fa-flag"
}