From 1cd775df974146b024770488530cf7b3953b3f45 Mon Sep 17 00:00:00 2001 From: gorhill Date: Thu, 25 Sep 2014 06:35:50 -0700 Subject: [PATCH] Updated Filter syntax extensions (markdown) --- Filter-syntax-extensions.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/Filter-syntax-extensions.md b/Filter-syntax-extensions.md index 344c33f..0180bdc 100644 --- a/Filter-syntax-extensions.md +++ b/Filter-syntax-extensions.md @@ -9,11 +9,20 @@ µBlock extends Adblock Plus filter syntax. #### Network filters -**The `important` network filter option:** The important filter option, `important`, means to ignore all _exception_ filters (those prefixed with `@@`). It applies only to net _block_ filters. The `important` option will allow you to block with 100% certainty specific net requests. Example: `||google-analytics.com^$important,third-party` will block all net requests to `google-analytics.com`, disregarding any existing network _exception_ filters. Another example: `||twitter.com^$important,third-party`. Etc. + +**The `important` network filter option:** The important filter option, `important`, means to ignore all _exception_ filters (those prefixed with `@@`). + +It applies only to net _block_ filters. The `important` option will allow you to block with 100% certainty specific net requests. + +Example: `||google-analytics.com^$important,third-party` will block all net requests to `google-analytics.com`, disregarding any existing network _exception_ filters. Another example: `||twitter.com^$important,third-party`. Etc. **The `inline-script` network filter option:** To specifically disable inline script tags in a main page: `||example.com^$inline-script`. #### Cosmetic filters -**Entity-based cosmetic filters:** Filters which are to be applied to a specific _entity_. An _entity_ is defined as follow: a formal domain name with the Public Suffix part replaced by a wildcard. Examples: `google.*` will apply to all similar Google domain names: `google.com`, `google.com.br`, `google.ca`, `google.co.uk`, etc. Another example: `facebook.*` will apply to all similar Facebook domain names: `facebook.com`, `facebook.net`. +**Entity-based cosmetic filters:** Filters which are to be applied to a specific _entity_. + +An _entity_ is defined as follow: a formal domain name with the Public Suffix part replaced by a wildcard. + +Examples: `google.*` will apply to all similar Google domain names: `google.com`, `google.com.br`, `google.ca`, `google.co.uk`, etc. Another example: `facebook.*` will apply to all similar Facebook domain names: `facebook.com`, `facebook.net`.