Skip to content

Commit

Permalink
automatically update translations
Browse files Browse the repository at this point in the history
  • Loading branch information
vyanovsky authored and github-actions[bot] committed Nov 27, 2024
1 parent 6388ec2 commit cd586f0
Show file tree
Hide file tree
Showing 313 changed files with 2,556 additions and 1,566 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -13,25 +13,25 @@ This article is about AdGuard Browser Extension, which safeguards only your brow

Here are outlined the main features and settings available in the AdGuard Browser Extension.

[Features](/adguard-browser-extension/features/features.md)
[Features](/adguard-browser-extension/features)

## Availability

In this article, you'll learn about the supported browsers and platforms where the extension can be installed.

[Availability](/adguard-browser-extension/availability.md)
[Availability](/adguard-browser-extension/availability)

## Installation

The article explains how to install the AdGuard Browser Extension on various supported browsers.

[Installation](/adguard-browser-extension/installation.md)
[Installation](/adguard-browser-extension/installation)

## Compatibility with the standalone app

The article explains the compatibility of the AdGuard Browser Extension with the AdGuard desktop apps.

[Compatibility with the standalone app](adguard-browser-extension/compatibility.md)
[Compatibility with the standalone app](/adguard-browser-extension/compatibility)

## AdGuard Browser Extension for Chrome MV3

Expand All @@ -43,16 +43,16 @@ This article discusses the AdGuard browser extension for Chrome, which is compat

The article describes how the AdGuard Browser Extension manages protected pages, restricting ad blocking on certain sensitive websites to ensure proper functionality.

[Browser-protected pages](/adguard-browser-extension/protected-pages.md)
[Browser-protected pages](/adguard-browser-extension/protected-pages)

## Solving problems

This section includes guides addressing known issues and possible solutions.

[Solving problems](/adguard-browser-extension/solving-problems/solving-problems.md)
[Solving problems](/adguard-browser-extension/solving-problems)

## Comparison to standalone apps

The article highlights the differences in functionality, coverage, and features between the AdGuard extensions and desktop apps.

[Comparison to standalone apps](/adguard-browser-extension/comparison-standalone.md)
[Comparison to standalone apps](/adguard-browser-extension/comparison-standalone)
Original file line number Diff line number Diff line change
Expand Up @@ -23,4 +23,4 @@ We have a standalone extension for Safari. Since the release of [Safari 13](http

:::

**Do not forget that the functionality of each extension is strictly limited by the browser’s capabilities.** So if you want to get full-fledged protection, consider installing a standalone program for your computer. There's [a reason why](adguard-browser-extension/comparison-standalone).
**Do not forget that the functionality of each extension is strictly limited by the browser’s capabilities.** So if you want to get full-fledged protection, consider installing a standalone program for your computer. There's [a reason why](/adguard-browser-extension/comparison-standalone).
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,12 @@ This article is about AdGuard for Mac, a multifunctional ad blocker that protect

:::

During the installation of AdGuard on macOS High Sierra (or later), you may see this message: "System Extension Blocked". This is a new security mechanism that appeared in High Sierra, it requires you to explicitly allow the installation of a third-party system extension. To complete the installation of AdGuard you have to manually allow loading the extension in *System Preferences**Security & Privacy**General*.
During the installation of AdGuard on macOS High Sierra (or later), you may receive the message "System Extension Blocked". This is a new security mechanism introduced in High Sierra that requires you to explicitly allow the installation of a third-party system extension.

To complete the installation of AdGuard you have to manually allow loading the extension by clicking the "Allow" button in *System Preferences**Security & Privacy**General*.

On macOS Sequoia, you can do it in *System Preferences**Security & Privacy**General**Login Items & Extensions*. Once there, click the "i" icon next to *Network Extensions* and toggle the AdGuard option.

![Allow extension installation in settings](https://cdn.adtidy.org/public/Adguard/kb/PicturesEN/highsierra.png)

Click the "Allow" button, and after that you will be able to proceed with the installation as normal.
After that you will be able to proceed with the installation as usual.
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ User rules and allowlist rules are included into every extension.

## AdGuard for Safari

*AdGuard for Safari activates the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection for a specific website or block ads manually. It also contains advanced rules that aren't converted to the format supported by Safari. These include [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [Extended CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets), which allow AdGuard to block complex ads, such as those on YouTube.
*AdGuard for Safari* activates the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection for a specific website or block ads manually. It also contains advanced rules that aren't converted to the format supported by Safari. These include [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [extended CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets), which allow AdGuard to block complex ads, such as those on YouTube.

## How to manage Safari extensions

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ And even when a rule finally gets added to a filter, it doesn't mean that it sta

AdGuard users [have access to a special web reporting tool](https://reports.adguard.com/new_issue.html). Thanks to user complaints, filter developers can focus on correcting their filter lists and not on scouring the Internet for new and old unblocked ads.

Filters can do more than just block ads. There are filters that block tracking, social media widgets, and annoyances such as cookie notices. Different users may choose different combinations of filters to match their personal preferences. There are websites like [filterlists.com](https://filterlists.com/) that are dedicated to filter lists and have huge databases.
Filters can do more than just block ads. There are filters that block tracking, social media widgets, and annoyances, such as cookie notices. Different users may choose different combinations of filters to match their personal preferences. There are websites like [filterlists.com](https://filterlists.com/) that are dedicated to filter lists and have huge databases.

We develop and maintain [our own set of filter lists](../adguard-filters) that can be used with AdGuard or other ad blockers.

Expand Down Expand Up @@ -62,3 +62,40 @@ These rules are quite complicated and require the ad blocker to be granted certa
There are other types of filtering rules, but they require more advanced technical knowledge to understand how they work. If you are interested, [check out our comprehensive guide on filtering rules in the linked article](../create-own-filters).

:::

## Types of request handling in AdGuard

AdGuard handles requests according to filters, user rules and settings enabled by the user. As a result, a request can be blocked, modified, allowed or, when nothing is done to it, just processed.

Detailed information on how each request of yours has been handled by AdGuard can be found in the *Filtering log* (AdGuard for Windows, AdGuard for Mac, AdGuard Browser Extension) or *Recent activity* (AdGuard for iOS, AdGuard for Android).

Regarding AdGuard filters, you can also check [our filter policy](../filter-policy), which describes in detail what and why each of our filters blocks.

### Examples of blocked requests

AdGuard DNS filter blocks requests to ad domains, such as `ad.doubleclick.net`.

AdGuard Tracking Protection filter blocks tracking requests, such as `youtube.com/youtubei/log_event?`.

### Examples of allowed requests

AdGuard Base filter allows non-ad requests, such as `www.google.com/complete/search?q=`.

Filter unblocking search ads and self-promotion allows requests to search ad-related domains, such as `www.google.com/aclk?`.

Requests to websites that are added by the user to *Allowlist* are allowed.

### Examples of modified requests

Tracking protection feature with protection level set to *High* enables AdGuard URL Tracking filter which modifies requests by removing tracking parameters from them:

`https://www.rentio.jp/products/ax-n1b?click_from=top_newitems``https://www.rentio.jp/products/ax-n1b`

`https://www.baseballchannel.jp/npb/183688/?ref=ise``https://www.baseballchannel.jp/npb/183688/`

`https://www.gog.com/game/spec_ops_the_line?pp=2863d7ae605104eeef364e3f164d3404e20f680c&gad_source=1``https://www.gog.com/game/spec_ops_the_line`

Please note that *modified* events you see in the Filtering log or Recent activity refer not only to the cases when a request is modified, but also when:

- something on the page is changed (usually by cosmetic rules)
- the response is modified
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Each time you visit a website, your local client exchanges information with our

AdGuard provides the best possible protection by inspecting both the pages and all objects loaded on them. AdGuard checks URLs and domain names using hash prefixes, not the full URLs, so our servers retain no information about the websites you visit and your personal information is completely safe. Our servers respond to the app’s query with a list of all possible addresses that match the hash prefix. When a potential threat is detected based on hash matches, access to that website is immediately blocked.

![DNS warning](https://cdn.adtidy.org/content/kb/ad_blocker/general/bs_diana.png)
![AdGuard warning](https://cdn.adtidy.org/content/kb/ad_blocker/general/dangerous_website_blocked.png)

### In browser extensions

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -55,9 +55,9 @@ This script removes Google's tracking feature from the links in Google search re

Its source code is [available on GitHub](https://github.com/Rob--W/dont-track-me-google). This userscript can be downloaded from [GreasyFork](https://greasyfork.org/en/scripts/428243-don-t-track-me-google) and installed in any AdGuard CoreLibs-based app.

#### microShield
#### tinyShield

A userscript for people visiting Korean websites and some international websites. The microShield userscript blocks Ad-Shield ads and anti-adblocks. Its original source code is available at [asdefuser](https://github.com/seia-soto/userscripts/tree/master/sources/asdefuser) and [AdShield Defuser](https://github.com/seia-soto/adshield-defuser). This userscript can be installed in AdGuard CoreLibs-based apps, Violentmonkey, Tampermonkey, and [quoid/userscripts](https://github.com/quoid/userscripts). Learn more about microShield and how to install it on [GitHub](https://github.com/List-KR/microShield).
A userscript for people visiting Korean websites and some international websites. The tinyShield userscript blocks Ad-Shield ads and anti-adblocks. This userscript can be installed in AdGuard CoreLibs-based apps, Violentmonkey, Tampermonkey, and [quoid/userscripts](https://github.com/quoid/userscripts). Learn more about tinyShield and how to install it on [GitHub](https://github.com/List-KR/tinyShield).

### Where can you get more userscripts?{#more-userscripts}

Expand Down Expand Up @@ -89,15 +89,7 @@ If you like the idea of customizing your browser with userscripts and have quest

#### Request license

If you are developing your own custom script and want to test how it works with AdGuard, you can request a beta license key for the app.

To get it, please send an email to [email protected] with the following information:

**Subject:** Userscript author license request

**Body:** Please tell us about the userscripts you are working on.

Here is a [mailto link](mailto:[email protected]?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK).
If you are developing your own userscript and want to test how it works with AdGuard, you can request a license by filling in [the form](https://surveys.adguard.com/en/for_developers_request/form.html).

#### Compatibility

Expand Down Expand Up @@ -213,7 +205,7 @@ GM_log

## Userstyles

Userstyles allow users to customize their online experience. Whether you’re looking to change the appearance of a website or automate repetitive tasks, styles offer a world of possibilities.
Userstyles allow users to change the appearance of popular websites.

AdGuard has the option to upload or create your own userstyles. This is an advanced feature, so you will need some knowledge of HTML and CSS.

Expand All @@ -231,15 +223,15 @@ You can download userstyles from various websites. One of the most popular users

1. Follow the link above and choose the userstyle you like

2. Right-click the _Install_ button and choose _Copy Link Address_
2. Click _Copy_ next to the userstyle address

3. Open AdGuard settings → _Extensions_

4. Press the [+] button and paste the userstyle link

5. Done!

If you’re familiar with CSS rules, you can also create the userstyles yourself.
If you’re familiar with CSS rules, you can also create userstyles yourself.

:::note

Expand Down
2 changes: 1 addition & 1 deletion i18n/be/docusaurus-plugin-content-docs/current/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ AdGuard is one of the leaders on the market of ad-blocking software with 15+ yea

But we also develop and maintain free browser extensions for all popular browsers:

- [AdGuard Browser Extension](/adguard-browser-extension/features/filters)
- [AdGuard Browser Extension](/adguard-browser-extension/availability)
- [AdGuard for Safari](/adguard-for-safari/features/general)

## Not just ad blocking
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,25 +13,25 @@ This article is about AdGuard Browser Extension, which safeguards only your brow

Here are outlined the main features and settings available in the AdGuard Browser Extension.

[Features](/adguard-browser-extension/features/features.md)
[Features](/adguard-browser-extension/features)

## Availability

In this article, you'll learn about the supported browsers and platforms where the extension can be installed.

[Availability](/adguard-browser-extension/availability.md)
[Availability](/adguard-browser-extension/availability)

## Installation

The article explains how to install the AdGuard Browser Extension on various supported browsers.

[Installation](/adguard-browser-extension/installation.md)
[Installation](/adguard-browser-extension/installation)

## Compatibility with the standalone app

The article explains the compatibility of the AdGuard Browser Extension with the AdGuard desktop apps.

[Compatibility with the standalone app](adguard-browser-extension/compatibility.md)
[Compatibility with the standalone app](/adguard-browser-extension/compatibility)

## AdGuard Browser Extension for Chrome MV3

Expand All @@ -43,16 +43,16 @@ This article discusses the AdGuard browser extension for Chrome, which is compat

The article describes how the AdGuard Browser Extension manages protected pages, restricting ad blocking on certain sensitive websites to ensure proper functionality.

[Browser-protected pages](/adguard-browser-extension/protected-pages.md)
[Browser-protected pages](/adguard-browser-extension/protected-pages)

## Solving problems

This section includes guides addressing known issues and possible solutions.

[Solving problems](/adguard-browser-extension/solving-problems/solving-problems.md)
[Solving problems](/adguard-browser-extension/solving-problems)

## Comparison to standalone apps

The article highlights the differences in functionality, coverage, and features between the AdGuard extensions and desktop apps.

[Comparison to standalone apps](/adguard-browser-extension/comparison-standalone.md)
[Comparison to standalone apps](/adguard-browser-extension/comparison-standalone)
Original file line number Diff line number Diff line change
Expand Up @@ -23,4 +23,4 @@ We have a standalone extension for Safari. Since the release of [Safari 13](http

:::

**Do not forget that the functionality of each extension is strictly limited by the browser’s capabilities.** So if you want to get full-fledged protection, consider installing a standalone program for your computer. There's [a reason why](adguard-browser-extension/comparison-standalone).
**Do not forget that the functionality of each extension is strictly limited by the browser’s capabilities.** So if you want to get full-fledged protection, consider installing a standalone program for your computer. There's [a reason why](/adguard-browser-extension/comparison-standalone).
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,12 @@ This article is about AdGuard for Mac, a multifunctional ad blocker that protect

:::

During the installation of AdGuard on macOS High Sierra (or later), you may see this message: "System Extension Blocked". This is a new security mechanism that appeared in High Sierra, it requires you to explicitly allow the installation of a third-party system extension. To complete the installation of AdGuard you have to manually allow loading the extension in *System Preferences**Security & Privacy**General*.
During the installation of AdGuard on macOS High Sierra (or later), you may receive the message "System Extension Blocked". This is a new security mechanism introduced in High Sierra that requires you to explicitly allow the installation of a third-party system extension.

To complete the installation of AdGuard you have to manually allow loading the extension by clicking the "Allow" button in *System Preferences**Security & Privacy**General*.

On macOS Sequoia, you can do it in *System Preferences**Security & Privacy**General**Login Items & Extensions*. Once there, click the "i" icon next to *Network Extensions* and toggle the AdGuard option.

![Allow extension installation in settings](https://cdn.adtidy.org/public/Adguard/kb/PicturesEN/highsierra.png)

Click the "Allow" button, and after that you will be able to proceed with the installation as normal.
After that you will be able to proceed with the installation as usual.
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ User rules and allowlist rules are included into every extension.

## AdGuard for Safari

*AdGuard for Safari activates the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection for a specific website or block ads manually. It also contains advanced rules that aren't converted to the format supported by Safari. These include [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [Extended CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets), which allow AdGuard to block complex ads, such as those on YouTube.
*AdGuard for Safari* activates the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection for a specific website or block ads manually. It also contains advanced rules that aren't converted to the format supported by Safari. These include [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [extended CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets), which allow AdGuard to block complex ads, such as those on YouTube.

## How to manage Safari extensions

Expand Down
Loading

0 comments on commit cd586f0

Please sign in to comment.