From 9975db583ca2219397ca9d3d11c95246d04320b0 Mon Sep 17 00:00:00 2001 From: gwarser Date: Sat, 14 Dec 2024 10:57:27 +0100 Subject: [PATCH] Document the page, update images, please review --- Dashboard:-My-filters.md | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/Dashboard:-My-filters.md b/Dashboard:-My-filters.md index 17c3ab6..8cdb623 100644 --- a/Dashboard:-My-filters.md +++ b/Dashboard:-My-filters.md @@ -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).