malhuda/AdguardKnowledgeBase
1
0
Fork 0
mirror of https://github.com/AdguardTeam/AdguardKnowledgeBase.git synced 2025-02-20 11:13:10 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

EN text

Browse Source
This commit is contained in:
Vasily Bagirov 2021-12-13 13:16:54 +03:00
parent b856dc3978
commit b0f6be4301
1 changed files with 40 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
05.ios/04.safari-web-extension/docs.en.md
View File

@ -1,23 +1,55 @@
---
title: 'AdGuard Safari Web Extension'
title: 'Web Extension'
taxonomy:
category:
- docs
---
AdGuard Safari Web extension (not to be confused with [AdGuard for Safari](https://kb.adguard.com/en/safari), which is de-facto a browser extension for Safari browser on Mac) is a tool that takes advantage of the new features of iOS 15. It serves to enhance the capabilities of AdGuard for iOS or AdGuard Pro for iOS. With it, AdGuard apps can apply advanced filtering rules and ultimately block more ads.
Web extensions add custom functionality to Safari. You can find [more information about Web extensions here](https://developer.apple.com/documentation/safariservices/safari_web_extensions).
>Screenshot
AdGuard's Safari Web extension is a tool that takes advantage of the new features of iOS 15. It serves to enhance the capabilities of AdGuard for iOS. With it, AdGuard can apply advanced filtering rules and ultimately block more ads.
<a name="features"></a>
### What it does
By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#cosmetic-css-rules), [CSS selectors](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#extended-css-selectors), and [scriptlets](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example.
AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules.
Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it.
>Screenshot
>On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar.
You will see the following list of options:
* **Enabling/disabling protection on the website**. Turning the switch off will disable AdGuard completely for the current website and add a respective exclusion rule. Turning the switch back on will resume protection for the website and delete the rule. Any such change will require some time to take effect.
* **Blocking elements on the page manually**. Tap the *Block elements on this page* button to prompt a pop-up for element blocking. Select any element on the page you want to hide, adjust the selection zone, then preview changes and confirm the removal. A corresponding filtering rule will be added to AdGuard (that you can later disable or delete to revert the change).
* **Report an issue**. Swipe up to bring out the *Report an issue* button. Use it to report a missed ad or any other problem that you encountered on the current page.
<a name="install"></a>
### Enabling Safari Web extension
### Enabling AdGuard's Safari Web extension
Safari Web extension is not a standalone tool and requires an AdGuard app to work. If you don't have AdGuard for iOS or AdGuard Pro installed on your device, please [install one of them first](https://kb.adguard.com/en/ios/installation) and complete the onboarding process to prepare it for work.
Web extension is not a standalone tool and requires AdGuard for iOS. If you don't have AdGuard for iOS installed on your device, please [install it first](https://kb.adguard.com/en/ios/installation) and complete the onboarding process to prepare it for work.
Once done, open *Settings > Safari > Extensions*. Find **Allow these extensions** tab and then find **AdGuard** among the available extensions. Tap it, then turn on the switch. On the same screen make sure that AdGuard extension has the required permissions: **All Websites** should have the *Allow* status.
Once done, open *Settings > Safari > Extensions*. Find **Allow these extensions** section and then find **AdGuard** among the available extensions. Tap it, then turn on the switch. On the same screen make sure that the AdGuard extension has required permissions: **All Websites** should have the *Allow* status.
>Safari Web extension requires access to the web pages' content to operate, but doesn't use it for any purpose other than blocking ads.
>Screenshot
You can also turn AdGuard extension on from the Safari browser. Find the jigsaw piece icon in the address bar and tap it (depending on your device type it may be located to the left or to the right). Then tap *Manage Extensions* button and in the prompted window find and enable **AdGuard** extension. Although in this case you may have to go to Safari settings to grant AdGuard extension the necessary permissions anyway.
>AdGuard's Safari Web extension requires access to the web pages' content to operate, but doesn't use it for any purpose other than blocking ads.
You can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button. Then find the *Manage Extensions* option in the list and tap it. In the opened window turn on the switch next to **AdGuard**.
>Screenshot
If you use this method, you may have to go to Safari settings to grant AdGuard extension the necessary permissions anyway.
You should now be able to see the AdGuard icon in the Safari browser's address bar. Tap it, and then tap on the yellow **i** icon. Enable **Advanced protection** by tapping the *Turn on* button and confirming the action.
@ -25,4 +57,4 @@ You should now be able to see the AdGuard icon in the Safari browser's address b
Alternatively, you can enable **Advanced protection** directly from the app, in the **Protection** tab (second from the left in the bottom icon row).
Safari web extension only works on iOS versions 15 and later.
AdGuard's Safari Web extension only works on iOS versions 15 and later.