diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/be/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/be/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/be/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/be/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/be/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/be/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/be/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/bn/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/bn/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/bn/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/bn/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index 774ac5b54c9..e7575eb9b08 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ Tento článek popisuje AdGuard pro iOS, multifunkční blokátor reklam, který ::: -V systému iOS 15 přidala společnost Apple podporu pro webová rozšíření Safari a my jsme zase přidali nový modul _Pokročilá ochrana_ do AdGuardu pro iOS. Umožňuje AdGuardu aplikovat pokročilá pravidla filtrování, jako jsou pravidla CSS, selektory CSS a skriptlety, a poradit si tak i se složitými reklamami, jako jsou reklamy YouTube. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 42f069c2287..bb8a5d98ea9 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ Webové rozšíření pro Safari od AdGuardu je nástroj, který využívá nov ## K čemu slouží -Safari ve výchozím nastavení poskytuje blokátorům obsahu pouze základní nástroje. Tyto nástroje neumožňují takovou úroveň výkonu, jakou mají blokátory obsahu v jiných operačních systémech (Windows, Mac, Android). Například AdGuard aplikace na jiných platformách mohou používat takové účinné zbraně proti reklamám, jako jsou [CSS pravidla](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [selektory CSS](/general/ad-filtering/create-own-filters#extended-css-selectors), a [skriptlety](/general/ad-filtering/create-own-filters#scriptlets). Bohužel jsou tyto nástroje naprosto nenahraditelné při řešení složitějších případů, jako jsou například reklamy před videi na YouTube. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. Webové rozšíření pro Safari od AdGuardu doplňuje AdGuard tím, že mu umožňuje používat tyto typy pravidel filtrování. Kromě toho lze Webové rozšíření pro Safari od AdGuardu použít k rychlé správě AdGuardu pro iOS přímo z prohlížeče. Klepněte na *Rozšíření* – je to tlačítko s ikonou skládačky, v závislosti na typu vašeho zařízení může být umístěno vlevo nebo vpravo od adresního řádku. Vyhledejte **AdGuard** v seznamu a klepněte na něj. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> Na iPadech je webové rozšíření pro Safari od AdGuardu dostupné přímo klepnutím na ikonu AdGuardu v adresním řádku prohlížeče. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. Zobrazí se vám následující seznam možností: @@ -56,7 +57,7 @@ Klepněte na něj a zapněte přepínač. Na stejné obrazovce nastavte oprávn ### V Safari -Rozšíření AdGuard můžete zapnout také v prohlížeči Safari. Klepněte na *Rozšíření* (pokud jej nevidíte vedle adresního řádku, klepněte na ikonu `aA`). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) 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 836328d33ce..d61bcc3cb80 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 @@ -49,13 +49,19 @@ Uživatelská pravidla a pravidla seznamu povolených jsou součástí každého ## AdGuard pro Safari -*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. +*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. ## 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. Klikněte na *Natavení...* -1. Vyberte *Rozšíření*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) +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. Vyberte *Rozšíření*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Proč vyžaduje AdGuard pro Safari oprávnění diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index d4bf7066b20..2013e1519df 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ Tento článek popisuje AdGuard pro Windows, multifunkční blokátor reklam, kt ::: -AdGuard dokáže výrazně rozšířit funkčnost webových stránek a funguje jako [správce uživatelských skriptů](/general/extensions). Uživatelé AdGuardu mohou přidávat své vlastní skripty a také spravovat stávající. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 e23a2d29f3c..699be6fb4f3 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 @@ -4410,6 +4410,7 @@ kde: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/cs/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..a9ab9cb990c --- /dev/null +++ b/i18n/cs/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Rozšíření +sidebar_position: 6 +--- + +## Uživatelské skripty + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. Upravují nebo rozšiřují funkce jedné nebo více webových stránek. Mnoho uživatelů AdGuardu již možná zná uživatelské skripty jako AdGuard asistent, Blokátor vyskakovacích oken a AdGuard Extra. + +:::note Supported apps + +AdGuard může výrazně rozšířit funkčnost webových stránek tím, že funguje jako správce uživatelských skriptů. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Doporučené skripty AdGuardu + +Tyto uživatelské skripty pocházejí přímo od vývojářů AdGuardu a můžeme zaručit, že jsou účinné a bezpečné. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +Rozšíření, které blokuje reklamu v obtížných případech, kdy běžný přístup založený na filtru nestačí. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. Pokud jej však chcete používat společně s Rozšířením prohlížeče AdGuard nebo jiným blokátorem reklam, musíte použít další rozšíření. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard blokátor vyskakovacích oken + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard asistent (starší verze) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Zakázat AMP + +Skript, který je předinstalován pouze v aplikaci AdGuard pro Android. Zakáže AMP (Accelerated Mobile Pages) na stránce s výsledky vyhledávání Google. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Kde můžete získat další uživatelské skripty?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Zde popíšeme některé z nejoblíbenějších katalogů uživatelských skriptů. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Komunita + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Vývoj + +#### Žádost o licenci + +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. + +Chcete-li ji získat, zašlete e-mail na adresu devteam@adguard.com a uveďte následující informace: + +**Subject:** Userscript author license request + +**Body:** Please tell us about the userscripts you are working on. + +Here is a [mailto link](mailto:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Kompatibilita + +#### Blokování metadat + +#### Podporované vlastnosti + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Nepodporované vlastnosti + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Podporované funkce GM + +AdGuard podporuje jak staré funkce GM\_, tak nové rozhraní GM4 API, které používá objekt GM. + +#### Hodnoty + +:::note + +Všechny uvedené staré funkce Greasemonkey jsou zastaralé, ale stále podporované. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Příklad + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link Address_ + +3. Open AdGuard settings → _Extensions_ + +4. Press the [+] button and paste the userstyle link + +5. Hotovo! + +If you’re familiar with CSS rules, you can also create the userstyles yourself. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). Např: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Příklad + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/cs/docusaurus-plugin-content-docs/current/general/how-to-install.md index d2273ffff43..b1f8617e0bd 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: Jak nainstalovat AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Podle toho, kterou aplikaci AdGuard nebo rozšíření prohlížeče chcete nainstalovat, vyhledejte příslušný článek pomocí jednoho z těchto odkazů: diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/cs/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 7d50a029d78..29be0c71dc5 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Známé problémy sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Poslední aktualizace: 20. září 2022 +Last update: September 17, 2024 Pochopení tohoto článku může vyžadovat základní znalosti o šifrování, TLS a HTTPS. @@ -30,7 +32,38 @@ Všechny nám známé problémy a předpokládané termíny jejich oprav jsou uv Největší nevýhodou mechanismu HTTPS filtrování je, že skrývá skutečný certifikát webové stránky. Nemůžete jednoduše zkontrolovat jeho originální certifikát, protože vidíte pouze ten, který vydal AdGuard. -Tento problém řeší v [Asistent prohlížeče](https://adguard.com/adguard-assistant/overview.html). Toto rozšíření prohlížeče vám pomůže spravovat filtrování přímo z prohlížeče a umožní vám zkontrolovat originální certifikát jakékoli webové stránky. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Transparentnost certifikátu diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/da/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/da/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/da/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/da/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/da/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/da/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index e59a3d75f1d..0069489d235 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ Dieser Artikel behandelt AdGuard für iOS, einem multifunktionalen Werbeblocker, ::: -In iOS 15 hat Apple die Unterstützung für Safari-Web-Erweiterungen hinzugefügt, und wir haben im Gegenzug ein neues Modul _Erweiterter Schutz_ zu AdGuard für iOS hinzugefügt. Es ermöglicht AdGuard die Anwendung fortgeschrittener Filterregeln, wie CSS-Regeln, CSS-Selektoren und Scriptlets, und somit auch den Umgang mit komplexen Anzeigen, wie z. B. Werbung in YouTube. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Bildschirm für den Erweiterten Schutz \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 0ff2bee3c55..a66f6635798 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ Die Safari-Web-Erweiterung von AdGuard ist ein Tool, das sich die neuen Funktion ## Was sie bewirkt -Safari bietet standardmäßig nur grundlegende Werkzeuge für Inhaltsblocker. Diese Tools bieten nicht die gleiche Leistung wie Inhaltsblocker auf anderen Betriebssystemen (Windows, Mac, Android). Beispielsweise können AdGuard-Apps auf anderen Plattformen wirksame Waffen gegen Werbung einsetzen, wie [CSS-Regeln](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS-Selektoren](/general/ad-filtering/create-own-filters#extended-css-selectors) und [Scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Leider sind diese Werkzeuge absolut unersetzlich, wenn es um komplexere Fälle wie z. B. Pre-Roll-Anzeigen auf YouTube geht. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. Die Web-Erweiterung von AdGuard ergänzt die AdGuard-App, indem sie es der App ermöglicht, diese Art von Filterregeln anzuwenden. Darüber hinaus kann die Safari-Web-Erweiterung von AdGuard verwendet werden, um AdGuard für iOS schnell und direkt im Browser zu verwalten. Tippen Sie auf die Schaltfläche *Erweiterungen* — das ist die Schaltfläche mit dem Puzzlesymbol, die sich je nach Gerätetyp links oder rechts von der Adressleiste befindet. Suchen Sie **AdGuard** in der Liste und tippen Sie darauf. ![Menü der Web-Erweiterung *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> Auf dem iPad können Sie direkt auf die Safari-Web-Erweiterung von AdGuard zugreifen, indem Sie auf das AdGuard-Symbol in der Adressleiste des Browsers tippen. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. Dort wird die folgende Liste von Optionen angezeigt: @@ -56,7 +57,7 @@ Tippen Sie darauf und legen Sie dann den Schalter um. Auf demselben Bildschirm s ### In Safari -Alternativ können Sie die Erweiterung auch über den Safari-Browser aktivieren. Tippen Sie auf die Schaltfläche *Erweiterungen* (wenn Sie sie nicht neben der Adressleiste sehen, tippen Sie auf das Symbol `aA`). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![Tippen Sie in Safari auf das Symbol aA *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index ee97abc04c1..437ade1b6d8 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ Benutzerregeln und Regeln für die Freigabeliste sind in jeder Erweiterung entha ## AdGuard für Safari -*AdGuard für Safari* aktiviert das AdGuard-Symbol neben der Suchleiste. Dies ist nützlich, wenn Sie schnell einen Schutz für eine bestimmte Website einrichten oder Werbung manuell blockieren möchten. Sie enthält zudem erweiterte Regeln, die nicht in das von Safari unterstützte Format konvertiert werden. Dazu gehören CSS-Regeln, CSS-Selektoren und Scriptlets, die es AdGuard ermöglichen, komplexe Werbung zu blockieren, z. B. auf 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. ## So verwalten Sie Safari-Erweiterungen -1. Öffnen Sie Safari und klicken Sie auf *Safari* in der oberen linken Ecke des Bildschirms, um das Menü zu erweitern. ![Safari-Einstellungen *mobil](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) -1. Klicken Sie auf *Einstellungen…* -1. Wählen Sie *Erweiterungen*. ![Erweiterungen-Tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) +1. Öffnen Sie Safari und klicken Sie auf *Safari* in der oberen linken Ecke des Bildschirms, um das Menü zu erweitern. + + ![Safari-Einstellungen *mobil](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + +1. Click *Settings...* + +1. Wählen Sie *Erweiterungen*. + + ![Erweiterungen-Tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Darum benötigt AdGuard für Safari eine Genehmigung diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index f2c087c1fb6..a5d0ff9435d 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ Dieser Artikel behandelt AdGuard für Windows, einem multifunktionalen Werbebloc ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). Sie können ihre eigenen Skripte hinzufügen und bestehende Skripte verwalten. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Erweiterungen \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 433af01c1f6..5a614e90fda 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/filter-policy.md b/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/filter-policy.md index 9b449d8ef19..93554b60ae3 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/filter-policy.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/filter-policy.md @@ -48,7 +48,7 @@ AdGuard-Filter zum Blockieren von Werbung umfassen: - **Der Basisfilter** blockiert Werbung auf englischsprachigen Websites und solchen, für die es keinen eigenen Filter gibt. Er enthält auch allgemeine Filterregeln, die für alle Websites unabhängig von der Sprache gelten - **Filter gegen mobile Werbung** blockiert Werbung auf mobilen Versionen von Websites und in mobilen Apps. Es gibt keine Unterteilung nach Sprachen - **Sprachspezifische Filter** folgen der gleichen Politik wie der **Basisfilter**, sind aber auf Websites in bestimmten Sprachen beschränkt -- Quick-Fixes-Filter zur schnellen Behebung kritischer Probleme bei der Filterung von Inhalten auf beliebten Websites ohne Aktualisierung der MV3-Erweiterung. +- **Quick-Fixes-Filter** zur schnellen Behebung kritischer Probleme bei der Filterung von Inhalten auf beliebten Websites ohne Aktualisierung der MV3-Erweiterung. Das Ziel von Werbeblockern ist es, alle Arten von Werbung auf Websites, in Apps und auf bestimmten Geräten, die Werbung aus dem Internet laden können, zu blockieren: diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/de/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..8950497c96b --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Erweiterungen +sidebar_position: 6 +--- + +## Benutzerskripte + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. Sie ändern oder erweitern die Funktionalität einer oder mehrerer Websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Empfohlene AdGuard-Skripte + +Diese Benutzerskripte stammen direkt von AdGuard und wir können garantieren, dass sie effektiv und sicher sind. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +Eine Erweiterung, die Werbung in schwierigen Fällen blockiert, wenn der übliche filterbasierte Ansatz nicht ausreicht. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. Wenn Sie es jedoch zusammen mit AdGuard Browsererweiterung oder einem anderen Werbeblocker verwenden möchten, müssen Sie eine zusätzliche Erweiterung verwenden. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Pop-up-Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard-Assistent (alte Version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### AMP deaktivieren + +Ein Skript, das nur in AdGuard für Android vorinstalliert ist. Es deaktiviert AMP (Accelerated Mobile Pages) auf der Google-Suchergebnisseite. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Wo kann man weitere Benutzerskripte erhalten? {#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Im Folgenden werden einige der beliebtesten Benutzerskript-Kataloge beschrieben. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Entwicklung + +#### Lizenz anfordern + +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. + +Um sie zu erhalten, senden Sie bitte eine E-Mail an devteam@adguard.com mit den folgenden Informationen: + +**Subject:** Userscript author license request + +**Body:** Please tell us about the userscripts you are working on. + +Here is a [mailto link](mailto:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Kompatibilität + +#### Metadaten-Block + +#### Unterstützte Eigenschaften + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Nicht unterstützte Eigenschaften + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Unterstützte GM-Funktionen + +AdGuard unterstützt sowohl die alten GM\_-Funktionen als auch die neue GM4-API, die das GM-Objekt verwendet. + +#### Werte + +:::note + +Alle aufgeführten früheren Greasemonkey-Funktionen sind veraltet, werden aber weiterhin unterstützt. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Beispiel + +```javascript +// ==Benutzerskript== +// @name Name, wie er dem Benutzer angezeigt wird, wenn das Gebietsschema Englisch oder unbekannt ist +// @name:ru Name, wie er dem Benutzer angezeigt wird, wenn das Gebietsschema russisch ist +// @description Beschreibung, wie sie dem Benutzer angezeigt wird, wenn das Gebietsschema englisch oder unbekannt ist +// @description:ru Beschreibung, wie sie dem Benutzer angezeigt wird, wenn das Gebietsschema russisch ist +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link Address_ + +3. Open AdGuard settings → _Extensions_ + +4. Press the [+] button and paste the userstyle link + +5. Fertig! + +If you’re familiar with CSS rules, you can also create the userstyles yourself. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). Zum Beispiel: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Beispiel + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/de/docusaurus-plugin-content-docs/current/general/how-to-install.md index ebb4bd7bbe0..b79b038324a 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: So installieren Sie AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Je nachdem, welche AdGuard-App oder Browsererweiterung Sie installieren möchten, folgen Sie einem dieser Links, um den entsprechenden Artikel zu finden: diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/de/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index b1bbc502e6d..a6d1e253012 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ Este artículo trata sobre AdGuard para iOS, un bloqueador de anuncios multifunc ::: -En iOS 15 Apple ha añadido el soporte para Extensiones Web de Safari, y a su vez hemos añadido un nuevo módulo de _protección avanzada_ a AdGuard para iOS. Permite a AdGuard aplicar reglas de filtrado avanzadas, como reglas CSS, selectores CSS y scriptlets, y por tanto hacer frente incluso a los anuncios más complejos, como los de YouTube. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Pantalla de protección avanzada \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index b86c94a6e60..a8f5a39fcdc 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ La extensión web Safari de AdGuard es una herramienta que aprovecha las nuevas ## Para qué sirve -De forma predeterminada, Safari proporciona sólo herramientas básicas para los bloqueadores de contenido. Estas herramientas no permiten el nivel de rendimiento que se puede encontrar en los bloqueadores de contenidos de otros sistemas operativos (Windows, Mac, Android). Por ejemplo, las aplicaciones de AdGuard en otras plataformas pueden usar armas tan efectivas contra anuncios como [Reglas CSS](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [Selectores CSS](/general/ad-filtering/create-own-filters#extended-css-selectors)y [Scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Desafortunadamente, estos instrumentos son absolutamente insustituibles cuando se trata de casos más complejos como los anuncios pre-roll en YouTube, por ejemplo. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. La extensión web de Safari de AdGuard complementa a AdGuard dándole la capacidad de emplear este tipo de reglas de filtrado. Además, la extensión web Safari de AdGuard se puede usar para administrar rápidamente AdGuard para iOS directamente desde el navegador. Pulsa el botón *Extensiones* (el que tiene el icono de un rompecabezas). Dependiendo del tipo de dispositivo puede estar situado a la izquierda o a la derecha de la barra de direcciones. Busca **AdGuard** en la lista y tócalo. ![Menú de extensión web *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> En iPads, se puede acceder directamente a la extensión web Safari de AdGuard tocando el icono de AdGuard en la barra de direcciones del navegador. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. Verás la siguiente lista de opciones: @@ -56,7 +57,7 @@ Tócalo y luego activa el interruptor. En la misma pantalla, establece el permis ### En Safari -Como alternativa, también puedes activar la extensión AdGuard desde el navegador Safari. Pulsa el botón *Extensiones* (si no lo ves junto a la barra de direcciones, pulsa el icono `aA`). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![En Safari, toca el ícono aA *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index 4f8684465ec..5cc6509eedc 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ Las reglas de usuario y las reglas de la lista de permitidos se incluyen en toda ## AdGuard para Safari -*AdGuard para Safari* habilita el ícono de AdGuard al lado de la barra de búsqueda. Es útil si deseas configurar rápidamente la protección en un sitio web en particular o bloquear anuncios manualmente. También contiene reglas avanzadas que no se convierten al formato admitido por Safari. Esto incluye reglas CSS, selectores CSS y scriptlets que permiten a AdGuard bloquear anuncios complejos, como los de 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. ## Cómo gestionar las extensiones de Safari -1. Abre Safari y haz clic en *Safari* en la esquina superior izquierda de la pantalla para expandir el menú. ![Configuración de Safari *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) -1. Haz clic en *Configuración...* -1. Selecciona *Extensiones*. ![Pestaña Extensiones](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) +1. Abre Safari y haz clic en *Safari* en la esquina superior izquierda de la pantalla para expandir el menú. + + ![Configuración de Safari *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + +1. Click *Settings...* + +1. Selecciona *Extensiones*. + + ![Pestaña Extensiones](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Por qué AdGuard para Safari requiere permisos diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 4e281975840..8d201005143 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ Este artículo trata sobre AdGuard para Windows, un bloqueador de anuncios multi ::: -AdGuard puede ampliar significativamente la funcionalidad del sitio web trabajando como [gestor de scripts de usuario](/general/extensions). Los usuarios de AdGuard pueden añadir sus propios scripts, así como gestionar los existentes. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensiones \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 916a686784a..c1da5b98034 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/es/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/es/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..bff7a88f30f --- /dev/null +++ b/i18n/es/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensiones +sidebar_position: 6 +--- + +## Userscripts + +Los scripts de usuario (también los llamamos "extensiones") son, de facto, miniprogramas escritos en JavaScript. Modifican o amplían la funcionalidad de uno o más sitios web. Es posible que muchos usuarios de AdGuard ya estén familiarizados con scripts de usuario como AdGuard Assistant, Popup Blocker y AdGuard Extra. + +:::note Supported apps + +AdGuard puede ampliar significativamente la funcionalidad del sitio web al actuar como administrador de scripts de usuario. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Scripts de AdGuard recomendados + +Estos scripts de usuario provienen directamente de los desarrolladores de AdGuard y podemos garantizar que son efectivos y seguros. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +Una extensión que bloquea anuncios en casos difíciles cuando el enfoque habitual basado en filtros no es suficiente. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. Sin embargo, si deseas utilizarlo junto con la extensión de navegador AdGuard o cualquier otro bloqueador de anuncios, necesitarás utilizar una extensión adicional. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (versión antigua) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Deshabilitar AMP + +Un script que sólo está preinstalado en AdGuard para Android. Desactiva AMP (Accelerated Mobile Pages) en la página de resultados de búsqueda de Google. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Mejores opciones fuera de AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +Este script elimina la función de seguimiento de Google de los enlaces en los resultados de búsqueda de Google. Acelera la carga de los resultados de búsqueda y te permite hacer clic derecho o tocar para copiar la URL del enlace. + +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 + +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). + +### ¿Dónde conseguir más scripts de usuario?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Cualquier script de fuente desconocida conlleva un riesgo potencial. Sin embargo, existe una gran variedad de scripts interesantes que, si se instalan con cuidado y responsabilidad, pueden hacer que el uso de algunos sitios web sea más conveniente. + +Aquí describiremos algunos de los catálogos de scripts de usuario más populares. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Comunidad + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Desarrollo + +#### Solicitar licencia + +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. + +Para obtenerlo, envía un correo electrónico a devteam@adguard.com con la siguiente información: + +**Subject:** Userscript author license request + +**Body:** Please tell us about the userscripts you are working on. + +Here is a [mailto link](mailto:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibilidad + +#### Bloqueo de metadatos + +#### Propiedades compatibles + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Propiedades no compatibles + +Estas propiedades serán simplemente ignoradas por AdGuard. + +```text +@unwrap +``` + +#### Funciones GM compatibles + +AdGuard admite tanto las funciones GM\_ antiguas como la nueva API GM4 que utiliza objetos GM. + +#### Valores + +:::note + +Todas las funciones antiguas de Greasemonkey enumeradas están obsoletas pero aún son compatibles. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Ejemplo + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link Address_ + +3. Open AdGuard settings → _Extensions_ + +4. Press the [+] button and paste the userstyle link + +5. ¡Listo! + +If you’re familiar with CSS rules, you can also create the userstyles yourself. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Ejemplo + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/es/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/es/docusaurus-plugin-content-docs/current/general/how-to-install.md index 25bbb8aaf66..e21f85dc187 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: Cómo instalar AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Dependiendo de la aplicación AdGuard o de la extensión del navegador que desee instalar, siga uno de estos enlaces para encontrar el artículo correspondiente: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/es/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 45cbffdc218..04dd7552ba9 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Problemas conocidos sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Última actualización: 20 de septiembre de 2022 +Last update: September 17, 2024 Para comprender este artículo es posible que se requieran algunos conocimientos básicos sobre cifrado, TLS y HTTPS. @@ -30,7 +32,38 @@ A continuación se enumeran todos los problemas que conocemos y el tiempo estima La desventaja más importante del mecanismo de filtrado HTTPS es que oculta el certificado real de un sitio web. No puedes simplemente verificar su certificado original porque solo puedes ver el emitido por AdGuard. -Este problema se resuelve en [Asistente del navegador](https://adguard.com/adguard-assistant/overview.html). Esta extensión del navegador te ayuda a administrar el filtrado directamente desde el navegador y te permite inspeccionar el certificado original de cualquier sitio web. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Transparencia del certificado diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/fa/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/fa/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/fa/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/fa/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/fi/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/fi/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/fi/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/fi/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index 2e67a166b4a..07e69c0e291 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ Cet article parle de AdGuard pour iOS, un bloqueur de contenus multifonctionnel ::: -Dans iOS 15, Apple a ajouté la prise en charge des extensions Web Safari, et nous avons à notre tour ajouté un nouveau module _Protection avancée_ à AdGuard pour iOS. Il permet à AdGuard d'appliquer des règles de filtrage avancées, telles que des règles CSS, des sélecteurs CSS et des scriptlets, ce qui permet de gérer même les annonces complexes, comme les publicités YouTube. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Écran de protection avancée \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 97de9d76d4e..db4cf4a505f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ L'extension web Safari d'AdGuard est un outil qui profite des nouvelles fonction ## Ce qu'il fait -Par défaut, Safari ne fournit que des outils de base aux bloqueurs de contenu. Ces outils ne permettent pas le niveau de performance que l'on peut trouver dans les bloqueurs de contenu sur d'autres systèmes d'exploitation (Windows, Mac, Android). Par exemple, les applications AdGuard sur d'autres plateformes peuvent utiliser des armes efficaces contre les publicités telles que les [règles CSS](/general/ad-filtering/create-own-filters#cosmetic-css-rules), les [sélecteurs CSS](/general/ad-filtering/create-own-filters#extended-css-selectors) et les [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Malheureusement, ces instruments sont absolument irremplaçables lorsqu’il s’agit de cas plus complexes comme les publicités pré-roll sur YouTube par exemple. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. L'extension web Safari d'AdGuard complète AdGuard en lui donnant la possibilité d'utiliser ces types de règles de filtrage. En plus de cela, l'extension web Safari d'AdGuard peut être utilisée pour gérer rapidement AdGuard pour iOS directement depuis le navigateur. Appuyez sur le bouton *Extensions* — c'est celui avec une icône en forme de puzzle, selon le type de votre appareil, elle peut être située à gauche ou à droite de la barre d'adresse. Recherchez **AdGuard** dans la liste et appuyez dessus. ![Menu de l'extension web *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> Sur les iPads, l'extension web Safari d'AdGuard est accessible directement en appuyant sur l'icône AdGuard dans la barre d'adresse du navigateur. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. Vous verrez la liste d’options suivante : @@ -56,7 +57,7 @@ Appuyez dessus, puis activez le commutateur. Sur le même écran, définissez l' ### Dans Safari -Vous pouvez également activer l'extension AdGuard à partir du navigateur Safari. Appuyez sur le bouton *Extensions* (si vous ne le voyez pas à côté de la barre d'adresse, appuyez sur l'icône `aA` ). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![Dans Safari, appuyez sur l'icône A * mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index cc4f3b4c4ed..ef4caa29a1a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ Les règles d'utilisation et les règles d'autorisation sont incluses dans chaqu ## AdGuard pour Safari -*AdGuard pour Safari* active l'icône AdGuard à côté de la barre de recherche. Cette fonction est utile si vous souhaitez configurer rapidement la protection d'un site web particulier ou bloquer les publicités manuellement. Vous y trouverez également des règles avancées qui ne sont pas converties au format pris en charge par Safari. Cela inclut les règles CSS, les sélecteurs CSS et les scriptlets qui permettent à AdGuard de bloquer les publicités complexes, par exemple sur 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. ## Comment gérer les extensions Safari -1. Ouvrez Safari et cliquez sur *Safari* dans le coin supérieur gauche de l'écran pour développer le menu. ![Paramètres Safari *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) -1. Cliquez sur *Paramètres...* -1. Sélectionnez *Extensions*. ![Onglet Extensions](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) +1. Ouvrez Safari et cliquez sur *Safari* dans le coin supérieur gauche de l'écran pour développer le menu. + + ![Paramètres Safari *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + +1. Click *Settings...* + +1. Sélectionnez *Extensions*. + + ![Onglet Extensions](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Pourquoi AdGuard pour Safari nécessite une autorisation diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 212f7421e60..57ec4f3921a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ Cet article parle de AdGuard pour Windows, un bloqueur de contenus multifonction ::: -AdGuard peut accroître considérablement les fonctionnalités des sites web en agissant comme un [gestionnaire de scripts utilisateur](/general/extensions). Les utilisateurs d'AdGuard peuvent ajouter leurs propres scripts et gérer les scripts existants. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 131e2e3af7e..12a3630bb7a 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/fr/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..9df1a3c4ee3 --- /dev/null +++ b/i18n/fr/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Scripts utilisateur + +Les scripts utilisateurs ou userscripts (que nous appelons aussi "extensions") sont, en fait, des miniprogrammes écrits en JavaScript. Ils modifient ou élargissent les fonctionnalités d'un ou plusieurs sites web. De nombreux utilisateurs d'AdGuard sont peut-être déjà familiers avec des scripts utilisateur tels que AdGuard Assistant, Popup Blocker et AdGuard Extra. + +:::note Supported apps + +AdGuard peut accroître considérablement les fonctionnalités des sites web en agissant comme un gestionnaire de scripts utilisateur. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Scripts AdGuard recommandés + +Ces scripts utilisateur proviennent directement des développeurs AdGuard et nous pouvons garantir qu'ils sont efficaces et sûrs. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +Une extension qui bloque les publicités dans les cas difficiles où l'approche habituelle basée sur les filtres ne suffit pas. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. Cependant, si vous souhaitez l'utiliser avec l'extension de navigateur AdGuard ou tout autre bloqueur de publicités, vous devrez utiliser une extension supplémentaire. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### Bloqueur AdGuard de fenêtres pop-up + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### Assistant AdGuard (ancienne version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Désactiver AMP + +Un script préinstallé uniquement dans AdGuard pour Android. Il désactive AMP (Accelerated Mobile Pages - pages mobiles accélérées) sur la page de résultats de recherche Google. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Meilleurs choix en dehors d'AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +Ce script supprime la fonctionnalité de suivi de Google des liens dans les résultats de recherche Google. Il accélère le chargement des résultats de recherche et vous permet de cliquer ou d'appuyer avec le bouton droit pour copier l'URL du lien. + +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 + +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). + +### Où trouver d'autres scripts utilisateur ?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Tout script provenant d'une source inconnue comporte un risque potentiel. Pourtant, il existe une grande variété de scripts intéressants qui, s’ils sont installés avec soin et de manière responsable, peuvent réellement rendre l’utilisation de certains sites web plus pratique. + +Nous décrirons ici certains des catalogues de scripts utilisateur les plus populaires. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Communauté + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Développement + +#### Demande de licence + +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. + +Pour l'obtenir, veuillez envoyer un email à devteam@adguard.com avec les informations suivantes : + +**Subject:** Userscript author license request + +**Body:** Please tell us about the userscripts you are working on. + +Here is a [mailto link](mailto:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibilité + +#### Bloc de métadonnées + +#### Propriétés prises en charge + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Propriétés non prises en charge + +Ces propriétés seront simplement ignorées par AdGuard. + +```text +@unwrap +``` + +#### Fonctions GM prises en charge + +AdGuard prend en charge à la fois les anciennes fonctions GM\_ et la nouvelle API GM4 qui utilisent l'objet GM. + +#### Valeurs + +:::note + +Toutes les anciennes fonctions Greasemonkey répertoriées sont obsolètes mais toujours prises en charge. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## Styles utilisateur + +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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link Address_ + +3. Open AdGuard settings → _Extensions_ + +4. Press the [+] button and paste the userstyle link + +5. C'est fait ! + +If you’re familiar with CSS rules, you can also create the userstyles yourself. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/fr/docusaurus-plugin-content-docs/current/general/how-to-install.md index 3e5022b291f..6a3eca6e7e5 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: Comment installer AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Selon l'application AdGuard ou l'extension de navigateur que vous souhaitez installer, suivez l'un de ces liens pour trouver l'article correspondant : diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/fr/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 1a9b94d5740..ede0e0e8ed9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Problèmes connus sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Dernière mise à jour : 20 septembre 2022 +Last update: September 17, 2024 La compréhension de cet article peut nécessiter des connaissances de base sur le chiffrement, TLS et HTTPS. @@ -30,7 +32,38 @@ Tous les problèmes que nous connaissons et les dates de résolution estimées s L'inconvénient le plus important du mécanisme de filtrage HTTPS est qu'il cache le véritable certificat d'un site web. Vous ne pouvez pas simplement vérifier son certificat d'origine car vous ne pouvez voir que celui émis par AdGuard. -Ce problème est résolu dans [l'Assistant de navigateur](https://adguard.com/adguard-assistant/overview.html). Cette extension de navigateur vous aide à gérer le filtrage directement à partir du navigateur et vous permet d'inspecter le certificat original de n'importe quel site web. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Transparence des certificats diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/hr/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/hr/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/hr/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/hr/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index 60a98f5d5d8..29c30f05595 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 6da53f63b90..61930b903a0 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/hu/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/hu/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/hu/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/hu/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index 6de74f0cd71..72a9ee006ce 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ Questo articolo riguarda AdGuard per iOS, un blocco annunci multifunzionale che ::: -Su iOS 15, Apple ha aggiunto il supporto alle Estensioni Web di Safari e, a nostra volta, abbiamo aggiunto un nuovo modulo di _Protezione avanzata_ ad AdGuard per iOS. Consente ad AdGuard di applicare regole di filtraggio avanzate, quali regole e selettori CSS e scriptlet e, dunque, di gestire persino gli annunci complessi, come quelli di YouTube. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Schermata di protezione avanzata \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index abbe28ba506..1789725a7a5 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ L'estensione Web per Safari di AdGuard è uno strumento che sfrutta le nuove fun ## Cosa fa -Di default, Safari fornisce soltanto strumenti essenziali ai blocchi di contenuto. Questi strumenti non consentono il livello di prestazioni di blocchi di contenuti di altri sistemi operativi (Windows, Mac, Android). Ad esempio, le app di AdGuard su altre piattaforme, possono utilizzare armi efficienti contro gli annunci, come le [regole CSS](/general/ad-filtering/create-own-filters#cosmetic-css-rules), i [selettori CSS](/general/ad-filtering/create-own-filters#extended-css-selectors) e gli [scriptlet](/general/ad-filtering/create-own-filters#scriptlets). Sfortunatamente, questi strumenti sono assolutamente insostituibili affrontando casi più complessi, come ad esempio, gli annunci pre-roll su YouTube. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. L'estensione Web per Safari di AdGuard completa AdGuard dandogli la capacità di impiegare questi tipi di regole di filtraggio. Inoltre, l'estensione Web per Safari di AdGuard è utilizzabile per gestire rapidamente AdGuard per iOS, direttamente dal browser. Tocca il pulsante *Estensioni*: è quello con l'icona di un puzzle, a seconda del tipo del tuo dispositivo, si potrebbe trovare a sinistra o a destra della barra degli indirizzi. Trova **AdGuard** nell'elenco e toccalo. ![Menu dell'estensione web *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> Su iPad, l'estensione web per Safari di AdGuard è accessibile direttamente toccando l'icona AdGuard nella barra degli indirizzi del browser. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. Vedrai il seguente elenco di opzioni: @@ -56,7 +57,7 @@ Toccalo, quindi attiva l'interruttore. Sulla stessa schermata, imposta l'autoriz ### Su Safari -Altrimenti, puoi anche attivare l'estensione di AdGuard dal browser Safari. Tocca il pulsante *Estensioni* (se non lo vedi affianco alla barra degli indirizzi, tocca l'icona `aA`). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![Su Safari tocca l'icona aA *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index e7d33df3412..9974708643b 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ Le regole degli utenti e dell'allowlist sono incluse in ogni estensione. ## AdGuard per Safari -*AdGuard per Safari* abilita l'icona di AdGuard affianco alla barra di ricerca. È utile se desideri configurare rapidamente la protezione su un sito web in particolare, o bloccare manualmente gli annunci. Inoltre, contiene delle regole avanzate, non convertite nel formato supportato da Safari. Ciò include le regole e i selettori CSS e gli scriptlet che consentono ad AdGuard di bloccare gli annunci complessi, ad esempio, su 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. ## Come gestire le estensioni di Safari -1. Apri Safari e clicca su *Safari* nell'angolo superiore destro della schermata, per espandere il menu. ![Impostazioni di Safari *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) -1. Clicca su *Impostazioni...* -1. Seleziona *Estensioni*. ![Scheda delle estensioni](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) +1. Apri Safari e clicca su *Safari* nell'angolo superiore destro della schermata, per espandere il menu. + + ![Impostazioni di Safari *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + +1. Click *Settings...* + +1. Seleziona *Estensioni*. + + ![Scheda delle estensioni](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Perché AdGuard per Safari richiede l'autorizzazione diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 9bf54936cbc..e58013f5828 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ Questo articolo riguarda AdGuard per Windows, un blocco annunci multifunzionale ::: -AdGuard può ampliare significativamente la funzionalità del sito web, operando da [gestore degli script dell'utente](/general/extensions). Gli Utenti di AdGuard possono aggiungere i propri script, nonché gestire quelli esistenti. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Estensioni \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 e1b73207431..60ca8b4ab62 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/it/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/it/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..af5f2e9fc40 --- /dev/null +++ b/i18n/it/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Estensioni +sidebar_position: 6 +--- + +## Script utente + +Gli userscript (li chiamiamo anche "estensioni") sono, di fatto, miniprogrammi scritti in JavaScript. Essi, modificano o estendono la funzionalità di uno o più siti web. Molti utenti di AdGuard potrebbero già essere a conoscenza di certi userscript, come AdGuard Assistant, Popup Blocker e AdGuard Extra. + +:::note Supported apps + +AdGuard può ampliare significativamente la funzionalità del sito web, agendo da gestore di userscript. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Script di AdGuard consigliati + +Questi script utente provengono direttamente dagli sviluppatori di AdGuard e possiamo garantire che siano efficienti e sicuri. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +C'è un'estensione che blocca gli annunci in casi difficili, quando il solito approccio basato sui filtri non è sufficiente. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. Tuttavia, se desideri utilizzarla insieme all'Estensione di browser AdGuard o qualsiasi altro bloccatore di annunci, dovrai utilizzare un'ulteriore estensione. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (versione ereditaria) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +Uno script preinstallato soltanto su AdGuard per Android. Disabilita AMP (Pagine Mobili Accelerate) sulla pagina dei risultati di ricerca di Google. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Le migliori scelte al di fuori di AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +Questo script rimuove la funzionalità di monitoraggio di Google dai collegamenti nei risultati di ricerca di Google. Accelera il caricamento dei risultati di ricerca e consente di fare clic con il pulsante destro del mouse o toccare per copiare l'URL del collegamento. + +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 + +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). + +### Dove puoi ottenere altri userscript?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Qualsiasi script proveniente da una fonte sconosciuta comporta un potenziale rischio. Tuttavia, esiste una grande varietà di script interessanti che, se installati con attenzione e responsabilità, possono davvero rendere più conveniente l'utilizzo di alcuni siti web. + +Qui, descriveremo alcuni dei cataloghi di userscript più popolari. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Comunità + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Sviluppo + +#### Richiedi la licenza + +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. + +Per ottenerla, sei pregato di inviare un'email a devteam@adguard.com con le seguenti informazioni: + +**Subject:** Userscript author license request + +**Body:** Please tell us about the userscripts you are working on. + +Here is a [mailto link](mailto:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibilità + +#### Blocco dei metadati + +#### Proprietà supportate + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Proprietà non supportate + +Queste proprietà saranno semplicemente ignorate da AdGuard. + +```text +@unwrap +``` + +#### Funzioni GM supportate + +AdGuard supporta sia le vecchie funzionalità GM\_ che la nuova API GM4, che utilizza l'oggetto GM. + +#### Valori + +:::note + +Tutte le funzionalità di Greasemonkey elencate sono deprecate, ma ancora supportate. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Esempio + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## Stili utente + +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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link Address_ + +3. Open AdGuard settings → _Extensions_ + +4. Press the [+] button and paste the userstyle link + +5. Fatto! + +If you’re familiar with CSS rules, you can also create the userstyles yourself. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Esempio + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/it/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/it/docusaurus-plugin-content-docs/current/general/how-to-install.md index 06a9d0c8624..297fff52c61 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: Come installare AdGuard -sidebar_position: 8 +sidebar_position: 9 --- A seconda di quale app o estensione del browser di AdGuard desideri installare, segui uno di questi link per trovare l'articolo rilevante: diff --git a/i18n/it/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/it/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index e89cf3ea487..4efaa2c4c24 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Problemi noti sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Ultimo aggiornamento: 20 settembre 2022 +Last update: September 17, 2024 Per comprendere questo articolo potrebbero essere necessarie alcune conoscenze di base sulla crittografia, TLS e HTTPS. @@ -30,7 +32,38 @@ Tutti i problemi a noi noti e le stime sulle correzioni, sono elencati di seguit Lo svantaggio più importante del meccanismo di filtraggio HTTPS è che nasconde il certificato reale di un sito web. Non puoi semplicemente controllarne il certificato originale, poiché puoi visualizzare soltanto quello emesso da AdGuard. -Questo problema è risolto nel [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). Quest'estensione del browser ti aiuta a gestire il filtraggio direttamente dal browser, consentendoti di ispezionare il certificato originale di qualsiasi sito web. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Trasparenza del Certificato diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index 670f5517bb5..279950098b6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ sidebar_position: 3 ::: -iOS 15でAppleはSafari Web Extensionsのサポートを開始したことで、AdGuard for iOS に新しい「_高度な保護機能_」を追加することができました。 高度な保護機能により、AdGuardはCSSルール、CSSセレクタ、スクリプトレットなどという高度なフィルタリングルールを適用することで、YouTube広告のような複雑な広告にも対応できます。 +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 7ea737d496a..d8f6c1255e4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuardのSafariウェブ拡張機能は、iOS 15の新機能を活用して AdG ## ウェブ拡張機能の効果 -デフォルトでは、Safariはコンテンツブロッカーにベーシックなツールしか提供していません。 これらのツールでは、他のオペレーティング・システム(Windows、Mac、Android)のコンテンツブロッカーにのようなレベルのパフォーマンスは発揮できません。 たとえば、他のプラットフォーム上のAdGuardアプリは、 [CSSルール](/general/ad-filtering/create-own-filters#cosmetic-css-rules)、 [CSSセレクター](/general/ad-filtering/create-own-filters#extended-css-selectors)、 [scriptlets](/general/ad-filtering/create-own-filters#scriptlets)などといった効果的な広告対策武器を使用できます。 複雑なケース(YouTubeのプリロール広告など)を扱う場合、こうした手段は絶対に代用できません。 +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard の Safari Web 拡張機能は、これらのタイプのフィルタリングルールの適用を可能にすることで、AdGuard for iOS を補完します。 さらに、AdGuard の Safari Web 拡張機能は、ブラウザからiOS用AdGuardの管理を可能にします。 Safariで*拡張機能*ボタンをタップします。これはジグソー🧩アイコンのボタンで、デバイスの種類に応じて、アドレスバーの左側または右側に配置されている場合があります。 一覧で **AdGuard** を見つけてタップします。 ![ウェブ拡張機能メニュー *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_ja.png?1) -> iPadでは、ブラウザのアドレスバーにあるAdGuardアイコンをタップすることで、AdGuardのSafariウェブ拡張機能に直接アクセスできます。 + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. 以下のオプションのリストが表示されます: @@ -56,7 +57,7 @@ AdGuard の Safari Web 拡張機能は、これらのタイプのフィルタリ ### Safari を使った手順 -SafariからWeb機能拡張を有効にすることもできます。 Safarアドレスバーの横の*拡張機能ボタン*(🧩)をタップします。(見つからない場合は、アドレスバーの横の「`ぁあ`」アイコンをタップします。 +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![Safariでぁあアイコンをタップ *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_ja.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index 470bfc89bdc..1f58b593671 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ Safari拡張機能は、Safariウェブブラウザで機能を追加する小 ## 「AdGuard for Safari」拡張機能 -「*AdGuard for Safari*」という拡張機能は検索バーの横にあるAdGuardアイコンを有効にします。 特定のウェブサイトに対して広告ブロックを素早くオン・オフにしたい場合や、手動で広告をブロックしたい場合に便利です。 また、Safariがサポートするフォーマットに変換できない高度なルールもこの拡張機能に含まれています。 高度なルールにはCSSルール、CSSセレクタ、scriptletsが含まれ、これらのおかげでAdGuardは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. ## Safariの拡張機能を管理する方法 -1. Safariを開き、画面左上の *Safari* をクリックしてメニューを展開します。 ![Safari設定 *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) -1. *環境設定...*をクリックします。 -1. 🧩「*拡張機能*」タブを選択します。 ![拡張機能タブ](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) +1. Safariを開き、画面左上の *Safari* をクリックしてメニューを展開します。 + + ![Safari設定 *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + +1. Click *Settings...* + +1. 🧩「*拡張機能*」タブを選択します。 + + ![拡張機能タブ](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## AdGuard for Safari にアクセス権限が必要な理由 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 50a0b1ff7e4..f40516a0eaa 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ sidebar_position: 3 ::: -AdGuard は[ユーザースクリプトマネージャ](/general/extensions)として、ウェブサイトの機能を大幅に拡張することができます。 AdGuard のユーザーは、独自のスクリプトを追加したり、既存のスクリプトを管理したりできます。 +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![拡張機能画面 \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 bb4cbe0435e..3304fedfa1a 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/ja/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0796b1e1a17 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: 拡張機能 +sidebar_position: 6 +--- + +## ユーザースクリプト + +ユーザースクリプト(私たちは "エクステンション"とも呼んでいます)は、事実上、JavaScriptで書かれたミニプログラムです。 ユーザースクリプトは1つまたは複数のウェブサイトの機能を変更または拡張します。 AdGuardユーザーの多くは、「AdGuard アシスタント」「ポップアップブロッカー」「AdGuard Extra」などのユーザースクリプトをすでにご存知かもしれません。 + +:::note Supported apps + +AdGuard はユーザースクリプトマネージャとして、ウェブサイトの機能を大幅に拡張することができます。 You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### お勧めのAdGuardスクリプト + +これらのユーザースクリプトはAdGuardの開発者から直接提供されたもので、効果的で安全です。 For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +通常のフィルタベースアプローチでは不十分な場合に、広告をブロックしてくれる拡張機能。 AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. ただし、AdGuard ブラウザ拡張機能やその他の広告ブロッカーと一緒に使用したい場合は、追加の拡張機能を使用する必要があります。 Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard ポップアップブロッカー + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard アシスタント (レガシー版) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### AMPを無効化 + +Android版AdGuardにのみプリインストールされているスクリプト。 Google 検索結果ページで AMP (Accelerated Mobile Pages) を無効にします。 Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### AdGuard以外でおすすめのスクリプト + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +このスクリプトは、Googleの検索結果のリンクからGoogleのトラッキング機能を削除します。 検索結果の読み込みを高速化し、右クリックやタップでリンクURLをコピーできるようにします。 + +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 + +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). + +### さらに多くのユーザースクリプトはどこで入手できますか? + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. 未知のソースからのスクリプトは、潜在的なリスクを伴います。 しかし、注意深く責任を持ってインストールすれば、ウェブサイトの利用をより便利にしてくれる興味深いスクリプトは実に多種多様です。 + +以下で、最も人気なユーザースクリプト・カタログのいくつかをご紹介します。 + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### コミュニティ + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### 開発者向け + +#### AdGuardライセンスをリクエストする + +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. + +ご希望の方は、以下の情報を明記の上、devteam@adguard.com にご連絡ください: + +**Subject:** Userscript author license request + +**Body:** Please tell us about the userscripts you are working on. + +Here is a [mailto link](mailto:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### 互換性 + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +これらのプロパティは、AdGuardによって無視されます: + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard は、古い GM\_ 関数と、GM オブジェクトを使用する新しい GM4 API の両方をサポートしています。 + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## ユーザースタイル + +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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link Address_ + +3. Open AdGuard settings → _Extensions_ + +4. Press the [+] button and paste the userstyle link + +5. 完了です! + +If you’re familiar with CSS rules, you can also create the userstyles yourself. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/ja/docusaurus-plugin-content-docs/current/general/how-to-install.md index 4010c6b3c25..32a20cc559a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: AdGuard のインストール方法 -sidebar_position: 8 +sidebar_position: 9 --- インストールしたいAdGuardアプリ・ブラウザ拡張機能に応じて、以下のリンクから関連記事をご覧ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/ja/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index 61c9d718c21..9d711226450 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ sidebar_position: 3 ::: -iOS 15에서 Apple은 Safari 웹 확장 프로그램에 대한 지원을 추가했으며, 이에 따라 iOS용 AdGuard에 새로운 **고급 보호** 모듈을 추가했습니다. 이를 통해 AdGuard는 CSS 규칙, CSS 선택기 및 스크립틀릿과 같은 고급 필터링 규칙을 적용하여 YouTube 광고와 같은 복잡한 광고도 처리할 수 있습니다. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![고급 보호 화면 \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index a4c4e3dcc0d..a2e177f20b2 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard의 Safari 웹 확장 프로그램은 iOS 15의 새로운 기능을 활 ## AdGuard Safari 웹 확장 프로그램의 기능 -기본적으로 Safari는 콘텐츠 차단 기능에 기본 도구만 제공합니다. 이러한 도구는 다른 운영 체제(Windows, Mac, Android)의 콘텐츠 차단 프로그램에서 볼 수 있는 수준의 성능을 제공하지 않습니다. 예를 들어, 다른 플랫폼의 AdGuard 앱은 [CSS 규칙](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS 선택기](/general/ad-filtering/create-own-filters#extended-css-selectors) 및 [스크립틀릿(scriptlets)](/general/ad-filtering/create-own-filters#scriptlets)과 같은 효과적인 도구를 사용하여 광고를 차단할 수 있습니다. 안타깝게도 이러한 도구는 YouTube의 프리롤 광고와 같은 더 복잡한 경우를 처리할 때 절대적으로 필요합니다. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. Safari용 AdGuard 웹 확장 프로그램은 이러한 모든 유형의 필터링 규칙을 적용할 수 있는 기능을 제공함으로써 AdGuard를 보완합니다. 그 외에도 AdGuard의 Safari 웹 확장 프로그램을 사용하면 브라우저에서 바로 iOS용 AdGuard를 빠르게 관리할 수 있습니다. *확장 프로그램* 버튼(직소 아이콘이 있는 버튼)을 탭합니다. 기기 유형에 따라 주소창 왼쪽 또는 오른쪽에 위치할 수 있습니다. 목록에서 **AdGuard**를 찾아서 탭합니다. ![웹 확장 프로그램 메뉴 *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> iPad의 경우 브라우저의 주소 표시줄에서 AdGuard 아이콘을 탭하여 AdGuard의 Safari 웹 확장 프로그램에 바로 액세스할 수 있습니다. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. 다음과 같은 옵션 목록이 표시됩니다. @@ -56,7 +57,7 @@ AdGuard의 Safari 웹 확장 프로그램은 작동을 위해 웹페이지의 ### Safari -또는 Safari 브라우저에서 AdGuard 확장 프로그램을 켤 수도 있습니다. *확장 프로그램* 버튼을 탭합니다(주소 표시줄 옆에 표시되지 않으면 `aA` 아이콘을 탭함). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![Safari에서 aA 아이콘을 탭하기 *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index b8d492914bf..3a30b09856a 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ Safari 확장 프로그램은 Safari 웹 브라우저에 기능을 추가하는 ## Safari용 AdGuard -*Safari용 AdGuard* 검색창 옆에 있는 AdGuard 아이콘을 활성화합니다. 특정 웹사이트에 대한 보호 기능을 빠르게 설정하거나 수동으로 광고를 차단하려는 경우 유용합니다. 또한 Safari에서 지원되지 않는 형식으로 변환되지 않는 고급 규칙도 포함되어 있습니다. 고급 규칙에는 복잡한 광고(예: YouTube 광고)를 차단할 수 있는 CSS 규칙, CSS 선택기 및 스크립틀릿이 포함되어 있습니다. +*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. ## Safari용 확장 프로그램 관리 방법 -1. Safari를 열고 화면 왼쪽 상단 모서리에 있는 *Safari*를 클릭하여 메뉴를 확장합니다. ![Safari 설정 *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) -1. *설정...*을 클릭합니다. -1. *확장 프로그램*을 선택합니다. ![확장 프로그램 탭](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) +1. Safari를 열고 화면 왼쪽 상단 모서리에 있는 *Safari*를 클릭하여 메뉴를 확장합니다. + + ![Safari 설정 *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + +1. Click *Settings...* + +1. *확장 프로그램*을 선택합니다. + + ![확장 프로그램 탭](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Safari용 AdGuard에 권한이 필요한 이유 diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 32776dd1894..26b9311f874 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ sidebar_position: 3 ::: -AdGuard는 [유저스크립트 관리자](/general/extensions) 역할을 수행하여 웹사이트 기능을 크게 확장할 수 있습니다. AdGuard 사용자는 자체 스크립트를 추가할 수 있을 뿐만 아니라 기존 스크립트를 관리할 수도 있습니다. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![확장 프로그램 \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 c3f1ee6640a..2123b303202 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/ko/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..b1d4fb148c9 --- /dev/null +++ b/i18n/ko/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: 확장 프로그램 +sidebar_position: 6 +--- + +## 유저스크립트 + +유저스크립트('확장 프로그램'이라고도 함)는 사실상 자바스크립트로 작성된 미니 프로그램입니다. 하나 이상의 웹사이트의 기능을 수정하거나 확장합니다. 많은 AdGuard 사용자는 이미 AdGuard 어시스턴트, 팝업 차단기 및 AdGuard Extra와 같은 유저스크립트에 익숙할 것입니다. + +:::note Supported apps + +AdGuard는 유저스크립트 관리자 역할을 수행하여 웹사이트 기능을 크게 확장할 수 있습니다. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### 권장 AdGuard 스크립트 + +이러한 유저스크립트는 AdGuard에서 개발되었습니다. 효과적이고 안전하게 작동한다는 것을 보장할 수 있습니다. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +일반적인 필터 기반 접근 방식으로는 충분하지 않은 어려운 경우에 광고를 차단하는 확장 프로그램입니다. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. 하지만 AdGuard 브라우저 확장 프로그램이나 다른 광고 차단기와 함께 사용하려면 추가 확장 프로그램을 사용해야 합니다. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard 팝업 차단기 + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard 어시스턴트(이전 버전) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### AMP 비활성화 + +Android용 AdGuard에만 사전 설치된 스크립트입니다. Google 검색 결과 페이지에서 AMP(가속화된 모바일 페이지)를 비활성화합니다. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### AdGuard 외부에서 추천하는 제품{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +이 스크립트는 Google 검색 결과의 링크에서 Google의 추적 기능을 제거합니다. 검색 결과 로딩 속도가 빨라지고 마우스 오른쪽 버튼을 클릭하거나 탭하여 링크 URL을 복사할 수 있습니다. + +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 + +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). + +### 더 많은 유저스크립트는 어디서 구할 수 있나요?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. 출처를 알 수 없는 스크립트는 잠재적인 위험을 수반합니다. 하지만 신중하게 설치하면 일부 웹사이트를 더 편리하게 사용할 수 있는 흥미로운 스크립트가 많이 있습니다. + +아래에서 가장 인기 있는 일부 유저스크립트 카탈로그에 대해 설명합니다. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### 커뮤니티 + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### 개발 + +#### 라이선스 요청 + +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. + +라이선스 키를 받으려면 다음 정보를 포함하여 devteam@adguard.com으로 이메일을 보내주십시오. + +**Subject:** Userscript author license request + +**Body:** Please tell us about the userscripts you are working on. + +Here is a [mailto link](mailto:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### 호환성 + +#### 메타데이터 블록 + +#### 지원되는 속성 + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### 지원되지 않는 속성 + +이러한 속성은 AdGuard에서 무시됩니다. + +```text +@unwrap +``` + +#### 지원되는 GM 기능 + +AdGuard는 기존 GM\_ 기능과 GM 개체를 사용하는 새로운 GM4 API를 모두 지원합니다. + +#### 값 + +:::note + +나열된 모든 이전 Greasemonkey 기능은 더 이상 사용되지 않지만 여전히 지원됩니다. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name 로캘이 영어이거나 알 수 없는 경우 사용자에게 표시되는 이름 +// @name:ru 로캘이 러시아어일 때 사용자에게 표시되는 이름 +// @description 로캘이 영어이거나 알 수 없는 경우 사용자에게 표시되는 설명 +// @description:ru 로캘이 러시아어일 때 사용자에게 표시되는 설명 +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant 속성:설정 +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 유저스타일 + +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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link Address_ + +3. Open AdGuard settings → _Extensions_ + +4. Press the [+] button and paste the userstyle link + +5. 끝! + +If you’re familiar with CSS rules, you can also create the userstyles yourself. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/ko/docusaurus-plugin-content-docs/current/general/how-to-install.md index b842f3b982c..b4472bdfa94 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: AdGuard를 설치하는 방법 -sidebar_position: 8 +sidebar_position: 9 --- 설치하려는 AdGuard 앱 또는 확장 프로그램에 따라 다음 링크 중 하나를 클릭하여 관련 지침을 따르세요. diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/ko/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index d47b6e0338c..dd0931dc56d 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: 'HTTPS 필터링: 알려진 문제' sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -마지막 업데이트: 2022년 9월 20일 +Last update: September 17, 2024 이 글을 읽으려면 암호화, TLS 및 HTTPS에 대한 기본적인 지식이 필요할 수 있습니다. @@ -30,7 +32,38 @@ AdGuard의 HTTPS 필터링에는 단점이 있지만, 이미 이에 대한 업 HTTPS 필터링을 사용하는 경우, 웹사이트에서 사용하는 실제 인증서가 숨겨집니다. 실제 인증서를 확인할 수 없으며 AdGuard에서 발급한 인증서만 볼 수 있습니다. -이 문제는 [브라우저 어시스턴트](https://adguard.com/adguard-assistant/overview.html)에서 해결할 수 있습니다. 어시스턴트를 사용하면 브라우저에서 바로 필터링을 관리하고 모든 웹사이트의 원본 인증서를 확인할 수 있습니다. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### 인증서 투명성(Certificate Transparency) diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/nl/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/nl/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/nl/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/nl/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/no/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/no/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/no/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/no/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/no/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/no/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/no/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/pl/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/pl/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/pl/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/pl/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index 09e40e17417..88e0c7cc22e 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ Este artigo é sobre o AdGuard para iOS, um bloqueador de anúncios multifuncion ::: -No iOS 15, a Apple adicionou suporte para Safari Web Extensions e, por sua vez, adicionamos um novo módulo _Proteção avançada_ ao AdGuard para iOS. Ele permite que o AdGuard aplique regras avançadas de filtragem, como regras CSS, seletores CSS e scriptlets, e, portanto, lide até mesmo com anúncios complexos, como anúncios do YouTube. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Tela de proteção avançada \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index ac00f67f96f..4ddfbf41f93 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ A extensão para Safari do AdGuard é uma ferramenta que aproveita os novos recu ## O que ele faz -Por padrão, o Safari fornece apenas ferramentas básicas para bloqueadores de conteúdo. Essas ferramentas não permitem o nível de desempenho encontrado em bloqueadores de conteúdo em outros sistemas operacionais (Windows, Mac, Android). Por exemplo, os aplicativos AdGuard em outras plataformas podem usar armas eficazes contra anúncios, como [regras CSS](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [seletores CSS](/general/ad-filtering/create-own-filters#extended-css-selectors) e [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Infelizmente, esses instrumentos são absolutamente necessários quando se trata de casos mais complexos, como anúncios pre-roll no YouTube, por exemplo. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. A extensão para Safari do AdGuard é um complemento ao AdGuard, dando-lhe a capacidade de empregar esses tipos de regras de filtragem. Além disso, a extensão Safari Web do AdGuard pode ser usada para gerenciar rapidamente o AdGuard para iOS diretamente do navegador. Toque no botão *Extensões* (o ícone de quebra-cabeça). Dependendo do tipo de dispositivo, ele pode estar localizado à esquerda ou à direita da barra de endereço. Encontre o **AdGuard** na lista e toque nele. ![Menu da extensão Web *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> Em iPads, a extensão Safari Web do AdGuard pode ser acessada diretamente tocando no ícone do AdGuard na barra de endereço do navegador. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. Você verá a seguinte lista de opções: @@ -56,7 +57,7 @@ Toque nele e ative o interruptor. Na mesma tela, defina a permissão *Todos os s ### No Safari -Como alternativa, você também pode ativar a extensão AdGuard no navegador Safari. Toque no botão *Extensões* (se você não o vir próximo à barra de endereço, toque no ícone `aA`). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![No Safari, toque no ícone A *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index b9987463ebd..60c2e0ff75c 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ Regras de usuário e regras de lista de permissões estão incluídas em todas a ## AdGuard para Safari -*AdGuard para Safari* ativa o ícone do AdGuard próximo à barra de pesquisa. Pode ser útil se você desejar configurar rapidamente a proteção em um site específico ou bloquear anúncios manualmente. Ele também contém regras avançadas que não são convertidas para o formato suportado pelo Safari. Isso inclui regras CSS, seletores CSS e scriptlets que permitem ao AdGuard bloquear anúncios complexos, como no YouTube, por exemplo. +*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. ## Como gerenciar as extensões do Safari -1. Abra o Safari e clique em *Safari* no canto superior esquerdo da tela para expandir o menu. ![Configurações do Safari *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) -1. Clique em *Configurações...* -1. Selecione *Extensões*. ![Aba Extensões](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) +1. Abra o Safari e clique em *Safari* no canto superior esquerdo da tela para expandir o menu. + + ![Configurações do Safari *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + +1. Click *Settings...* + +1. Selecione *Extensões*. + + ![Aba Extensões](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Por que o AdGuard para Safari requer permissões diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index f167a43dd1b..261ade100c1 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ Este artigo aborda o AdGuard para Windows, um bloqueador de anúncios multifunci ::: -O AdGuard pode ampliar significativamente a funcionalidade de um site funcionando como um [gerenciador de scripts de usuário](/general/extensions). Os usuários do AdGuard podem adicionar seus próprios scripts, bem como gerenciar os existentes. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensões \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 0f13b080933..ded2de5f8f5 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..1d09d9f24a9 --- /dev/null +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensões +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (também chamados de "extensões") são, na verdade, miniprogramas escritos em JavaScript. Eles modificam ou ampliam a funcionalidade de um ou mais websites. Muitos usuários do AdGuard já podem estar familiarizados com scripts de usuário como o Assistente AdGuard, o Bloqueador de pop-ups e o AdGuard Extra. + +:::note Supported apps + +O AdGuard pode ampliar significativamente a funcionalidade de sites, agindo como um gerenciador de userscripts. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Scripts recomendados do AdGuard + +Esses scripts de usuário vêm diretamente dos desenvolvedores do AdGuard e podemos garantir que são eficazes e seguros. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +Uma extensão que bloqueia anúncios em casos difíceis, quando a abordagem usual baseada em filtros não é suficiente. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. No entanto, se quiser usá-lo junto com a extensão do navegador AdGuard ou qualquer outro bloqueador de anúncios, você precisará usar uma extensão adicional. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### Bloqueador de pop-ups do AdGuard + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### Assistente AdGuard (versão antiga) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Desativar AMP + +Um script pré-instalado apenas no AdGuard para Android. Ele desativa o AMP (Accelerated Mobile Pages) na página de resultados de pesquisa do Google. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Principais opções fora do AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +Este script remove o recurso de rastreamento do Google dos links nos resultados de pesquisa do Google. Ele acelera o carregamento dos resultados da pesquisa e permite clicar com o botão direito ou tocar para copiar o link do URL. + +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 + +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). + +### Onde obter mais userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Qualquer script de fonte desconhecida acarreta um risco potencial. No entanto, há uma grande variedade de scripts interessantes que, se instalados com cuidado e responsabilidade, podem realmente tornar o uso de alguns sites mais conveniente. + +Aqui descreveremos alguns dos catálogos de userscript mais populares. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Comunidade + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Desenvolvimento + +#### Solicitar licença + +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. + +Para obtê-la, envie um email para devteam@adguard.com com as seguintes informações: + +**Subject:** Userscript author license request + +**Body:** Please tell us about the userscripts you are working on. + +Here is a [mailto link](mailto:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibilidade + +#### Bloqueio de metadados + +#### Propriedades compatíveis + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Propriedades não compatíveis + +Essas propriedades serão simplesmente ignoradas pelo AdGuard. + +```text +@unwrap +``` + +#### Funções GM compatíveis + +O AdGuard oferece suporte às antigas funções GM\_ e à nova API GM4 que usa o objeto GM. + +#### Valores + +:::note + +Todas as funções antigas do Greasemonkey listadas estão obsoletas, mas ainda são suportadas. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Exemplo + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link Address_ + +3. Open AdGuard settings → _Extensions_ + +4. Press the [+] button and paste the userstyle link + +5. Pronto! + +If you’re familiar with CSS rules, you can also create the userstyles yourself. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Exemplo + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/how-to-install.md index a519528cd4e..e7e6b5e31b6 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index ed29d93393d..6671133664c 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Problemas conhecidos sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Última atualização: 20 de setembro de 2022 +Last update: September 17, 2024 Entender este artigo pode exigir algum conhecimento básico sobre criptografia, TLS e HTTPS. @@ -30,7 +32,38 @@ Todos os problemas que conhecemos e as estimativas de suas correções estão li A desvantagem mais importante do mecanismo de filtragem HTTPS é que ele oculta o certificado real de um site. Você não pode simplesmente verificar o certificado original porque só pode ver o emitido pelo AdGuard. -Este problema é resolvido no [Assistente do navegador](https://adguard.com/adguard-assistant/overview.html). Esta extensão do navegador ajuda você a gerenciar a filtragem diretamente do navegador e permite que você inspecione o certificado original de qualquer site. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Transparência do Certificado diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index 5effcb063d1..c905cddb65f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 148c96e1679..bfe88077574 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ Este artigo aborda o AdGuard para Windows, um bloqueador de anúncios multifunci ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 d43172a8163..6654db92683 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/pt/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/pt/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/pt/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/pt/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/ro/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/ro/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/ro/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/ro/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/app-management.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/app-management.md index e2586187ed8..f6c0d154098 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/app-management.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/app-management.md @@ -24,7 +24,7 @@ sidebar_position: 2 Из контекстного меню вы также можете попасть в статистику приложения. -![App management in Chrome. Контекстное меню \*mobile\_border](https://cdn.adtidy.org/blog/new/4z85achome_management_context_menu.png) +![Управление приложениями: Chrome. Контекстное меню \*mobile\_border](https://cdn.adtidy.org/blog/new/4z85achome_management_context_menu.png) ### Непроблемные и проблемные приложения diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/assistant.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/assistant.md index 7883b400a05..ca97d61991e 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/assistant.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/assistant.md @@ -38,7 +38,7 @@ sidebar_position: 5 Вы перейдёте в приложение AdGuard, где увидите подробную информацию о последних 10 тысячах запросов, сделанных Chrome. -![App recent activity \*mobile\_border](https://cdn.adtidy.org/blog/new/66hpechrome-recent-activity.png) +![Недавняя активность в приложении \*mobile\_border](https://cdn.adtidy.org/blog/new/66hpechrome-recent-activity.png) #### Статистика приложения diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/free-vs-full.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/free-vs-full.mdx index 595aaf0ff8f..ec09e6143b2 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/free-vs-full.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/free-vs-full.mdx @@ -13,7 +13,7 @@ sidebar_position: 6 Есть бесплатная и платная версии AdGuard для Android. Платные функции расширяют возможности AdGuard: -- _Ad blocking in apps_ allows you to block ads in non-browser apps. You can specify apps for filtering in [_App management_](/adguard-for-android/features/app-management) +- _Блокировка рекламы в приложениях_ позволяет блокировать рекламу в небраузерных приложениях. Вы можете указать приложения для фильтрации в разделе [*Управление приложениями*] (/adguard-for-android/features/app-management) :::note @@ -21,12 +21,12 @@ AdGuard блокирует рекламу на YouTube помощью собст ::: -- _Tracking protection_ increases your privacy by blocking tracking requests, online counters, UTM tags, analytics systems, and more. [More about Tracking protection](/adguard-for-android/features/protection/tracking-protection) +- _Защита от трекинга_ защищает данные, блокируя отслеживающие запросы, онлайн-счётчики, UTM-метки и системы аналитики. [Подробнее о защите от трекинга](/adguard-for-android/features/protection/tracking-protection) -- _Browsing security_ warns you if you're about to visit a potentially dangerous website. [More about Browsing security](/adguard-for-android/features/protection/browsing-security) +- _Browsing security_ warns you if you're about to visit a potentially dangerous website. [Подробнее о защите от фишинга](/adguard-for-android/features/protection/browsing-security) -- _Custom filters and user rules_ allow you to add your own filtering rules and third-party filters to fine-tune ad blocking. [More about filters](/adguard-for-android/features/settings#filters) +- _Собственные фильтры и правила_ позволяют добавлять свои правила фильтрации и сторонние фильтры для более точной настройки блокировки рекламы. [Подробнее о фильтрах](/adguard-for-android/features/settings#filters) -- _Userscripts_ allow you to extend the functionality of the browser and use [AdGuard Extra](/adguard-for-android/features/settings#adguard-extra) that prevents ad reinjection. [More about userscripts](/adguard-for-android/features/settings#userscripts) +- _Пользовательские скрипты_ позволяют расширить функциональность браузера и использовать [AdGuard Extra](/adguard-for-android/features/settings#adguard-extra), который предотвращает повторное внедрение рекламы. [Подробнее о пользовательских скриптах](/adguard-for-android/features/settings#userscripts) -You can get access to these features by [purchasing a license](https://adguard.com/license.html). [How to activate a license](/general/license/activation/#activating-adguard-for-android) +Вы можете получить доступ к этим функциям, [купив лицензию](https://adguard.com/license.html). [Как активировать лицензию](/general/license/activation/#activating-adguard-for-android) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/integration-with-vpn.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/integration-with-vpn.md index 675fdc953e6..4237ff6533f 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/integration-with-vpn.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/integration-with-vpn.md @@ -9,10 +9,10 @@ sidebar_position: 8 ::: -AdGuard для Android создает локальный VPN для фильтрации трафика. Получается, другие VPN-приложения нельзя использовать, пока работает AdGuard для Android. However, both AdGuard and [AdGuard VPN](https://adguard-vpn.com/) apps have Integrated modes that let you use them together. +AdGuard для Android создает локальный VPN для фильтрации трафика. Получается, другие VPN-приложения нельзя использовать, пока работает AdGuard для Android. Но в приложениях AdGuard и [AdGuard VPN](https://adguard-vpn.com/) есть Режим интеграции, который позволяет использовать их вместе. В этом режиме AdGuard VPN выступает в роли исходящего прокси-сервера, через который AdGuard направляет свой трафик. Это позволяет AdGuard создавать VPN-интерфейс и блокировать рекламу и трекеры локально, а AdGuard VPN направляет весь трафик через удалённый сервер. Если вы отключите AdGuard VPN, AdGuard перестанет использовать его в качестве исходящего прокси. Если вы отключите AdGuard, AdGuard VPN будет маршрутизировать трафик через собственный VPN-интерфейс. -If you have AdGuard Ad Blocker and install AdGuard VPN, the Ad Blocker app will detect it and enable _Integration with AdGuard VPN_ automatically. Это работает и наоборот. Обратите внимание, что при включённой интеграции вы не сможете управлять исключениями приложений и подключаться к DNS-серверам из приложения AdGuard VPN. Вы можете указать приложения, которые будут маршрутизироваться через VPN-туннель, через _Настройки_ → _Фильтрация_ → _Сеть_ → _Прокси_ → _Приложения, работающие через прокси_. Чтобы выбрать DNS-сервер, откройте AdGuard → _Защита_ → _DNS-защита_ → _DNS-сервер_. +Если на устройство с AdGuard вы установили AdGuard VPN, Блокировщик обнаружит VPN-приложение и автоматически включит _Интеграцию с AdGuard VPN_. Это работает и наоборот. Обратите внимание, что при включённой интеграции вы не сможете управлять исключениями приложений и подключаться к DNS-серверам из приложения AdGuard VPN. Вы можете указать приложения, которые будут маршрутизироваться через VPN-туннель, через _Настройки_ → _Фильтрация_ → _Сеть_ → _Прокси_ → _Приложения, работающие через прокси_. Чтобы выбрать DNS-сервер, откройте AdGuard → _Защита_ → _DNS-защита_ → _DNS-сервер_. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/statistics.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/statistics.md index 044419a8d68..8b2a1fe3adf 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/statistics.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/features/statistics.md @@ -11,17 +11,17 @@ sidebar_position: 3 Модуль _Статистика_ можно открыть, нажав на вкладку _Статистика_ (четвёртая иконка слева в нижней части экрана). Статистика помогает увидеть полную картину того, что происходит с трафиком на вашем устройстве: сколько запросов отправляется и в какие компании, сколько данных загружается и скачивается, какие запросы блокируются и многое другое. Вы можете выбрать отображение статистики за период времени: 24 часа, 7 дней, 30 дней или за всё время. -![Statistics \*mobile\_border](https://cdn.adtidy.org/blog/new/czy5rStatistics.jpeg?mw=1360) +![Статистика \*mobile\_border](https://cdn.adtidy.org/blog/new/czy5rStatistics.jpeg?mw=1360) Статистика разбита на несколько разделов. ### Запросы -This section shows the number of blocked ads, trackers, and the total number of requests. You can filter requests by data type: mobile data, Wi-Fi, or all data combined. +В этом разделе показано количество заблокированной рекламы, трекеров и общее количество запросов. Можно отфильтровать запросы по типу данных: мобильные данные, Wi-Fi или все данные вместе. -_Recent activity_, formerly known as _Filtering log_, shows the last 10,000 requests processed by AdGuard. Tap three-dots menu (⋮) and then _Customize_ to filter requests by status (_regular_, _blocked_, _modified_, or _allowlisted_) or origin (_first-party_ or _third-party_). +_Недавняя активность_, ранее известная как _Журнал фильтрации_, показывает последние 10 000 запросов, обработанных AdGuard. Нажмите на меню (⋮), а затем _Настроить_, чтобы отфильтровать запросы по статусу (_обычные_, _заблокированные_, _изменённые_ или _в белом списке_) или происхождению (_собственные_ или _сторонние_). -You can tap a request to view its details and add a blocking or unblocking rule in one tap. +Нажмите на запрос, чтобы просмотреть сведения о нём и добавить правило блокировки или разблокировки одним касанием. ### Использование данных @@ -31,20 +31,20 @@ This section shows the amount of downloaded and uploaded data and saved traffic Здесь отображается статистика по всем приложениям, установленным на вашем устройстве. Вы можете сортировать приложения по количеству заблокированной рекламы или трекеров или по количеству отправленных запросов. -Tap _View all apps_ to expand the list of your apps, sorted by the number of ads, trackers, or requests. +Нажмите _Показать все_, чтобы развернуть список ваших приложений, ранжированный по количеству рекламы, трекеров или запросов. -![List of apps \*mobile\_border](https://cdn.adtidy.org/blog/new/toq0mkScreenshot_20230627-235219_AdGuard.jpg) +![Список приложений \*mobile\_border](https://cdn.adtidy.org/blog/new/toq0mkScreenshot_20230627-235219_AdGuard.jpg) При нажатии на приложение можно увидеть его полную статистику: количество отправленных запросов, домены и компании, к которым оно обращается. ### Компании -В этом разделе отображаются компании, с которыми связывается ваше устройство. Что это значит? AdGuard обнаруживает домены, на которые ваше устройство отправляет запросы, и определяет, каким компаниям они принадлежат. A database of companies can be found on [GitHub](https://github.com/AdguardTeam/companiesdb). +В этом разделе отображаются компании, с которыми связывается ваше устройство. Что это значит? AdGuard обнаруживает домены, на которые ваше устройство отправляет запросы, и определяет, каким компаниям они принадлежат. Базу данных компаний можно найти [на GitHub](https://github.com/AdguardTeam/companiesdb). ### DNS-статистика -This section shows data about the requests handled by _DNS protection_. Общее количество отправленных и заблокированных AdGuard запросов вы можете увидеть в цифрах и графиках. You'll also find statistics on the amount of traffic saved and data downloaded and uploaded. +В этом разделе показаны данные о запросах, обработанных _DNS-защитой_. Общее количество отправленных и заблокированных AdGuard запросов вы можете увидеть в цифрах и графиках. Здесь вы также найдете статистику по объёму сохранённого трафика, а также скачанных и загруженных данных. ### Использование батареи -В этом разделе представлена статистика использования ресурсов устройства AdGuard за последние 24 часа. The data may differ from the stats displayed in your device settings. This happens because the system attributes the traffic of all filtered apps to AdGuard. Устройство показывает, что AdGuard потребляет больше ресурсов, чем есть на самом деле. [Read more about battery and traffic consumption issues](/adguard-for-android/solving-problems/battery/). +В этом разделе представлена статистика использования ресурсов устройства AdGuard за последние 24 часа. Данные могут отличаться от статистики, отображаемой в настройках вашего устройства. Это происходит потому, что система приписывает AdGuard трафик всех фильтруемых приложений. Устройство показывает, что AdGuard потребляет больше ресурсов, чем есть на самом деле. [Подробнее о проблемах с расходом заряда батареи и трафика](/adguard-for-android/solving-problems/battery/). diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/extending-restricted-settings.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/extending-restricted-settings.md index 0843ffae3e7..0965f946e17 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/extending-restricted-settings.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/extending-restricted-settings.md @@ -1,5 +1,5 @@ --- -title: Problems caused by extending restricted settings +title: Проблемы, вызванные расширением ограниченных настроек sidebar_position: 18 --- @@ -9,28 +9,28 @@ sidebar_position: 18 ::: -In an effort to improve user privacy, Google has expanded the restriction settings in Android 15. More settings, such as _App usage access_, now require an additional permission to be enabled. Since the _[Firewall](/adguard-for-android/features/protection/firewall)_ and _[Detect Samsung Pay](/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea)_ features require the _App usage access_ setting to be enabled for them to work properly, you may have experienced problems using them. To resolve these issues, please follow the steps below: +Стремясь повысить уровень конфиденциальности пользователей, Google расширила настройки ограничений в Android 15. Теперь для включения дополнительных настроек, таких как _Доступ к использованию приложений_, требуется дополнительное разрешение. Поскольку функции _[Фаервол](/adguard-for-android/features/protection/firewall)_ и _[Обнаружение Samsung Pay](/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea)_ требуют включения настройки _Доступ к использованию приложений_ для их правильной работы, у вас могли возникнуть проблемы с их использованием. Чтобы решить эти проблемы, выполните следующие действия: :::note -AdGuard придерживается строгой политики без логов, что означает, что мы не собираем ваши данные и не передаём их третьим лицам. We only ask for access to data without which the application cannot function. +AdGuard придерживается строгой политики без логов, что означает, что мы не собираем ваши данные и не передаём их третьим лицам. Мы запрашиваем только доступ к тем данным, без которых приложение не может функционировать. ::: -1. On your Android device, open the **Settings app**. -2. Tap **Apps**. -3. Tap **AdGuard** +1. На вашем Android-устройстве откройте приложение **Настройки**. +2. Нажмите **Приложения**. +3. Нажмите **AdGuard** -![AdGuard in Apps \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/problems-caused-by-extending-restricted-settings/restricted1.png) +![AdGuard в приложениях \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/problems-caused-by-extending-restricted-settings/restricted1.png) -If you can't find it, first tap **See all apps** or **App info**. +Если вы не можете найти его, сначала нажмите **Просмотреть все приложения** или **Информация о приложении**. -1. Tap **More** (⁝) → _Allow restricted settings_. +1. Нажмите **Еще** (⁝) → _Разрешить ограниченные настройки_. -![Allow restricted settings \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/problems-caused-by-extending-restricted-settings/restricted2.png) +![Разрешить ограниченные настройки \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/problems-caused-by-extending-restricted-settings/restricted2.png) -Follow the on-screen instructions. +Следуйте инструкциям на экране. -All done! Now the _Firewall_ and _Detect Samsung Pay_ features will work correctly. +Готово! Теперь функции _Фаервол_ и _Обнаружение Samsung Pay_ будут работать корректно. -![Restricted settings allowed for AdGuard \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/problems-caused-by-extending-restricted-settings/restricted3.png) +![Ограниченные настройки разрешены для AdGuard \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/problems-caused-by-extending-restricted-settings/restricted3.png) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/har.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/har.md index cb4f828e3e1..6fd72d09029 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/har.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/har.md @@ -1,5 +1,5 @@ --- -title: How to generate HAR files +title: Как сгенерировать файлы HAR sidebar_position: 5 --- @@ -11,17 +11,17 @@ sidebar_position: 5 :::note -HAR files are processed in accordance with [the AdGuard Privacy Policy](https://adguard.com/en/privacy.html). +Файлы HAR обрабатываются в соответствии с [Политикой конфиденциальности AdGuard](https://adguard.com/ru/privacy.html). ::: ## Что такое файлы HAR? -Формат HAR (HTTP ARchive) представляет собой файл архива в формате JSON для протоколирования взаимодействия браузера с сайтом. The specifications of HAR format define archival data for HTTP transactions that a browser uses to export detailed information about the web pages it loads. Более подробное описание формата файла HAR и его характеристик вы можете найти на сайте [softwareishard.com](http://www.softwareishard.com/blog/har-12-spec/). +Формат HAR (HTTP ARchive) представляет собой файл архива в формате JSON для протоколирования взаимодействия браузера с сайтом. Технические характеристики формата HAR определяют архивные данные для транзакций HTTP, которые используются браузером для экспорта подробной информации о загружаемых веб-страницах. Более подробное описание формата файла HAR и его характеристик вы можете найти на сайте [softwareishard.com](http://www.softwareishard.com/blog/har-12-spec/). -## How to generate HAR files +## Как сгенерировать файлы HAR -Иногда нам нужно проанализировать данные файлы, чтобы заблокировать определённые объявления, которые по какой-то причине трудно воспроизвести. To get HAR files, follow these steps: +Иногда нам нужно проанализировать данные файлы, чтобы заблокировать определённые объявления, которые по какой-то причине трудно воспроизвести. Чтобы получить файлы HAR, выполните следующие действия: 1. Откройте AdGuard и перейдите в **Настройки** (значок ⚙ в правом нижнем углу). 2. Нажмите **Общие** →**Дополнительные** → **Низкоуровневые настройки**. @@ -31,7 +31,7 @@ HAR files are processed in accordance with [the AdGuard Privacy Policy](https:// 6. Вернитесь в раздел **Расширенные**. 7. Нажмите **Экспортировать логи и информацию о системе** → **Разрешить** (при необходимости) → **Сохранить**. -**Send the generated file with the logs to the AdGuard support service.** +**Отправьте сгенерированный файл с логами в поддержку AdGuard.** :::note diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/log.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/log.md index 215926ad7a9..4c9ee56b277 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/log.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/log.md @@ -1,5 +1,5 @@ --- -title: How to collect debug logs +title: Как получить отладочные логи AdGuard sidebar_position: 2 --- @@ -15,7 +15,7 @@ sidebar_position: 2 ::: -In this article, we'll guide you through the process of collecting debug logs, an essential troubleshooting step for solving complex issues that may potentially arise. Отладочные логи позволяют получить подробное представление о внутреннем устройстве AdGuard для Android. Если команда поддержки AdGuard попросит вас предоставить отладочные логи, просто следуйте этим инструкциям. +В этой статье мы расскажем вам о том, как собирать отладочные логи — важном этапе поиска неисправностей для решения сложных проблем, которые могут потенциально возникнуть. Отладочные логи позволяют получить подробное представление о внутреннем устройстве AdGuard для Android. Если команда поддержки AdGuard попросит вас предоставить отладочные логи, просто следуйте этим инструкциям. :::note @@ -25,7 +25,7 @@ AdGuard стремится защищать вашу конфиденциаль ### Запись отладочных логов -To collect **debug** log and send it to us, you need to perform following steps: +Чтобы собрать **отладочные** логи и отправить их нам, сделайте следующее: 1. Перейдите на страницу *Настройки* → *Основные* → *Расширенные*. 1. Выберите пункт *Уровень логирования* и установите его на *Записывать всё*. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/multiple-user-profiles.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/multiple-user-profiles.md index 61ee5e4482f..8bacda78e35 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/multiple-user-profiles.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/multiple-user-profiles.md @@ -51,7 +51,7 @@ If you try to reinstall AdGuard after an unsuccessful removal attempt, you will ::: -1. [Install and configure](https://www.xda-developers.com/install-adb-windows-macos-linux/) ADB; On the Windows platform, **Samsung** owners may need to install [this utility](https://developer.samsung.com/mobile/android-usb-driver.html). +1. [Установите и настройте](https://www.xda-developers.com/install-adb-windows-macos-linux/) ADB; На платформе Windows владельцам **Samsung** может потребоваться установить [эту утилиту](https://developer.samsung.com/mobile/android-usb-driver.html). 1. Подключите устройство с помощью кабеля USB **** к компьютеру или ноутбуку, на котором вы установили **ADB**; diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/tasker.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/tasker.md index a2b3d1f8829..88728aa48de 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/tasker.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/tasker.md @@ -126,7 +126,7 @@ sidebar_position: 3 ::: -**Don't forget to include the password, package name, and class. Это нужно делать для каждого интента.** +**Не забудьте указать пароль, имя приложения (package) и класс. Это нужно делать для каждого интента.** Extra: `password:*******` @@ -136,7 +136,7 @@ Class: `com.adguard.android.receiver.AutomationReceiver` :::note -До версии 4.0 класс назывался `com.adguard.android.receivers.AutomationReceiver`, но затем мы изменили его название на `com.adguard.android.receiver.AutomationReceiver`. If this function is used, remember to update to the new name. +До версии 4.0 класс назывался `com.adguard.android.receivers.AutomationReceiver`, но затем мы изменили его название на `com.adguard.android.receiver.AutomationReceiver`. Если используется эта функция, не забудьте обновить её название. ::: diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index a4607816b56..b902f6b736b 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ sidebar_position: 3 ::: -В iOS 15 Apple добавила поддержку веб-расширений для Safari, а мы, в свою очередь, добавили в AdGuard для iOS новый модуль _Расширенная защита_. Благодаря ему AdGuard может применять расширенные правила фильтрации, такие как CSS-правила, CSS-селекторы и скриптлеты, и тем самым способен бороться со сложной рекламой, такой как реклама на YouTube. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Экран расширенной защиты \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_ru.jpeg) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/features/dns-protection.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/features/dns-protection.md index c20958e6de0..975897bb874 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/features/dns-protection.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/features/dns-protection.md @@ -43,7 +43,7 @@ sidebar_position: 2 1. В AdGuard DNS перейдите в _Настройки сервера_ → _Устройства_ → _Настройки_ и измените DNS-сервер на сервер с аутентификацией. Если вы нажмёте _Запретить другие протоколы_, подключиться к вашему серверу через другие протоколы будет невозможно. Скопируйте сгенерированный адрес. -![DNS-over-HTTPS with authentication](https://cdn.adtidy.org/content/release_notes/dns/v2-7/http-auth/http-auth-en.png) +![DNS-over-HTTPS с аутентификацией](https://cdn.adtidy.org/content/release_notes/dns/v2-7/http-auth/http-auth-en.png) 1. В AdGuard для iOS перейдите на вкладку _Защита_ → _DNS-защита_ → _DNS-сервер_ и вставьте сгенерированный адрес в поле _Добавить пользовательский DNS-сервер_. Сохраните и выберите новую конфигурацию. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 3a13633cce2..6a000cc8da4 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ sidebar_position: 3 ## Что оно делает -По умолчанию, Safari предоставляет блокировщикам контента только базовые инструменты. Эти инструменты не позволяют добиться уровня блокировки, который доступен блокировщикам на других операционных системах (Windows, Mac, Android). Например, приложения AdGuard для других платформ могут использовать такие мощные средства борьбы против рекламы, как [CSS-правила](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS-селекторы](/general/ad-filtering/create-own-filters#extended-css-selectors) и [скриптлеты](/general/ad-filtering/create-own-filters#scriptlets). К сожалению, эти инструменты совершенно незаменимы при работе со сложной рекламой, такой как, например, видеореклама в YouTube. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. Веб-расширение AdGuard для Safari дополняет AdGuard, давая ему возможность применять все эти типы правил фильтрации. Помимо этого, веб-расширение AdGuard для Safari может быть использовано для управления приложением AdGuard для iOS прямо из браузера. Нажмите на кнопку *Расширения* — это иконка с пазлом, которая может быть расположена левее или правее адресной строки, в зависимости от типа вашего устройства. Найдите в списке расширений **AdGuard** и нажмите на него. ![Меню веб-расширения *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_ru.png) -> На устройствах iPad веб-расширение AdGuard для Safari доступно напрямую — просто нажмите на иконку AdGuard в адресной строке браузера. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. Вы увидите следующий список опций: @@ -56,7 +57,7 @@ sidebar_position: 3 ### В Safari -Вы также можете включить расширение AdGuard прямо в браузере Safari. Для этого нажмите кнопку *Расширения* (если рядом с адресной строкой нет кнопки Расширения, нажмите кнопку `aA`). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![В Safari коснитесь значка aA * mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_ru.png) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/dns.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/dns.md index fee08d56c98..8b9da3e88b6 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/dns.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/dns.md @@ -38,4 +38,4 @@ To export or import a blocklist, open the context menu. ### Белый список -Domains from this list aren’t filtered. To add a domain, click `+`. To export or import an allowlist, open the context menu. +Домены из этого списка не фильтруются. To add a domain, click `+`. To export or import an allowlist, open the context menu. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/general.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/general.md index 440a6188f07..1391d817b39 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/general.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/general.md @@ -29,7 +29,7 @@ This feature prevents AdGuard from blocking [search ads and self-promotions on w ### Launch AdGuard at login -This feature automatically launches AdGuard automatically after you restart your computer. This helps keep AdGuard protection active without having to manually open the app. +This feature automatically launches AdGuard automatically after you restart your computer. Это помогает поддерживать защиту AdGuard включённой без необходимости вручную открывать приложение. ### Скрыть иконку меню @@ -37,4 +37,4 @@ This feature hides AdGuard’s icon from the menu bar but keeps AdGuard running ### Белый список -Websites added to this list aren’t filtered. You can also access allowlisted websites from _User rules_. +Websites added to this list aren’t filtered. Вы также можете получить доступ к сайтам, включённым в разрешённый список, из _Правил пользователя_. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/network.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/network.md index ccd78d31fe7..ce2f66d2322 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/network.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/network.md @@ -15,13 +15,13 @@ sidebar_position: 9 ### Автоматически фильтровать трафик приложений -By default, AdGuard blocks ads and trackers in most browsers ([Tor Browser is an exception](/adguard-for-mac/solving-problems/tor-filtering)). Эта настройка позволяет AdGuard блокировать рекламу и в приложениях. +По умолчанию AdGuard блокирует рекламу и трекеры в большинстве браузеров ([за исключением Tor Browser](/adguard-for-mac/solving-problems/tor-filtering)). Эта настройка позволяет AdGuard блокировать рекламу и в приложениях. Чтобы управлять отфильтрованными приложениями, нажмите _Приложения_. ### Фильтровать HTTPS-протокол -This setting allows AdGuard to filter the secure HTTPS protocol, which is currently used by most websites and apps. By default, websites with potentially sensitive information, such as banking services, are not filtered. Чтобы управлять исключениями HTTPS, нажмите _Исключения_. +Этот параметр позволяет AdGuard фильтровать защищённый HTTPS-протокол, который в настоящее время используется большинством сайтов и приложений. По умолчанию сайты с потенциально конфиденциальной информацией, например банковские сервисы, не фильтруются. Чтобы управлять исключениями HTTPS, нажмите _Исключения_. По умолчанию AdGuard не фильтрует сайты с сертификатами Extended Validation (EV). При необходимости вы можете включить опцию _Фильтровать сайты с EV-сертификатами_. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/security.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/security.md index ea381bf43d9..25934e4c4b1 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/security.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/security.md @@ -15,7 +15,7 @@ sidebar_position: 6 У AdGuard есть база мошеннических, фишинговых и вредоносных доменов. Если вы включите функцию _Защита от фишинга и вредоносных программ_, AdGuard будет предупреждать вас каждый раз, когда вы собираетесь посетить опасный сайт. Даже если опасными являются только некоторые части сайта, AdGuard проверит их и выдаст предупреждение. -Это безопасно. As AdGuard checks hash prefixes, not URLs, it doesn’t know what websites you visit. [Узнайте больше о проверках безопасности AdGuard](/general/browsing-security) +Это безопасно. Поскольку AdGuard проверяет хеш-префиксы, а не URL-адреса: он не знает, какие сайты вы посещаете. [Узнайте больше о проверках безопасности AdGuard](/general/browsing-security) :::note diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/high-sierra-compatibility.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/high-sierra-compatibility.md index 6ced212ec4b..a714301c720 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/high-sierra-compatibility.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/high-sierra-compatibility.md @@ -9,7 +9,7 @@ sidebar_position: 3 ::: -During the installation of AdGuard on macOS High Sierra (or later), you may see this message: "System Extension Blocked". Это новый механизм защиты, появившийся в High Sierra, он требует от вас явно разрешить установку сторонних расширений. Чтобы завершить установку AdGuard, вам нужно вручную разрешить установку расширений: перейдите в *Системные настройки* → *Защита и безопасность* → *Основные*. +Во время установки AdGuard на macOS High Sierra (или более поздние версии) вы можете увидеть такое сообщение: «Системное расширение заблокировано». Это новый механизм защиты, появившийся в High Sierra, он требует от вас явно разрешить установку сторонних расширений. Чтобы завершить установку AdGuard, вам нужно вручную разрешить установку расширений: перейдите в *Системные настройки* → *Защита и безопасность* → *Основные*. ![Разрешить установку расширений в настройках](https://cdn.adtidy.org/public/Adguard/kb/PicturesEN/highsierra.png) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index f8d498b362a..261bd85d947 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ sidebar_position: 3 ## AdGuard для Safari -*AdGuard для Safari* добавляет иконку AdGuard рядом со строкой поиска. Это полезно, если вы хотите быстро настроить защиту на конкретном сайте или заблокировать рекламу вручную. Оно также содержит расширенные правила, которые не преобразуются в формат, поддерживаемый Safari. Сюда входят правила CSS, CSS-селекторы и скриптлеты, позволяющие AdGuard блокировать сложную рекламу — например, на 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. ## Как управлять расширениями Safari -1. Откройте Safari и нажмите *Safari* в левом верхнем углу экрана, чтобы развернуть меню. ![Настройки Safari *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) -1. Нажмите *Настройки...* -1. Выберите *Расширения*. ![Вкладка Расширения](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) +1. Откройте Safari и нажмите *Safari* в левом верхнем углу экрана, чтобы развернуть меню. + + ![Настройки Safari *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + +1. Click *Settings...* + +1. Выберите *Расширения*. + + ![Вкладка Расширения](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Почему AdGuard для Safari нужны разрешения diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/browser-assistant.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/browser-assistant.md index 3842090c004..281e222b787 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/browser-assistant.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/browser-assistant.md @@ -21,7 +21,7 @@ sidebar_position: 3 В предыдущих версиях Браузерного расширения AdGuard (до версии 3.5), если оно было установлено вместе с AdGuard для Windows, расширение брало на себя функции Помощника, прекращало фильтровать самостоятельно и полагалось на приложение. -Расширение и приложение работали вместе, но иногда интеграция давала сбой. The protection normally provided by the desktop program would stop on certain sites, where only the less powerful extension would then provide protection. +Расширение и приложение работали вместе, но иногда интеграция давала сбой. Работа десктопной программы прекращалась на определённых сайтах, и тогда защиту обеспечивало только менее мощное расширение. При использовании Браузерного помощника все эти проблемы не имеют значения, поскольку конфликтов по сути быть не может. Роль Браузерного помощника чётко определена, и он не может помешать работе основного приложения, так что не о чем беспокоиться. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 19f8c1d65d3..b1abe4927f8 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ sidebar_position: 3 ::: -AdGuard может значительно расширить функциональность сайта, работая в качестве [менеджера пользовательских скриптов](/general/extensions). Пользователи AdGuard могут добавлять собственные скрипты, а также управлять существующими. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/others.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/others.md index fdab0235bd6..c51120bee8a 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/others.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/others.md @@ -30,7 +30,7 @@ sidebar_position: 4 ![О программе \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/about.png) -In addition to information about the current version of the program, this tab provides some useful links to Licese agreement, Privacy policy, Acknowledgements, Discussions, and Version history pages. +В дополнение к информации о текущей версии программы, эта вкладка содержит несколько полезных ссылок на страницы Лицензионного соглашения, Политики конфиденциальности, Благодарностей, Обсуждений и Истории версий. ### Проверить обновления diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/installation.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/installation.md index 1d9a16a1efe..eb1c0cb2e33 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/installation.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/installation.md @@ -23,7 +23,7 @@ sidebar_position: 2 Чтобы использовать программу AdGuard на компьютере или планшете под управлением Microsoft Windows, загрузите установочный пакет этого приложения и запустите программу установки. Для этого выполните перечисленные ниже действия: -1. Go to the [AdGuard website](http://adguard.com) in the address bar and click *Download* [on the homepage](https://adguard.com/download.html?auto=1). +1. Перейдите на сайт [AdGuard](http://adguard.com) в адресной строке и нажмите *Скачать* [на главной странице](https://adguard.com/download.html?auto=1). ![Скачайте AdGuard](https://cdn.adtidy.org/content/kb/ad_blocker/windows/installation/download-from-website.png) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/adguard-logs.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/adguard-logs.md index e89a3450375..0b3a67abea1 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/adguard-logs.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/adguard-logs.md @@ -23,7 +23,7 @@ AdGuard стремится защищать вашу конфиденциаль ::: -### Debug logs {#debug-logs} +### Отладочные логи {#debug-logs} 1. Откройте настройки AdGuard. Перейдите в раздел *Общие настройки*, прокрутите вниз до конца экрана и измените *Уровень логирования* на *Подробный*. @@ -57,9 +57,9 @@ AdGuard стремится защищать вашу конфиденциаль 1. Откройте консоль (наберите `cmd` в стартовой панели). -1. Run the application with the command `C:\"Program Files"\Adguard\Adguard.exe /trace` regardless of Windows bitness if you have installed AdGuard v7.16 for Windows or later. +1. Запустите приложение командой `C:\"Program Files"\Adguard\Adguard.exe /trace` независимо от разрядности Windows, если у вас установлен AdGuard 7.16 для Windows или новее. -If you have an older version of AdGuard for Windows, run the application with the command C:\"Program Files (x86)"\Adguard\Adguard.exe /trace if you are using 64-bit Windows, and C:\"Program Files"\Adguard\Adguard.exe /trace if you are using 32-bit. +Если у вас установлена старая версия AdGuard для Windows, запустите приложение командой C:\"Program Files (x86)"\Adguard\Adguard.exe /trace, если вы используете 64-битную Windows, и C:\"Program Files"\Adguard\Adguard.exe /trace, если 32-битную. 1. Воспроизведите ошибку. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/system-logs.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/system-logs.md index 37c89948830..2224c750d18 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/system-logs.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/system-logs.md @@ -33,7 +33,7 @@ sidebar_position: 5 - Щёлкните правой кнопкой мыши по разделу *Приложение* и в выпадающем меню выберите *Сохранять все события как...* - - Выберите имя и место сохранения, нажмите *Сохранить*. Выберите *Отображать сведения для следующих языков*. You need to check the checkbox next to *English*. Нажмите *OK*. + - Выберите имя и место сохранения, нажмите *Сохранить*. Выберите *Отображать сведения для следующих языков*. Поставьте галочку напротив пункта *Английский язык*. Нажмите *OK*. - Откройте *Система*: *Просмотр событий (локальный)* → *Логи Windows* → *Система*. 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 0a5b0cf9968..b6c485c8872 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 @@ -38,11 +38,11 @@ sidebar_position: 2 - **Экспериментальный фильтр** предназначен для проверки некоторых новых правил фильтрации, которые потенциально могут вызывать конфликты или ломать работу сайтов. В случае успешной проверки правила из этого фильтра добавляются в основные фильтры. [Посмотреть правила](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) -- **Quick Fixes filter** — used to quickly resolve critical content filtering issues on popular websites without updating the MV3 extension. [View rules](https://filters.adtidy.org/extension/chromium-mv3/filters/24.txt) +- **Фильтр быстрых исправлений** используется для быстрого устранения критических проблем фильтрации контента на популярных сайтах без обновления MV3-расширения. [Посмотреть правила](https://filters.adtidy.org/extension/chromium-mv3/filters/24.txt) ## Политика фильтров AdGuard -Our filter policy defines what AdGuard filters should and shouldn't block, as well as the rules for adding and removing rules from filters. Чтобы узнать больше, прочтите полный текст [политики фильтров AdGuard](../filter-policy). +Наша политика фильтрации определяет, что фильтры AdGuard должны блокировать, а что нет, а также регулирует порядок добавления и удаления правил из фильтров. Чтобы узнать больше, прочтите полный текст [политики фильтров AdGuard](../filter-policy). ## Участвовать в развитии фильтров AdGuard 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 c7f53b6f52d..1bdb94a7d17 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 @@ -4410,6 +4410,7 @@ false_conditions_rules_list - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/how-ad-blocking-works.md b/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/how-ad-blocking-works.md index 111488a04a9..ce214741cf2 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/how-ad-blocking-works.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/how-ad-blocking-works.md @@ -3,7 +3,7 @@ title: Как работает блокировка рекламы sidebar_position: 1 --- -AdGuard has many ad-blocking products for different platforms, each with its own unique features. Но объединяет их всех то, что они блокируют рекламу и трекеры. Эта статья описывает, как устроена блокировка рекламы изнутри. +В семействе блокировщиков AdGuard есть много продуктов для разных платформ, и каждый из них обладает своими уникальными особенностями. Но объединяет их всех то, что они блокируют рекламу и трекеры. Эта статья описывает, как устроена блокировка рекламы изнутри. :::note diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/general/browsing-security.md b/i18n/ru/docusaurus-plugin-content-docs/current/general/browsing-security.md index 42b88da332e..52a55a4b58a 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/general/browsing-security.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/general/browsing-security.md @@ -3,17 +3,17 @@ title: Защита от фишинга и вредоносных програм sidebar_position: 3 --- -Falling prey to phishing and malware remains a common issue. To enhance digital security, we’ve incorporated special filters in AdGuard products to shield you from malicious and phishing websites. To date, we’ve categorized over 15 million sites and built a database of 1.5 million websites known for phishing and malware. Using this database, AdGuard checks the websites you visit to protect you from online threats. +Распространённой проблемой остаётся фишинг и вредоносное ПО. Для повышения безопасности мы включили в продукты AdGuard специальные фильтры, которые защитят вас от вредоносных и фишинговых сайтов. Мы классифицировали более 15 миллионов сайтов и создали базу данных из 1,5 миллиона сайтов, известных как фишинговые и вредоносные. Используя эту базу данных, AdGuard проверяет посещаемые вами сайты, чтобы защитить вас от онлайн-угроз. -:::note Important +:::note Важно -We strictly do not collect or use any information about the websites you visit. +Мы не собираем и не используем информацию о посещаемых вами сайтах. ::: -## How does AdGuard check websites? +## Как AdGuard проверяет сайты? -Каждый раз, когда вы посещаете сайт, ваш локальный клиент обменивается информацией с нашим внутренним сервером в виде хешей и хеш-префиксов. Based on this exchange, the local client determines whether or not the website is listed in the potentially dangerous websites database. There is a difference in the scope of this check for apps and extensions. +Каждый раз, когда вы посещаете сайт, ваш локальный клиент обменивается информацией с нашим внутренним сервером в виде хешей и хеш-префиксов. На основе этого обмена локальный клиент определяет, занесён ли сайт в базу потенциально опасных сайтов. There is a difference in the scope of this check for apps and extensions. ### В приложениях @@ -39,38 +39,38 @@ AdGuard provides the best possible protection by inspecting both the pages and a ![Browsing security in Android *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/general/bs_android.png) -- **For iOS**: Although there’s no separate module, you can go to *Safari protection* → *Filters* → *Security* and enable the available filters. Additionally, enable *DNS protection* and select one of the AdGuard DNS servers +- **For iOS**: Although there’s no separate module, you can go to *Safari protection* → *Filters* → *Security* and enable the available filters. Кроме того, включите *DNS-защиту* и выберите один из серверов AdGuard DNS -![Security in iOS *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/general/bs_ios.jpg) +![Безопасность в iOS *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/general/bs_ios.jpg) -- **For Browser extensions**: Enable *Phishing and malware protection* in the *Settings* tab. For enhanced protection, go to *Filters* → *Security* and activate available filters +- **Для расширений браузера**: включите *Защитe от фишинговых и вредоносных сайтов* на вкладке *Настройки*. Для усиленной защиты перейдите в *Фильтры* → *Безопасность* и активируйте доступные фильтры ![Защита от фишинга и вредоносных программ](https://cdn.adtidy.org/content/kb/ad_blocker/general/extension_protection.png) -- **For Private AdGuard DNS:** Enable malware protection in *Server settings* under *Security* +- **Для приватного DNS AdGuard:** Включите защиту от вредоносных программ в *Настройках сервера* в разделе *Безопасность* -![Security in DNS](https://cdn.adtidy.org/content/kb/ad_blocker/general/bs_dns.png) +![Безопасность в DNS](https://cdn.adtidy.org/content/kb/ad_blocker/general/bs_dns.png) -## What we block +## Что мы блокируем -We maintain two primary filters: one that protects against phishing and fraudulent websites that attempt to steal user credentials, and another that blocks access to websites known to distribute malware, which could lead to data loss, information leaks, or damage to your device. These filters also protect you from websites with various scams and fraudulent schemes. For more detailed information, refer to this [Wikipedia article](https://en.wikipedia.org/wiki/Phishing). +Мы используем два основных фильтра: один защищает от фишинговых и мошеннических сайтов, которые пытаются украсть учётные данные пользователя, а другой блокирует доступ к сайтам. Эти сайты, как известно, распространяют вредоносное ПО, что может привести к потере данных, утечке информации или повреждению устройства. These filters also protect you from websites with various scams and fraudulent schemes. Более подробную информацию можно найти в этой [статье на Википедии](https://ru.wikipedia.org/wiki/Фишинг). -## Maintaining our filters +## Поддержка наших фильтров -AdGuard maintains an extensive database of phishing and malware websites, and it’s updated regularly and automatically as new threats are discovered. We collect information from a variety of reliable, high-quality sources, both public and from other companies, and aggregate it into a common database of dangerous sites. +AdGuard ведёт обширную базу данных фишинговых и вредоносных сайтов, которая регулярно и автоматически обновляется по мере обнаружения новых угроз. Мы собираем информацию из различных надёжных и качественных источников, как публичных, так и от других компаний, и агрегируем её в общую базу данных опасных сайтов. -We automatically analyze complaints about suspicious sites and spend a great deal of time keeping the database up-to-date, cleaning up false positives, and implementing mechanisms to prevent them in the future. +Мы автоматически анализируем жалобы на подозрительные сайты и тратим много времени на то, чтобы поддерживать актуальность базы данных, устранять ложные срабатывания и внедрять механизмы для их предотвращения в будущем. -### Want to help? +### Как помочь -Any help is welcome! If you encounter a phishing or malware website, please report it to . +Любая помощь приветствуется! Если вы столкнулись с фишинговым или вредоносным сайтом, сообщите об этом по адресу . -### False-positive responses +### Ложноположительные срабатывания -Occasionally, some non-malicious websites are added to AdGuard’s filters. Мы следим, чтобы такого не происходило, но бывают разные случаи. If you encounter this behavior from AdGuard, please report the false positive to our technical support at . +Изредка происходит так, что в фильтры AdGuard попадают сайты, которые не являются опасными. Мы следим, чтобы такого не происходило, но бывают разные случаи. Если вы столкнулись с подобным поведением AdGuard, сообщите о ложном срабатывании в поддержку по адресу . -## If you are suspicious about a website +## Если вы сомневаетесь в сайте -If you suspect that a certain website might be dangerous, check it first by using our [security check tool](https://reports.adguard.com/welcome.html). +Если вы подозреваете, что какой-то сайт может быть опасным, сначала проверьте его с помощью нашего [инструмента проверки безопасности](https://reports.adguard.com/welcome.html). -![Security check](https://cdn.adtidy.org/content/kb/ad_blocker/general/site_warning.png) +![Проверка безопасности](https://cdn.adtidy.org/content/kb/ad_blocker/general/site_warning.png) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/ru/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..467aac420ce --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Расширения +sidebar_position: 6 +--- + +## Пользовательские скрипты + +Пользовательские скрипты (мы также называем их «‎расширениями»‎) — это мини-программы, написанные на языке JavaScript. Они модифицируют или расширяют функциональность одного или нескольких сайтов. Многие пользователи AdGuard уже наверняка знакомы с такими расширениями, как Помощник AdGuard, Блокировщик всплывающей рекламы и AdGuard Extra. + +:::note Supported apps + +AdGuard может значительно расширять функциональность сайтов, работая как менеджер пользовательских скриптов. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Рекомендуемые скрипты AdGuard + +Эти пользовательские скрипты разработаны в AdGuard, и мы можем гарантировать, что они эффективны и безопасны. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +Расширение, которое блокирует рекламу в сложных случаях, когда привычного подхода, основанного на фильтрах, недостаточно. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. Однако, если вы хотите использовать его вместе с Браузерным расширением AdGuard или любым другим блокировщиком рекламы, вам понадобится дополнительное расширение. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### Блокировщик всплывающих окон + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### Помощник AdGuard (устаревшая версия) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Отключить AMP + +Скрипт, который предустановлен только в AdGuard для Android. Он отключает AMP (Accelerated Mobile Pages или «ускоренные мобильные страницы») на странице результатов поиска Google. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Лучшие варианты вне AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +Этот скрипт удаляет функцию отслеживания Google из ссылок в результатах поиска Google. Это ускоряет загрузку результатов поиска и позволяет скопировать URL-адрес ссылки, щёлкнув по нему правой кнопкой мыши или нажав на него. + +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 + +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). + +### Где взять больше пользовательских скриптов{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Любой скрипт из неизвестного источника несёт в себе потенциальный риск. Тем не менее, существует огромное количество интересных скриптов, которые, если установить их аккуратно и ответственно, могут действительно сделать использование некоторых сайтов более удобным. + +Здесь мы опишем несколько популярных каталогов пользовательских скриптов. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Сообщество + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Разработка + +#### Запросить лицензию + +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. + +Для этого отправьте нам сообщение devteam@adguard.com со следующей информацией: + +**Subject:** Userscript author license request + +**Body:** Please tell us about the userscripts you are working on. + +Here is a [mailto link](mailto:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Совместимость + +#### Блок метаданных + +#### Поддерживаемые свойства + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Неподдерживаемые свойства + +AdGuard проигнорирует эти свойства. + +```text +@unwrap +``` + +#### Поддерживаемые функции GM + +AdGuard поддерживает как старые функции GM\_, так и новый GM4 API, использующий объект GM. + +#### Значения + +:::note + +Все перечисленные функции Greasemonkey устарели, но всё ещё поддерживаются. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Пример + +```javascript +// ==UserScript== +// @name Имя, которое показывается пользователю, если локаль английская или неизвестна +// @name:ru Имя, которое показывается пользователю, если локаль русская +// @description Описание, которое показывается пользователю, если локаль английская или неизвестна +// @description:ru Описание, которое показывается пользователю, если локаль русская +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage. com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage. com/mylibrary.js +// @grant свойство: настройки +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +! function(){( + console.log("I am loaded!"); +)}(); +``` + +## Пользовательские стили + +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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link Address_ + +3. Open AdGuard settings → _Extensions_ + +4. Press the [+] button and paste the userstyle link + +5. Готово! + +If you’re familiar with CSS rules, you can also create the userstyles yourself. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). Например: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Пример + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/ru/docusaurus-plugin-content-docs/current/general/how-to-install.md index 3cb909f4404..a6c4014b4d3 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: Как установить AdGuard -sidebar_position: 8 +sidebar_position: 9 --- В зависимости от того, какое приложение или браузерное расширение AdGuard вы хотите установить, перейдите по одной из этих ссылок и найдите соответствующую инструкцию: diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/ru/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index dbacef0a8d8..3011a8a4e30 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Известные проблемы sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Последнее обновление: 20 сентября 2022 года +Last update: September 17, 2024 Понимание этой статьи может потребовать некоторых базовых знаний о шифровании, TLS и HTTPS. @@ -30,7 +32,38 @@ AdGuard копирует свойства TLS-соединения, которы Самый главный недостаток механизма HTTPS-фильтрации заключается в том, что он скрывает оригинальный сертификат сайта. Вы просто не можете увидеть реальный сертификат — вместо него вы видите тот, который сгенерировал AdGuard. -Эта проблема уже решена в [Браузерном Помощнике](https://adguard.com/adguard-assistant/overview.html). Это браузерное расширение помогает управлять фильтрацией прямо из браузера и позволяет просматривать исходные сертификаты сайтов. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Прозрачность сертификата (Certificate Transparency) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/general/https-filtering/what-is-https-filtering.md b/i18n/ru/docusaurus-plugin-content-docs/current/general/https-filtering/what-is-https-filtering.md index d64155b7119..65eb89ee9fa 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/general/https-filtering/what-is-https-filtering.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/general/https-filtering/what-is-https-filtering.md @@ -7,7 +7,7 @@ sidebar_position: 1 HTTPS (аббр. от англ. HyperText Transfer Protocol Secure) — расширение HTTP-протокола, поддерживающее шифрование для повышения безопасности. Этот протокол используется для защищённой передачи важной информации, такой как персональные данные, реквизиты банковских карт и т. д. -Использование HTTPS — сугубо положительная вещь, ведь зашифрованный трафик защищён от прослушивания третьей стороной, и мы это только приветствуем. HTTPS acceptance has been growing in recent years, mainly because it is [encouraged by Google](https://webmasters.googleblog.com/2014/08/https-as-ranking-signal.html) and also due to the emergence of the free certificate authority [Let’s Encrypt](https://en.wikipedia.org/wiki/Let's_Encrypt). +Использование HTTPS — сугубо положительная вещь, ведь зашифрованный трафик защищён от прослушивания третьей стороной, и мы это только приветствуем. Рост HTTPS сильно ускорился в последние годы в связи с тем, что это [поощряется Google](https://webmasters.googleblog.com/2014/08/https-as-ranking-signal.html), а также с появлением бесплатного центра сертификации [Let’s Encrypt](https://ru.wikipedia.org/wiki/Let’s_Encrypt). На диаграмме ниже мы описали разницу между простым HTTP-протоколом и защищённым HTTPS-протоколом. @@ -15,17 +15,17 @@ HTTPS (аббр. от англ. HyperText Transfer Protocol Secure) — расш ### Что такое сертификат безопасности -Проще говоря, HTTPS означает шифрование данных. Но остаётся ещё одна проблема: как быть уверенным, что вы установили зашифрованное соединение именно с тем сайтом, с которым планировали? Тут в игру и вступают сертификаты безопасности. A certificate serves as proof that the website is really who or what it claims to be. Если такого сертификата у сайта нет или в нём содержится неправильная информация, браузер не позволит вам установить защищённое соединение. При этом важно, чтобы сертификат, используемый сайтом, был выдан центром сертификации, которому доверяет ваш браузер. Такие центры сертификации гарантируют, что сертификат выдан именно владельцу сайта. +Проще говоря, HTTPS означает шифрование данных. Но остаётся ещё одна проблема: как быть уверенным, что вы установили зашифрованное соединение именно с тем сайтом, с которым планировали? Тут в игру и вступают сертификаты безопасности. Сертификат — это удостоверение, что сайт представляет собой именно тот ресурс, за который себя выдаёт. Если такого сертификата у сайта нет или в нём содержится неправильная информация, браузер не позволит вам установить защищённое соединение. При этом важно, чтобы сертификат, используемый сайтом, был выдан центром сертификации, которому доверяет ваш браузер. Такие центры сертификации гарантируют, что сертификат выдан именно владельцу сайта. ### Зачем AdGuard нужно уметь фильтровать HTTPS? -Большинство сайтов теперь используют HTTPS, то же самое относится и к рекламным сетям. Here are a few popular websites where you can’t remove ads without HTTPS filtering: youtube.com, facebook.com, and x.com. +Большинство сайтов теперь используют HTTPS, то же самое относится и к рекламным сетям. Вот примеры популярных сайтов, рекламу на которых невозможно убрать без HTTPS-фильтрации: youtube.com, facebook.com, x.com. ### Как работает HTTPS-фильтрация -Если бы это было просто, HTTPS не был бы безопасным. При попытке браузера соединиться с сервером, AdGuard устанавливает два защищённых соединения: одно с браузером (или с другим приложением), а другое с сервером. Важно, чтобы при этом браузер доверял AdGuard и созданному им соединению. Для этого AdGuard генерирует специальный (и уникальный) корневой сертификат и устанавливает его в систему и, при необходимости, в некоторые браузеры (например, Firefox). AdGuard can now see the data packets inside the secure connection and thus do its job — block ads and trackers. +Если бы это было просто, HTTPS не был бы безопасным. При попытке браузера соединиться с сервером, AdGuard устанавливает два защищённых соединения: одно с браузером (или с другим приложением), а другое с сервером. Важно, чтобы при этом браузер доверял AdGuard и созданному им соединению. Для этого AdGuard генерирует специальный (и уникальный) корневой сертификат и устанавливает его в систему и, при необходимости, в некоторые браузеры (например, Firefox). Теперь AdGuard может видеть пакеты данных внутри защищённого соединения и выполнять свою работу — блокировать рекламу и трекеры. -For better understanding, we have depicted this process: +Для лучшего понимания мы изобразили этот процесс на картинке: ![Как работает HTTPS-фильтрация](https://cdn.adtidy.org/public/Adguard/Blog/https/what_is_https_filtering.png) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/block-push-notifications.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/block-push-notifications.md index 0491b06056c..def86f962e2 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/block-push-notifications.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/block-push-notifications.md @@ -47,6 +47,6 @@ To avoid similar ads in the future, you can also block push notifications direct ### On Mac -1. Open AdGuard. Go to _Preferences_. +1. Open AdGuard. Перейдите в _Настройки_. 2. In the _Stealth Mode_ tab, go to _Browser API_. 3. Enable _Block Push API_. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/minidump.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/minidump.md index 04ada095647..e766a579c95 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/minidump.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/minidump.md @@ -5,7 +5,7 @@ sidebar_position: 8 К сожалению, почти все пользователи Windows знакомы с ошибкой [Синий экран смерти (Blue Screen of Death, BSoD)](https://en.wikipedia.org/wiki/Blue_screen_of_death). Эта ошибка возникает, когда системе Windows сталкивается с проблемами, которые могут повлиять на безопасную работу системы, например, проблемы со сторонним кодом драйвера, аппаратным обеспечением или кодом Microsoft. Чтобы устранить ошибку синего экрана, пользователи могут использовать файл minidump. -## What is Minidump file? +## Что такое файл minidump? Файл minidump — это файл с информацией о характере сбоя системы. Он создаётся непосредственно перед появлением синего экрана и содержит минимальное количество полезной информации, которую можно использовать для решения проблемы. Обычно расширение файла minidump — *.dmp*. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/proxy-certificate.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/proxy-certificate.md index 97140866a39..dd149459d1b 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/proxy-certificate.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/proxy-certificate.md @@ -19,7 +19,7 @@ HTTP-трафик будет фильтроваться в любом случа ### Windows {#windows} -1. Note the IP address of your desktop computer with AdGuard installed. +1. Узнайте IP-адрес вашего десктопного компьютера, на котором установлен AdGuard. 1. Убедитесь, что защита AdGuard включена. На компьютере с Windows установите флажок **Использовать AdGuard как HTTP-прокси** во вкладке **Сеть** в его настройках. For Mac, go to **Settings** → **Preferences** → **Network** and enable **HTTP proxy**. @@ -75,7 +75,7 @@ HTTP-трафик будет фильтроваться в любом случа 1. Введите пароль администратора и нажмите **Изменить связку ключей**. -1. Go to **Spotlight** (the search icon in the top right corner), type in `Keychain Access`, and then select **Keychain Access** from the search results. +1. Перейдите в **Spotlight** (значок поиска в правом верхнем углу), введите `Связка ключей` и выберите **Связка ключей** в результатах поиска. 1. В разделе *Система* выделите добавленный сертификат. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/take-screenshot.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/take-screenshot.md index fa9ff5ddb2d..34b5affb7e0 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/take-screenshot.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/take-screenshot.md @@ -48,21 +48,21 @@ sidebar_position: 5 На некоторых ноутбуках необходимо удерживать клавишу *Fn*, а затем нажимать *PrtScn*. -*Please note: The PrtScn (Print Screen) key may be abbreviated differently on different keyboards — PrntScrn, PrtScn, PrtScr, or PrtSc.* +*Обратите внимание: клавиша PrtScn (Print Screen) может быть по-разному обозначена на различных клавиатурах — PrntScrn, PrtScn, PrtScr или PrtSc.* Windows сделает снимок всего экрана и скопирует его в буфер обмена. -To take a screenshot of an active window, use the following shortcut keys: +Чтобы сделать снимок активного окна, используйте следующее сочетание клавиш: - **Нажмите и удерживайте клавишу *Alt* и нажмите *PrtScn* (или *Fn + Alt + PrtScn * на некоторых ноутбуках)** -To take a screenshot of a specific area, use the following shortcut keys: +Чтобы сделать снимок определённой области экрана, используйте следующее сочетание клавиш: - ***Нажмите сочетание клавиш ***Win + Shift + S****** -После того, как вы сделаете скриншот, он сохранится в буфере обмена. In most cases, you will be able to paste it into a document that you are currently editing by using the *Ctrl + V* shortcut. Или, если вам нужно сохранить скриншот как файл, откройте стандартную программу **Paint** (или любую другую, работающую с изображениями). Paste your screenshot there using the same shortcut keys or by clicking the Paste button (usually in the top left corner of the screen) and then save it. +После того, как вы сделаете скриншот, он сохранится в буфере обмена. Вы сможете вставить его в документ, с которым работаете, используя сочетание клавиш *Ctrl + V*. Или, если вам нужно сохранить скриншот как файл, откройте стандартную программу **Paint** (или любую другую, работающую с изображениями). Вставьте снимок экрана используя ту же комбинацию клавиш или нажав кнопку Вставить (обычно в левом верхнем углу страницы), а затем сохраните его. -Windows 8 and 10 let you take a screenshot very quickly with the *Win + PrtScn* shortcut keys. Как только вы нажмете пки, снимок экрана будет автоматически сохранён в виде файла в вашей папке *Картинки* → *Папка скриншотов*. +Операционные системы Windows 8 и 10 позволяют быстро создавать скриншоты с помощью сочетания клавиш *Win + PrtScn*. Как только вы нажмете пки, снимок экрана будет автоматически сохранён в виде файла в вашей папке *Картинки* → *Папка скриншотов*. Существует также специальная программа *Ножницы* для создания скриншотов, которая запускается из меню *Пуск > Все программы > Стандартные*. Ножницы позволяют сделать скриншот любой области экрана или всего экрана целиком. После создания скриншота с помощью данной программы вы сможете редактировать изображение и сохранить его в любой папке вашего компьютера. @@ -70,26 +70,26 @@ Windows 8 and 10 let you take a screenshot very quickly with the *Win + PrtScn* ### macOS {#mac} -To take a screenshot on Mac, use the following shortcut keys: +Чтобы сделать снимок экрана на Mac, используйте следующее сочетание клавиш: - ***Нажмите и удерживайте ***⌘ Cmd + Shift + 3****** Ваш компьютер зафиксирует изображение всего экрана и сохранит его на рабочем столе. -To take a screenshot of an active window, use the following shortcut keys: +Чтобы сделать снимок активного окна, используйте следующее сочетание клавиш: - **Нажмите и удерживайте *⌘ Cmd + Shift + 4 + пробел*. Указатель мыши изменится на значок камеры. Щёлкните по окну, чтобы захватить его. Чтобы отменить создание скриншота, нажмите Esc** -To take a screenshot of a specific area, use the following shortcut keys: +Чтобы сделать снимок определённой области экрана, используйте следующее сочетание клавиш: -- ***Press ***⌘ Cmd + Shift + 5******. Перетащите перекрестие, чтобы выделить нужную область. Release your mouse or trackpad to take a screenshot, press Esc to cancel it. +- ***Нажмите ***⌘ Cmd + Shift + 5******. Перетащите перекрестие, чтобы выделить нужную область. Отпустите кнопку миши или трекпада, чтобы сделать снимок экрана, для отмены нажмите кнопку Esc. -To take a screenshot of the *Touch Bar* (MacBook Pro), use the following shortcut keys: +Чтобы сделать скриншот *Touch Bar* (на MacBook Pro), используйте следующие сочетания клавиш: - ***Нажмите сочетание клавиш ***⌘ Cmd + Shift + 6****** Ваш компьютер зафиксирует изображение всего *Touch Bar* и сохранит его как файл на вашем рабочем столе. -To copy a screenshot to the clipboard instead of saving it, hold down *Ctrl* together with any of the shortcut keys above. Then you can paste the screenshot (from the clipboard) into a document or an image you are currently editing by using *Cmd + V* shortcut keys. +Чтобы скопировать снимок экрана в буфер обмена вместо сохранения, нажмите и удерживайте клавишу *Ctrl * вместе с любым из вышеперечисленных сочетаний клавиш. Затем вставьте снимок экрана (из буфера обмена) в документ или изображение, которое вы редактируете, используя сочетание клавиш *Cmd + V*. Вы также можете сделать скриншот, используя **Preview** и выбрав **Сделать скриншот** (выбранной зоны, окна или всего экрана). Пользуясь **Preview** вы можете сохранять файлы в форматах JPG, TIFF, PDF и др. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/intro.md b/i18n/ru/docusaurus-plugin-content-docs/current/intro.md index dda9303d0e6..b932c7196de 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/intro.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/intro.md @@ -20,4 +20,4 @@ AdGuard — один из лидеров на рынке программ для ## Не только блокировка рекламы -Блокировщик рекламы AdGuard не просто блокирует рекламу. Он защитит вас от онлайн-отслеживания и повысит вашу конфиденциальность во многих отношениях. В зависимости от конкретного продукта AdGuard также может предложить такие преимущества, как DNS-фильтрация для более полной защиты, Родительский контроль для защиты детей от неприемлемого контента, Журнал фильтрации для лучшего контроля над интернет-трафиком и многое другое. This Knowledge Base contains detailed information about any and all of them — feel free to jump to any article that interests you. +Блокировщик рекламы AdGuard не просто блокирует рекламу. Он защитит вас от онлайн-отслеживания и повысит вашу конфиденциальность во многих отношениях. В зависимости от конкретного продукта AdGuard также может предложить такие преимущества, как DNS-фильтрация для более полной защиты, Родительский контроль для защиты детей от неприемлемого контента, Журнал фильтрации для лучшего контроля над интернет-трафиком и многое другое. Эта База знаний содержит подробную информацию обо всех продуктах и функциях — переходите к любой интересующей вас статье. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/miscellaneous/contribute/filters.md b/i18n/ru/docusaurus-plugin-content-docs/current/miscellaneous/contribute/filters.md index 7b086cf7236..442a7d5ef6e 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/miscellaneous/contribute/filters.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/miscellaneous/contribute/filters.md @@ -13,7 +13,7 @@ sidebar_position: 4 Работа с фильтрами, блокирующими рекламу, требует специальных навыков. Если они у вас есть, и вы знаете, как создавать правила, то направляйтесь прямо в наш репозиторий [AdGuard Filters](https://github.com/AdguardTeam/AdguardFilters) на GitHub. Там вы найдёте множество открытых вопросов, каждый из которых ссылается на проблему с каким-либо сайтом — пропущенное объявление, ложное срабатывание и т. д. Выбирайте любой и предлагайте свои правила в комментариях. Инженеры фильтров AdGuard рассмотрят ваше предложение и добавят правило в фильтры, если оно окажется корректным. -If you are not yet familiar with our filtering rule syntax, or maybe need a refresher, you'll find the basics about the syntax [in our Knowledge Base](/general/ad-filtering/create-own-filters). +Если вы ещё не знакомы с синтаксисом наших правил фильтрации или просто хотите освежить знания, то вам нужно обратиться к [нашей Базе знаний](/general/ad-filtering/create-own-filters). ### Как мы благодарим помощников {#rewards} diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/miscellaneous/contribute/translate/guidelines.md b/i18n/ru/docusaurus-plugin-content-docs/current/miscellaneous/contribute/translate/guidelines.md index c6d9d184e02..2f70c4dda96 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/miscellaneous/contribute/translate/guidelines.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/miscellaneous/contribute/translate/guidelines.md @@ -45,7 +45,7 @@ sidebar_position: 3 ![crowdin *border](https://cdn.adtidy.org/public/Adguard/kb/en/ag-translations/context-note.png) -1. Note that source strings may also have screenshots in the Context section. Они помогают понять контекст и передать точное значение. +1. Обратите внимание, что исходные строки также могут содержать скриншоты в разделе Context. Они помогают понять контекст и передать точное значение. ![crowdin *border](https://cdn.adtidy.org/public/Adguard/kb/en/ag-translations/screenshot.png) diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/sk/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/sk/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/sk/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/sk/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/sl/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/sl/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/sl/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/sl/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/sv/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/sv/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/sv/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/sv/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/ta/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/ta/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/ta/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/ta/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md index 5f4d337e055..1e44be1ad80 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md @@ -55,7 +55,7 @@ The maximum number of simultaneously enabled filters is **50**. **Dynamic rules:** a strict cap of **5,000** rules is imposed, which includes a maximum of 1,000 regex rules. -If this limit is exceeded, only **5,000 converted rules** will be applied in the following order: first Allowlist, then User rules, Custom filters, and finally — Quick Fixes filter. +Bu limit aşılırsa, yalnızca **5,000 dönüştürülmüş kural** aşağıdaki sırayla uygulanacaktır: önce İzin listesi, ardından Kullanıcı kuralları, Özel filtreler ve nihayet — Hızlı Çözümler filtresi. > **Converted rules** are rules that have been transformed > to [DNR format] using the [declarative converter][github-declarative-converter]. diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index f2803543187..09ba590ebff 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ Bu makale, cihazınızı sistem düzeyinde koruyan çok işlevli bir reklam enge ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +iOS 15'te Apple, Safari Web Uzantıları için destek ekledi ve biz de iOS için AdGuard'a yeni _Gelişmiş koruma_ modülünü ekledik. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 78e0b594dbd..c87dd7011a4 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard'ın Safari Web uzantısı, iOS 15'in yeni özelliklerinden yararlanan bi ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +Safari, varsayılan olarak içerik engelleyiciler için yalnızca temel araçlar sağlar. Bu araçlar, diğer işletim sistemlerindeki (Windows, Mac, Android) içerik engelleyicilerde bulunan performans düzeyini sunmaz. For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Ne yazık ki bu araçlar, YouTube'daki önce gösterilen reklamlar gibi daha karmaşık durumlarla uğraşırken kesinlikle yeri doldurulamaz. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web uzantısı menüsü *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> iPad'lerde AdGuard'ın Safari Web uzantısına, tarayıcının adres çubuğundaki AdGuard simgesine dokunarak doğrudan erişilebilir. + +> iPad'lerde, AdGuard'ın Safari web uzantısına tarayıcının adres çubuğundaki AdGuard simgesine dokunarak doğrudan erişilebilir. Aşağıdaki seçenekler listesini göreceksiniz: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternatif olarak, AdGuard uzantısını Safari tarayıcısından da açabilirsiniz. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +Ayrıca, AdGuard uzantısını Safari tarayıcısından da etkinleştirebilirsiniz. Bunu yapmak için *Uzantılar* öğesine dokunun (adres çubuğunun yanında görmüyorsanız `aA` simgesine dokunun). ![Safari'de aA simgesine dokunun *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index 8ac045f7539..8fbcdd646a1 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ Kullanıcı kuralları ve izin listesi kuralları her uzantıya dahildir. ## Safari için AdGuard -*Safari için AdGuard* arama çubuğunun yanındaki AdGuard simgesini etkinleştirir. Belirli bir sitede hızlı bir şekilde koruma ayarlamak veya reklamları elle engellemek istiyorsanız kullanışlıdır. Ayrıca Safari tarafından desteklenen biçime dönüştürülmeyen gelişmiş kurallar da içerir. Buna, AdGuard'ın örneğin YouTube'daki karmaşık reklamları engellemesine olanak tanıyan CSS kuralları, CSS seçiciler ve komut dosyaları dahildir. +*Safari için AdGuard, arama çubuğunun yanındaki AdGuard simgesini etkinleştirir. Belirli bir sitede hızlı bir şekilde koruma ayarlamak veya reklamları elle engellemek istiyorsanız kullanışlıdır. Ayrıca Safari tarafından desteklenen biçime dönüştürülmemiş gelişmiş kurallar da içerir. 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. ## Safari uzantıları nasıl yönetilir -1. Safari'yi açın ve menüyü genişletmek için ekranın sol üst köşesindeki *Safari* öğesine tıklayın. ![Safari ayarları *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Safari'yi açın ve menüyü genişletmek için ekranın sol üst köşesindeki *Safari* öğesine tıklayın. + + ![Safari ayarları *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. *Ayarlar...* öğesine tıklayın -1. *Uzantılar* öğesini seçin. ![Uzantılar sekmesi](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. *Uzantılar* öğesini seçin. + + ![Uzantılar sekmesi](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Safari için AdGuard neden izin gerektiriyor diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 40764a643b8..ea161bae31f 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ Bu makale, cihazınızı sistem düzeyinde koruyan çok işlevli bir reklam enge ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Kullanıcıları kendi betiklerini ekleyebilir ve mevcut olanları yönetebilir. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 620a75fef55..2fe9f828a14 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [Chrome MV3 için AdGuard][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera @@ -4771,6 +4772,7 @@ The following scriptlets also may be used for debug purposes: [ext-chr]: #what-product "AdGuard Browser Extension for Chrome and other Chromium-based browsers" [ext-mv3]: #what-product "Chrome için AdGuard Tarayıcı Uzantısı MV3" [ext-mv3]: #what-product "AdGuard Browser Extension for Chrome MV3" +[ext-mv3]: #what-product "AdGuard Browser Extension for Chrome MV3" [ext-ff]: #what-product "AdGuard Browser Extension for Firefox" [ext-ff]: #what-product "Firefox için AdGuard Tarayıcı Uzantısı" [ios-app]: #what-product "iOS için AdGuard ve iOS için AdGuard Pro" diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/tr/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..143620a5f96 --- /dev/null +++ b/i18n/tr/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Uzantılar +sidebar_position: 6 +--- + +## Kullanıcı Betikleri + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Desteklenen uygulamalar + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Önerilen AdGuard betikleri + +Bu kullanıcı betikleri doğrudan AdGuard geliştiricilerinden gelmektedir, bunların etkili ve güvenli olduğunu garanti edebiliriz. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +Normal filtre tabanlı yaklaşımın yeterli olmadığı zor durumlarda reklamları engelleyen bir uzantı. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Açılır Pencere Engelleyici + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### AMP'yi devre dışı bırak + +Yalnızca Android için AdGuard'da önceden yüklenmiş olan bir betik. Google arama sonuçları sayfasında AMP'yi (Hızlandırılmış Mobil Sayfalar) devre dışı bırakır. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### AdGuard dışında en çok tercih edilenler{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Beni izleme Google + +Bu betik, Google arama sonuçlarındaki bağlantılardan Google'ın izleyici özelliğini kaldırır. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### Lisans talep et + +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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Örnek + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## Kullanıcı stilleri + +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. + +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. + +:::info Desteklenen uygulamalar + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link Address_ + +3. Open AdGuard settings → _Extensions_ + +4. Press the [+] button and paste the userstyle link + +5. Tamamlandı! + +If you’re familiar with CSS rules, you can also create the userstyles yourself. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). Örneğin: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Örnek + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/tr/docusaurus-plugin-content-docs/current/general/how-to-install.md index a16a67d3467..2a54efde143 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/tr/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 57938812105..fef2d392cdc 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Bilinen sorunlar sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Son güncelleme: 17 Eylül 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +Bu sorun 2 şekilde çözülebilir: + +- [Tarayıcı Asistanımızı](https://adguard.com/adguard-assistant/overview.html) kullanarak. Bu tarayıcı uzantısı, filtrelemeyi doğrudan tarayıcıdan yönetmenize yardımcı olur ve herhangi bir web sitesinin orijinal sertifikasını incelemenize olanak tanır + + ![Sertifika Tarayıcı Asistanı *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. Bu yöntemi kullanarak sertifikayı görüntülemek için aşağıdaki talimatları izleyin. + +#### Inspect original certificate in AdGuard for Android + +1. Gezinme çubuğundaki İstatistikler simgesine tıklayın. +2. Go to *Recent activity*. +3. İstek ayrıntılarını açmak için sertifikasını incelemek istediğiniz isteğe tıklayın. +4. Scroll down to *Original certificate*. Daha fazla bilgi için tıklayın. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. İstek ayrıntılarını açmak için sertifikasını incelemek istediğiniz isteğe tıklayın. +3. Under the *TLS* section, click *View website certificate*. + +![Windows için AdGuard filtreleme günlüğü *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Dişli çark simgesine tıklayın. Açılır menüde, *Gelişmiş* → *Filtreleme günlüğü....* öğesine gidin. +2. İstek ayrıntılarını açmak için sertifikasını incelemek istediğiniz isteğe tıklayın. +3. *Sertifikayı görüntüle* öğesine tıklayın. + +![Mac için AdGuard filtreleme günlüğü *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/uk/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/uk/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/uk/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/uk/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/vi/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/vi/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/vi/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/vi/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index a7a12dec377..b574a1f2958 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ sidebar_position: 3 ::: -在 iOS 15 中,Apple 添加了对 Safari Web Extensions 的支持,而我们又在 AdGuard iOS 版中添加了新的「高级保护」模块。 该模块允许 AdGuard 应用高级过滤规则,例如 CSS 规则、CSS 选择器和 Scriptlet,因此甚至可以处理复杂的广告,例如 YouTube 广告。 +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![高级保护 \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 255bfebde93..4ff6e5133b3 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard Safari Web 扩展是一款让用户利用 iOS 15 新功能的工具。 ## 工作原理 -默认情况下,Safari 仅为内容拦截器提供基本工具。 这些工具无法达到用於其他操作系统(Windows、Mac、Android)的拦截器所能达到的拦截水平。 例如,其他平台上的 AdGuard 应用程序可以使用 [CSS 规则](/general/ad-filtering/create-own-filters#cosmetic-css-rules)、[CSS 选择器](/general/ad-filtering/create-own-filters#extended-css-selectors)和[小脚本](/general/ad-filtering/create-own-filters#scriptlets)等有效功能来阻止广告。 在处理复杂广告(如 YouTube 预滚动广告)时,这些功能永远无法替代。 +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard Safari Web 扩展应用这些过滤规则增加 iOS 版 AdGuard 能力。 此外,AdGuard Safari Web 扩展让用户在浏览器快速管理 iOS 版 AdGuard。 点击「*扩展*」按钮,这是一个带拼图图标的按钮,根据设备类型,它可能位于地址栏的左侧或右侧。 在列表中点击「**AdGuard**」。 ![Web 扩展菜单 *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> 在 iPad 上,点击浏览器地址栏中的 AdGuard 图标,即可访问 AdGuard Safari Web 扩展。 + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. 用户将看到以下列表: @@ -56,7 +57,7 @@ Web 扩展不是独立工具,需要 iOS 版 AdGuard。 如果设备上未安 ### Safari 浏览器 -用户还可以通过 Safari 启用 Web 扩展。 点击 Safar 地址栏旁边的「*扩展*」按钮(如果找不到,请点击地址栏旁边的「`大小`」图标)。 +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![在 Safari 中点击「大小」图标 *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index bd9bb320c98..5eb24a7f9e1 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ AdGuard 使用过滤规则阻止网站上的广告、跟踪器和其他骚扰。 ## AdGuard Safari版 -「*AdGuard Safari 版*」可启用搜索栏旁边的 AdGuard 图标。 如果用户想在特定网站上快速设置保护或手动屏蔽广告,AdGuard Safari 版就非常有用。 它还包含未转换为 Safari 支持格式的高级规则, 包括 CSS 规则、CSS 选择器以及允许 AdGuard 阻止复杂广告(例如 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. ## 如何管理 Safari 扩展程序 -1. 打开 Safari,单击屏幕左上角的「*Safari*」展开菜单。 ![Safari 设置 *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) -1. 单击「*设置...*」 -1. 选择「*扩展*」 ![扩展标签](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) +1. 打开 Safari,单击屏幕左上角的「*Safari*」展开菜单。 + + ![Safari 设置 *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + +1. Click *Settings...* + +1. 选择「*扩展*」 + + ![扩展标签](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## 为什么 Safari 版 AdGuard 需要权限 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 016a2ab3556..226096feea2 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ sidebar_position: 3 ::: -AdGuard 可作为[用户脚本管理器](/general/extensions)以显著扩展网站功能。 AdGuard 用户可以添加自己的脚本,也可以管理现有脚本。 +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![扩展 \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 7fabd0dc8c9..570f7f729a2 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..bc2b0a6737f --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: 浏览器扩展 +sidebar_position: 6 +--- + +## 用户脚本 + +用户脚本(我们也称之为「扩展」)实质上是用 JavaScript 编写的小程序。 用户脚本修改或扩展一个或多个网站的功能。 许多 AdGuard 用户已经熟悉 AdGuard 助手、弹窗拦截器和 AdGuard Extra 等用户脚本。 + +:::note Supported apps + +AdGuard 可作为用户脚本管理器以显著扩展网站功能。 You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### 推荐的 AdGuard 脚本 + +AdGuard 开发人员创建这些用户脚本,我们可以保证它们有效且安全。 For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +该扩展可以在通常的过滤方法无法解决问题的情况下屏蔽广告。 AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. 不过,如果有用户想将 AdGuard Extra 与 AdGuard 浏览器扩展或其他广告拦截器一起使用,需要使用一个额外的扩展。 Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard 弹窗拦截器 + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard 助手(旧版) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### 禁用 AMP + +这是一个仅在 Android 版 AdGuard 中预安装的脚本。 它禁用 Google 搜索结果页面上的 AMP(加速移动页面)。 Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### AdGuard 以外的最佳脚本选择{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +该脚本移除 Google 搜索结果中链接的 Google 跟踪功能。 它加快搜索结果的加载速度,允许用户右键单击或点击复制链接 URL。 + +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 + +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). + +### 在哪里查看更多自定义脚本{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. 任何来源不明的脚本都有潜在风险。 不过,也有大量有用的脚本。如果认真负责地选择,确实可以使网页更易于浏览。 + +下面我们将介绍一些最常用的用户脚本。 + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### 社区 + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### 开发 + +#### 申请许可证 + +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. + +要获取许可证,请发送电子邮件至 devteam@adguard.com 并附上以下信息: + +**Subject:** Userscript author license request + +**Body:** Please tell us about the userscripts you are working on. + +Here is a [mailto link](mailto:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### 兼容性 + +#### 元数据块 + +#### 支持的属性 + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### 不支持的属性 + +AdGuard 将忽略这些属性。 + +```text +@unwrap +``` + +#### 支持的 GM 函数 + +AdGuard 同时支持旧的 GM\_ 函数和使用 GM 对象的新 GM4 API。 + +#### 数值 + +:::note + +所有列出的旧 Greasemonkey 函数都已过时,但仍受支持。 + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### 示例 + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 用户样式 + +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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link Address_ + +3. Open AdGuard settings → _Extensions_ + +4. Press the [+] button and paste the userstyle link + +5. 完成! + +If you’re familiar with CSS rules, you can also create the userstyles yourself. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### 示例 + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/how-to-install.md index 69e203cc655..70c6f007a71 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: 如何安装 AdGuard -sidebar_position: 8 +sidebar_position: 9 --- 根据您想安装的 AdGuard 应用程序或浏览器扩展,请按照以下不同的链接找到相关文章: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index cc41fc09822..3fce549ccdc 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -9,7 +9,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect ::: -In iOS 15 Apple has added the support for Safari Web Extensions, and we in turn added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as CSS rules, CSS selectors, and scriptlets, and therefore to deal even with the complex ads, such as YouTube ads. +In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. ![Advanced protection screen \*mobile\_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md index 58a567e921c..6c4ba7ee9d8 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-ios/web-extension.md @@ -11,14 +11,15 @@ AdGuard's Safari Web extension is a tool that takes advantage of the new feature ## What it does -By default, Safari provides only basic tools to content blockers. These tools don't allow the level of performance that can be found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such effective weapons against ads as [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets). Unfortunately, these instruments are absolutely irreplaceable when dealing with more complex cases such as pre-roll ads on YouTube, for example. +By default, Safari provides only basic tools for content blockers. These tools don't offer the level of performance found in content blockers on other operating systems (Windows, Mac, Android). For example, AdGuard apps on other platforms can use such powerful anti-ad weapons as [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). Unfortunately, these utilities are absolutely irreplaceable when dealing with more complex cases, such as pre-roll ads on YouTube. AdGuard's Safari Web extension compliments AdGuard by giving it the ability to employ these types of filtering rules. Besides that, AdGuard's Safari Web extension can be used to quickly manage AdGuard for iOS right from the browser. Tap the *Extensions* button — it's the one with a jigsaw icon, depending on your device type it may be located to the left or to the right of the address bar. Find **AdGuard** in the list and tap it. ![Web extension menu *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/ext_adguard_en.png?1) -> On iPads AdGuard's Safari Web extension is accessible directly by tapping the AdGuard icon in the browser's address bar. + +> On iPads, AdGuard's Safari web extension can be accessed directly by tapping the AdGuard icon in the browser's address bar. You will see the following list of options: @@ -56,7 +57,7 @@ Tap it, then toggle the switch. On the same screen, set the *All Websites* permi ### In Safari -Alternitavely, you can also turn AdGuard extension on from the Safari browser. Tap the *Extensions* button (if you don't see it next to the address bar, tap the `aA` icon). +You can also enable the AdGuard extension from the Safari browser. To do it, tap *Extensions* (if you don't see it next to the address bar, tap the `aA` icon). ![In Safari tap aA icon *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/webext/safari1_en.png) diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md index a74eae3026a..32475928eb8 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-safari/extensions.md @@ -49,13 +49,19 @@ User rules and allowlist rules are included into every extension. ## AdGuard for Safari -*AdGuard for Safari* enables the AdGuard icon next to the search bar. It's useful if you want to quickly set up protection on a particular website or block ads manually. It also contains advanced rules that aren't converted into the format supported by Safari. This includes CSS rules, CSS selectors, and scriptlets that allow AdGuard to block complex ads — for example, on YouTube. +*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 -1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) +1. Open Safari and click *Safari* in the upper left corner of the screen to expand the menu. + + ![Safari settings *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + 1. Click *Settings...* -1. Select *Extensions*. ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + +1. Select *Extensions*. + + ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## Why AdGuard for Safari requires permission diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md index 260fa0e83b3..17884a6df33 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/features/extensions.md @@ -9,7 +9,7 @@ This article covers AdGuard for Windows, a multifunctional ad blocker that prote ::: -AdGuard can significantly broaden website functionality working as a [user script manager](/general/extensions). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly extend website functionality by working as a [userscript manager](/general/extensions.md). AdGuard users can add their own scripts as well as manage existing ones. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) 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 3fb026fd486..fd0884d9c2c 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 @@ -4410,6 +4410,7 @@ where: - `adguard_app_ios` — AdGuard for iOS - `adguard_ext_safari` — AdGuard for Safari - `adguard_ext_chromium` — AdGuard Browser Extension for Chrome (and chromium-based browsers, e.g. new Microsoft Edge) + - `adguard_ext_chromium_mv3` — [AdGuard for Chrome MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - `adguard_ext_opera` — AdGuard Browser Extension for Opera diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/extensions.md new file mode 100644 index 00000000000..0cf454b4329 --- /dev/null +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/extensions.md @@ -0,0 +1,301 @@ +--- +title: Extensions +sidebar_position: 6 +--- + +## Userscripts + +Userscripts (we also call them "extensions") are, de facto, miniprograms written in JavaScript. They modify or extend the functionality of one or more websites. Many AdGuard users may be already familiar with such userscripts as AdGuard Assistant, Popup Blocker, and AdGuard Extra. + +:::note Supported apps + +AdGuard can significantly broaden website functionality by acting as a userscript manager. You can add your custom scripts or manage the existing ones in our three products: [AdGuard for Windows](/adguard-for-windows/features/extensions), [AdGuard for Android](/adguard-for-android/features/settings#userscripts), and [AdGuard for Mac](/adguard-for-mac/features/extensions). + +::: + +### Recommended AdGuard scripts + +These userscripts come directly from the AdGuard developers, and we can guarantee that they are effective and safe. For some of the userscripts developed by others that we consider good and reliable, [scroll down to the next section](#top-picks). You can also find some of the [popular websites with scripts](#more-userscripts) below, but remember that whenever you download a userscript from an unknown source, you are exposing yourself to a certain risk, as some scripts may be harmful to your computer. + +#### AdGuard Extra + +An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed in AdGuard standalone apps, except for the one for iOS, so you don't need to do anything to enable it. However, if you want to use it alongside AdGuard Browser Extension or any other ad blocker, you'll need to use an additional extension. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/AdGuardExtra). + +![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) + +#### AdGuard Popup Blocker + +The name speaks for itself: it blocks popups — one of the most annoying types of ads on websites. Learn more about this userscript, its key features, and installation on [GitHub](https://github.com/AdguardTeam/PopupBlocker). + +![AdGuard Popup Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) + +#### AdGuard Assistant (legacy version) + +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, as it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). However, the legacy Assistant may be useful if there is no Browser Assistant for your browser. If this is your case, you can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). + +::: + +#### Disable AMP + +A script that is only pre-installed in AdGuard for Android. It disables AMP (Accelerated Mobile Pages) on the Google search results page. Learn more about this userscript and how to install it on [GitHub](https://github.com/AdguardTeam/DisableAMP). + +![Disable AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) + +### Top picks outside AdGuard{#top-picks} + +These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation. + +#### Don't track me Google + +This script removes Google's tracking feature from the links in Google search results. It speeds up the loading of search results and allows you to right-click or tap to copy the link URL. + +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 + +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). + +### Where can you get more userscripts?{#more-userscripts} + +Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Any script from an unknown source carries a potential risk. Yet, there is a great variety of interesting scripts that, if installed carefully and responsibly, can really make using some websites more convenient. + +Here we will describe some of the most popular userscript catalogs. + +#### Userscript.Zone + +[Userscript.Zone](https://www.userscript.zone) is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts. + +#### Community + +If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites: + +- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) +- [FreeNode](https://webchat.freenode.net/#greasemonkey) +- [Reddit](https://www.reddit.com/r/userscripts/) + +### Development + +#### 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 devteam@adguard.com 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:devteam@adguard.com?Subject=Userscript%20author%20license%20request\&Body=Hello%2C%0A%0AMy%20userscript%28s%29%3A%20LINK). + +#### Compatibility + +#### Metadata block + +#### Supported properties + +```text +@name +@namespace +@description +@version +@match +@include +@exclude +@grant +@connect +@require +@resource +@downloadURL +@updateURL +@supportURL +@homepageURL +@homepage +@website +@source +@run-at +@noframes +@icon +@iconURL +@defaulticon +@icon64 +@icon64URL +``` + +#### Unsupported properties + +These properties will be simply ignored by AdGuard. + +```text +@unwrap +``` + +#### Supported GM functions + +AdGuard supports both old GM\_ functions and new GM4 API that use GM object. + +#### Values + +:::note + +All listed old Greasemonkey functions are deprecated but still supported. + +::: + +```text +GM.info / GM_info +GM.setValue / GM_setValue +GM.getValue / GM_getValue +GM.listValues / GM_listValues +GM.deleteValue / GM_deleteValue +GM.getResourceUrl / GM_getResourceURL +GM.setClipboard / GM_setClipboard +GM.xmlHttpRequest / GM_xmlhttpRequest +GM.openInTab / GM_openInTab +GM.notification +unsafeWindow +GM_getResourceText +GM_addStyle +GM_log +``` + +[Here](https://wiki.greasespot.net/GM.info) you can find more information about Greasemonkey API. + +#### Example + +```javascript +// ==UserScript== +// @name Name as shown to the user when locale is english or unknown +// @name:ru Name as shown to the user when locale is russian +// @description Description as shown to the user when locale is english or unknown +// @description:ru Description as shown to the user when locale is russian +// @icon https://myhomepage.com/myuserscript.png +// @version 1.0.0.0 +// @downloadURL https://dl.myhomepage.org/myuserscript.user.js +// @updateURL https://dl.myhomepage.org/myuserscript.meta.js +// @homepageURL https://myhomepage.com/myuserscript +// @include * +// @exclude *://website.com/* +// @resource https://myhomepage.com/myuserscript.css +// @require https://myhomepage.com/mylibrary.js +// @grant property:settings +// @grant GM_getValue +// @grant GM_setValue +// @grant GM_deleteValue +// @grant GM_listValues +// @grant GM_getResourceText +// @grant GM_getResourceURL +// @grant GM_addStyle +// @grant GM_log +// @grant GM_setClipboard +// @grant GM_xmlhttpRequest +// @grant unsafeWindow +// @grant GM_info +// @grant GM_openInTab +// @grant GM_registerMenuCommand +// @run-at document-start +// ==/UserScript== +!function(){( + console.log("I am loaded!"); +)}(); +``` + +## 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. + +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. + +:::info Supported apps + +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows (v7.19 or later) and AdGuard for Mac (v2.16 or later). We also plan to implement this new feature in AdGuard v4.8 for Android in the nearest future. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating a userstyle, please contact our support team at . + +### How to set up a userstyle in AdGuard + +You can download userstyles from various websites. One of the most popular userstyle websites is [https://userstyles.world/](https://userstyles.world/explore), which we will use as an example for the following instructions on how to set up the userstyle in AdGuard. + +1. Follow the link above and choose the userstyle you like + +2. Right-click the _Install_ button and choose _Copy Link 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. + +:::note + +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + +1. Open AdGuard settings → _Extensions_ + +2. Press the [+] button and choose the _Create userstyle_ option. A new window will appear on your screen + +3. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +4. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: + + ```CSS + body { + background: gray; + } + ``` + + Or: + + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + +5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard + +### Example + +```css +/* ==UserStyle== +@name Example userstyle +@namespace https://example.org/userstyle +@homepageURL https://example.org/userstyle +@version 1.0.0 +@license Other +@description This is an example +@author example +@preprocessor default +==/UserStyle== */ +@-moz-document regexp("https?\:\/\/(www\.)?example\.(org|com).*") { + body { + background-color: #000000 !important; + } +} +``` diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 8 +sidebar_position: 9 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md index 177ca1855f8..8697f58139d 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/https-filtering/known-issues.md @@ -1,9 +1,11 @@ --- title: Known issues sidebar_position: 2 +toc_min_heading_level: 2 +toc_max_heading_level: 4 --- -Last update: September 20, 2022 +Last update: September 17, 2024 Understanding this article may require some basic knowledge about encryption, TLS, and HTTPS. @@ -30,7 +32,38 @@ All the issues known to us and the ETAs on their fixes are listed below. The most important drawback of the HTTPS filtering mechanism is that it hides the real certificate of a website. You cannot simply check its original certificate because you can only see the one issued by AdGuard. -This problem is solved in [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website. +This problem can be solved in 2 ways: + +- By using our [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). This browser extension helps you manage filtering directly from the browser and allows you to inspect the original certificate of any website + + ![Certificate Browser Assistant *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the *Recent activity* section in AdGuard for Android or the *Filtering log* section in AdGuard for Windows and AdGuard for Mac. While in the Browser Assistant you can only see the certificate of the website, in Recent activity you can inspect the certificate of any server used in a subrequest or browser, with or without the Browser Assistant. To view the certificate using this method, follow the instructions below. + +#### Inspect original certificate in AdGuard for Android + +1. Click the Statistics icon on the navigation bar. +2. Go to *Recent activity*. +3. Click the request whose certificate you want to inspect to open the request details. +4. Scroll down to *Original certificate*. Click for more info. + +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +#### Inspect original certificate in AdGuard for Windows + +1. Go to *Settings* → *Ad Blocker* → *Filtering log*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Under the *TLS* section, click *View website certificate*. + +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +#### Inspect original certificate in AdGuard for macOS + +1. Click the gear icon. In the drop-down menu, go to *Advanced* → *Filtering log...*. +2. Click the request whose certificate you want to inspect to open the request details. +3. Click *View certificate*. + +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency