Mirrors/uBlock
1
0
Fork 0
mirror of https://github.com/gorhill/uBlock.git synced 2024-11-16 15:33:38 +01:00
Code Issues Releases Wiki Activity

Created Deploying uBlock Origin: policies (markdown)

Raymond Hill 2021-01-05 16:50:26 -05:00
parent 5c67be2b56
commit dc3abd53d6
1 changed files with 42 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
Deploying-uBlock-Origin:-policies.md Normal file

@ -0,0 +1,42 @@
uBO supports being configured through central policies, see browser documentation for administrators:
- Chromium: ["Configuring Apps and Extensions by Policy"](https://www.chromium.org/administrators/configuring-policy-for-extensions)
- Firefox: ["Managed storage manifests"](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Native_manifests#Managed_storage_manifests)
## toSet
The properties in the `toSet` branch will wholly replace the corresponding local settings. Currently, the following subset of properties are supported:
### hiddenSettings
The purpose of the `hiddenSettings` property is to set the values of various [advanced settings](https://github.com/uBlockOrigin/uBlock-issues/wiki/Advanced-settings).
Each entry in the array is an array consisting of a pair of name-value strings. Each name string must be a supported advanced setting, and each value string must properly resolve to a supported value.
Every valid entry will be used to overwrite the corresponding default advanced setting, and will also become read-only, i.e. the user won't be able to change it.
Example, to remove the ability to configure uBO from the popup panel:
{
"toSet": {
"hiddenSettings": [
[ "popupPanelDisabledSections", "28" ]
]
}
}
### trustedSiteDirectives
The `trustedSiteDirectives` property is an array of string, which of which must resolve into a valid trusted-site directive, used to dictate where uBO must be disabled. All the directives will be used to wholly replace the local trusted-site directives, including the built-in ones.
See documentation on how to create valid trusted-site directives: ["How to mark a web site as trusted"](https://github.com/uBlockOrigin/uBlock-issues/wiki/How-to-mark-a-web-site-as-trusted)
## toAdd
The properties in the `toAdd` branch will append to the already present local settings. Currently, the following subset of properties are supported:
### trustedSiteDirectives
The `trustedSiteDirectives` property is an array of string, which of which must resolve into a valid trusted-site directive, used to dictate where uBO must be disabled. The directives will be appended to the local ones.
See documentation on how to create valid trusted-site directives: ["How to mark a web site as trusted"](https://github.com/uBlockOrigin/uBlock-issues/wiki/How-to-mark-a-web-site-as-trusted)