diff --git a/03.macos/01.overview/docs.en.md b/03.macos/01.features-overview/01.features-overview/docs.en.md similarity index 85% rename from 03.macos/01.overview/docs.en.md rename to 03.macos/01.features-overview/01.features-overview/docs.en.md index f3e0c810..3d03fa18 100644 --- a/03.macos/01.overview/docs.en.md +++ b/03.macos/01.features-overview/01.features-overview/docs.en.md @@ -1,8 +1,9 @@ --- -title: Feature review +title: Features overview taxonomy: category: - docs +visible: true --- [Home panel](#home-panel) @@ -11,8 +12,8 @@ taxonomy: [User rules](#user-rules) [Stealth Mode](#stealth-mode) [Browsing Security](#browsing-security) -[Extensions](#extensions) [Browser Assistant](#browser-assistant) +[Extensions](#extensions) [Network Filtering](#network-filtering) [Others](#others) - [License Management](#license-management) @@ -64,10 +65,10 @@ Some filter lists (AdGuard’s Base filter, Annoyances filter, EasyList etc) are Aside from the more general and universally applicable filters (like Base filter), AdGuard provides an extensive quantity of filters for every occasion. There are filters aimed solely at tracking (like Tracking Protection filter), language-specific ad filters that block content in a selected language, Social media filter (bye-bye, “Like” and “Share” buttons), Annoyances filter for cookie warnings, in-page pop-ups and others of the same ilk, and even a filter that unblocks some ads instead of blocking them — Filter for search ads and self-promotions. -AdGuard filters are automatically updated. Our developers create them all based on user feedback received. You can always help other AdGuard users (and yourself, in perspective) by sending us reports right from the app's Assistant (it's really handy, we'll tell you more about the Assistant further on), or from the [website](https://agrd.io/report). If you wish to know more about filters, here is [some info](https://kb.adguard.com/en/general/adguard-ad-filters). +AdGuard filters are automatically updated. Our developers create them all based on user feedback received. You can always help other AdGuard users (and yourself, in perspective) by sending us reports right from the app's Assistant (it's really handy, we'll tell you more about the Assistant further on), or from the [website](https://agrd.io/report). If you wish to know more about AdGuard filters, here is [some info](https://kb.adguard.com/en/general/adguard-ad-filters). -##User rules +## User rules @@ -87,9 +88,9 @@ Stealth Mode contains a wide range of options, which ensure its flexible configu -Next we have the Security panel, where a module also known as Browsing Security is located. What it does is protection from malware and phishing websites. In essence, it is designed not to let you install malware and protect you from web frauds such as the infamous phishing. +Next we have the Security panel, where a module also known as Browsing Security is located. What it does is protection from malware and phishing websites. In essence, it is designed to warn you about malware and to protect you from web frauds such as the infamous phishing. -> Please note that AdGuard is not an antivirus, but an entirely different program. It will show you a warning if you are about to go onto an infected domain, but cannot otherwise stop you from downloading anything suspicious. +> Please note that AdGuard is not an antivirus, but an entirely different program. It will show you a warning if you are about to go onto an infected domain, but it cannot stop you from downloading anything suspicious or help you deal with already existing viruses. Phishing is a very common web fraud aimed at stealing personal data (passwords, bank account details, etc.). It is carried out using fake web pages mimicking popular websites or real services, such as web stores or social networks. Many phishing websites have URLs that only differ from the real ones in just a few symbols to put you off your guard. If a user enters their details on such a website, they’ll definitely end up in the wrong hands. @@ -99,6 +100,17 @@ Some web pages are not malicious themselves, but they may contain elements built If you wish to help us in perfecting this module, you can check the lower box on the panel near the “Help us with Browsing Security filters development” phrase. This will enable your computer to send us pertinent info on fraudulent websites you might stumble upon while surfing the web — and our developers will make sure they end up locked at the bottom of your ban list. + +## Browser Assistant + + + +AdGuard Browser Assistant’s primary function is to manage filtering directly from the browser. It has existed for quite a long time, and its form and content have changed. More precisely, it used to be a mere userscript incorporated into AdGuard for Mac app and became a full-fledged browser extension. Now it definitely yields [more benefits](https://kb.adguard.com/en/macos/features/browser-assistant). + + + +If you use AdGuard for MacOS, the Browser Assistant is included there and you don't need to download it. If you use another browser, you can download the Assistant for it [at this link](https://adguard.com/en/adguard-assistant/overview.html#safari). Or, you can install the Browser Assistant for your default browser via app settings or during the onboarding process. + ## Extensions @@ -106,8 +118,8 @@ If you wish to help us in perfecting this module, you can check the lower box on Extensions are small programs that do exactly what their name implies — they extend functionality. And AdGuard uses several extensions of its own, also called userscripts, to broaden its functions range: -**1. AdGuard Assistant** -The name of this extension is deliberate: it assists the user in changing basic AdGuard settings within the browser, without the need to open the app itself. AdGuard Assistant works with all macOS compatible browsers. Thanks to this little tool you can do several things without having to leave the browser: add a certain webpage to the “do not block” list, choose and block an especially annoying element of the page, report the website if it still manages to get ads through to you. +**1. AdGuard Assistant** (legacy version) +This extension assists the user in changing basic AdGuard settings within the browser, without the need to open the app itself. Like Browser Assistant, legacy Assistant works with all macOS compatible browsers. Thanks to this little tool you can do several things without having to leave the browser: add a certain webpage to the “do not block” list, choose and block an especially annoying element on the page, report the website if it still manages to get ads through to you. *But note that this version is legacy, we recommend using the new one — Browser Assistant.* **2. AdGuard Extra** This extension is used to solve the more complicated ad blocking cases you might encounter. We would recommend you to always keep it switched on, unless you have a serious reason not to. **3. AdGuard Popup Blocker** @@ -115,23 +127,6 @@ Prevents all these annoying popup windows from opening when you view webpages. B One of the important features of AdGuard for Mac is that the application can work as a cross-browser userscript manager. You can easily add any scripts you like and manage existing ones without having to switch browsers every time. - -## Browser Assistant - - - -Browser Assistant (not to be confused with the legacy Assistant that existed until v2.4 of AdGuard for Mac) is a native browser extension. It simultaneously takes over the roles of the old Assistant and of the Integration mode. [In Integration mode](https://kb.adguard.com/en/browser-extensions/integration-mode), workload was distributed between the browser extension and the desktop program, but the Browser Assistant can handle it better alone. - - - -With the Browser Assistant, the main AdGuard app can be managed from the BA's settings: launch it if it doesn't work, enable/disable protection in a single click, and quickly access settings or filtering log directly from the browser. Another useful feature is displaying the real certificate of a filtered page. - -When desktop AdGuard program and browser extension were used in Integration mode, they could hamper each other’s work. On some websites this integration glitched and the filtering was performed by the less powerful browser extension. With the Browser Assistant, there is no more such risk of an incompatibility. - - - -If you use AdGuard for MacOS, the Browser Assistant is included there and you don't need to download it. If you use another browser, you can download the Assistant for it [at this link](https://adguard.com/en/adguard-assistant/overview.html#safari). Or, you can install the Browser Assistant for your default browser via app settings or during the onboarding process. - ## Network Filtering @@ -171,4 +166,4 @@ It is possible to attach a diagnostic report to your message, you only need to c ### Updates check -Last but not least. You can check for Filter updates and Program updates by simply clicking on the corresponding menu options in the dropdown menu (tap on the gear icon, and you'll see it). \ No newline at end of file +Last but not least. You can check for filter and program updates by simply clicking on the corresponding menu options in the dropdown menu (tap on the gear icon, and you'll see it). \ No newline at end of file diff --git a/03.macos/01.overview/docs.ru.md b/03.macos/01.features-overview/01.features-overview/docs.ru.md similarity index 99% rename from 03.macos/01.overview/docs.ru.md rename to 03.macos/01.features-overview/01.features-overview/docs.ru.md index bfc3361f..ce3814a9 100644 --- a/03.macos/01.overview/docs.ru.md +++ b/03.macos/01.features-overview/01.features-overview/docs.ru.md @@ -3,6 +3,7 @@ title: Обзор функций taxonomy: category: - docs +visible: true --- [Главный экран](##home-panel) @@ -66,7 +67,7 @@ AdGuard для Mac — это независимый блокировщик ре * фильтры раздражителей, скрывающие предупреждения о cookies, всплывающие окна и другие подобные элементы; * и даже фильтр, который разблокирует некоторые объявления, а не блокирует их — фильтр для поисковой рекламы и саморекламы. -Фильтры автоматически обновляются с серверов AdGuard. Наши разработчики создают их на основе полученных отзывов пользователей. Вы всегда можете помочь другим пользователям AdGuard и в конечном счёте себе тоже, отправив отчёт прямо из приложения Помощника (это очень удобно, позже мы расскажем о нём подробнее) или с [сайта](https://agrd.io/report). Если вы хотите разобраться в фильтрах, вот [основная информация](https://kb.adguard.com/ru/general/adguard-ad-filters), которую мы рекомендуем изучить. +Фильтры автоматически обновляются с серверов AdGuard. Наши разработчики создают их на основе полученных отзывов пользователей. Вы всегда можете помочь другим пользователям AdGuard и в конечном счёте себе тоже, отправив отчёт прямо из приложения Помощника (это очень удобно, позже мы расскажем о нём подробнее) или с [сайта](https://agrd.io/report). Если вы хотите разобраться в фильтрах AdGuard, вот [основная информация](https://kb.adguard.com/ru/general/adguard-ad-filters), которую мы рекомендуем изучить. ## Пользовательские правила @@ -89,7 +90,7 @@ AdGuard для Mac — это независимый блокировщик ре Следующим идёт окно «Безопасность». Здесь можно включить защиту от фишинга и вредоносных программ. -> Но имейте в виду, что AdGuard – это не антивирус, а совершенно другая программа. Он предупредит вас, если вы попадёте на заражённый домен, но не остановит вас от скачивания чего-то подозрительного. +> Но имейте в виду, что AdGuard – это не антивирус, а совершенно другая программа. Он предупредит вас, если вы попадёте на заражённый домен, но не остановит вас от скачивания чего-то подозрительного и не . Фишинг — это очень распространённый вид веб-мошенничества, направленный на кражу персональных данных (паролей, реквизитов банковских счетов и т. д.). В нём используются поддельные веб-страницы, имитирующие популярные вебсайты или сервисы, как, например, интернет-магазины или социальные сети. У многих фишинговых сайтов есть URL-адреса, которые отличаются от реальных всего несколькими символами, чтобы сбить вас с толку. Если пользователь введёт свои данные на таком сайте, они кажутся в чужих руках. diff --git a/03.macos/01.features-overview/02.browser-assistant/docs.en.md b/03.macos/01.features-overview/02.browser-assistant/docs.en.md new file mode 100644 index 00000000..a6d148be --- /dev/null +++ b/03.macos/01.features-overview/02.browser-assistant/docs.en.md @@ -0,0 +1,52 @@ +--- +title: 'AdGuard Browser Assistant' +taxonomy: + category: + - docs +--- + +AdGuard Assistant’s primary function is to manage filtering directly from the browser. It has existed for quite a long time, and its form and content have changed. More precisely, it used to be a mere userscript incorporated into AdGuard for Mac app and became a full-fledged browser extension. Now it definitely yields more benefits. + +
+
+ +
+
+ +
+
+ +## Benefits +### Independence +AdGuard Browser Assistant is a browser extension, it is installed in a browser, so there is no need to wait for the userscript to be injected into the filtered web page, as it was with the preceding one. In other words, it is more autonomous from the main AdGuard app. Still, Browser Assistant needs the installed AdGuard for Mac, because there is no point in using the extension without the app. +### Compatibility with the main app +If you got into the habit of using our previous AdGuard ad blocker extension [in Integration mode](https://kb.adguard.com/en/browser-extensions/integration-mode), you may like the solution that we have developed for the new Browser Assistant. + +Background information: +> In previous versions of the AdGuard Browser Extension (before v3.5), if you had it installed along with a desktop AdGuard for Mac, the extension took over the functions of Assistant, stopped filtering itself and relied on the app to do this. + +> The extension and the app worked in conjunction but sometimes the integration would fail. Some websites would stop being protected by the desktop program and be backed up only by the less powerful extension. + +When using the Browser Assistant, all these problems don’t matter as there can be no conflicts in essence. The role of the Browser Assistant is well-defined and it can’t hinder the functioning of the main app, so there is no need to worry. + +### Smart onboarding +When AdGuard for Mac is installed for the first time, the thing a user encounters in the first place is the onboarding. During this process the user quickly learns about AdGuard's settings and can customize filtering to their liking. At one stage AdGuard will determine the user's default browser and provide them with a download link for the new Assistant. + + + +> On rare occasions, a browser may prove incompatible with the Browser Assistant, and the user will be offered to install the legacy version instead. + +## Separate tab in settings +The new Browser Assistant has its own tab in AdGuard for Mac settings, together with Stealth Mode, Browsing Security, Parental Control and others. Don’t worry if you missed the opportunity to install Browser Assistant during the onboarding, you'll find this option in the app's settings. Besides, there is a checkbox to enable the legacy Assistant. + + + +## Legacy Assistant +Legacy Assistant is the previous version of Assistant, which is a mere userscript, not a browser extension. Basically, there are two cases when you might want to pick it instead of the new Browser Assistant: 1) the new Assistant is not available for your browser; 2) you are used to the green shield icon and want to leave things as they were. If you recognize yourself in any of these scenarios, then the legacy version will suit you. + +## How to install AdGuard Browser Assistant +Technically, you won’t need to do it on your own: during the onboarding process AdGuard app will determine your default browser and offer to install Browser Assistant for it. Yet, if you missed that step, you can download it yourself. + +AdGuard Browser Assistant is available for all popular browsers: Chrome, Firefox, Safari, Edge, Opera, and Yandex. To install the Browser Assistant for your default browser, you can do it directly from the app settings, but you also have an opportunity to install it for other browsers. + +To install the one you need (or many, it is not prohibited but even encouraged), go to [our website](https://adguard.com/en/adguard-assistant/overview.html), click the browser icon and tap the *Download* button. That’s it! diff --git a/03.macos/01.features-overview/02.browser-assistant/docs.ru.md b/03.macos/01.features-overview/02.browser-assistant/docs.ru.md new file mode 100644 index 00000000..2844ab57 --- /dev/null +++ b/03.macos/01.features-overview/02.browser-assistant/docs.ru.md @@ -0,0 +1,54 @@ +--- +title: 'Браузерный Помощник AdGuard' +taxonomy: + category: + - docs +--- + +Главная функция Помощника AdGuard – управлять фильтрацией прямо из браузера. Он существовал довольно долго, так что его форма и содержание изменились. Раньше это был просто пользовательский скрипт, включённый в приложение AdGuard для Mac, а теперь он стал полноценным браузерным расширением. Теперь Помощник определённо приносит больше пользы. + +
+
+ +
+
+ +
+
+ +## Преимущества + +### Независимость +Браузерный Помощник AdGuard – это браузерное расширение, он устанавливается в браузер, так что не нужно ждать, пока пользовательский скрипт будет вставлен в код фильтруемой веб-страницы, как это было раньше. Другими словами, он более независим от основного приложения AdGuard. И всё же, Браузерному Помощнику нужен установленный AdGuard для Mac, потому что использовать расширение без приложения бессмысленно. + +### Совместимость с основным приложением +Если вы привыкли к использованию нашего прежнего расширения [в режиме интеграции](https://kb.adguard.com/ru/browser-extensions/integration-mode), вам может понравиться решение, которое мы разработали для нового Браузерного Помощника. + +Справочная информация: +> В предыдущих версиях браузерного расширения AdGuard (до версии 3.5), если оно было установлено у вас вместе с десктопным приложением AdGuard для Mac, расширение брало на себя функции Помощника и переставало фильтровать само, полагаясь в этом на приложение. + +> Расширение и приложение работали в связке, но иногда интеграция ломалась. Некоторые сайты прекращали фильтроваться приложением, вместо этого фильтрацию производило расширение, обладающее заметно меньшими возможностями. + +При использовании Браузерного Помощника все эти проблемы не имеют значения и никаких конфликтов быть не может в принципе. Роль Браузерного Помощника чётко определена, он не может помешать функционированию основного приложения, так что теперь не о чем беспокоиться. + +### Умная установка +Когда AdGuard для Mac устанавливается в первый раз, первое, с чем сталкивается пользователь, – это установка. В ходе этого процесса пользователь быстро узнает о настройках AdGuard и может настроить фильтрацию, как ему нравится. На определённом этапе AdGuard определит браузер пользователя по умолчанию и предоставит ссылку для загрузки нового Помощника. + + + +> В редких случаях браузер может оказаться несовместимым с Браузерным Помощником, и вместо него пользователю предложат установить [легаси-версию](#legacy-assistant). + +## Отдельная вкладка в настройках +У нового Браузерного Помощника есть своя вкладка в настройках AdGuard для Mac, наряду с Антитрекингом, Антифишингом, Родительским контролем и другими. Не волнуйтесь, если пропустили шаг со скачиванием Браузерного Помощника во время установки, вы найдёте эту опцию в настройках приложения. Кроме того, там можно установить флажок для включения прежней версии Помощника. + + + +## Прежняя версия Помощника +Легаси – это предыдущая версия Помощника, который по сути был пользовательским скриптом, а не браузерным расширением. В основном, есть два случая, когда вы можете предпочесть её новому Браузерному Помощнику: 1) новый Помощник недоступен для вашего браузера; 2) вы привыкли к иконке с зелёным щитом и хотите оставить всё как было. Если вы узнали себя в одном из этих сценариев, тогда легаси-версия вам подходит. + +## Как установить Браузерный Помощник AdGuard +Технически, вам не нужно делать это самостоятельно: во время установки приложение AdGuard определит ваш браузер по умолчанию и предложит установить Браузерный Помощник для него. Но если вы пропустили этот шаг, то можете скачать его самостоятельно. + +Если вы хотите установить Браузерный Помощник для браузера по умолчанию, то можете сделать это напрямую из настроек приложения, но также у вас есть возможность установить Помощник для других браузеров. + +Браузерный Помощник AdGuard доступен для всех популярных браузеров: Chrome, Firefox, Safari, Edge, Opera, и Яндекс.Браузера. Чтобы установить Помощник (или несколько для разных браузеров, это не запрещено, а даже приветствуется), перейдите на [наш сайт](https://adguard.com/ru/adguard-assistant/overview.html), кликните на иконку браузера и нажмите кнопку *«Скачать»*. Вот и всё! \ No newline at end of file diff --git a/03.macos/03.features/docs.en.md b/03.macos/03.features/docs.en.md index b1995708..47f96e79 100644 --- a/03.macos/03.features/docs.en.md +++ b/03.macos/03.features/docs.en.md @@ -3,6 +3,7 @@ title: Features taxonomy: category: - docs +visible: false --- AdGuard for macOS is designed to block ads on web pages and in applications installed on your computer. In addition, AdGuard protects users from fraudulent websites and their information from statistics gathering systems. This section gives a brief overview of the AdGuard for macOS functions. diff --git a/03.macos/03.features/docs.ru.md b/03.macos/03.features/docs.ru.md index 58875723..b65ef9c3 100644 --- a/03.macos/03.features/docs.ru.md +++ b/03.macos/03.features/docs.ru.md @@ -3,6 +3,7 @@ title: Функции taxonomy: category: - docs +visible: false --- AdGuard для macOS предназначен для блокировки рекламы на веб-страницах и в установленных на компьютере приложениях. Кроме того, AdGuard защищает пользователей от распространенных в Интернете мошеннических сайтов, а их личную информацию — от сбора различными системами статистики. В этом разделе представлено краткое описание функций AdGuard для macOS.