prehistoric-systems/uBlock
1
0
Fork 0
mirror of https://github.com/gorhill/uBlock.git synced 2026-03-11 09:04:36 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Created Dynamic filtering tutorial (markdown)

Raymond Hill 2015-01-07 07:15:18 -05:00
parent e8db3844b6
commit 70a29e5adf
1 changed files with 39 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

39
Dynamic-filtering-tutorial.md Normal file

@ -0,0 +1,39 @@
In µBlock v0.9.0.0, dynamic filtering has been completely revamped. For a fresh new install of µBlock, this is how the popup UI looks:
This is the "novice user" interface, which is the default when installing for the first time:
![figure 1](https://raw.githubusercontent.com/gorhill/uBlock/fix-433/doc/img/df-tut-01.png)
Notice the difference with the previous version:
- The dynamic filtering widgets are not accessible
- This is to prevent novice users to tamper with dynamic filters without really knowing what they do
- The network request logger (the _eye_ icon) is now always available
- There is no more setting to enable/disable the network request logger, it will be turned on/off automatically when opening/closing the logger page
To access dynamic filtering, you need to indicate to µBlock that you are an advanced user:
![figure 2](https://raw.githubusercontent.com/gorhill/uBlock/fix-433/doc/img/df-tut-02.png)
For advanced users, µBlock's popup UI will show a little `+` widget aside the prompt "requests blocked" below:
![figure 3](https://raw.githubusercontent.com/gorhill/uBlock/fix-433/doc/img/df-tut-03.png)
This little widget allows to expand/collapse the new re-designed dynamic filtering pane:
![figure 4](https://raw.githubusercontent.com/gorhill/uBlock/fix-433/doc/img/df-tut-04.png)
As seen above, just as with previous versions you can still dynamically filter:
- inline scripts
- 1st-party scripts
- 3rd-party scripts
- 3rd-party frames
However, as per issue #282, you can't no longer dynamically filter 1st-party frames (that was pointless).
Also, I threw in the ability to dynamically filters images (regardless of origin), as I saw this sort of feature requested a couple of places. It's useful for users who wish to save bandwidth, or memory resources.
![figure 5](https://raw.githubusercontent.com/gorhill/uBlock/fix-433/doc/img/df-tut-05.png)
![figure 6](https://raw.githubusercontent.com/gorhill/uBlock/fix-433/doc/img/df-tut-06.png)