diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/be/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/be/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/bn/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/bn/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/bn/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..738fe590995 --- /dev/null +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: Jak exportovat protokoly ze stránky na pozadí +sidebar_position: 1 +--- + +## Exportování protokolů ze stránky na pozadí v rozšíření + +### Chrome + +1. Otevřete rozšíření prohlížeče AdGuard a pokud je to možné, zopakujte akce, které vedly k chybě. Zaznamenejte přesný čas, kdy k chybě došlo. + +2. Přejděte na `chrome://extensions`. + +3. Povolte _Režim pro vývojáře_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Klikněte na `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Otevřete kartu _Konzola_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Otevřete kontextovou nabídku a vyberte _Uložit jako…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Otevřete rozšíření prohlížeče AdGuard a pokud je to možné, zopakujte akce, které vedly k chybě. Zaznamenejte přesný čas, kdy k chybě došlo. + +2. Přejděte na `about:addons`. + +3. Klikněte na _Doplňky ladění_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Klikněte na _Zkontrolovat_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Přejděte na kartu _Konzola_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Klikněte na _Uložit všechny zprávy do souboru_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Odesílání záznamů + +Po shromáždění záznamů postupujte podle následujících kroků a odešlete je našemu vývojovému týmu: + +1. Nahlaste chybu na [GitHub] (https\://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Odešlete archiv se záznamy a časem na adresu `devteam@adguard.com` a připojte odkaz na svůj problém na GitHubu. Archiv můžete také nahrát na Disk Google a místo přiložení souboru k němu přidat odkaz. diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 20659751b7b..c46fd343abd 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Uživatelské skripty jsou miniprogramy napsané v jazyce JavaScript, které roz ##### AdGuard Extra -AdGuard Extra je vlastní uživatelský skript, který zabraňuje webovým stránkám obcházet blokátory reklam a znovu vkládat blokované reklamy. +AdGuard Extra je vlastní uživatelský skript, který blokuje složité reklamy a mechanismy, které znovu vkládají reklamy na webové stránky. ### Licence @@ -421,7 +421,7 @@ GitHub je alternativní způsob, jak hlásit chyby a navrhovat nové funkce. [Po ::: -### Bezplatná vs plná verze +## Bezplatná vs plná verze @@ -441,13 +441,13 @@ AdGuard používá k blokování reklam ve videích YouTube vlastní přehráva - *Vlastní filtry a uživatelská pravidla* vám umožňují přidávat vlastní pravidla filtrování a filtry třetích stran pro vylepšení blokování reklam. [Zpět k filtrům](#filters) -- *Uživatelské skripty* vám umožňují používat AdGuard Extra k obcházení zákazů blokování reklam a instalaci dalších uživatelských skriptů pro rozšíření funkčnosti prohlížeče. [Zpět k uživatelským skriptům](#userscripts) +- *Uživatelské skripty* umožňují rozšířit funkčnost prohlížeče a používat [AdGuard Extra](#adguard-extra), který zabraňuje opětovnému vkládání reklam. [Zpět k uživatelským skriptům](#userscripts) K těmto funkcím získáte přístup [zakoupením licence](https://adguard.com/license.html). [Jak aktivovat licenci](/general/license/activation/#activating-adguard-for-android) -### Zařízení s přístupem root vs bez přístupu root +## Zařízení s přístupem root vs bez přístupu root -Vzhledem k dalším bezpečnostním opatřením systému Android jsou některé funkce AdGuardu dostupné pouze na zařízeních s přístupem root. Zde je jejich seznam: +Vzhledem k bezpečnostním opatřením OS Android jsou některé funkce AdGuardu dostupné pouze na zařízeních s přístupem root. Zde je jejich seznam: - **HTTPS filtrování ve většině aplikací** vyžaduje [instalaci certifikátu CA do systémového úložiště](#security-certificates), protože většina aplikací nedůvěřuje certifikátům v uživatelském úložišti. Instalace certifikátu do systémového úložiště je možná pouze na zařízeních s přístupem root - Režim směrování [**Automatický proxy**](#routing-mode) vyžaduje přístup root kvůli omezením systému Android ohledně filtrování provozu v celém systému diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index d8de60108f8..836328d33ce 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -25,7 +25,7 @@ K blokování reklam, slídičů a obtěžujících prvků na webových stránk Každé rozšíření pro blokování obsahu může obsahovat až 150 000 aktivních pravidel filtrování. Počet pravidel ve většině skupin filtrů nepřesahuje 150 000. Pokud však aktivujete příliš mnoho jazykově specifických nebo vlastních filtrů, můžete tento limit překročit. V takových případech budou náhodná pravidla, která překročí limit, automaticky zakázána, což může vést k nesprávnému blokování. **Důrazně doporučujeme aktivovat pouze ty filtry, které potřebujete**. -There is also one more extension responsible for other features: *AdGuard for Safari*, which adds the AdGuard icon next to the search bar in Safari and allows using advanced rules to block complex ads. +K dispozici je také další rozšíření, které je zodpovědné za další funkce: *AdGuard pro Safari*, které přidává ikonu AdGuard vedle vyhledávací lišty a umožňuje používání pokročilejších pravidel k blokování záludnějších reklam. ![Safari extensions](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-icon1.png) @@ -49,19 +49,19 @@ Uživatelská pravidla a pravidla seznamu povolených jsou součástí každého ## AdGuard pro Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. Je to užitečné, pokud chcete rychle nastavit ochranu na konkrétním webu nebo ručně blokovat reklamy. It also contains advanced rules that aren't converted into the format supported by Safari. To zahrnuje pravidla CSS, selektory CSS a skriptlety, které umožňují AdGuardu blokovat složité reklamy — například na YouTube. +*AdGuard pro Safari* aktivuje ikonu AdGuardu vedle vyhledávací lišty. Je to užitečné, pokud chcete rychle nastavit ochranu na konkrétním webu nebo ručně blokovat reklamy. Obsahuje také pokročilá pravidla, která nejsou převedena do formátu podporovaného prohlížečem Safari. To zahrnuje pravidla CSS, selektory CSS a skriptlety, které umožňují AdGuardu blokovat složité reklamy — například na YouTube. ## Jak spravovat rozšíření Safari 1. Otevřete Safari a kliknutím na *Safari* v levém horním rohu obrazovky rozbalte nabídku. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) -1. Click *Settings...* +1. Klikněte na *Natavení...* 1. Vyberte *Rozšíření*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) -## Why AdGuard for Safari requires permission +## Proč vyžaduje AdGuard pro Safari oprávnění -When enabling the *AdGuard for Safari* extension, you might notice that it requires **access to web page content** and **access to browsing history**. Here's why it needs these permissions: +Při povolování rozšíření *AdGuard pro Safari* si můžete všimnout, že vyžaduje **přístup k obsahu webových stránek** a k **historii prohlížení**. Zde je důvod, proč potřebuje tato oprávnění: -- 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 +- Pro správnou funkci ručního blokování reklam a pokročilých pravidel blokování je nutný přístup k obsahu webové stránky +- Přístup k historii prohlížení je nutný pro kontrolu stavu ochrany na webových stránkách a určení, která pokročilá pravidla by měla být použita Tyto údaje nepoužíváme pro žádné jiné účely a ani je s nikým nesdílíme. Pro více informací se můžete podívat na naše [Zásady ochrany osobních údajů](https://adguard.com/privacy.html). diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 0dce063e95a..9b203d461b3 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard pro Safari je bezplatná aplikace uvedená v App Store. Chcete-li ji nai 1. Chcete-li nastavit AdGuard pro Safari, povolte AdGuard rozšíření v nastavení Safari. V oznámení klikněte na *Opravit*. V otevřeném okně zaškrtněte políčka vedle rozšíření AdGuardu. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + Pro správnou funkci AdGuardu pro Safari nejsou nutná všechna rozšíření. Například zaškrtnutím rozšíření *Ikona* se aktivuje ikona vedle vyhledávacího řádku. Doporučujeme však povolit všechny. -Pro správnou funkci AdGuardu pro Safari nejsou nutná všechna rozšíření. Například zaškrtnutím rozšíření *Ikona* se aktivuje ikona vedle vyhledávacího řádku. Doporučujeme však povolit všechny. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. Aby AdGuard na webových stránkách fungoval, musí být povoleno nastavení *Blokátory obsahu*. Můžete je povolit pro všechny webové stránky nebo vybrat ty, které chcete. + + :::note + + Tento krok je nutný pro iOS 9.0 a novější, macOS 10.11 se Safari 10 a macOS 10.12 a novější. + + +::: + +V macOS klikněte na *Předvolby* → *Webové stránky* → *Blokátory obsahu*. Pokud chcete povolit AdGuard na každé webové stránce, nastavte *Při návštěvě jiných webových stránek* na *Zapnuto*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +V iOS přejděte na *Nastavení* → *Safari* → *Blokátory obsahu*a nastavte možnost na *Ano*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -Po dokončení kroků 1-3 začne AdGuard pro Safari fungovat. Nyní můžete nakonfigurovat jeho nastavení. +Po dokončení kroků 1-4 začne AdGuard pro Safari fungovat. Nyní můžete nakonfigurovat jeho nastavení. ## Jak odinstalovat AdGuard pro Safari {#uninstall} diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/cs/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 6e9be74ffb2..2e38912bc27 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ Tento článek je o filtrech, které vytváříme pro použití v AdGuardu a jin - **Filtr ochrany sledování** — komplexní seznam různých online čítačů a nástrojů pro analýzu webu. Pomocí něj můžete skrýt své akce online a vyhnout se sledování. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **Filtr sledování URL** zvyšuje soukromí odstraněním sledovacích parametrů z adres URL. Pokud se uživatel rozhodne blokovat parametry sledování ve Režimu utajení, bude tento filtr automaticky povolen. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Filtr sociálních médií** odstraňuje četná tlačítka "Like" a "Tweet" a další integrace sociálních médií na oblíbených webových stránkách. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Filtr obtěžování** blokuje obtěžující prvky na webových stránkách. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Obsahuje následující filtry AdGuard (všechny lze povolit odděleně od Filtru obtěžování): +- **Filtr obtěžování** blokuje obtěžující prvky na webových stránkách. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Zahrnuje následující AdGuard filtry (všechny lze aktivovat nezávisle na Filtru obtěžování): + - **Upozornění na soubory cookies:** blokuje upozornění na soubory cookie na webových stránkách. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Vyskakovací okna:** blokuje všechny druhy vyskakovacích oken, které nejsou nutné pro provoz webových stránek. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Bannery mobilních aplikací:** blokuje bannery, které propagují mobilní aplikace webových stránek. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgety:** blokuje widgety třetích stran, online asistenty, chaty živé podpory atd. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Ostatní obtěžování:** blokuje prvky, které nespadají do kategorií obtěžování. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filtr odblokování reklam ve vyhledávání a vlastní propagace** odblokuje reklamy, které mohou být pro uživatele užitečné. Více informací o tomto filtru najdete na [této stránce](../search-ads). [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Ruský filtr** odstraňuje reklamy z webových stránek s obsahem v ruštině. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **Německý filtr** odstraňuje reklamy z webových stránek s obsahem v němčině. Založen na filtru [EasyList Germany](https://easylist.to/) a následně námi upraven podle stížností uživatelů. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ Tento článek je o filtrech, které vytváříme pro použití v AdGuardu a jin - **Španělský/Portugalský filtr** odstraňuje reklamy z webových stránek s obsahem ve španělštině a portugalštině. Založen na filtru [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) a následně námi upraven podle stížností uživatelů. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turecký filtr** odstraňuje reklamy z webových stránek s obsahem v turečtině. Vytvořen námi na základě stížností uživatelů. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Čínský filtr** odstraňuje reklamy z webových stránek s obsahem v čínštině. Založen na filtru [EasyList China](https://github.com/easylist/easylistchina) a následně námi upraven podle stížností uživatelů. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainský filtr** odstraňuje reklamy z webových stránek s obsahem v ukrajinštině. Více informací o tomto filtru najdete na [této stránce](https://adguard.com/en/blog/ukrainian-filter.html). [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimentální filtr** slouží k testování některých nových pravidel filtrování, která mohou potenciálně způsobovat konflikty a narušovat práci webových stránek. Pokud tato pravidla fungují bez problémů, přidají se do hlavních filtrů. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Filtr mobilních reklam** blokuje reklamy v mobilních zařízeních. Obsahuje všechny známé sítě mobilní reklamy. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filtr** — (Základní filtrAdGuard, Filtr sociálních médií, Filtr ochrany sledování, Filtr mobilních reklam, EasyList a EasyPrivacy), který je zjednodušený pro lepší kompatibilitu s blokováním reklamy na úrovni DNS. Tento filtr používá servery [AdGuard DNS](https://adguard-dns.io/kb) k blokování reklam a sledování. [Zobrazit pravidla](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/cs/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 31d9bec256b..90724bb3250 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Prohlížeč rozpozná zablokovaný požadavek jako dokončený s chybou. ::: +:::note Délka pravidla + +Pravidla kratší než 4 znaky jsou považována za nesprávná a budou ignorována. + +::: + ### Syntaxe základních pravidel {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard pro Safari a AdGuard pro iOS plně nepodporují regulární výrazy kvů ::: -### Omezení uplatňování pravidel {#rules-restrictions} - -Pravidla, která odpovídají libovolně velkému počtu adres URL, jsou považována za nesprávná a budou ignorována. K tomu může dojít, pokud pravidlo neobsahuje masku nebo pokud maska odpovídá jakékoli URL s určitým protokolem. - -Toto pravidlo bude ignorováno: - -```text -|http://$replace=/a/b/ -``` - -Toto omezení lze obejít použitím regulárního výrazu `/.*/` uvnitř masky. - -Toto pravidlo nebude ignorováno: - -```text -/.*/$replace=/a/b/ -``` - -**Výjimky** - -Tato validace pravidel se nepoužije v následujících případech: - -1. Pravidlo obsahuje modifikátor [`$domain`](#domain-modifier), který ukazuje na konkrétní seznam domén - - Tato pravidla nebudou ignorována: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - Toto pravidlo bude ignorováno z důvodu doménové negace, která způsobuje příliš široký rozsah použití pravidla: - - ```text - $domain=~example.com,script - ``` - -1. Pravidlo obsahuje modifikátor [`$app`](#app-modifier), který ukazuje na konkrétní seznam aplikací - - Toto pravidlo nebude ignorováno: - - ```text - $app=curl,document - ``` - - Toto pravidlo bude ignorováno z důvodu negace aplikace, která způsobuje příliš široký rozsah použití pravidla: - - ```text - $app=~curl,document - ``` - -1. Pravidlo obsahuje jeden nebo více modifikátorů z [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - Tato pravidla nebudou ignorována: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Podpora zástupných znaků pro TLD (domény nejvyšší úrovně) {#wildcard-for-tld} Zástupné znaky jsou podporovány pro TLD domén ve vzorech [kosmetických](#cosmetic-rules), [filtrování HTML](#html-filtering-rules) a pravidel [JavaScript](#javascript-rules). @@ -1430,7 +1374,7 @@ preroll.ts - Pravidla `$hls` lze použít [**pouze v důvěryhodných filtrech**](#trusted-filters). - Pravidla `$hls` jsou kompatibilní pouze s modifikátory `$domain`, `$third- party`, `$app`, `$important`, `$match- case` a `$xmlhttprequest`. - `$hls` pravidla platí pouze pro seznamy stop HLS, což je text kódovaný v UTF-8 začínající řádkem `#EXTM3U`. Jakákoli jiná odpověď nebude těmito pravidly upravena. -- `$hls` rules do not apply if the size of the original response is more than 10 MB. +- Pravidla `$hls` neplatí, pokud je velikost původní odpovědi větší než 10 MB. ::: @@ -1675,7 +1619,7 @@ V AdGuardu pro Windows, Mac a Android, **s knihovnou CoreLibs v1.11 nebo nověj :::caution Omezení - Pravidla `$jsonprune` jsou kompatibilní s těmito specifickými modifikátory `$domain`, `$third-party`, `$app`, `$important`, `$match-case` a `$xmlhttprequest`. -- `$jsonprune` rules do not apply if the size of the original response is more than 10 MB. +- Pravidla `$jsonprune` neplatí, pokud je velikost původní odpovědi větší než 10 MB. ::: @@ -1827,7 +1771,7 @@ Tato pravidla umožňují přepsat [zásadu odkazování stránky](https://devel Pravidlo výjimky s hodnotou modifikátoru zakáže pravidlo blokování se stejnou hodnotou modifikátoru. Pravidlo výjimky bez hodnoty modifikátoru zakáže všechna odpovídající pravidla zásad odkazování. -If a request matches multiple `$referrerpolicy` rules not disabled by exceptions, only one of them (it is not specified which one) is applied. `$referrerpolicy` rules without specified [content-type modifiers](#content-type-modifiers) apply to `$document` and `$subdocument` content types. +Pokud požadavek odpovídá více pravidlům `$referrerpolicy`, která nejsou zakázána výjimkami, použije se pouze jedno z nich (není uvedeno, které). `$referrerpolicy` pravidla bez specifikovaných [modifikátorů typu obsahu](#content-type-modifiers) platí pro `$document` a `$subdocument` typy obsahu. **Příklady** @@ -2084,7 +2028,7 @@ K použití modifikátoru `$replace` budete potřebovat určité znalosti regul **Funkce** - Pravidla `$replace` platí pro jakoukoli textovou odpověď, ale neplatí pro binární (`media`, `image`, `object` atd.). -- `$replace` rules do not apply if the size of the original response is more than 10 MB. +- Pravidla `$replace` neplatí, pokud je velikost původní odpovědi větší než 10 MB. - Pravidla `$replace` mají vyšší prioritu než ostatní základní pravidla (**včetně** pravidel výjimek). Pokud tedy požadavek odpovídá dvěma různým pravidlům, z nichž jedno má modifikátor `$replace`, použije se toto pravidlo. - Pravidla výjimek na úrovni dokumentu s modifikátory `$content` nebo `$document` zakáží pravidla `$replace` pro požadavky, které jim odpovídají. - Ostatní pravidla výjimek na úrovni dokumentu (`$generichide`, `$elemhide` nebo modifikátory `$jsinject`) se uplatňují vedle pravidel `$replace`. To znamená, že můžete upravit obsah stránky pomocí pravidla `$replace` a zároveň zde zakázat kosmetická pravidla. @@ -2443,7 +2387,7 @@ Pravidla pro skrytí prvků slouží ke skrývání prvků webových stránek. J Pravidla pro skrytí prvků mohou fungovat odlišně [v závislosti na platformě](#cosmetic-rules-priority). -#### Syntaxe {#non-basic-rules-modifiers-syntax} +#### Syntaxe ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [selektor CSS](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), který definuje prvky, na které chceme styl použít. -- **`domains`** — omezení domény pro dané pravidlo. Stejné zásady jako v [pravidlech pro skrývání prvků](#elemhide-syntax). +- **`domains`** — omezení domény pro dané pravidlo. Stejné zásady jako v [pravidlech pro skrývání prvků](#cosmetic-elemhide-rules). - **`style`** — styl CSS, který chceme použít na vybrané prvky. **Příklady** @@ -3250,7 +3194,7 @@ Tato pseudo-třída byla v podstatě zkratkou pro `:not(:has())`. Byla podporov Způsob, jakým jsou aplikována pravidla **pro skrývání prvků** a **CSS**, je specifický pro danou platformu. -**V AdGuardu pro Windows, Mac a Android** používáme šablonu stylů vloženou do stránky. Priorita kosmetických pravidel je stejná jako u jakéhokoli jiného souboru stylů CSS na webových stránkách. Existují však omezení: [skrytí prvku](#elemhide-syntax) a [pravidla CSS](#cosmetic-css-rules) nemohou přepsat vložené styly. V takových případech se doporučuje použít rozšířené selektory nebo filtrování HTML. +**V AdGuardu pro Windows, Mac a Android** používáme šablonu stylů vloženou do stránky. Priorita kosmetických pravidel je stejná jako u jakéhokoli jiného souboru stylů CSS na webových stránkách. Existují však omezení: [skrytí prvku](#cosmetic-elemhide-rules) a [pravidla CSS](#cosmetic-css-rules) nemohou přepsat vložené styly. V takových případech se doporučuje použít rozšířené selektory nebo filtrování HTML. **V Rozšíření prohlížeče AdGuard** se používají tzv. "soubory uživatelských stylů". Mají vyšší prioritu než řádkové styly. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — název prvku s malými písmeny, např. `div` nebo `script`. -- **`domains`** — omezení domény pro dané pravidlo. Stejné zásady jako v [syntaxi pravidel pro skrývání prvků](#elemhide-syntax). +- **`domains`** — omezení domény pro dané pravidlo. Stejné zásady jako v [syntaxi pravidel pro skrývání prvků](#cosmetic-elemhide-rules). - **`attributes`** — seznam atributů, které limitují výběr prvků. `name` — název atributu, `value` — podřetězec, který je obsažen v hodnotě atributu. - **`pseudoName`** — název pseudotřídy. - **`pseudoArgs`** — argumenty pseudotřídy typu funkce. @@ -3483,7 +3427,7 @@ AdGuard podporuje speciální typ pravidel, která umožňují vložit na webov rule = [domains] "#%#" script ``` -- **`domains`** — omezení domény pro dané pravidlo. Stejné zásady jako v [pravidlech pro skrývání prvků](#elemhide-syntax). +- **`domains`** — omezení domény pro dané pravidlo. Stejné zásady jako v [pravidlech pro skrývání prvků](#cosmetic-elemhide-rules). - **`skript`** — libovolný kód JavaScript **v jednom řetězci**. **Příklady** @@ -3593,7 +3537,7 @@ Další informace o důvěryhodných skriptletech najdete na [GitHubu](https://g Každé pravidlo lze upravit pomocí modifikátorů popsaných v následujících odstavcích. -**Syntaxe** +**Syntaxe** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ kde: - `adguard_ext_opera` — Rozšíření prohlížeče AdGuard pro Operu - `adguard_ext_android_cb` — Blokátor obsahu AdGuard pro mobilní prohlížeče Samsung a Yandex - `ext_ublock` — speciální případ; ten je deklarován, když je verze filtru uBlock kompilována pomocí [FiltersRegistry][] + - `cap_html_filtering` — produkty, které podporují pravidla filtrování HTML: AdGuard pro Windows, AdGuard pro macOS a AdGuard pro Android - `!#else` — začátek bloku při nesplnění podmínek - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — seznamy pravidel - `!#endif` — konec blokování diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/cs/docusaurus-plugin-content-docs/current/general/license/activation.md index d46ca023b5c..a1bc491a137 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Případně můžete k aktivaci použít [licenční klíč](../what-is#license- ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Případně můžete klepnout na *Mám licenci* na následující obrazovce a aktivovat licenci jedním z výše uvedených způsobů. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Aktivace AdGuardu pro iOS 1. Klepněte na *Nastavení* a poté vyberte *Licence*. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/da/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/da/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 38c08c78408..67a1476672e 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### Lizenz @@ -401,7 +401,7 @@ In this section, you can find information about your license and manage it: - Open the AdGuard account to manage your license there - Reset your license – for example, if you've reached device limit for this license and want to apply another one -![License screen *mobile_border](https://cdn.adtidy.org/blog/new/3wyh5hlicense.png) +![Lizenzbildschirm *mobile_border](https://cdn.adtidy.org/blog/new/3wyh5hlicense.png) ### Support @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 16997ec886a..e641409a9b2 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 89883158671..5724c4bc00d 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ In diesem Artikel geht es um die Filter, die wir für AdGuard und andere Werbebl - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ In diesem Artikel geht es um die Filter, die wir für AdGuard und andere Werbebl - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 45f4123adef..50f86e6eced 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -356,7 +300,7 @@ If you want the rule not to be applied to certain apps, start the app name with - `||baddomain.com^$app=~org.example.app` — a rule to block requests that match the specified mask and are sent from any app except for the `org.example.app`. - `||baddomain.com^$app=~org.example.app1|~org.example.app2` — same as above, but now two apps are excluded: `org.example.app1` and `org.example.app2`. -:::caution Beschränkungen +:::caution Restrictions Apps in the modifier value cannot have a wildcard, e.g. `$app=com.*.music`. Rules with such modifier are considered invalid. @@ -397,7 +341,7 @@ or to the combination of these three: @@||y.com$script,domain=a.com|b.com ``` -:::caution Beschränkungen +:::caution Restrictions - The rule's matching pattern cannot target any specific domains, e.g. it cannot start with `||`. - Domains in the modifier value cannot be negated, e.g. `$denyallow=~x.com`, or have a wildcard TLD, e.g. `$denyallow=x.*`. @@ -490,7 +434,7 @@ In the following examples it is implied that requests are sent from `http://exam ##### `$domain` modifier limitations {#domain-modifier-limitations} -:::caution Beschränkungen +:::caution Restrictions Safari does not support the simultaneous use of allowed and disallowed domains, so rules like `||baddomain.com^$domain=example.org|~foo.example.org` will not work in AdGuard for iOS and AdGuard for Safari. @@ -584,7 +528,7 @@ This modifier limits the rule scope to requests that use the specified set of HT - `@@||evil.com$method=get` unblocks only GET requests to `evil.com`. - `@@||evil.com$method=~post` unblocks any requests to `evil.com` except POST. -:::caution Beschränkungen +:::caution Restrictions Rules with mixed negated and not negated values are considered invalid. So, for example, the rule `||evil.com^$method=get|~head` will be rejected. @@ -654,7 +598,7 @@ You may use a shorter name (alias) instead of using the full modifier name: `$3p - `/ads$to=~not.evil.com|evil.com` blocks any request to `evil.com` and its subdomains, with a path matching `/ads`, except requests to `not.evil.com` and its subdomains. - `/ads$to=~good.com|~good.org` blocks any request with a path matching `/ads`, except requests to `good.com` or `good.org` and their subdomains. -:::caution Beschränkungen +:::caution Restrictions [`$denyallow`](#denyallow-modifier) can not be used together with `$to`. It can be expressed with inverted `$to`: `$denyallow=a.com|b.com` is equivalent to `$to=~a.com|~b.com`. @@ -1007,7 +951,7 @@ Blocking cookies and removing tracking parameters is achieved by using rules wit ::: -:::caution Beschränkungen +:::caution Restrictions - Modifier options should be lowercase, i.e. `$stealth=DPI` will be rejected. - Modifier options cannot be negated, i.e. `$stealth=~3p-cookie` will be rejected. @@ -1252,7 +1196,7 @@ There are two methods to deactivate `$cookie` rules: the primary method involves - `@@||example.org^$cookie=concept` unblocks a single cookie named `concept` - `@@||example.org^$cookie=/^_ga_/` unblocks every cookie that matches the regular expression -:::caution Beschränkungen +:::caution Restrictions `$cookie` rules support a limited list of modifiers: `$domain`, `$~domain`, `$important`, `$third-party`, and `$~third-party`. @@ -1294,7 +1238,7 @@ In case if multiple `$csp` rules match a single request, we will apply each of t - `||example.org^$csp=script-src 'self' 'unsafe-eval' http: https:` disables inline scripts on all the pages matching the rule pattern. - `@@||example.org^$document` or `@@||example.org^$urlblock` disables all the `$csp` rules on all the pages matching the rule pattern. -:::caution Beschränkungen +:::caution Restrictions - There are a few characters forbidden in the `$csp` value: `,`, `$`. - `$csp` rules support limited list of modifiers: `$domain`, `$important`, `$subdocument`. @@ -1425,7 +1369,7 @@ preroll.ts -:::caution Beschränkungen +:::caution Restrictions - `$hls` rules are only allowed [**in trusted filters**](#trusted-filters). - `$hls` rules are compatible with the modifiers `$domain`, `$third-party`, `$app`, `$important`, `$match-case`, and `$xmlhttprequest` only. @@ -1672,7 +1616,7 @@ In AdGuard for Windows, Mac and Android **running CoreLibs v1.11 or later**, JSO -:::caution Beschränkungen +:::caution Restrictions - `$jsonprune` rules are only compatible with these specific modifiers: `$domain`, `$third-party`, `$app`, `$important`, `$match-case`, and `$xmlhttprequest`. - `$jsonprune` rules do not apply if the size of the original response is more than 10 MB. @@ -1696,7 +1640,7 @@ This is basically a Firewall-like rule allowing to fully block or unblock access We recommend to get acquainted with this [article](#regexp-support) for better understanding of regular expressions. -:::caution Beschränkungen +:::caution Restrictions The `$network` modifier can only be used in rules together with the `$app` and `$important` modifiers, and not with any other modifiers. @@ -1747,7 +1691,7 @@ In case if multiple `$permissions` rules match a single request, AdGuard will ap - `$domain=example.org|example.com,permissions=storage-access=()\, camera=()` disallows using the Storage Access API to request access to unpartitioned cookies and using video input devices across `example.org` and `example.com`. - `@@||example.org^$document` or `@@||example.org^$urlblock` disables all the `$permission` rules on all the pages matching the rule pattern. -:::caution Beschränkungen +:::caution Restrictions 1. Characters forbidden in the `$permissions` value: `$` 1. `$permissions` is compatible with the limited list of modifiers: `$domain`, `$important`, and `$subdocument` @@ -1885,7 +1829,7 @@ In case of multiple `$removeheader` rules matching a single request, we will app @@||example.org/path/$removeheader ``` -:::caution Beschränkungen +:::caution Restrictions This type of rules can be used [**only in trusted filters**](#trusted-filters). @@ -2060,7 +2004,7 @@ With these rules, specified UTM parameters will be removed from any request save `$removeparam` rules can also be disabled by `$document` and `$urlblock` exception rules. But basic exception rules without modifiers do not do that. For example, `@@||example.com^` will not disable `$removeparam=p` for requests to **example.com**, but `@@||example.com^$urlblock` will. -:::caution Beschränkungen +:::caution Restrictions - Rules with `$removeparam` modifier can be used [**only in trusted filters**](#trusted-filters). - `$removeparam` rules are compatible with [basic modifiers](#basic-rules-basic-modifiers), [content-type modifiers](#content-type-modifiers), and with `$important` and `$app` modifiers. Rules with any other modifiers are considered invalid and will be discarded. @@ -2137,7 +2081,7 @@ You can see how this rule works here: http://regexr.com/3cesk - `@@||example.org^$replace` will disable all `$replace` rules matching `||example.org^`. - `@@||example.org^$document` or `@@||example.org^$content` will disable all `$replace` rules **originated from** pages of `example.org` **including the page itself**. -:::caution Beschränkungen +:::caution Restrictions Rules with `$replace` modifier can be used [**only in trusted filters**](#trusted-filters). @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -2548,7 +2492,7 @@ example.com#@$#.textad { visibility: hidden; } We recommend to use this kind of exceptions only if it is not possible to change the CSS rule itself. In other cases it is better to change the original rule, using domain restrictions. -:::caution Beschränkungen +:::caution Restrictions Styles that lead to loading any resource are forbidden. Basically, it means that you cannot use any `` type of value in the style. @@ -2839,7 +2783,7 @@ div:matches-css(before, content: block*) div:matches-css(before, content: /block me/) ``` -:::caution Beschränkungen +:::caution Restrictions Regexp patterns **do not support** flags. @@ -2907,7 +2851,7 @@ For **regexp** patterns `"` and `\` should be **escaped**, e.g. `div:matches-att ``` -:::caution Beschränkungen +:::caution Restrictions Regexp patterns **do not support** flags. @@ -2982,7 +2926,7 @@ To check properties of a specific element, do the following: ::: -:::caution Beschränkungen +:::caution Restrictions Regexp patterns **do not support** flags. @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3514,7 +3458,7 @@ Sometimes, it may be necessary to disable all restriction rules. For example, to We recommend to use this kind of exceptions only if it is not possible to change the hiding rule itself. In other cases it is better to change the original rule, using domain restrictions. -:::caution Beschränkungen +:::caution Restrictions JavaScript rules can be used [**only in trusted filters**](#trusted-filters). @@ -3573,7 +3517,7 @@ Trusted scriptlets are not compatible with other ad blockers except AdGuard. ::: -:::caution Beschränkungen +:::caution Restrictions Trusted scriptlets rules can be used [**only in trusted filters**](#trusted-filters). @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/de/docusaurus-plugin-content-docs/current/general/license/activation.md index 56ddb15b28a..b0e953f76c5 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -3,13 +3,13 @@ title: Lizenz aktivieren sidebar_position: 3 --- -## How to activate a license +## So aktivieren Sie eine Lizenz Um Ihre Lizenz zu aktivieren, gehen Sie zum Abschnitt *Lizenz* Ihres AdGuard-Produkts und suchen Sie das Feld *Anmelden* oder die Schaltfläche *Aktivieren* . Verwenden Sie die E-Mail und das Passwort Ihres AdGuard-Kontos, um sich anzumelden. Wenn Sie noch kein Konto haben, wird Ihnen angeboten, eines zu erstellen. :::note -To activate a license via the AdGuard account, a valid license with at least one free slot is required. If your license is already used on a maximum number of devices, you can [upgrade it](../payment-options#upgrade) or [transfer it from one device to another](../transfer). +Um eine Lizenz über das AdGuard-Konto zu aktivieren, ist eine gültige Lizenz mit mindestens einem freien Slot erforderlich. Wenn Ihre Lizenz bereits auf einer maximalen Anzahl von Geräten verwendet wird, können Sie die Lizenz [erweitern](../payment-options#upgrade) oder [von einem Gerät auf ein anderes übertragen](../transfer). ::: @@ -19,66 +19,62 @@ Alternativ können Sie auch einen [Lizenzschlüssel](../what-is#license-key) ver ### Aktivieren von AdGuard für Windows -1. On the expired license screen, click *Activate*. +1. Klicken Sie im Bildschirm mit der abgelaufenen Lizenz auf *Aktivieren*. - ![Expired license screen *border](https://cdn.adtidy.org/blog/new/eapwtexp.png) + ![Bildschirm für abgelaufene Lizenzen *border](https://cdn.adtidy.org/blog/new/eapwtexp.png) - Alternatively, select *License* in the upper right corner of the main screen and click *Activate*. + Alternativ dazu wählen Sie *Lizenz* in der oberen rechten Ecke des Hauptbildschirms und klicken auf *Aktivieren*. - ![Main screen *border](https://cdn.adtidy.org/blog/new/ca313hmain-screen.png) + ![Hauptbildschirm *border](https://cdn.adtidy.org/blog/new/ca313hmain-screen.png) - ![License screen *border](https://cdn.adtidy.org/blog/new/n7nkclicense-screen.png) + ![Lizenzbildschirm *border](https://cdn.adtidy.org/blog/new/n7nkclicense-screen.png) -1. Activate your license using your preferred method. If the license is bound to your email address, click *AdGuard Account* or select a social network associated with this email address. Alternatively, enter your license key. +1. Aktivieren Sie Ihre Lizenz mit der von Ihnen bevorzugten Methode. Wenn die Lizenz an Ihre E-Mail-Adresse gebunden ist, klicken Sie auf *AdGuard Konto* oder wählen Sie ein soziales Netzwerk aus, das mit dieser E-Mail-Adresse verbunden ist. Alternativ können Sie auch Ihren Lizenzschlüssel eingeben. - ![Activating a license *border](https://cdn.adtidy.org/blog/new/lnzz5activate-license.png) + ![Aktivieren einer Lizenz *border](https://cdn.adtidy.org/blog/new/lnzz5activate-license.png) ### Aktivieren von AdGuard für Mac -1. On the expired license screen, click *Activate*. +1. Klicken Sie im Bildschirm mit der abgelaufenen Lizenz auf *Aktivieren*. - ![Expired license screen *mobile_border](https://cdn.adtidy.org/blog/new/o9bhtexpired-screen.png) + ![Bildschirm für abgelaufene Lizenzen *mobile_border](https://cdn.adtidy.org/blog/new/o9bhtexpired-screen.png) - Alternatively, click the gear icon in the AdGuard menu, then click *License*. + Alternativ können Sie auch auf das Zahnradsymbol im AdGuard-Menü klicken und dann auf *Lizenz*. - ![Preferences *border](https://cdn.adtidy.org/blog/new/xuyqmpreferences.png) + ![Präferenzen *border](https://cdn.adtidy.org/blog/new/xuyqmpreferences.png) -1. In the opened window, click *Activate*. +1. Klicken Sie im geöffneten Fenster auf *Aktivieren*. - ![License screen *border](https://cdn.adtidy.org/blog/new/8rbc8license-screen.png) + ![Lizenzbildschirm *border](https://cdn.adtidy.org/blog/new/8rbc8license-screen.png) -1. Activate your license using your preferred method. If the license is bound to your email address, click *AdGuard Account* or select a social network associated with this email address. Alternatively, enter your license key. +1. Aktivieren Sie Ihre Lizenz mit der von Ihnen bevorzugten Methode. Wenn die Lizenz an Ihre E-Mail-Adresse gebunden ist, klicken Sie auf *AdGuard Konto* oder wählen Sie ein soziales Netzwerk aus, das mit dieser E-Mail-Adresse verbunden ist. Alternativ können Sie auch Ihren Lizenzschlüssel eingeben. - ![Activating a license *border](https://cdn.adtidy.org/blog/new/tws3jkactivate-license.png) + ![Aktivieren einer Lizenz *border](https://cdn.adtidy.org/blog/new/tws3jkactivate-license.png) ### Aktivieren von AdGuard für Android -1. Tap *Settings*, then select *License*. +1. Tippen Sie auf *Einstellungen* und wählen Sie dann *Lizenz*. - ![Settings screen *mobile_border](https://cdn.adtidy.org/blog/new/sbdcysettings.png) + ![Bildschirm Einstellungen *mobile_border](https://cdn.adtidy.org/blog/new/sbdcysettings.png) -1. Tap *Activate license*. +1. Tippen Sie auf *Lizenz aktivieren*. - ![License screen *mobile_border](https://cdn.adtidy.org/blog/new/04fs1license-screen.png) + ![Lizenzbildschirm *mobile_border](https://cdn.adtidy.org/blog/new/04fs1license-screen.png) -1. Activate your license using your preferred method. If the license is bound to your email address, tap *Continue with email* or select a social network associated with this email address. Alternatively, enter your license key. +1. Aktivieren Sie Ihre Lizenz mit der von Ihnen bevorzugten Methode. Wenn die Lizenz an Ihre E-Mail-Adresse gebunden ist, tippen Sie auf *Mit E-Mail anmelden* oder wählen Sie ein mit dieser E-Mail-Adresse verknüpftes soziales Netzwerk aus. Alternativ können Sie auch Ihren Lizenzschlüssel eingeben. - ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) + ![Aktivieren einer Lizenz *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) ### Aktivieren von AdGuard für iOS -1. Tap *Settings*, then select *License*. +1. Tippen Sie auf *Einstellungen* und wählen Sie dann *Lizenz*. - ![Settings screen *mobile_border](https://cdn.adtidy.org/blog/new/uf8f1fsettings.png) + ![Bildschirm Einstellungen *mobile_border](https://cdn.adtidy.org/blog/new/uf8f1fsettings.png) -1. Tap **Log in** in the upper right corner of the screen +1. Tippen Sie auf **Anmelden** in der oberen rechten Ecke des Bildschirms - ![Purchase screen *mobile_border](https://cdn.adtidy.org/blog/new/10j5bhpurchase-page.png) + ![Kaufbildschirm *mobile_border](https://cdn.adtidy.org/blog/new/10j5bhpurchase-page.png) -1. Use your email address or social media account to activate your license. +1. Verwenden Sie Ihre E-Mail-Adresse oder Ihr Social-Media-Konto, um Ihre Lizenz zu aktivieren. - ![Login screen *mobile_border](https://cdn.adtidy.org/blog/new/prnjdlogin-page.png) + ![Anmeldebildschirm *mobile_border](https://cdn.adtidy.org/blog/new/prnjdlogin-page.png) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/license/cancel-refund.md b/i18n/de/docusaurus-plugin-content-docs/current/general/license/cancel-refund.md index 197cbe7e1fb..8630460a9c7 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/general/license/cancel-refund.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/license/cancel-refund.md @@ -1,31 +1,31 @@ --- -title: How to cancel or refund +title: Abonnement kündigen oder Rückerstattung erhalten sidebar_position: 5 --- ## Wie man ein Abonnement kündigt -Das Abonnement kann in Ihrem AdGuard-Konto gekündigt werden. To cancel your subscription: +Das Abonnement kann in Ihrem AdGuard-Konto gekündigt werden. Um Ihr Abonnement zu kündigen: - 1. Go to your [AdGuard account](https://my.adguard.com/). - 1. Select *Licenses*. - 1. Click *Cancel subscription* below the subscription you no longer need. ![Abbrechen](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-cancel-sub.png) + 1. Öffnen Sie Ihr [AdGuard-Konto](https://my.adguard.com/). + 1. Wählen Sie *Lizenzen*. + 1. Klicken Sie auf *Abonnement kündigen* unter dem Abonnement, das Sie nicht mehr benötigen. ![Abbrechen](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-cancel-sub.png) Das gekündigte Abonnement bleibt bis zu seinem Ablaufdatum gültig. :::note -Subscriptions purchased on the App Store can be managed in the App Store account or in the device's settings. +Im App Store gekaufte Abonnements können im App Store-Konto oder in den Einstellungen des Geräts verwaltet werden. ::: ## So erhalten Sie eine Erstattung -In accordance with our [Terms of Sale](https://adguard.com/terms-of-sale.html), you can get a 100% refund on the AdGuard license key you purchased at https://adguard.com. To get a refund, contact our support team at *support@adguard.com* and specify the payment option you've used. +In Übereinstimmung mit unseren [Verkaufsbedingungen](https://adguard.com/terms-of-sale.html) können Sie eine Rückerstattung des AdGuard-Lizenzschlüssels erhalten, den Sie unter https://adguard.com erworben haben. Um eine Rückerstattung zu erhalten, wenden Sie sich bitte an unser Support-Team unter *support@adguard.com* und geben Sie die Zahlungsoption an, die Sie verwendet haben. -A refund may be declined if: +Eine Erstattung kann abgelehnt werden, wenn: -- A license was purchased more than 60 days ago -- A license was purchased from a distributor -- A license was purchased from the App Store -- You applied for a partial refund for a license key upgrade or renewal +- Die Lizenz vor mehr als 60 Tagen erworben wurde +- Die Lizenz von einem Händler erworben wurde +- Die Lizenz im App Store erworben wurde +- Sie eine Teilerstattung für eine Erweiterung oder eine Erneuerung der Lizenz beantragt haben diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/license/payment-options.md b/i18n/de/docusaurus-plugin-content-docs/current/general/license/payment-options.md index 4edc702ef53..6df5938e142 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/general/license/payment-options.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/license/payment-options.md @@ -1,23 +1,23 @@ --- -title: How to purchase or upgrade +title: Lizenz erwerben oder erweitern sidebar_position: 2 --- -## How to purchase a license{#purchase} +## So erwerben Sie eine Lizenz{#purchase} -AdGuard licenses can be bought on [adguard.com](https://adguard.com/license.html). You can pay with Visa, Mastercard, Apple Pay, Google Pay, PayPal, Alipay and UnionPay. We also accept the following cryptocurrencies: Bitcoin, Ethereum, Litecoin, and Tether. +AdGuard-Lizenzen können auf [adguard.com](https://adguard.com/license.html) erworben werden. Sie können mit Visa, Mastercard, Apple Pay, Google Pay, PayPal, Alipay und UnionPay bezahlen. Wir akzeptieren zudem die folgenden Kryptowährungen: Bitcoin, Ethereum, Litecoin und Tether. AdGuard Pro für iOS kann im App Store gekauft werden. -Werbeblocker-Lizenzen werden auch von verschiedenen Distributoren verkauft. The availability of AdGuard products in app stores and by distributors depends on your country. +Werbeblocker-Lizenzen werden auch von verschiedenen Distributoren verkauft. Die Verfügbarkeit von AdGuard-Produkten in App Stores und bei Händlern hängt von Ihrem Land ab. -## How to upgrade a license{#upgrade} +## So erweitern Sie eine Lizenz{#upgrade} -To make more use of your AdGuard products, you can upgrade your license for the following benefits. +Um das Beste aus den AdGuard-Produkten herauszuholen, können Sie Ihre Lizenz erweitern. -- To extend the number of devices, you can **upgrade your Personal license to Family** -- You can also **upgrade your 1-year subscription to a lifetime license** +- Um die Anzahl der Geräte zu erweitern, können Sie **Ihre Einzellizenz auf eine Familienlizenz** erweitern +- Sie können auch von Ihrem**1-Jahres-Abonnement auf eine lebenslange Lizenz umsteigen** -You can upgrade your license in your AdGuard account. To do so, click *Upgrade to Lifetime* or *Increase device limit*. +Sie können Ihre Lizenz in Ihrem AdGuard-Konto erweitern. Klicken Sie dazu auf *Auf Lebenslange Lizenz umsteigen* oder *Gerätelimit erhöhen*. ![Erweitern](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-upgrade.png) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/license/transfer.md b/i18n/de/docusaurus-plugin-content-docs/current/general/license/transfer.md index 5e822bf6ec4..b2c13333628 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/general/license/transfer.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/license/transfer.md @@ -1,53 +1,53 @@ --- -title: How to transfer +title: So übertragen Sie eine Lizenz sidebar_position: 4 --- -## How to transfer a license to another device{#transfer} +## So übertragen Sie eine Lizenz auf ein anderes Gerät{#transfer} -The license key can be activated on a [limited number of devices](../what-is). If the key has already been used on the maximum allowed number of devices, you need to unbind a device from your account. +Der Lizenzschlüssel kann auf einer [begrenzten Anzahl von Geräten](../what-is) aktiviert werden. Wenn der Schlüssel bereits auf der maximal zulässigen Anzahl von Geräten verwendet wurde, müssen Sie die Bindung eines Geräts an Ihr Konto aufheben. -### How to unbind a device +### So lösen Sie die Verknüpfung -- Click *Reset license* or *Log out* in an AdGuard app +- Klicken Sie auf *Lizenz zurücksetzen* oder *Abmelden* in einer AdGuard-App -- Remove the device from your AdGuard account: - 1. Click *AdGuard Ad Blocker* in your [AdGuard account](https://my.adguard.com/). +- Entfernen Sie das Gerät aus Ihrem AdGuard-Konto: + 1. Klicken Sie auf *AdGuard Werbeblocker* in Ihrem [AdGuard Konto](https://my.adguard.com/). - ![Account Ad Blocker tab *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-unbind-device-0.png) + ![Tab Werbeblocker-Konto *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-unbind-device-0.png) - 1. Click the device you want to unbind. + 1. Klicken Sie auf das Gerät, dessen Verknüpfung Sie aufheben möchten. - ![Select device *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-unbind-device-1.png) + ![Gerät auswählen *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-unbind-device-1.png) - 1. Click *Remove*. + 1. Klicken Sie auf *Entfernen*. - ![Click Remove *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-unbind-device-2.png) + ![Klicken Sie auf Entfernen *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-unbind-device-2.png) -After you have unbound the number of devices you need, you can log in to your AdGuard account on new devices. The license will be bound to them. +Nachdem Sie die benötigte Anzahl von Geräten freigegeben haben, können Sie sich mit den neuen Geräten bei Ihrem AdGuard-Konto anmelden. Die Lizenz wird an diese verknüpft sein. -## How to transfer a license to another AdGuard account{#transferaccount} +## So übertragen Sie eine Lizenz auf ein anderes AdGuard-Konto{#transferaccount} -1. Go to the AdGuard account that contains the license you would like to transfer. +1. Öffnen Sie das AdGuard-Konto, das jene Lizenz enthält, die Sie übertragen möchten. -1. Go to the *Licenses* tab. +1. Öffnen Sie den Tab *Lizenzen*. -1. Find the license you want to transfer and click *Unbind from account*. +1. Suchen Sie die Lizenz, die Sie übertragen möchten, und klicken Sie auf *Verknüpfung zum Konto lösen*. - ![Click Unbind from account](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-transfer-to-account.png) + ![Klicken Sie auf „Verknüpfung zum Konto lösen“](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-transfer-to-account.png) -1. Click *Unbind* (**Important**: be sure to save the license key). +1. Klicken Sie auf *Verknüpfung lösen* (**Wichtig**: Stellen Sie sicher, dass Sie den Lizenzschlüssel speichern). - ![Remember the license key *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-transfer-to-account-1.png) + ![Lizenzschlüssel nicht vergessen *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-transfer-to-account-1.png) -1. Go to the AdGuard account that you would like to transfer the license to. +1. Öffnen Sie das AdGuard-Konto, auf das Sie die Lizenz übertragen möchten. -1. Go to the *Licenses* tab. +1. Öffnen Sie den Tab *Lizenzen*. -1. Click *Bind license* in the upper right corner. +1. Klicken Sie auf *Lizenz verknüpfen* in der oberen rechten Ecke. - ![Bind license *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-transfer-to-account-2.png) + ![Lizenz verknüpfen *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/general/newaccount-transfer-to-account-2.png) -1. Enter your license key (from step 3). +1. Geben Sie Ihren Lizenzschlüssel (aus Schritt 4) ein. -In case you can't access your initial account, please contact our support team at support@adguard.com. +Sollten Sie keinen Zugang zu Ihrem ursprünglichen Konto haben, wenden Sie sich bitte an unser Support-Team unter support@adguard.com. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/license/what-is.md b/i18n/de/docusaurus-plugin-content-docs/current/general/license/what-is.md index 6f065600083..7fd9161622e 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/general/license/what-is.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/license/what-is.md @@ -1,57 +1,57 @@ --- -title: What is an AdGuard license +title: Was ist eine AdGuard-Lizenz? sidebar_position: 1 --- -## What is an AdGuard license +## Was ist eine AdGuard-Lizenz? -A license is a permission to use the AdGuard product, provided in accordance with the [End User License Agreement](https://adguard.com/eula.html). If bound to an email address, AdGuard licenses can be found in the user's [AdGuard account](https://my.adguard.com/). +Eine Lizenz ist eine Erlaubnis zur Nutzung des AdGuard-Produkts, die in Übereinstimmung mit dem [Endbenutzer-Lizenzvertrag](https://adguard.com/eula.html) erteilt wird. Wenn sie an eine E-Mail-Adresse gebunden sind, können die AdGuard-Lizenzen im [AdGuard-Konto](https://my.adguard.com/) gefunden werden. -## What types of AdGuard licenses exist +## Welche Arten von AdGuard-Lizenzen gibt es? -On the [purchase page](https://adguard.com/license.html), you can see the following types of licenses: +Auf der [Kaufseite](https://adguard.com/license.html) sind folgende Arten von Lizenzen aufgeführt: -- **1-year subscriptions** — these licenses are renewed automatically every year or can be extended manually - - Personal — up to 3 devices - - Family — up to 9 devices -- **Lifetime** — these licenses are not time-limited - - Personal — up to 3 devices - - Family — up to 9 devices +- **1-Jahres-Abonnements** — diese Lizenzen werden automatisch jedes Jahr erneuert oder können manuell verlängert werden + - Einzellizenz — schützt bis zu 3 Geräte + - Familienlizenz — schützt bis zu 9 Geräte +- **Lebenslang** — diese Lizenzen sind zeitlich nicht begrenzt + - Einzellizenz — schützt bis zu 3 Geräte + - Familienlizenz — schützt bis zu 9 Geräte -There are also licenses that the user can purchase from other sources or get for free: +Es gibt auch Lizenzen, die man von anderen Quellen erwerben oder kostenlos erhalten kann: -- **Trial licenses** are free time-limited licenses that allow you to test the full functionality of the product - - AdGuard for Windows — 14-day trial - - AdGuard for Mac — 14-day trial - - AdGuard for Android — 7-day trial -- **Distributor licenses** and **gifted licenses** can be both time-limited and non-time limited. Licenses with an expiration date can only be renewed manually - - Personal — up to 3 devices - - Family — up to 9 devices -- **The AdGuard Pro for iOS license** is purchased and managed through the App Store and can only be used on iOS and iPadOS devices with the same Apple ID +- **Testlizenzen** sind kostenlose, zeitlich begrenzte Lizenzen, mit denen Sie die volle Funktionalität des Produkts testen können + - AdGuard für Windows — 14-Tage-Testversion + - AdGuard für Mac — 14-Tage-Testversion + - AdGuard für Android — 7-Tage-Testversion +- **Vertriebshändlerlizenzen** und **Geschenklizenzen** können sowohl zeitlich begrenzt als auch nicht zeitlich begrenzt sein. Lizenzen mit einem Auslaufdatum können nur manuell verlängert werden + - Einzellizenz — schützt bis zu 3 Geräte + - Familienlizenz — schützt bis zu 9 Geräte +- **Die Lizenz für AdGuard Pro für iOS** wird über den App Store erworben und verwaltet und kann nur auf iOS- und iPadOS-Geräten mit der gleichen Apple-ID verwendet werden :::tip -To extend the device limit, you can [upgrade](../payment-options/#upgrade) your license. +Um die Gerätebeschränkung aufzuweiten, können Sie Ihre [Lizenz erweitern](../payment-options/#upgrade). ::: -## How to use the AdGuard license +## So verwenden Sie die AdGuard-Lizenz -To use your license on a device, log in to your AdGuard app using the email address associated with the license. If the license hasn't been bound to your email address yet, you can do it in your [AdGuard account](https://my.adguard.com/). To do so, open the *Licenses* tab and click *Bind license*. +Zuerst melden Sie sich bei Ihrer AdGuard-App mit jener E-Mail-Adresse an, die mit der Lizenz verknüpft ist. Wenn die Lizenz noch nicht an Ihre E-Mail-Adresse gebunden wurde, können Sie dies in Ihrem [AdGuard-Konto](https://my.adguard.com/) tun. Öffnen Sie dazu den Tab *Lizenzen* und klicken Sie auf *Lizenz verknüpfen*. -Alternatively, you can enter your [license key](#license-key) in your AdGuard app. +Alternativ können Sie Ihren [Lizenzschlüssel](#license-key) in Ihrer AdGuard-App eingeben. -## License key +## Lizenzschlüssel -A license key is a unique string of characters that represents an AdGuard Ad Blocker license. It is automatically registered to the email you used to purchase the license, or is provided to you when you purchase an AdGuard license from a distributor. With a license key, you can: +Ein Lizenzschlüssel ist eine eindeutige Zeichenfolge, die eine Lizenz für AdGuard Werbeblocker darstellt. Der Schlüssel wird automatisch auf die E-Mail-Adresse registriert, die Sie beim Kauf der Lizenz verwendet haben, oder wird Ihnen zur Verfügung gestellt, wenn Sie eine AdGuard-Lizenz von einem Händler erwerben. Mit einem Lizenzschlüssel können Sie: -- [Activate your license](../activation) in a product, if you don't have an AdGuard account -- Bind your license to your AdGuard account and unbind it +- Ihre Lizenz in einem Produkt [aktivieren](../activation), wenn Sie noch kein AdGuard-Konto haben +- Ihre Lizenz mit Ihrem AdGuard-Konto verknüpfen und diese Verknüpfung aufheben -When you unbind a license, be sure to save the license key first. You'll need the key to rebind your license or transfer it to another account. +Wenn Sie die Verknüpfung aufheben, müssen Sie zuerst den Lizenzschlüssel speichern. Sie benötigen diesen Schlüssel, um Ihre Lizenz neu zu verknüpfen oder sie auf ein anderes Konto zu übertragen. ### So stellen Sie einen Lizenzschlüssel wieder her -If you don't remember the license key, check out your AdGuard account: all licenses bound to your email address are displayed there. +Wenn Sie Ihren Lizenzschlüssel vergessen haben, schauen Sie in Ihrem AdGuard-Konto nach: Dort werden alle Lizenzen angezeigt, die mit Ihrer E-Mail-Adresse verknüpft sind. -If you've lost the license key purchased from a distributor, please reach out to us at support@adguard.com. Be ready to provide a receipt or other proof of purchase. +Wenn Sie den von einem Händler gekauften Lizenzschlüssel verloren haben, wenden Sie sich bitte an uns unter support@adguard.com. Legen Sie eine Quittung oder einen anderen Kaufbeleg vor. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 1aef41808f3..00af189b6a8 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### Licencia @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 264b89c3ec2..a4bf54b0f55 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/es/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/es/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 6c097238486..33e1d343680 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ Este artículo trata sobre los filtros que creamos para usar en AdGuard y otros - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ Este artículo trata sobre los filtros que creamos para usar en AdGuard y otros - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/es/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 195e982d85b..d8d991e5eda 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/es/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/es/docusaurus-plugin-content-docs/current/general/license/activation.md index e19a71290b1..fdb2c02d78e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ También puedes utilizar una clave [](../what-is#license-key) para activar la li ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activando AdGuard para iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/fa/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/fa/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/fa/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/fi/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/fi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/fi/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 074ac2b268c..4c95fe9887e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### Licence @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 83892ac7c07..6dc8400d2d1 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/fr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 1ad54911c01..e7ef7fc7389 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ Cet article concerne les filtres que nous créons pour les utiliser dans AdGuard - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ Cet article concerne les filtres que nous créons pour les utiliser dans AdGuard - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/fr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index bf00b28c500..e30e77c0c48 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/fr/docusaurus-plugin-content-docs/current/general/license/activation.md index 3fb56eb00f0..7c0e8657f04 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternativement, vous pouvez utiliser une [clef de licence](../what-is#license-k ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### L'activation de AdGuard pour iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/hr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/hr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/hr/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/hu/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/hu/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/hu/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 02912f0c5fb..2669877ac4a 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### Licenza @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index b273dc0dbe9..e7749ec4bc2 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/it/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/it/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 6e73ce1cdcc..76dc4ffce66 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ Questo articolo riguarda i filtri che creiamo per l'utilizzo in AdGuard e altri - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ Questo articolo riguarda i filtri che creiamo per l'utilizzo in AdGuard e altri - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/it/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 7871afd0a02..3d91f3cd6c1 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/it/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/it/docusaurus-plugin-content-docs/current/general/license/activation.md index f60892f2a1b..8f4b0972f74 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Altrimenti, puoi utilizzare una [chiave di licenza](../what-is#license-key) per ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Attivare AdGuard per iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index ebc132b6450..e48c44d56b5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### ライセンス @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index ec78610592f..69ae4bdb968 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/ja/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 57bfb4d6758..ef22e8812b3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ sidebar_position: 2 - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ sidebar_position: 2 - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/ja/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 699280186ae..bc358e55584 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/ja/docusaurus-plugin-content-docs/current/general/license/activation.md index 60f2f744e49..40d51d0ab22 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -19,66 +19,62 @@ sidebar_position: 3 ### AdGuard for Windows を有効にする方法 -1. On the expired license screen, click *Activate*. +1. ライセンス/試用期間の有効期限切れに関する通知画面で、「*認証する*」をクリックします。 - ![Expired license screen *border](https://cdn.adtidy.org/blog/new/eapwtexp.png) + ![期限切れライセンス画面 *border](https://cdn.adtidy.org/blog/new/eapwtexp.png) - Alternatively, select *License* in the upper right corner of the main screen and click *Activate*. + または、メイン画面の右上にある「*ライセンス*」を選択し、「*ライセンスを認証する*」をクリックします。 - ![Main screen *border](https://cdn.adtidy.org/blog/new/ca313hmain-screen.png) + ![メイン画面 *border](https://cdn.adtidy.org/blog/new/ca313hmain-screen.png) - ![License screen *border](https://cdn.adtidy.org/blog/new/n7nkclicense-screen.png) + ![ライセンス画面 *border](https://cdn.adtidy.org/blog/new/n7nkclicense-screen.png) -1. Activate your license using your preferred method. If the license is bound to your email address, click *AdGuard Account* or select a social network associated with this email address. Alternatively, enter your license key. +1. ご希望の方法（アカウントもしくはライセンスキー）を使ってライセンスを認証します。 ライセンスがメール アドレスにバインド（紐付け）されている場合は、 「*AdGuard アカウント*」をクリックするか、そのメールアドレスに関連付けられているソーシャルアカウントを選択します。 または、ライセンスキーを入力して認証することもできます。 - ![Activating a license *border](https://cdn.adtidy.org/blog/new/lnzz5activate-license.png) + ![ライセンスの有効化 *border](https://cdn.adtidy.org/blog/new/lnzz5activate-license.png) ### AdGuard for Mac を有効にする方法 -1. On the expired license screen, click *Activate*. +1. ライセンス/試用期間の有効期限切れに関する通知画面で、「*認証する*」をクリックします。 - ![Expired license screen *mobile_border](https://cdn.adtidy.org/blog/new/o9bhtexpired-screen.png) + ![期限切れライセンス画面 *mobile_border](https://cdn.adtidy.org/blog/new/o9bhtexpired-screen.png) - Alternatively, click the gear icon in the AdGuard menu, then click *License*. + または、AdGuard を開いて歯車⚙アイコンをクリックし、「*ライセンス*」をクリックします。 - ![Preferences *border](https://cdn.adtidy.org/blog/new/xuyqmpreferences.png) + ![設定 *border](https://cdn.adtidy.org/blog/new/xuyqmpreferences.png) -1. In the opened window, click *Activate*. +1. 開いたウィンドウで、「*ライセンスを認証する*」をクリックします。 - ![License screen *border](https://cdn.adtidy.org/blog/new/8rbc8license-screen.png) + ![ライセンス画面 *border](https://cdn.adtidy.org/blog/new/8rbc8license-screen.png) -1. Activate your license using your preferred method. If the license is bound to your email address, click *AdGuard Account* or select a social network associated with this email address. Alternatively, enter your license key. +1. ご希望の方法（アカウントもしくはライセンスキー）を使ってライセンスを認証します。 ライセンスがメール アドレスにバインド（紐付け）されている場合は、 「*AdGuard アカウント*」をクリックするか、そのメールアドレスに関連付けられているソーシャルアカウントを選択します。 または、ライセンスキーを入力して認証することもできます。 - ![Activating a license *border](https://cdn.adtidy.org/blog/new/tws3jkactivate-license.png) + ![ライセンスの有効化 *border](https://cdn.adtidy.org/blog/new/tws3jkactivate-license.png) ### AdGuard for Android を有効にする方法 -1. Tap *Settings*, then select *License*. +1. *右下の歯車⚙アイコン*（設定）をタップし、 「*ライセンス*」を選択します。 - ![Settings screen *mobile_border](https://cdn.adtidy.org/blog/new/sbdcysettings.png) + ![設定画面 *mobile_border](https://cdn.adtidy.org/blog/new/sbdcysettings.png) -1. Tap *Activate license*. +1. 「*ライセンスを認証する*」をタップします。 - ![License screen *mobile_border](https://cdn.adtidy.org/blog/new/04fs1license-screen.png) + ![ライセンス画面 *mobile_border](https://cdn.adtidy.org/blog/new/04fs1license-screen.png) -1. Activate your license using your preferred method. If the license is bound to your email address, tap *Continue with email* or select a social network associated with this email address. Alternatively, enter your license key. +1. ご希望の方法（アカウントもしくはライセンスキー）を使ってライセンスを認証します。 ライセンスがメール アドレスにバインド（紐付け）されている場合は、 「*メールアドレスで続ける*」をタップするか、そのメールアドレスに関連付けられているソーシャルアカウントを選択します。 または、ライセンスキーを入力して認証することもできます。 - ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) + ![ライセンスの有効化 *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) ### AdGuard for iOS を有効にする方法 -1. Tap *Settings*, then select *License*. +1. *右下の歯車⚙アイコン*（設定）をタップし、 「*ライセンス*」を選択します。 - ![Settings screen *mobile_border](https://cdn.adtidy.org/blog/new/uf8f1fsettings.png) + ![設定画面 *mobile_border](https://cdn.adtidy.org/blog/new/uf8f1fsettings.png) -1. Tap **Log in** in the upper right corner of the screen +1. 画面右上の「**ログイン**」をタップします。 - ![Purchase screen *mobile_border](https://cdn.adtidy.org/blog/new/10j5bhpurchase-page.png) + ![購入画面 *mobile_border](https://cdn.adtidy.org/blog/new/10j5bhpurchase-page.png) -1. Use your email address or social media account to activate your license. +1. メールアドレスまたはソーシャルアカウントを使ってログインすることで、ライセンスを認証します。 - ![Login screen *mobile_border](https://cdn.adtidy.org/blog/new/prnjdlogin-page.png) + ![ログイン画面 *mobile_border](https://cdn.adtidy.org/blog/new/prnjdlogin-page.png) diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 19d974c6463..abd5ef39274 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index cd32d505586..4934051ce76 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/ko/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 02ccca1a82a..e336dfe94b6 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ sidebar_position: 2 - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ sidebar_position: 2 - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/ko/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 11fe3b3872e..cb527118114 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/ko/docusaurus-plugin-content-docs/current/general/license/activation.md index 75a831b7607..f2e45d234a8 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ To activate a license via the AdGuard account, a valid license with at least one ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### iOS용 AdGuard 활성화 방법 1. Tap *Settings*, then select *License*. diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/nl/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/nl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/nl/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/no/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/no/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/no/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/no/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/no/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/no/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/pl/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/pl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/pl/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 4ab37c182df..a658af816ab 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### Licença @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 34e02061ebc..5e3ca7871fb 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0ef2bca48d4..40ed6e8a612 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ Este artigo é sobre os filtros que criamos para usar no AdGuard e outros softwa - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ Este artigo é sobre os filtros que criamos para usar no AdGuard e outros softwa - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index e218246ddb6..ef743b22715 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/license/activation.md index 3df57817f8f..e397dc61066 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Como alternativa, você pode usar uma chave [](../what-is#license-key) para ativ ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Ativando o AdGuard para iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 9cda8348404..78039079b9a 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 871daf5bd1b..5539215d0e6 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/pt/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 6bfa5b9c734..972ff2ea031 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ Este artigo é sobre os filtros que criamos para usar no AdGuard e em outros sof - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ Este artigo é sobre os filtros que criamos para usar no AdGuard e em outros sof - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/pt/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 2dfa3508d61..75c9db70ac7 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/pt/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/ro/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/ro/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/ro/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index fe2b9c425ff..3ec06084af2 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ AdGuard блокирует рекламу, трекеры и раздражит ##### AdGuard Extra -AdGuard Extra — это специальный пользовательский скрипт, который не позволяет сайтам обходить блокировщики рекламы и повторно вставлять заблокированную рекламу. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### Лицензия @@ -421,7 +421,7 @@ GitHub — ещё один способ сообщать об ошибках и ::: -### Разница между бесплатной и платной версией +## Free vs full version @@ -441,13 +441,13 @@ AdGuard блокирует рекламу на YouTube помощью собст - *Собственные фильтры и правила* позволяют добавлять свои правила фильтрации и сторонние фильтры для более точной настройки блокировки рекламы. [К фильтрам](#filters) -- *Пользовательские скрипты* позволяют использовать AdGuard Extra, чтобы запретить сайтам повторно вставлять рекламу, и устанавливать другие скрипты для расширения функциональности браузера. [Назад к пользовательским скриптам](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Назад к пользовательским скриптам](#userscripts) Вы можете получить доступ к этим функциям, [купив лицензию](https://adguard.com/license.html). [Как активировать лицензию](/general/license/activation/#activating-adguard-for-android) -### Рутованные и нерутованные устройства +## Rooted vs non-rooted devices -Из-за усиленных мер безопасности приложений Android некоторые функции AdGuard доступны только на устройствах с root-доступом. Вот их список: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Вот их список: - **HTTPS-фильтрация в большинстве приложений** требует [установки сертификата ЦС в системное хранилище](#security-certificates), так как большинство приложений не доверяют сертификатам в пользовательском хранилище. Установка сертификата в системное хранилище возможна только на рутованных устройствах - Режим [**Автоматический прокси**](#routing-mode) требует root-доступа из-за ограничений Android на фильтрацию трафика на уровне системы @@ -457,7 +457,7 @@ AdGuard блокирует рекламу на YouTube помощью собст Помощник — удобный инструмент для быстрого изменения настроек приложения или сайта и просмотра статистики без запуска приложения AdGuard. -### Как получить доступ к Помощнику +### How to access Assistant 1. Проведите пальцем вниз от верхней части экрана, чтобы открыть шторку уведомлений. 2. Найдите и **разверните** уведомление AdGuard. @@ -468,13 +468,13 @@ AdGuard блокирует рекламу на YouTube помощью собст ![Нажмите Помощник *mobile](https://cdn.adtidy.org/blog/new/1qvlhassistant-tap-assistant.jpg) -### Как пользоваться Помощником +### How to use Assistant Открыв Помощник, вы увидите две вкладки: **Приложения** и **Сайты**. В каждой есть список недавно использованных приложений и сайтов соответственно. ![Главный экран Помощника *mobile](https://cdn.adtidy.org/blog/new/i5mljAssistant-main.jpg) -### Приложения +### Apps tab После выбора приложения (**в качестве примера возьмём Chrome**) появится несколько вариантов действий. @@ -502,7 +502,7 @@ AdGuard блокирует рекламу на YouTube помощью собст Вы попадёте на экран AdGuard, где можно изменить настройки Фаервола для приложения — то есть управлять доступом приложения в интернет. -### Сайты +### Websites tab ![Помощник: вкладка Сайты *mobile](https://cdn.adtidy.org/blog/new/74y9rAssistant-websites.jpg) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 0aa66f9d3e3..6a0f88a2efb 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard для Safari — это бесплатная программа. Она 1. Чтобы настроить AdGuard для Safari, включите расширения AdGuard в настройках Safari. В уведомлении нажмите *Исправить*. В открывшемся окне поставьте галочки напротив расширений AdGuard. -![Уведомление: некоторые расширения отключены](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Уведомление: некоторые расширения отключены](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + Не все расширения необходимы для корректной работы AdGuard для Safari. Например, если вы отметите галочкой г*Иконку*, рядом с панелью поиска появится значок AdGuard. Тем не менее, мы рекомендуем включить их все. -Не все расширения обязательны для корректной работы AdGuard для Safari. Например, если вы отметите *Иконку AdGuard Safari*, рядом с панелью поиска появится значок AdGuard. Тем не менее, мы рекомендуем включить их все. ::: -![Отмеченные расширения](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Отмеченные расширения](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. Чтобы AdGuard работал на сайтах, включите настройку *Блокировщики контента*. Вы можете либо включить её для всех сайтов, либо выбрать те, которые вам нужны. + + :::note + + Этот шаг необходим для iOS 9.0 и более поздних версий, macOS 10.11 с Safari 10 и macOS 10.12 и более поздних версий. + + +::: + +В macOS нажмите *Настройки* → *Сайты* → *Блокировщики контента*. Если вы хотите, чтобы AdGuard работал на всех сайтах, включите опцию *При посещении других сайтов*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -После того как вы выполните шаги 1-3, AdGuard для Safari начнёт работать. Теперь вы можете настроить его параметры. +After you complete steps 1-4, AdGuard for Safari will start functioning. Теперь вы можете настроить его параметры. ## Как удалить AdGuard для Safari {#uninstall} diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 291f9f4cbf8..d725ec3a36b 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ sidebar_position: 2 - **Фильтр счётчиков и системы аналитики** содержит наиболее полный список различных интернет-счётчиков и систем интернет-аналитики. Используйте его, чтобы избежать отслеживания. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **Фильтр отслеживания по URL** повышает конфиденциальность, удаляя параметры отслеживания из URL-адресов. Когда пользователь включает блокировку параметров отслеживания в модуле Антитрекинга, автоматически включается этот фильтр. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Фильтр виджетов социальных сетей** скрывает многочисленные кнопки «Мне нравится», «Поделиться» и подобные им интеграции с социальными сетями на популярных сайтах. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Фильтр раздражителей** блокирует раздражающие элементы на сайтах. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Включает следующие фильтры AdGuard (все они могут быть включены независимо от фильтра раздражителей): +- **Фильтр раздражителей** блокирует раздражающие элементы на сайтах. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Фильтр cookie-уведомлений** блокирует уведомления о cookie-файлах на веб-страницах. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Фильтр всплывающих окон** блокирует всплывающие окна, не имеющие отношения к функциональности сайта. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Фильтр баннеров мобильных приложений** блокирует баннеры, рекламирующие мобильные приложения сайтов. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Фильтр виджетов** блокирует виджеты онлайн-ассистентов, чатов службы поддержки и т. п. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Фильтр других раздражителей** блокирует элементы на веб-страницах, не включённые в популярные категории раздражителей. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Фильтр полезной рекламы** разблокирует рекламу, которая может быть полезна пользователям. Подробнее о фильтре можете узнать на [этой странице](../search-ads). [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Русский фильтр** убирает рекламу с сайтов на русском языке. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **Немецкий фильтр** убирает рекламу с сайтов на немецком языке. Изначально основан на фильтре [EasyList Germany](https://easylist.to/) и доработан нами исходя из жалоб и сообщений пользователей. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ sidebar_position: 2 - **Испано-португальский фильтр** убирает рекламу с сайтов на испанском и португальском языках. Изначально основан на фильтре [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) и доработан нами исходя из жалоб и сообщений пользователей. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Турецкий фильтр** убирает рекламу с сайтов на турецком языке. Создан нами в соответствии с жалобами пользователей. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Китайский фильтр** убирает рекламу с сайтов на китайском языке. Изначально основан на фильтре [EasyList China](https://github.com/easylist/easylistchina) и доработан нами исходя из жалоб и сообщений пользователей. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Экспериментальный фильтр** предназначен для проверки некоторых новых правил фильтрации, которые потенциально могут вызывать конфликты или ломать работу сайтов. В случае успешной проверки правила из этого фильтра добавляются в основные фильтры. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Фильтр мобильной рекламы** блокирует рекламу на мобильных устройствах. Содержит все известные нам рекламные сети. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS-фильтр** составлен из нескольких фильтров (Базовый фильтр AdGuard, Фильтр социальных сетей, Фильтр счётчиков и систем аналитики, Фильтр мобильной рекламы, EasyList и EasyPrivacy) и специально упрощён для лучшей совместимости с блокировкой рекламы на DNS-уровне. Этот фильтр используется серверами [AdGuard DNS](https://adguard-dns.io/kb) для блокировки рекламы и трекинга. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 4f9e63a5543..4be15e532c1 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ AdGuard Content Blocker — это расширение для браузеро ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Синтаксис базовых правил {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard для Safari и AdGuard для iOS не полностью поддер ::: -### Ограничения на применение правил {#rules-restrictions} - -Правила, соответствующие произвольно большому количеству URL-адресов, считаются некорректными и игнорируются. Это может произойти, если правило не содержит маски или если маска соответствует любому URL с определённым протоколом. - -Это правило будет игнорироваться: - -```text -|http://$replace=/a/b/ -``` - -Это ограничение можно обойти, используя регулярное выражение `/.*/` внутри маски. - -Это правило не будет игнорироваться: - -```text -/.*/$replace=/a/b/ -``` - -**Исключения** - -Данная проверка правил не применяется в следующих случаях: - -1. Правило содержит модификатор [`$domain`](#domain-modifier), указывающий на конкретный список доменов - - Эти правила не будут игнорироваться: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - Это правило будет проигнорировано из-за исключения домена, что приводит к слишком широкой области применения правила: - - ```text - $domain=~example.com,script - ``` - -1. Правило содержит модификатор [`$app`](#app-modifier), указывающий на конкретный список приложений - - Это правило не будет игнорироваться: - - ```text - $app=curl,document - ``` - - Это правило будет проигнорировано из-за исключения приложения, что приводит к слишком широкой области применения правила: - - ```text - $app=~curl,document - ``` - -1. Правило содержит один или несколько модификаторов из перечисленных: [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - Эти правила не будут игнорироваться: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Поддержка wildcard для доменов верхнего уровня (TLD) {#wildcard-for-tld} Wildcard-символы поддерживаются для TLD-доменов в шаблонах [косметических правил](#cosmetic-rules), правил [HTML-фильтрации](#html-filtering-rules) и [JavaScript](#javascript-rules). @@ -607,7 +551,7 @@ AdGuard будет пытаться закрыть браузерную вкла :::info Совместимость - Модификатор `$popup` лучше всего работает в браузерном расширении AdGuard. -- В AdGuard для Safari и iOS `$popup-правила` просто заблокируют страницу. +- В AdGuard для Safari и iOS `$popup`-правила просто заблокируют страницу. - В AdGuard для Windows, Mac и Android модификатор `$popup` в некоторых случаях может не обнаружить всплывающее окно, и оно не будет заблокировано. Модификатор `$popup` применяет тип контента `document` со специальным флагом, который передаётся блокирующей странице. Блокирующая страница сама может провести некоторые проверки и закрыть окно, если это действительно всплывающее окно. В противном случае страница должна быть загружена. Его можно комбинировать с другими модификаторами типа request, такими как `$third-party` и `$important`. - Правила с модификатором `$popup` не поддерживаются в AdGuard Content Blocker. @@ -2443,7 +2387,7 @@ replace = "/" regexp "/" replacement "/" modifiers Правила скрытия элементов работают по-разному, и их приоритет меняется [в зависимости от платформы](#cosmetic-rules-priority). -#### Синтаксис {#non-basic-rules-modifiers-syntax} +#### Синтаксис ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS-селектор](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), определяющий элементы, к которым мы хотим применить стиль. -- **`domains`** — ограничение на домены, на страницах которых будет применено правило. Строится по тем же правилам, что и в случае [правил скрытия элементов](#elemhide-syntax). +- **`domains`** — ограничение на домены, на страницах которых будет применено правило. Строится по тем же правилам, что и в случае [правил скрытия элементов](#cosmetic-elemhide-rules). - **`style`** — CSS-стиль, который мы хотим применить к выбранным элементам. **Примеры** @@ -2598,7 +2542,7 @@ CSS-правила работают по-разному, и их приорит Синтаксис расширенных CSS-правил: -- `#?# ` — для скрытия элементов, `#@?#` — для исключений +- `#?#` — для скрытия элементов, `#@?#` — для исключений - `#$?#` — для CSS-стилей, `#@$?#` — для исключений **Настоятельно рекомендуем** использовать этим маркеры каждый раз, когда вы используете расширенный CSS-селектор. @@ -2803,7 +2747,7 @@ div:contains(/it .* banner/gi) - `target` — необязательный, стандартный или расширенный CSS-селектор, может быть пропущен для проверки *любых* элементов - `pseudo-element` — необязательный, допустимый стандартный псевдоэлемент, например, `before`, `after`, `first-line` и т. д. - `property` — требуется, название CSS-свойства, которое будет проверено у элемента -- `pattern` — требуется, паттерн значений, который использует то же простое сопоставление с wildcard-знаками, что и в основных правилах фильтрации URL-адресов, ИЛИ регулярное выражение. Для этого типа соответствия AdGuard не обращает внимание на регистр. В случае с регулярными выражениями паттерн будет выглядеть так: `/regexp/`. +- `pattern` — требуется, шаблон значений, который использует то же простое сопоставление с подстановочными знаками, что и в основных правилах фильтрации URL-адресов, ИЛИ регулярное выражение. Для этого типа соответствия AdGuard не обращает внимание на регистр. В случае с регулярными выражениями шаблон будет выглядеть так: `/regexp/`. **Экранирование и снятие специальных символов** @@ -3250,7 +3194,7 @@ Rules with the `:not()` pseudo-class should use the [native implementation of `: То, как применяются правила **скрытия элементов** и **CSS-правила**, зависит от платформы. -**В AdGuard для Windows, Mac и Android** мы используем таблицу стилей, встроенную в страницу. Приоритет у косметических правил такой же, как и у любых других таблиц стилей CSS на сайтах. Но есть ограничение: [правила скрытия элементов](#elemhide-syntax) и [CSS-правила](#cosmetic-css-rules) не могут обходить встроенные стили. В таких случаях рекомендуется использовать расширенные селекторы или HTML-фильтрацию. +**В AdGuard для Windows, Mac и Android** мы используем таблицу стилей, встроенную в страницу. Приоритет у косметических правил такой же, как и у любых других таблиц стилей CSS на сайтах. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. В таких случаях рекомендуется использовать расширенные селекторы или HTML-фильтрацию. **В Браузерном расширении AdGuard** используются так называемые «пользовательские таблицы стилей». Их приоритет выше, даже чем у встроенных стилей. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — имя элемента в нижнем регистре, например, `div` или `script`. -- **`domains`** — ограничение на домены, на страницах которых будет применено правило. Те же принципы, что и в [синтаксисе правил скрытия элементов](#elemhide-syntax). +- **`domains`** — ограничение на домены, на страницах которых будет применено правило. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — список атрибутов, ограничивающих выбор элементов. `name` — имя атрибута, `value` — подстрока, которая содержится в значении атрибута. - **`pseudoName`** — имя псевдокласса. - **`pseudoArgs`** — аргументы псевдокласса, записанного в виде функции. @@ -3483,7 +3427,7 @@ AdGuard поддерживает специальный тип правил, п rule = [domains] "#%#" script ``` -- **`domains`** — ограничение на домены, на страницах которых будет применено правило. Строится по тем же правилам, что и в случае [правил скрытия элементов](#elemhide-syntax). +- **`domains`** — ограничение на домены, на страницах которых будет применено правило. Строится по тем же правилам, что и в случае [правил скрытия элементов](#cosmetic-elemhide-rules). - **`script`** — произвольный javascript-код **в одну строку**. **Примеры** @@ -3593,7 +3537,7 @@ example.org#%#//scriptlet("abort-on-property-read", "alert") Поведение любого правила можно изменить, используя модификаторы, описанные ниже. -**Синтаксис** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ false_conditions_rules_list - `adguard_ext_opera` — Браузерное расширение AdGuard для Opera - `adguard_ext_android_cb` — AdGuard Content Blocker для мобильных браузеров Samsung и Яндекс - `ext_ublock` — особый случай; эта константа объявляется, когда версия фильтра для uBlock компилируется при помощи [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — начало блока, когда условия ложны - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — списки правил - `!#endif` — конец блока diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/ru/docusaurus-plugin-content-docs/current/general/license/activation.md index 92f1275dd8e..d51729f9acb 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ sidebar_position: 3 ![Активация лицензии *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Вы также можете нажать *У меня есть лицензия* на следующем экране — откроется то же самое окно активации. - - ![У меня есть лицензия *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Активация AdGuard для iOS 1. Нажмите *Настройки*, затем выберите *Лицензия*. diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/sk/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/sk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/sk/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/sl/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/sl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/sl/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/sv/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/sv/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/sv/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/ta/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/ta/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/ta/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..d38e7e773ed --- /dev/null +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: Günlükler arka plan sayfasından nasıl dışa aktarılır +sidebar_position: 1 +--- + +## Uzantının arka plan sayfasından günlükleri dışa aktarma + +### Chrome + +1. AdGuard Tarayıcı Uzantısını açın ve mümkünse hataya neden olan işlemleri tekrarlayın. Hatanın oluştuğu tam zamana dikkat edin. + +2. `chrome://extensions` adresine gidin. + +3. _Geliştirici modu_ öğesini etkinleştirin. + + ![Geliştirici modu \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. `background.html` öğesine tıklayın. + + ![Arka plan \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. _Konsol_ sekmesini açın. + + ![Konsol sekmesi \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Sağ tık menüsünü açın ve _Farklı kaydet…_ öğesini seçin. + + ![Farklı kaydet \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. AdGuard Tarayıcı Uzantısını açın ve mümkünse hataya neden olan işlemleri tekrarlayın. Hatanın oluştuğu tam zamana dikkat edin. + +2. `about:addons` adresine gidin. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. _İncele_ öğesine tıklayın. + + ![İncele \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. _Konsol_ sekmesine gidin. + + ![Konsol \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. _Tüm Mesajları Dosyaya Kaydet_ öğesine tıklayın. + + ![Kaydet \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Günlükleri gönderme + +Artık günlükleri topladığınıza göre, bunları geliştirme ekibimize göndermek için lütfen aşağıdaki adımları izleyin: + +1. Hatayı [GitHub'dan](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose) bildirin. +2. Günlükleri ve yeniden oluşturma süresini içeren arşivinizi `devteam@adguard.com` adresine gönderin ve GitHub sorununuz için bir bağlantı ekleyin. Ayrıca arşivi Google Drive'a yükleyebilir ve dosyayı eklemek yerine bağlantıyı arşive ekleyebilirsiniz. diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 0855a0eb41e..6d3082e58f5 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra, karmaşık reklamları ve reklamları sitelere yeniden enjekte eden mekanizmaları engelleyen özel bir kullanıcı betiğidir. ### Lisans @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Ücretsiz ile tam sürüm karşılaştırması @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Kullanıcı betikleri* tarayıcının işlevselliğini genişletmenize ve reklamların yeniden eklenmesini önleyen [AdGuard Extra](#adguard-extra) kullanmanıza olanak tanır. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Android işletim sisteminin güvenlik önlemleri nedeniyle bazı AdGuard özellikleri yalnızca root erişimli cihazlarda kullanılabilir. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 2bf03d9a5fc..87c422b70a8 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -19,19 +19,41 @@ Safari için AdGuard, App Store'da sunulan ücretsiz bir uygulamadır. Cihazın 1. Press *Get* → *Install* → *Open*. -1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. +1. Safari için AdGuard'ı ayarlamak üzere Safari ayarlarında AdGuard uzantılarını etkinleştirin. Bir bildirimde *Düzelt* öğesine tıklayın. Açılan bir pencerede, AdGuard uzantılarının yanındaki kutuları işaretleyin. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Bildirim: Bazı uzantılar devre dışı bırakıldı](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::not + :::not + + Safari için AdGuard'ın düzgün çalışması için tüm uzantılar gerekli değildir. Örneğin, *Simge* uzantısını kontrol etmek, arama çubuğunun yanındaki simgeyi etkinleştirir. However, we recommend enabling all of them. -Not all extensions are required for AdGuard for Safari to function correctly. Örneğin, *Simge* uzantısını kontrol etmek, arama çubuğunun yanındaki simgeyi etkinleştirir. However, we recommend enabling all of them. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::not + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## Safari için AdGuard nasıl kaldırılır {#uninstall} diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 90ea51b337a..1959ec4e1f4 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [Kuralları görüntüleyin](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Aşağıdaki AdGuard filtrelerini içerir (hepsi AdGuard Can Sıkıcı Öğeler filtresinden ayrı olarak etkinleştirilebilir): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,28 +34,42 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) -- **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. + +Bu sayfada bu filtre hakkında daha fazla bilgi edinin. [Kuralları görüntüle](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) + + - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Bilinen tüm mobil reklam ağlarını içerir. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) -- **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) +- **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) + + ## AdGuard Filters Policy Our filter policy defines what AdGuard filters should block and what they should not, as well as the rules for adding and removing rules from filters. Read the full text of [AdGuard filter policy](../filter-policy) for detailed information. + + ## Contributing to AdGuard filters We are blessed with a unique community that not only loves AdGuard but also gives back. Many people volunteer in various ways to make AdGuard's user experience better for everybody. You are welcome to join the band and make a difference. We will do our part and happily reward the most active community. So, what can you do? + + ### Report Issues We rely on the community to let us know about issues with our filters. It helps us use our time more efficiently and keep filters constantly updated. To submit a report, please use this [web reporting tool](https://agrd.io/report). + + ### Suggest Filtering Rules You will find many open issues in the [GitHub filter repository](https://github.com/AdguardTeam/AdguardFilters/issues). Each one refers to a problem with a website, such as a missed ad or a false positive. Pick an issue and suggest your own rules in the comments. AdGuard filter engineers will review your suggestions and, if approved, add your rules to AdGuard filters. Here is the [official documentation](../create-own-filters) on the syntax of AdGuard filtering rules. Please read it carefully: it will help you create your own filtering rules. + + ### Katkıda bulunmanın diğer yolları Here is [a dedicated page](https://adguard.com/contribute.html) for people willing to contribute to AdGuard in other ways. diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index ea218f899a9..4f65141ec87 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Tarayıcı, engellenen bir isteğin hatayla tamamlandığını algılıyor. ::: +:::note Kural uzunluğu + +4 karakterden kısa kurallar hatalı kabul edilecek ve dikkate alınmayacaktır. + +::: + ### Temel kural söz dizimi {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -İsteğe bağlı olarak çok sayıda URL ile eşleşen kurallar hatalı kabul edilir ve dikkate alınmaz. Kural bir maske içermiyorsa veya maske belirli bir protokole sahip herhangi bir URL ile eşleşiyorsa bu durum meydana gelebilir. - -Bu kural göz ardı edilecektir: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -Bu kural göz ardı edilmeyecektir: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -Bu kural doğrulaması aşağıdaki durumlarda uygulanmaz: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - Bu kurallar göz ardı edilmeyecektir: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - Bu kural göz ardı edilmeyecektir: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - Bu kurallar göz ardı edilmeyecektir: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -356,7 +300,7 @@ If you want the rule not to be applied to certain apps, start the app name with - `||baddomain.com^$app=~org.example.app` — a rule to block requests that match the specified mask and are sent from any app except for the `org.example.app`. - `||baddomain.com^$app=~org.example.app1|~org.example.app2` — same as above, but now two apps are excluded: `org.example.app1` and `org.example.app2`. -:::caution Restrictions +:::dikkat Kısıtlamalar Değiştirici değerindeki uygulamaların joker karakteri olamaz, örneğin `$app=com.*.music`. Bu tür değiştiriciye sahip kurallar geçersiz kabul edilir. @@ -397,7 +341,7 @@ veya bu üçünün birleşimine: @@||y.com$script,domain=a.com|b.com ``` -:::caution Restrictions +:::dikkat Kısıtlamalar - The rule's matching pattern cannot target any specific domains, e.g. it cannot start with `||`. - Domains in the modifier value cannot be negated, e.g. `$denyallow=~x.com`, or have a wildcard TLD, e.g. `$denyallow=x.*`. @@ -490,7 +434,7 @@ In the following examples it is implied that requests are sent from `http://exam ##### `$domain` modifier limitations {#domain-modifier-limitations} -:::caution Restrictions +:::dikkat Kısıtlamalar Safari does not support the simultaneous use of allowed and disallowed domains, so rules like `||baddomain.com^$domain=example.org|~foo.example.org` will not work in AdGuard for iOS and AdGuard for Safari. @@ -584,7 +528,7 @@ This modifier limits the rule scope to requests that use the specified set of HT - `@@||evil.com$method=get` unblocks only GET requests to `evil.com`. - `@@||evil.com$method=~post` unblocks any requests to `evil.com` except POST. -:::caution Restrictions +:::dikkat Kısıtlamalar Rules with mixed negated and not negated values are considered invalid. So, for example, the rule `||evil.com^$method=get|~head` will be rejected. @@ -654,7 +598,7 @@ Tam değiştirici adını kullanmak yerine daha kısa bir ad (takma ad) kullanab - `/ads$to=~not.evil.com|evil.com` blocks any request to `evil.com` and its subdomains, with a path matching `/ads`, except requests to `not.evil.com` and its subdomains. - `/ads$to=~good.com|~good.org` blocks any request with a path matching `/ads`, except requests to `good.com` or `good.org` and their subdomains. -:::caution Restrictions +:::dikkat Kısıtlamalar [`$denyallow`](#denyallow-modifier) can not be used together with `$to`. It can be expressed with inverted `$to`: `$denyallow=a.com|b.com` is equivalent to `$to=~a.com|~b.com`. @@ -1007,7 +951,7 @@ Blocking cookies and removing tracking parameters is achieved by using rules wit ::: -:::caution Restrictions +:::dikkat Kısıtlamalar - Modifier options should be lowercase, i.e. `$stealth=DPI` will be rejected. - Modifier options cannot be negated, i.e. `$stealth=~3p-cookie` will be rejected. @@ -1252,7 +1196,7 @@ There are two methods to deactivate `$cookie` rules: the primary method involves - `@@||example.org^$cookie=concept` unblocks a single cookie named `concept` - `@@||example.org^$cookie=/^_ga_/` unblocks every cookie that matches the regular expression -:::caution Restrictions +:::dikkat Kısıtlamalar `$cookie` rules support a limited list of modifiers: `$domain`, `$~domain`, `$important`, `$third-party`, and `$~third-party`. @@ -1294,7 +1238,7 @@ In case if multiple `$csp` rules match a single request, we will apply each of t - `||example.org^$csp=script-src 'self' 'unsafe-eval' http: https:` disables inline scripts on all the pages matching the rule pattern. - `@@||example.org^$document` or `@@||example.org^$urlblock` disables all the `$csp` rules on all the pages matching the rule pattern. -:::caution Restrictions +:::dikkat Kısıtlamalar - There are a few characters forbidden in the `$csp` value: `,`, `$`. - `$csp` rules support limited list of modifiers: `$domain`, `$important`, `$subdocument`. @@ -1425,7 +1369,7 @@ preroll.ts -:::caution Restrictions +:::dikkat Kısıtlamalar - `$hls` rules are only allowed [**in trusted filters**](#trusted-filters). - `$hls` rules are compatible with the modifiers `$domain`, `$third-party`, `$app`, `$important`, `$match-case`, and `$xmlhttprequest` only. @@ -1672,7 +1616,7 @@ CoreLibs v1.11 veya sonraki sürümlerini çalıştıran Windows, Mac ve Android -:::caution Restrictions +:::dikkat Kısıtlamalar - `$jsonprune` rules are only compatible with these specific modifiers: `$domain`, `$third-party`, `$app`, `$important`, `$match-case`, and `$xmlhttprequest`. - `$jsonprune` rules do not apply if the size of the original response is more than 10 MB. @@ -1696,7 +1640,7 @@ This is basically a Firewall-like rule allowing to fully block or unblock access We recommend to get acquainted with this [article](#regexp-support) for better understanding of regular expressions. -:::caution Restrictions +:::dikkat Kısıtlamalar `$network` değiştiricisi, yalnızca `$app` ve `$important` değiştiricileriyle birlikte kurallarda kullanılabilir, diğer değiştiricilerle birlikte kullanılamaz. @@ -1747,7 +1691,7 @@ In case if multiple `$permissions` rules match a single request, AdGuard will ap - `$domain=example.org|example.com,permissions=storage-access=()\, camera=()` disallows using the Storage Access API to request access to unpartitioned cookies and using video input devices across `example.org` and `example.com`. - `@@||example.org^$document` or `@@||example.org^$urlblock` disables all the `$permission` rules on all the pages matching the rule pattern. -:::caution Restrictions +:::dikkat Kısıtlamalar 1. Characters forbidden in the `$permissions` value: `$` 1. `$permissions` is compatible with the limited list of modifiers: `$domain`, `$important`, and `$subdocument` @@ -1885,7 +1829,7 @@ In case of multiple `$removeheader` rules matching a single request, we will app @@||example.org/path/$removeheader ``` -:::caution Restrictions +:::dikkat Kısıtlamalar This type of rules can be used [**only in trusted filters**](#trusted-filters). @@ -2060,7 +2004,7 @@ With these rules, specified UTM parameters will be removed from any request save `$removeparam` rules can also be disabled by `$document` and `$urlblock` exception rules. But basic exception rules without modifiers do not do that. For example, `@@||example.com^` will not disable `$removeparam=p` for requests to **example.com**, but `@@||example.com^$urlblock` will. -:::caution Restrictions +:::dikkat Kısıtlamalar - Rules with `$removeparam` modifier can be used [**only in trusted filters**](#trusted-filters). - `$removeparam` rules are compatible with [basic modifiers](#basic-rules-basic-modifiers), [content-type modifiers](#content-type-modifiers), and with `$important` and `$app` modifiers. Rules with any other modifiers are considered invalid and will be discarded. @@ -2137,7 +2081,7 @@ You can see how this rule works here: http://regexr.com/3cesk - `@@||example.org^$replace` will disable all `$replace` rules matching `||example.org^`. - `@@||example.org^$document` or `@@||example.org^$content` will disable all `$replace` rules **originated from** pages of `example.org` **including the page itself**. -:::caution Restrictions +:::dikkat Kısıtlamalar Rules with `$replace` modifier can be used [**only in trusted filters**](#trusted-filters). @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Söz dizimi {#non-basic-rules-modifiers-syntax} +#### Söz dizimi ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Örnekler** @@ -2548,7 +2492,7 @@ example.com#@$#.textad { visibility: hidden; } We recommend to use this kind of exceptions only if it is not possible to change the CSS rule itself. In other cases it is better to change the original rule, using domain restrictions. -:::caution Restrictions +:::dikkat Kısıtlamalar Styles that lead to loading any resource are forbidden. Basically, it means that you cannot use any `` type of value in the style. @@ -2839,7 +2783,7 @@ div:matches-css(before, content: block*) div:matches-css(before, content: /block me/) ``` -:::caution Restrictions +:::dikkat Kısıtlamalar Regexp patterns **do not support** flags. @@ -2907,7 +2851,7 @@ For **regexp** patterns `"` and `\` should be **escaped**, e.g. `div:matches-att ``` -:::caution Restrictions +:::dikkat Kısıtlamalar Regexp patterns **do not support** flags. @@ -2982,7 +2926,7 @@ To check properties of a specific element, do the following: ::: -:::caution Restrictions +:::dikkat Kısıtlamalar Regexp patterns **do not support** flags. @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Örnekler** @@ -3514,7 +3458,7 @@ Sometimes, it may be necessary to disable all restriction rules. For example, to We recommend to use this kind of exceptions only if it is not possible to change the hiding rule itself. In other cases it is better to change the original rule, using domain restrictions. -:::caution Restrictions +:::dikkat Kısıtlamalar JavaScript rules can be used [**only in trusted filters**](#trusted-filters). @@ -3573,7 +3517,7 @@ Trusted scriptlets are not compatible with other ad blockers except AdGuard. ::: -:::caution Restrictions +:::dikkat Kısıtlamalar Trusted scriptlets rules can be used [**only in trusted filters**](#trusted-filters). @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Söz dizimi** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — özel durumdur; bu, bir filtrenin uBlock sürümü [FiltersRegistry][] tarafından derlendiğinde bildirilir + - `cap_html_filtering` — HTML filtreleme kurallarını destekleyen ürünler: Windows için AdGuard, Mac için AdGuard ve Android için AdGuard - `!#else` — koşullar yanlış olduğunda bloğun başlangıcı - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — kural listeleri - `!#endif` — end of the block diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/tr/docusaurus-plugin-content-docs/current/general/license/activation.md index ac171c23bb2..4f54388b133 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatif olarak lisansı etkinleştirmek için [lisans anahtarı](../what-is#l ![Lisansı etkinleştirme *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatif olarak, aşağıdaki ekranda *Lisansım var* öğesine dokunabilir ve lisansınızı yukarıda belirtilen yöntemlerden biriyle etkinleştirebilirsiniz. - - ![Lisansım var *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### iOS için AdGuard'ı etkinleştirme 1. *Ayarlar* öğesine dokunun, ardından *Lisans* öğesini seçin. diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/uk/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/uk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/uk/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/vi/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/vi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/vi/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*. diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..cf0ac710541 --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome 浏览器 + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox 浏览器 + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index a6764fc3ecd..31a81094753 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### 许可证 @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 208090d64bb..e63a9347448 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 2d8bdd2d010..c890ec43a89 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ sidebar_position: 2 - **防跟踪保护过滤器** — 各种在线计数器和网络分析工具的综合列表。 用它来隐藏用户在网上的活动，避免跟踪。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL 跟踪过滤器**从网址中移除跟踪参数加强隐私保护。 当用户选择在隐身模式下拦截跟踪参数时，此过滤器将自动启用。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **社交媒体过滤器**此过滤器移除社交媒体小工具「点赞」和「分享」按钮及类似的元素。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **恼人广告过滤器**屏蔽网页上的恼人元素。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) 包括以下 AdGuard 过滤器（所有过滤器都可以独立于烦恼过滤器启用）： +- **恼人广告过滤器**屏蔽网页上的恼人元素。 [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie 通知**在网页上拦截 Cookie 通知。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **弹出窗口**拦截各种对网站运行没有必要的弹窗。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **移动拦截程序横幅广告**阻止宣传网站移动应用的横幅。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **小工具**阻止第三方小工具：在线助手、实时客服支持聊天等 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **其他烦恼**阻止不属于流行的烦恼类别的元素。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **解除搜索广告和自我推销过滤器**解除可能对用户有用的广告。 在[此页](../search-ads)上了解更多关于此过滤器的信息。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **俄语过滤器**删除俄语网站上的广告。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **德语过滤器**删除德语网站上的广告。 最初是基于 [EasyList Germany](https://easylist.to/) 过滤器，随后我们根据用户的反馈进行修改。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ sidebar_position: 2 - **西班牙语/葡萄牙语过滤器**删除西班牙语和葡萄牙语网站上的广告。 最初是基于 [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) 过滤器，随后我们根据用户的反馈进行修改。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **土耳其语过滤器**删除土耳其语网站上的广告。 由我们根据用户的反馈创建。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **中文过滤器**删除中文网站上的广告。 Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **实验性过滤器**，此过滤器设计用于在将某些有风险的过滤规则添加到基本过滤器之前对其进行测试。 如果这些规则执行没有任何问题，它们会被添加到主过滤器中。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **移动广告过滤器**拦截移动设备上的广告。 包含所有已知的移动广告网络。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS 过滤器** — 此过滤器由其他几个过滤器 (AdGuard 基础过滤器、社交媒体过滤器、防跟踪保护过滤器、移动广告过滤器、EasyList 和 EasyPrivacy) 组成，并经过简化，以便更好地与 DNS 级别的广告拦截兼容。 [AdGuard DNS](https://adguard-dns.io/kb) 服务器使用此过滤器来拦截广告和跟踪器。 [查看规则](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index ad08ba8b7ef..47b11f505c6 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/license/activation.md index 4229d3920b7..1c3e843b4a6 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ sidebar_position: 3 ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### 在 iOS 版的 AdGuard 激活许可证 1. Tap *Settings*, then select *License*. diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md new file mode 100644 index 00000000000..6c45e8f4f97 --- /dev/null +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -0,0 +1,57 @@ +--- +title: How to export logs from the background page +sidebar_position: 1 +--- + +## Exporting logs from the background page in the extension + +### Chrome + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `chrome://extensions`. + +3. Enable _Developer mode_. + + ![Developer mode \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/developer_mode1.png) + +4. Click `background.html`. + + ![Background \*border](https://cdn.adguardvpn.com/content/kb/ad_blocker/browser_extension/background1.png) + +5. Open the tab _Console_. + + ![The Console tab \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/console.png) + +6. Open the context menu and select _Save as…_. + + ![Save as \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save.png) + +### Firefox + +1. Open AdGuard Browser Extension and, if possible, repeat the actions that led to the error. Note the exact time when the error occurred. + +2. Navigate to `about:addons`. + +3. Click _Debug Add-ons_. + + ![Debug Add-ons \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/add-ons.png) + +4. Click _Inspect_. + + ![Inspect \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/inspect.png) + +5. Go to the tab _Console_. + + ![Console \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/ff_console.png) + +6. Click _Save all Messages to File_. + + ![Save \*border](https://cdn.adguardvpn.com/content/kb/vpn/browser_extension/save-to-file.png) + +## Sending logs + +Now that you have collected the logs, please follow these steps to submit them to our development team: + +1. Report the bug on [GitHub](https://github.com/AdguardTeam/AdguardBrowserExtension/issues/new/choose). +2. Send your archive with logs and playback time to `devteam@adguard.com` and add a link to your GitHub issue. You can also upload the archive to Google Drive and add the link to it instead of attaching the file. diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md index 5378d723540..d4e3e27e7a0 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-android/overview.md @@ -388,7 +388,7 @@ Userscripts are mini-programs written in JavaScript that extend the functionalit ##### AdGuard Extra -AdGuard Extra is a custom userscript that prevents websites from bypassing ad blockers and re-inserting blocked ads. +AdGuard Extra is a custom userscript that blocks complex ads and mechanisms that reinject ads to websites. ### License @@ -421,7 +421,7 @@ GitHub is an alternative way to report bugs and suggest new features. [Instructi ::: -### Free vs full version +## Free vs full version @@ -441,13 +441,13 @@ AdGuard uses its own ad-free media player to block ads in YouTube videos. To ope - *Custom filters and user rules* allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [Back to filters](#filters) -- *Userscripts* allow you to use AdGuard Extra to bypass ad blocker bans and install other userscripts to extend your browser's functionality. [Back to userscripts](#userscripts) +- *Userscripts* allow you to extend the functionality of the browser and use [AdGuard Extra](#adguard-extra) that prevents ad reinjection. [Back to userscripts](#userscripts) You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate the license](/general/license/activation/#activating-adguard-for-android) -### Rooted vs non-rooted devices +## Rooted vs non-rooted devices -Due to additional security measures of Android apps, some AdGuard features are only available on rooted devices. Here's the list of them: +Due to security measures of the Android OS, some AdGuard features are only available on rooted devices. Here's the list of them: - **HTTPS filtering in most apps** requires [installing a CA certificate into the system store](#security-certificates), as most apps do not trust certificates in the user store. Installing a certificate into the system store is only possible on rooted devices - The [**Automatic proxy** routing mode](#routing-mode) requires root access due to Android's limitations on system-wide traffic filtering diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md index 33a4a727a69..07f163aa22f 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-safari/installation.md @@ -21,17 +21,39 @@ AdGuard for Safari is a free app presented on the App Store. To install it on yo 1. To set up AdGuard for Safari, enable the AdGuard extensions in the Safari settings. In a notification, click *Fix it*. In an opened window, check the boxes next to AdGuard extensions. -![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) + ![Notification: Some extensions are disabled](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-notification.png) -:::note + :::note + + 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. -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. ::: -![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + ![Extensions checked](https://cdn.adtidy.org/content/Kb/ad_blocker/safari/adguard-for-safari-extensions-checked.png) + +1. To make AdGuard take effects on websites, the *Content Blockers* setting must be enabled. You can either enable for all websites or select the ones you want. + + :::note + + This step is needed for iOS 9.0 and later, macOS 10.11 with Safari 10, and macOS 10.12 and later. + + +::: + +On macOS, click *Preference* → *Websites* → *Content Blockers*. If you want to enable AdGuard on every website, turn *When visiting other websites* to *On*. + + ![Mac Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/Fmc9U.png) + + + +On iOS, go *Settings* → *Safari* → *Content Blockers*, and set the option to *Yes*. + + ![iOS Safari Content Blocker Setting](https://i0.imgs.ovh/2023/10/26/FmgM0.jpeg) + + -After you complete steps 1-3, AdGuard for Safari will start functioning. You can now configure its settings. +After you complete steps 1-4, AdGuard for Safari will start functioning. You can now configure its settings. ## How to uninstall AdGuard for Safari {#uninstall} diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 0d89b7fdd76..aa3e499d36d 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -17,12 +17,14 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) - **URL Tracking filter** enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) - **Social media filter** removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) -- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): +- **Annoyances filter** blocks irritating elements on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt). Includes the following AdGuard filters (all of them can be enabled separately from the Annoyances filter): + - **Cookie Notices** blocks cookie notices on web pages. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_18_Annoyances_Cookies/filter.txt) - **Popups** blocks all kinds of pop-ups that are not necessary for websites' operation. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_19_Annoyances_Popups/filter.txt) - **Mobile App Banners** blocks banners that promote mobile apps of websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_20_Annoyances_MobileApp/filter.txt) - **Widgets** blocks third-party widgets: online assistants, live support chats, etc. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_22_Annoyances_Widgets/filter.txt) - **Other Annoyances** blocks elements that do not fall under the popular categories of annoyances. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_21_Annoyances_Other/filter.txt) + - **Filter unblocking search ads and self-promotions** unblocks ads that may be useful to users. Learn more about this filter on [this page](../search-ads). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) - **Russian filter** removes ads from websites in Russian. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_1_Russian/filter.txt) - **German filter** removes ads from websites in German. Originally based on the [EasyList Germany](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_6_German/filter.txt) @@ -32,6 +34,7 @@ This article is about the filters we create to use in AdGuard and other ad-block - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) +- **Ukrainian filter** removes ads from websites in Ukrainian. Learn more about this filter on [this page](https://adguard.com/en/blog/ukrainian-filter.html). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_23_Ukrainian/filter.txt) - **Experimental filter** serves to test some new filtering rules that can potentially cause conflicts and mess with websites' work. In case these rules perform without any issues, they get added to main filters. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_5_Experimental/filter.txt) - **Mobile ads filter** blocks ads on mobile devices. Contains all known mobile ad networks. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_11_Mobile/filter.txt) - **DNS filter** — composed of several other filters (AdGuard Base filter, Social media filter, Spyware filter, Mobile ads filter, EasyList and EasyPrivacy) and simplified specifically to be better compatible with DNS-level ad blocking. This filter is used by [AdGuard DNS](https://adguard-dns.io/kb) servers to block ads and tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt) diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 953433622f9..864ef2ec6f7 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -153,6 +153,12 @@ Browser detects a blocked request as completed with an error. ::: +:::note Rule length + +Rules shorter than 4 characters are considered incorrect and will be ignored. + +::: + ### Basic rule syntax {#basic-rules-syntax} ```text @@ -201,68 +207,6 @@ AdGuard Safari and AdGuard for iOS do not fully support regular expressions beca ::: -### Restrictions on rules application {#rules-restrictions} - -Rules that match an arbitrarily large number of URLs are considered incorrect and will be ignored. This can happen if the rule doesn't contain a mask, or if the mask matches any URL with a certain protocol. - -This rule will be ignored: - -```text -|http://$replace=/a/b/ -``` - -This limitation can be circumvented by using a `/.*/` regular expression inside the mask. - -This rule will not be ignored: - -```text -/.*/$replace=/a/b/ -``` - -**Exceptions** - -This rule validation is not applied in the following cases: - -1. The rule contains [`$domain`](#domain-modifier) modifier that points to a specific domain list - - These rules will not be ignored: - - ```text - $domain=example.com,script - $domain=example.*,script - ``` - - This rule will be ignored because of domain negation, which causes too wide of a rule application scope: - - ```text - $domain=~example.com,script - ``` - -1. The rule contains [`$app`](#app-modifier) modifier that points to a specific app list - - This rule will not be ignored: - - ```text - $app=curl,document - ``` - - This rule will be ignored because of app negation, which causes too wide of a rule application scope: - - ```text - $app=~curl,document - ``` - -1. The rule contains one or more modifiers from among [`$cookie`](#cookie-modifier), [`$removeparam`](#removeparam-modifier), [`$removeheader`](#removeheader-modifier), [`$stealth`](#stealth-modifier) - - These rules will not be ignored: - - ```text - $removeparam=cx_recsWidget - $cookie=ibbid - $removeheader=location - $stealth - ``` - ### Wildcard support for TLD (top-level domains) {#wildcard-for-tld} Wildcard characters are supported for TLDs of the domains in patterns of [cosmetic](#cosmetic-rules), [HTML filtering](#html-filtering-rules) and [JavaScript](#javascript-rules) rules. @@ -2443,7 +2387,7 @@ Element hiding rules are used to hide the elements of web pages. It is similar t Element hiding rules may operate differently [depending on the platform](#cosmetic-rules-priority). -#### Syntax {#non-basic-rules-modifiers-syntax} +#### Syntax ```text rule = [domains] "##" selector @@ -2519,7 +2463,7 @@ domains = [domain0, domain1[, ...[, domainN]]] ``` - **`selector`** — [CSS selector](https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors), that defines the elements we want to apply the style to. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`style`** — CSS style, that we want to apply to selected elements. **Examples** @@ -3250,7 +3194,7 @@ This pseudo-class was basically a shortcut for `:not(:has())`. It was supported The way **element hiding** and **CSS rules** are applied is platform-specific. -**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#elemhide-syntax) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](#cosmetic-elemhide-rules) and [CSS rules](#cosmetic-css-rules) cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering. **In AdGuard Browser Extension**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. @@ -3279,7 +3223,7 @@ pseudoClasses = pseudoClass *pseudoClass ``` - **`tagName`** — name of the element in lower case, for example, `div` or `script`. -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rule syntax](#cosmetic-elemhide-rules). - **`attributes`** — a list of attributes that limit the selection of elements. `name` — attribute name, `value` — substring, that is contained in attribute value. - **`pseudoName`** — the name of a pseudo-class. - **`pseudoArgs`** — the arguments of a function-style pseudo-class. @@ -3483,7 +3427,7 @@ We **strongly recommend** using [scriptlets](#scriptlets) instead of JavaScript rule = [domains] "#%#" script ``` -- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#elemhide-syntax). +- **`domains`** — domain restriction for the rule. Same principles as in [element hiding rules](#cosmetic-elemhide-rules). - **`script`** — arbitrary javascript code **in one string**. **Examples** @@ -3593,7 +3537,7 @@ More information about trusted scriptlets can be found [on GitHub](https://githu Each rule can be modified using the modifiers described in the following paragraphs. -**Syntax** +**Syntax** {#non-basic-rules-modifiers-syntax} ```text rule = "[$" modifiers "]" [rule text] @@ -3826,6 +3770,7 @@ where: - `adguard_ext_opera` — AdGuard Browser Extension for Opera - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] + - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, and AdGuard for Android - `!#else` — start of the block when conditions are false - `rules_list`, `true_conditions_rules_list`, `false_conditions_rules_list` — lists of rules - `!#endif` — end of the block diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/license/activation.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/license/activation.md index dc5fc8feca4..8a6d2e397dd 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/license/activation.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/license/activation.md @@ -65,10 +65,6 @@ Alternatively, you can use a [license key](../what-is#license-key) to activate t ![Activating a license *mobile_border](https://cdn.adtidy.org/blog/new/sbxttactivate-license.png) - Alternatively, you can tap *I have a license* on the following screen and activate your license with one of the above-mentioned methods. - - ![I have a license *mobile](https://cdn.adtidy.org/blog/new/fq28vi-have-a-license.png) - ### Activating AdGuard for iOS 1. Tap *Settings*, then select *License*.