1
0
mirror of https://github.com/gorhill/uBlock.git synced 2024-07-08 04:49:12 +02:00

<details> requires additional new lines around the content

gwarser 2024-03-13 08:17:10 +01:00
parent cea2c979c0
commit 37f6379fdf

@ -15,7 +15,8 @@ For **Firefox**, the setting can be configured in ["Native manifests"](https://d
For **Chrome**, see <https://www.chromium.org/administrators/configuring-policy-for-extensions/>.
<details><summary>Deprecated approach -- avoid if you can</summary>
At launch time, uBO will look for a setting named `adminSettings`, and if it exists, it will parse, extract and overwrite a user's settings with the administrator-assigned ones. Note that Chromium managed storage is not always ready on first browser start after change, and up to three restarts may be needed for settings to be applied to uBO, see <a href="https://github.com/uBlockOrigin/uBlock-issues/issues/1547">#1547</a>, <a href="https://github.com/uBlockOrigin/uBlock-issues/issues/1608">#1608</a>.
At launch time, uBO will look for a setting named `adminSettings`, and if it exists, it will parse, extract and overwrite a user's settings with the administrator-assigned ones. Note that Chromium managed storage is not always ready on first browser start after change, and up to three restarts may be needed for settings to be applied to uBO, see [#1547](https://github.com/uBlockOrigin/uBlock-issues/issues/1547), [#1608](https://github.com/uBlockOrigin/uBlock-issues/issues/1608).
The content of `adminSettings` is pretty straightforward: configure uBO as you wish for your users, then create a backup using the _"Backup to file"_ in the _Settings_ pane. Now open this backup file using a text editor, and remove all entries you do not want to overwrite while taking care to end up with a valid JSON file (mind trailing commas, etc.). All the entries left are the ones that will become overwritten on the user's side.
@ -30,6 +31,7 @@ For example, I created a backup file after having customized uBO and removed eve
Now, this JSON object can be used as the value for `adminSettings`.
For managing **Chrome** via **Google Workspace**, you can use [this apps-script](https://github.com/Landsil/apps_script--GoogleWorkspace-API/blob/master/uBlock_Origin_GSuite_policy.gs) to generate a policy JSON that will modify Trusted Sites for all designated users.
</details>
### Modifying the list of stock assets