Administration tools

Settings overview

Search feature states, operational health, and incomplete-configuration warnings, then follow direct links to the relevant settings group.

Use the settings overview

1. Open Administration → Plugins → Redmine UX Toolkit → Configure.
2. Search for a feature by name or scan the configuration and operational-health summaries.
3. Open the linked settings group for every incomplete or unhealthy entry.
4. Correct the required values, choose Redmine's normal Apply button, and confirm that the unsaved-change indicator disappears.
5. Return to Overview and verify that the state reflects the saved configuration.

Log viewer

Administrators can view the last 100, 250, or 500 escaped lines from readable files directly inside Rails.root/log. A selected log can be emptied after confirmation; files cannot be downloaded, deleted, or edited.

Inspect or empty a Redmine log

1. Open Administration → Redmine UX Toolkit → Log files.
2. Select a readable file located directly inside Rails.root/log and choose the number of tail lines to display.
3. Read the escaped plain-text output; HTML or script text in a log is not executed.
4. To reset the selected log, choose the empty action and confirm the exact file. The file is truncated in place so the running application can continue using the same path.

The viewer cannot browse subdirectories, download logs, rename files, or delete them. If a file is absent, unreadable, or outside the allowed directory, inspect server permissions outside the plugin.

Navigation, links, and custom code

Navigation visibility is visual only. Safe external-link handling adds noopener and noreferrer to external HTTP/HTTPS links. Trusted administrators can store global sanitized CSS and privileged JavaScript.

Navigation and external links

After changing link visibility, test with a normal user and keep another route to administration available. Hidden links remain reachable when Redmine permissions allow them. Safe-link handling changes only external HTTP/HTTPS links to another host; internal, relative, anchor, mail, and telephone links stay unchanged.

Custom CSS/JS

Add one small change at a time, apply it, and test login, administration, issue forms, and mobile navigation. Custom JavaScript executes globally with the privileges of every visiting browser; only trusted administrators should edit it, and secrets must never be embedded.