From 63b0187118eb7430c802ab20d1ad1a0a7285818c Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Thu, 10 Aug 2023 15:39:54 +0300 Subject: [PATCH 1/8] Safari extensions 1. Added an article about Safari extensions 2. Fixed wrong info about the Safari Icon extension in installation.md 3. Fixed a block about Safari extensions in create-own-filters.md --- docs/adguard-for-safari/extensions.md | 64 +++++++++++++++++++ docs/adguard-for-safari/installation.md | 2 +- .../ad-filtering/create-own-filters.md | 8 ++- 3 files changed, 70 insertions(+), 4 deletions(-) create mode 100644 docs/adguard-for-safari/extensions.md diff --git a/docs/adguard-for-safari/extensions.md b/docs/adguard-for-safari/extensions.md new file mode 100644 index 00000000000..6d20599c612 --- /dev/null +++ b/docs/adguard-for-safari/extensions.md @@ -0,0 +1,64 @@ +--- +title: Safari extensions +sidebar_position: 3 +--- + +:::info + +This article is about AdGuard for Safari, which safeguards only your Safari browser. To protect your entire device, [download the AdGuard app](https://adguard.com/download.html?auto=true) + +::: + +# What Safari extensions are + +Safari extensions are small software programs that add functionality to the Safari web browser. They allow users to customize and enhance their browsing experience by adding features that are not natively built into the browser. AdGuard for Safari uses extensions primarily to apply filtering rules on websites opened in Safari. + +# How it works + +To block ads, trackers, and annoyances on websites, AdGuard uses filtering rules. The rules from AdGuard's and your custom filters are converted into ones comprehensible by Safari and are integrated into 6 Safari extensions: + +* AdGuard General +* AdGuard Privacy +* AdGuard Social +* AdGuard Security +* AdGuard Other + +Each content-blocking extension can include up to 150,000 active filtering rules. The number of rules within most filter groups does not surpass 150,000. However, if you activate too many language-specific or custom filters, you might exceed the limit. In such cases, random rules that are over the limit will be automatically disabled, which may lead to incorrect blocking. **We strongly recommend activating only the filters you need**. + +There are also two extensions responsible for other features: + +* *AdGuard Safari Icon* enables AdGuard's icon next to the search bar in Safari +* *AdGuard Advanced Blocking* allows using advanced rules to block complex ads + +More on each extension below. + +# Content-blocking extensions + +*AdGuard General* applies rules from filters that you may find in *Filters* → *Ad blocking* and *Filters* → *Language-specific*. This extension focuses on comprehensive ad blocking and includes filters for ads in specific languages. + +*AdGuard Privacy* applies rules from filters that you may find in *Filters* → *Privacy*. It blocks tracking mechanisms and ensures that your browsing activity remains private. + +*AdGuard Social* applies rules from filters that you may find in *Filters* → *Social Widgets* and *Filters* → *Annoyances*. It blocks popups, social media buttons, online assistant windows, and other elements on web pages that you might find annoying. + +*AdGuard Security* applies rules from filters that you may find in *Filters* → *Security*. This extension identifies and blocks potentially harmful elements, safeguarding users from malicious content. + +*AdGuard Other* applies rules from filters that that don't fall under the above-mentioned categories and that you may find in *Filters* → *Other*: *Filter unblocking search ads and self-promotion*, *AdGuard DNS filter*, and *AdGuard Experimental filter*. + +*AdGuard Custom* applies rules from filters that you add on your own to *Custom filters*. + +User rules and allowlist rules are included into every extension. + +# Other extensions + +*AdGuard Safari Icon* enables the AdGuard Mini icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. + +*AdGuard Advanced blocking* contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on youtube.com. + +# Why some extensions require permissions + +When enabling some Safari extensions, you might notice that they ask for **access to web page content** and **access to browsing history**. Here's why AdGuard for Safari needs them: + +* Access to web page content is required for manual ad blocking and advanced blocking rules to work correctly +* Access to browsing history is required to check the protection status on websites and determine which advanced rules should be applied + +We do not use this data for any other person or share it with anyone. For more info, you can consult our [Privacy policy](https://adguard.com/privacy.html). \ No newline at end of file diff --git a/docs/adguard-for-safari/installation.md b/docs/adguard-for-safari/installation.md index 182f78bf252..751e4ba059a 100644 --- a/docs/adguard-for-safari/installation.md +++ b/docs/adguard-for-safari/installation.md @@ -25,7 +25,7 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo :::note -Not all extensions are required for AdGuard for Safari to function correctly. For instance, checking the *Icon* extension enables the icon in the tray menu. However, we recommend enabling all of them. +Not all extensions are required for AdGuard for Safari to function correctly. For instance, checking the *Icon* extension enables the icon next to the search bar. However, we recommend enabling all of them. ::: diff --git a/docs/general/ad-filtering/create-own-filters.md b/docs/general/ad-filtering/create-own-filters.md index cf6603fe611..30fd10aab95 100644 --- a/docs/general/ad-filtering/create-own-filters.md +++ b/docs/general/ad-filtering/create-own-filters.md @@ -3501,7 +3501,9 @@ domain.com##div.ad #### Safari affinity {#safari-affinity-directive} -Safari is notoriously known for its harsh 150k max limit for filtering rules in content blockers. But in AdGuard for Safari and AdGuard for iOS max rule count is raised to 300k by splitting them into several content blockers. Generally, several filters categories are more or less independent, so there is such content blockers with such categories included: +Safari's limit for each content blocker is 150,000 max limit active rules. But in AdGuard for Safari and AdGuard for iOS, we've split the rules into 6 content blockers, thus increasing the rule limit to 900,000. + +Here is the composition of each content blocker: - AdGuard General — Ad Blocking, Language-specific - AdGuard Privacy — Privacy - AdGuard Social — Social Widgets, Annoyances @@ -3509,9 +3511,9 @@ Safari is notoriously known for its harsh 150k max limit for filtering rules in - AdGuard Other — Other - AdGuard Custom — Custom -`User rules` and `Allowlist` are added to every content blocker. +User rules and allowlist are added to every content blocker. -The main issue with using multiple content blockers is that rules inside these content blockers cannot influence each other. This may lead to different unexpected issues. So filters maintainers may use `!#safari_cb_affinity` to define Safari content blockers affinity for the rules inside of the directive block. +The main issue with using multiple content blockers is that the rules within these content blockers cannot influence each other. This may lead to different unexpected issues. So filter maintainers may use `!#safari_cb_affinity` to define Safari content blocker affinity for the rules inside of the directive block. **Syntax** From 687c4c8626573ec45f32cad91616978830c68942 Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Thu, 10 Aug 2023 19:28:17 +0300 Subject: [PATCH 2/8] Fix markdown --- docs/adguard-for-safari/extensions.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/adguard-for-safari/extensions.md b/docs/adguard-for-safari/extensions.md index 6d20599c612..e50bcf12627 100644 --- a/docs/adguard-for-safari/extensions.md +++ b/docs/adguard-for-safari/extensions.md @@ -9,19 +9,19 @@ This article is about AdGuard for Safari, which safeguards only your Safari brow ::: -# What Safari extensions are +## What Safari extensions are Safari extensions are small software programs that add functionality to the Safari web browser. They allow users to customize and enhance their browsing experience by adding features that are not natively built into the browser. AdGuard for Safari uses extensions primarily to apply filtering rules on websites opened in Safari. -# How it works +## How it works To block ads, trackers, and annoyances on websites, AdGuard uses filtering rules. The rules from AdGuard's and your custom filters are converted into ones comprehensible by Safari and are integrated into 6 Safari extensions: -* AdGuard General -* AdGuard Privacy -* AdGuard Social -* AdGuard Security -* AdGuard Other +- AdGuard General +- AdGuard Privacy +- AdGuard Social +- AdGuard Security +- AdGuard Other Each content-blocking extension can include up to 150,000 active filtering rules. The number of rules within most filter groups does not surpass 150,000. However, if you activate too many language-specific or custom filters, you might exceed the limit. In such cases, random rules that are over the limit will be automatically disabled, which may lead to incorrect blocking. **We strongly recommend activating only the filters you need**. @@ -32,7 +32,7 @@ There are also two extensions responsible for other features: More on each extension below. -# Content-blocking extensions +## Content-blocking extensions *AdGuard General* applies rules from filters that you may find in *Filters* → *Ad blocking* and *Filters* → *Language-specific*. This extension focuses on comprehensive ad blocking and includes filters for ads in specific languages. @@ -48,17 +48,17 @@ More on each extension below. User rules and allowlist rules are included into every extension. -# Other extensions +## Other extensions *AdGuard Safari Icon* enables the AdGuard Mini icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. *AdGuard Advanced blocking* contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on youtube.com. -# Why some extensions require permissions +## Why some extensions require permissions When enabling some Safari extensions, you might notice that they ask for **access to web page content** and **access to browsing history**. Here's why AdGuard for Safari needs them: -* Access to web page content is required for manual ad blocking and advanced blocking rules to work correctly -* Access to browsing history is required to check the protection status on websites and determine which advanced rules should be applied +- Access to web page content is required for manual ad blocking and advanced blocking rules to work correctly +- Access to browsing history is required to check the protection status on websites and determine which advanced rules should be applied We do not use this data for any other person or share it with anyone. For more info, you can consult our [Privacy policy](https://adguard.com/privacy.html). \ No newline at end of file From 7d9c52c66cc8ecfc299448963a1596b7d2e15e57 Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Thu, 10 Aug 2023 19:41:57 +0300 Subject: [PATCH 3/8] Fix markdown --- docs/adguard-for-safari/extensions.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/adguard-for-safari/extensions.md b/docs/adguard-for-safari/extensions.md index e50bcf12627..e46dc3f9a5f 100644 --- a/docs/adguard-for-safari/extensions.md +++ b/docs/adguard-for-safari/extensions.md @@ -17,18 +17,18 @@ Safari extensions are small software programs that add functionality to the Safa To block ads, trackers, and annoyances on websites, AdGuard uses filtering rules. The rules from AdGuard's and your custom filters are converted into ones comprehensible by Safari and are integrated into 6 Safari extensions: -- AdGuard General -- AdGuard Privacy -- AdGuard Social -- AdGuard Security -- AdGuard Other +– AdGuard General +– AdGuard Privacy +– AdGuard Social +– AdGuard Security +– AdGuard Other Each content-blocking extension can include up to 150,000 active filtering rules. The number of rules within most filter groups does not surpass 150,000. However, if you activate too many language-specific or custom filters, you might exceed the limit. In such cases, random rules that are over the limit will be automatically disabled, which may lead to incorrect blocking. **We strongly recommend activating only the filters you need**. There are also two extensions responsible for other features: -* *AdGuard Safari Icon* enables AdGuard's icon next to the search bar in Safari -* *AdGuard Advanced Blocking* allows using advanced rules to block complex ads +– *AdGuard Safari Icon* enables AdGuard's icon next to the search bar in Safari +– *AdGuard Advanced Blocking* allows using advanced rules to block complex ads More on each extension below. @@ -58,7 +58,7 @@ User rules and allowlist rules are included into every extension. When enabling some Safari extensions, you might notice that they ask for **access to web page content** and **access to browsing history**. Here's why AdGuard for Safari needs them: -- Access to web page content is required for manual ad blocking and advanced blocking rules to work correctly -- Access to browsing history is required to check the protection status on websites and determine which advanced rules should be applied +– Access to web page content is required for manual ad blocking and advanced blocking rules to work correctly +– Access to browsing history is required to check the protection status on websites and determine which advanced rules should be applied -We do not use this data for any other person or share it with anyone. For more info, you can consult our [Privacy policy](https://adguard.com/privacy.html). \ No newline at end of file +We do not use this data for any other person or share it with anyone. For more info, you can consult our [Privacy policy](https://adguard.com/privacy.html). From 09f6fe6dd8a2ebf1eb98e3ee833445a71812f1e2 Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Fri, 11 Aug 2023 14:36:24 +0300 Subject: [PATCH 4/8] Small fixes to extensions.md --- docs/adguard-for-safari/extensions.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/adguard-for-safari/extensions.md b/docs/adguard-for-safari/extensions.md index e46dc3f9a5f..52fbdde9f18 100644 --- a/docs/adguard-for-safari/extensions.md +++ b/docs/adguard-for-safari/extensions.md @@ -34,15 +34,15 @@ More on each extension below. ## Content-blocking extensions -*AdGuard General* applies rules from filters that you may find in *Filters* → *Ad blocking* and *Filters* → *Language-specific*. This extension focuses on comprehensive ad blocking and includes filters for ads in specific languages. +*AdGuard General* applies rules from filters that you can find in *Filters* → *Ad blocking* and *Filters* → *Language-specific*. This extension focuses on comprehensive ad blocking and includes filters for ads in specific languages. -*AdGuard Privacy* applies rules from filters that you may find in *Filters* → *Privacy*. It blocks tracking mechanisms and ensures that your browsing activity remains private. +*AdGuard Privacy* applies rules from filters located in *Filters* → *Privacy*. It blocks tracking mechanisms and ensures that your browsing activity remains private. -*AdGuard Social* applies rules from filters that you may find in *Filters* → *Social Widgets* and *Filters* → *Annoyances*. It blocks popups, social media buttons, online assistant windows, and other elements on web pages that you might find annoying. +*AdGuard Social* applies rules from filters that can be found in *Filters* → *Social Widgets* and *Filters* → *Annoyances*. It blocks popups, social media buttons, online assistant windows, and other elements on web pages that you might find annoying. -*AdGuard Security* applies rules from filters that you may find in *Filters* → *Security*. This extension identifies and blocks potentially harmful elements, safeguarding users from malicious content. +*AdGuard Security* applies rules from filters under *Filters* → *Security*. This extension identifies and blocks potentially harmful elements, safeguarding users from malicious content. -*AdGuard Other* applies rules from filters that that don't fall under the above-mentioned categories and that you may find in *Filters* → *Other*: *Filter unblocking search ads and self-promotion*, *AdGuard DNS filter*, and *AdGuard Experimental filter*. +*AdGuard Other* applies rules from filters that that don't fall under the above-mentioned categories and that are located in *Filters* → *Other*: *Filter unblocking search ads and self-promotion*, *AdGuard DNS filter*, and *AdGuard Experimental filter*. *AdGuard Custom* applies rules from filters that you add on your own to *Custom filters*. @@ -52,7 +52,7 @@ User rules and allowlist rules are included into every extension. *AdGuard Safari Icon* enables the AdGuard Mini icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. -*AdGuard Advanced blocking* contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on youtube.com. +*AdGuard Advanced blocking* contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. ## Why some extensions require permissions From 127e1b678005f5a65bfb7c8b7df3b33c93db4fc7 Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Mon, 14 Aug 2023 13:36:05 +0300 Subject: [PATCH 5/8] Add screenshots + instructions how to find extensions --- docs/adguard-for-safari/extensions.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/adguard-for-safari/extensions.md b/docs/adguard-for-safari/extensions.md index 52fbdde9f18..34d1347ad01 100644 --- a/docs/adguard-for-safari/extensions.md +++ b/docs/adguard-for-safari/extensions.md @@ -30,6 +30,8 @@ There are also two extensions responsible for other features: – *AdGuard Safari Icon* enables AdGuard's icon next to the search bar in Safari – *AdGuard Advanced Blocking* allows using advanced rules to block complex ads +![Safari extensions](https://uploads.adguard.org/safari_extensions.png) + More on each extension below. ## Content-blocking extensions @@ -54,6 +56,19 @@ User rules and allowlist rules are included into every extension. *AdGuard Advanced blocking* contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +## How to manage Safari extensions + +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + +![Safari settings *mobile](https://cdn.adtidy.org/blog/new/sxaqgfsafari_settings.png) + +2. Click *Preferences...* . + +3. Select *Extensions*. + +![Extensions tab](https://cdn.adtidy.org/blog/new/ocofdextensions_tab.png) + + ## Why some extensions require permissions When enabling some Safari extensions, you might notice that they ask for **access to web page content** and **access to browsing history**. Here's why AdGuard for Safari needs them: From 3944ee1ae9fc85dc7b4b6d072ca9d01dc6d16be2 Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Mon, 14 Aug 2023 14:07:36 +0300 Subject: [PATCH 6/8] Fix markdown --- docs/adguard-for-safari/extensions.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/adguard-for-safari/extensions.md b/docs/adguard-for-safari/extensions.md index 34d1347ad01..ffc66031bcd 100644 --- a/docs/adguard-for-safari/extensions.md +++ b/docs/adguard-for-safari/extensions.md @@ -60,13 +60,13 @@ User rules and allowlist rules are included into every extension. 1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. -![Safari settings *mobile](https://cdn.adtidy.org/blog/new/sxaqgfsafari_settings.png) + ![Safari settings *mobile](https://cdn.adtidy.org/blog/new/sxaqgfsafari_settings.png) -2. Click *Preferences...* . +1. Click *Preferences...* -3. Select *Extensions*. +1. Select *Extensions*. -![Extensions tab](https://cdn.adtidy.org/blog/new/ocofdextensions_tab.png) + ![Extensions tab](https://cdn.adtidy.org/blog/new/ocofdextensions_tab.png) ## Why some extensions require permissions From dc96baa8fac59dde847eb5f4dc5ddedc14d73d99 Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Mon, 14 Aug 2023 14:35:56 +0300 Subject: [PATCH 7/8] Small fix --- docs/adguard-for-safari/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/adguard-for-safari/extensions.md b/docs/adguard-for-safari/extensions.md index ffc66031bcd..1ad11491116 100644 --- a/docs/adguard-for-safari/extensions.md +++ b/docs/adguard-for-safari/extensions.md @@ -52,7 +52,7 @@ User rules and allowlist rules are included into every extension. ## Other extensions -*AdGuard Safari Icon* enables the AdGuard Mini icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. +*AdGuard Safari Icon* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. *AdGuard Advanced blocking* contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. From 06284a858dcdc1fe8f29c7324e45484ba9035eee Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Mon, 14 Aug 2023 15:20:45 +0300 Subject: [PATCH 8/8] Fix markdown --- docs/adguard-for-safari/extensions.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/docs/adguard-for-safari/extensions.md b/docs/adguard-for-safari/extensions.md index 1ad11491116..9288976d19f 100644 --- a/docs/adguard-for-safari/extensions.md +++ b/docs/adguard-for-safari/extensions.md @@ -59,16 +59,11 @@ User rules and allowlist rules are included into every extension. ## How to manage Safari extensions 1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. - ![Safari settings *mobile](https://cdn.adtidy.org/blog/new/sxaqgfsafari_settings.png) - 1. Click *Preferences...* - 1. Select *Extensions*. - ![Extensions tab](https://cdn.adtidy.org/blog/new/ocofdextensions_tab.png) - ## Why some extensions require permissions When enabling some Safari extensions, you might notice that they ask for **access to web page content** and **access to browsing history**. Here's why AdGuard for Safari needs them: