1
0
mirror of https://github.com/gorhill/uBlock.git synced 2024-07-05 11:37:01 +02:00

Implement uBO naming convention

q1800 2022-02-08 14:19:08 -06:00
parent bec008342b
commit dafed74931

@ -2,7 +2,7 @@
***
Dynamic URL filtering became available in uBlock Origin version 0.9.8.0.
Dynamic URL filtering became available in uBlock Origin (uBO) version 0.9.8.0.
The primary purpose of dynamic URL filtering ("URL filtering") is as a diagnosis/mitigation tool to fix web page breakage caused by dynamic filtering or static filtering. Secondary purpose of URL filtering is to offer higher granularity than what dynamic filtering can support.
@ -28,6 +28,6 @@ It is very important to understand that URL filtering rules override dynamic fil
#### Examples of URL filtering usefulness.
Un-break a web site: a real case was reported in [issue #240](https://github.com/gorhill/uBlock/issues/240). The web site required the resource `http://s7.addthis.com/js/300/addthis_widget.js` for the comment section to render properly. However, `addthis.com` is blocked by uBlock's _Privacy_ filter list with the `important` filter option, meaning the filter cannot be overridden by an exception filter. [URL filtering to the rescue](https://github.com/gorhill/uBlock/issues/240#issuecomment-105019619), since URL filtering overrides both dynamic filtering rules and static filters.
Un-break a web site: a real case was reported in [issue #240](https://github.com/gorhill/uBlock/issues/240). The web site required the resource `http://s7.addthis.com/js/300/addthis_widget.js` for the comment section to render properly. However, `addthis.com` is blocked by uBO's _Privacy_ filter list with the `important` filter option, meaning the filter cannot be overridden by an exception filter. [URL filtering to the rescue](https://github.com/gorhill/uBlock/issues/240#issuecomment-105019619), since URL filtering overrides both dynamic filtering rules and static filters.
Finer-grained dynamic filtering: [need a better concrete example] block all 3rd resources by default using dynamic filtering rule `* * 3p block`, but allow one very specific 3rd-party resource `example.org https://foo.com/widget.js script allow`, something which would not be possible before URL filtering was available, the only solution was to allow everything from `foo.com`