Document the page, update images, please review

gwarser 2024-12-14 10:57:27 +01:00
parent 1b47755b97
commit 9975db583c

@ -10,7 +10,32 @@
***
![my-filters](https://user-images.githubusercontent.com/585534/85202191-a0ddfb00-b2d2-11ea-8f93-a360c338ded7.png)
![My filters page](https://github.com/user-attachments/assets/c0a66192-3635-44c7-8786-1d2c4c5adf50)
## The warning
**Do not add filters from untrusted sources**
Classic malicious filter can modify the appearance of a website to fool the user.
"Trusted filters", filters requiring trust, marked [in documentation](./Static-filter-syntax) as "Can only be used in a trusted-source origin", can directly execute code on web pages and make you harm. These type of filters can be used only in filter lists from [uBlock Origin/uAssets](https://github.com/uBlockOrigin/uAssets) repository and to use them in "My filters" you need to explicity enable setting bellow.
## Options
#### Enable my custom filters
This will enable filters on this page. It's the same as "My filters" entry on "Filter lists" tab.
#### Allow custom filters requiring trust
This will allow to use in "My filters", "Trusted filters", filters requiring trust, marked [in documentation](./Static-filter-syntax) as "Can only be used in a trusted-source origin".
>[!CAUTION]
>These filters can directly execute code on web pages and make you harm.
![My filters with trusted filters enabled](https://github.com/user-attachments/assets/0862dfbd-6609-4c58-ba91-1a01a88afc6a)
## Editor
uBlock Origin (uBO) uses [CodeMirror's widget](https://codemirror.net/index.html) to freely edit your filters as plain text.
Additionaly uBO uses also [syntax highlighter (linter)](https://github.com/uBlockOrigin/uBlock-issues/issues/1134) to detect warnings and errors in your filters (and in filter lists).