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] 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**