{"id":18509361,"url":"https://github.com/lgsinnovations/bits-toolbar-customizer","last_synced_at":"2026-01-23T05:36:28.133Z","repository":{"id":89443316,"uuid":"139933034","full_name":"LGSInnovations/bits-toolbar-customizer","owner":"LGSInnovations","description":"Add toolbar items to the BITS server, and hide existing toolbar or sidebar items","archived":false,"fork":false,"pushed_at":"2019-02-23T16:44:58.000Z","size":209,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-05-14T10:18:47.575Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LGSInnovations.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-07-06T04:26:45.000Z","updated_at":"2019-02-23T16:44:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"113221f3-6208-428a-a72d-640b0e3afd8a","html_url":"https://github.com/LGSInnovations/bits-toolbar-customizer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/LGSInnovations/bits-toolbar-customizer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LGSInnovations%2Fbits-toolbar-customizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LGSInnovations%2Fbits-toolbar-customizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LGSInnovations%2Fbits-toolbar-customizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LGSInnovations%2Fbits-toolbar-customizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LGSInnovations","download_url":"https://codeload.github.com/LGSInnovations/bits-toolbar-customizer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LGSInnovations%2Fbits-toolbar-customizer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28680991,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T04:33:33.518Z","status":"ssl_error","status_checked_at":"2026-01-23T04:33:30.433Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T15:17:22.056Z","updated_at":"2026-01-23T05:36:28.108Z","avatar_url":"https://github.com/LGSInnovations.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bits Toolbar Customizer\n\nContribute custom toolbar widgets and hide existing toolbar or sidebar items.\n\n## Install and Build\n\nFor the following, assume the bits server is installed at `/opt/bits` and your bits modules are in `/opt/bits-modules`.\n```\ncd /opt/bits-modules\ngit clone \u003chttps or ssh url for this repo\u003e\ncd bits-toolbar-customizer\nnpm install\ncd app/\nbower install\ncd /opt/bits/data/base/modules/modules\nln -s /opt/bits-modules/bits-toolbar-customizer\n```\n## Usage\n\nUse this module to customize the BITS UI in two ways:\n\n### Add Widgets to the Toolbar\n\nAdd custom widgets in `app/elements/bits-toolbar-customizer/bits-toolbar-customizer.html`. Replace the sample `\u003cpaper-icon-button\u003e` element with markup that implements your widget. Set the desired icon, add widget listeners, etc. Icons for any contributed widget will appear on the right-side of the BITS toolbar.\n\n### Hide Selected BITS UI Framework Items\n \nLaunch the BITS server and navigate to `https://localhost:9001/bits-toolbar-customizer` (or select the `Toolbar Customizer` module from the main BITS sidebar). Select items to be hidden or de-select previously-hidden items to be shown, and click `Save Changes`. Items will be hidden or shown immediately, except for Home sidebar items (which require a page reload as described below). Your customizations will persist throughout the session and across BITS server re-starts.\n\n## Notes\n\n* The customizations you specify are saved as json text in the file `customizations.json` in the data directory for this module (default `\u003cbits-installation-dir\u003e/data/bits-toolbar-customizer`). In a production environment, you may want to retain a copy of this file and provide some means for restoring it in the event the module data directory is deleted or purged.\n* To prevent users from changing the customizations in a production environment, remove the entries from this module's `module.json` file that have the following keys: `contentElement`, `contentImport`, and `displayName`. The module will continue to apply the customizations specified in the `customizations.json` file, but the module's UI will not be exposed.\n* The implementation of the capability for hiding UI framework items is not ideal. Unless and until the BITS framework explicitly supports customization, the only two options are: 1) Modify the BITS codebase and mantain a separate baseline, or 2) Provide a capabilty to find selected items in the rendered DOM, and hide them. This module takes the latter approach, which has several implications.\n\n  * This \"screen scrape\" implementation is theoretically brittle, and may break with future BITS versions.\n  * The hiding of UI elements is sometimes noticeable. The hidden element appears for an instant when the page is loaded, and then disappears.\n  * When specific items from the `Home` sidebar are hidden, they are not hidden after clicking the `Home` link from the main sidebar until the page is refreshed. They are hidden immediately if you navigate directly to the `/home` route. This will hopefully be corrected in a future verison of the module.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flgsinnovations%2Fbits-toolbar-customizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flgsinnovations%2Fbits-toolbar-customizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flgsinnovations%2Fbits-toolbar-customizer/lists"}