diff --git a/docs/adguard-for-safari/extensions.md b/docs/adguard-for-safari/extensions.md new file mode 100644 index 00000000000..9288976d19f --- /dev/null +++ b/docs/adguard-for-safari/extensions.md @@ -0,0 +1,74 @@ +--- +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 + +![Safari extensions](https://uploads.adguard.org/safari_extensions.png) + +More on each extension below. + +## Content-blocking extensions + +*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 located in *Filters* → *Privacy*. It blocks tracking mechanisms and ensures that your browsing activity remains private. + +*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 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 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*. + +User rules and allowlist rules are included into every extension. + +## Other extensions + +*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. + +## 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: + +– 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). diff --git a/docs/adguard-for-safari/installation.md b/docs/adguard-for-safari/installation.md index 5b4e031c3dd..8020ecd938e 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 da070d52b47..fdf08a6c8aa 100644 --- a/docs/general/ad-filtering/create-own-filters.md +++ b/docs/general/ad-filtering/create-own-filters.md @@ -3593,7 +3593,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 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 @@ -3602,9 +3604,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**