DX 9 Builder Theme

Introduction

This is a new theme for DX9. It can be directly used in the UI Builder or with the Theme Builder. This theme is built with CSS variables, making it possible to change the look and feel to meet the diverse UI requirements of businesses or brands.

Configure DX 9 builder

To set up a theme DX 9 Builder, go to the Theme field in UI settings > Configure Layout and select DX 9 Builder Theme.

When you select DX 8 Angle, you will see the following properties available for configuration:

• Menu Position:
  Determines the position of the menu
  • Dark Sidebar: A sidebar with a dark color design.
  • Light Sidebar: A sidebar with a light color design.
  • Dark Minimized: A minimized sidebar with a dark color design. 
  • Light Minimized: A minimized sidebar with a light color design. 
  • Dark Header: A dark horizontal header for navigation. 
  • Light Header: A light horizontal header for navigation. 
  • Dark Below Header: A dark horizontal header with two layers: the first layer for the app name label and the second layer for navigation. 
  • Light Below Header: A light horizontal header with two layers: the first layer for the app name label and the second layer for navigation. 
• Background Image: Upload a theme background image added to the body of the page.
• Hide Sidebar User Menu: Check this option to hide the sidebar user menu.
• Primary Color:
  Color Scheme-Primary Color.
  Choose from the preset colors or custom. By choosing a custom color, you can define the color manually or through the color picker. 
• Background:
  Color Scheme-Background.
  Choose a body background color.
• Content Background:
  Color Scheme-Content Background.
  Select a main body content background color.
• Header Color:
  Color Scheme-Header color.
  Select a header bar background color.
• Header Font Color:
  Color Scheme-Header Font Color.
  Select a header bar font color.
• Sidebar Background:
  Color Scheme-Sidebar Background Color.
  Sidebar background color.
• Sidebar Font Color:
  Color Scheme-Sidebar Font Color.
  Sidebar/horizontal menu font color.
• Sidebar Icon Color:
  Color Scheme-Sidebar Icon Color.
  Sidebar/horizontal menu icon color.
• Submenu Background Color:
  Color Scheme Color-Sidebar Submenu Background.
  Sidebar/horizontal menu badge background color.
• Active Sidebar Background:
  Color Scheme Color-Sidebar Active Background.
  Select a sidebar/horizontal menu hover/active background color.
• Active Sidebar Font Color:
  Color Scheme-Sidebar Active Font.
  Select a sidebar/horizontal menu hover/active font color.
• Active Sidebar Icon Color:
  Color Scheme-Sidebar Active Icon.
  Select a sidebar/horizontal menu hover/active icon color.
• Sidebar Badge Font Color:
  Color Scheme-Sidebar Badge Font.
  Select a Sidebar/horizontal menu badge font color.
• Scrollbar Thumb Color:
  Color Scheme-Sidebar Scrollbar Thumb. Select a scroll bar background color.
• Footer Background:
  Color Scheme-Footer Background.
  Select a footer background color.
• Footer Font Color:
  Color Scheme-Footer Font.
  Select a footer font color.
• Border Color:
  Color Scheme-Border.
  Select a border color.
• Sidebar Width: Width of the sidebar menu.
• Content Width: Max width of the main content.
• Content Padding Inline: Div padding left and right of the main content.
• Content Padding Inline (Mobile): Div padding left and right of the main content during mobile view.
• Footer Height: Footer height.
• Footer Padding: Full footer padding (e.g., 16px 50px).
• Header Height: Height of the header.
• Header Padding: Full header padding (e.g., 24px 40px).
• Font Size: Font size for the body.
• Line Height: Line height for the body.
• Icon Margin Inline: Padding left and right for the menu icon.
• Icon Size: Icon font size.
• Item Height: Height of the menu.
• Item Margin Block: Margin top and bottom of the sidebar menu.
• Item Margin Inline: Margin left and right of the sidebar menu.
• Control Height: Control the height of the pagination element.
• Border Radius: Horizontal inner menu border radius.
• Border Radius LG: Padding left and right of the horizontal menu.
• Box Shadow Secondary: Horizontal inner menu box shadow.

Advanced

The Advanced settings offer extensive customization for the DX 9 BUilder Theme. You can define URLs for the favicon and logo, disable user profile photos, and configure the inbox for assignments. Additional features include enabling font size control, dark theme, responsive switch for mobile devices, and adding custom CSS or JavaScript. You can also insert HTML for subheaders, subfooters, and a home banner and manage user menu shortcuts.

Fields to Configure:

• Favicon URL: Define the path to custom Favicon URL.
• Logo URL: Define the path to custom Logo URL.
• Disable Profile: Option to remove the user's profile photo display.
• User Image: 
  • Hide
  • Gravatar Service
  • Using Hash Variable
    • Define Hash Variable To Retrieve User Image URL
    • #form.user_profile.image[{currentUser.id}]#
• Inbox: Manage how assignments are displayed.
  • No Inbox
  • Show all assignments
  • Show current App assignment only
• Home Icon URL: Home Icon URL address.
• Shortcut Link Label: Name for the shortcut link.
• Shortcut: Defines links to be parked under the Shortcut menu.
• User Menu Shortcut: Defines links to be parked under the User menu.
• Enable Font Size Control?: Check this to enable the ability to change the font size on UI runtime.
• Enable Responsive Switch in Mobile Device?: When checked, the Switch to the Desktop version link will be shown on the mobile device.
• Remove Auto Title from Process/Assignment form?: Process title and activity name will be removed from the assignment form when checked.
• Home Banner:  Insert custom HTML for Home Banner
• Custom CSS: Add custom CSS to style the UI.
• Custom JavaScript: Add custom Javascript for the theme.
• Sub header: Insert HTML for a subheader.
• Sub footer: Insert HTML for a subfooter.
• Disable Help Guide Feature?: Click to hide the help guide feature.

Progressive web app (PWA) settings

The PWA settings ensure your application supports offline usage and push notifications. You can enable or disable PWA support and web push notifications and specify additional URLs to cache for offline functionality. These settings enhance the user experience by making the app more robust and accessible, even without an internet connection.

Fields to Configure:

• Disable Progressive Web App (PWA) Support: 
  Click the checkbox to disable PWA.
  Joget DX apps automatically enable Progressive Web Apps (PWA) features in this theme so that all apps will be PWA baseline compliant without requiring additional steps, with features such as adding to the home screen, offline support, and push notifications.
• Disable Web Push Notifications: Click to disable web push notifications in this user view.
• Additional URLs to Cache: Enter paths relative to the context root.

Login page UI

The Login Page UI settings allow you to customize your application's login page. You can upload a background image and add custom HTML content before and after the login form. These configurations help create a more engaging and personalized login experience for users, ensuring that the login page aligns with your application's branding and design.

Fields to Configure:

• Login Page Background: Upload Login Page Background.
• Custom HTML (Before Login Form): Add custom HTML before the login form to include additional information or branding elements.
• Custom HTML (After Login Form): Add custom HTML after the login form to include additional information or branding elements.

Permission settings

Permission settings control who can access and see the UI in the App Center. You can hide the UI from the App Center listing, manage permission types, and temporarily disable permission checking for testing purposes. This ensures only authorized users can access specific UI elements, maintaining security and appropriate access control.

Fields to Configure:

• Hide this UI in App Center?: When checked, this UI will not be listed in the App Center.
• Permission Type: The white list to determine access to this UI.
• Temporary Disable Permission Checking for Testing?: Click the checkbox to disable all category menu permission checking.