From 75948bfedad8433182d659d0a16806574636c565 Mon Sep 17 00:00:00 2001 From: puglieri <112409628+puglieri@users.noreply.github.com> Date: Mon, 14 Oct 2024 12:30:55 +0000 Subject: [PATCH] automatically update translations --- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../general/ad-filtering/filter-policy.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/app-management.md | 2 +- .../adguard-for-android/features/assistant.md | 2 +- .../features/free-vs-full.mdx | 12 +- .../features/integration-with-vpn.md | 4 +- .../features/statistics.md | 18 +- .../extending-restricted-settings.md | 26 +- .../solving-problems/har.md | 12 +- .../solving-problems/log.md | 6 +- .../multiple-user-profiles.md | 2 +- .../solving-problems/tasker.md | 4 +- .../features/dns-protection.md | 2 +- .../current/adguard-for-mac/features/dns.md | 2 +- .../adguard-for-mac/features/general.md | 4 +- .../adguard-for-mac/features/network.md | 4 +- .../adguard-for-mac/features/security.md | 2 +- .../high-sierra-compatibility.md | 2 +- .../adguard-for-windows/browser-assistant.md | 2 +- .../features/extensions.md | 2 +- .../adguard-for-windows/features/others.md | 2 +- .../adguard-for-windows/installation.md | 2 +- .../solving-problems/adguard-logs.md | 6 +- .../solving-problems/system-logs.md | 2 +- .../general/ad-filtering/adguard-filters.md | 4 +- .../ad-filtering/how-ad-blocking-works.md | 2 +- .../current/general/browsing-security.md | 44 +-- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../what-is-https-filtering.md | 10 +- .../guides/block-push-notifications.md | 2 +- .../current/guides/minidump.md | 2 +- .../current/guides/proxy-certificate.md | 4 +- .../current/guides/take-screenshot.md | 22 +- .../current/intro.md | 2 +- .../miscellaneous/contribute/filters.md | 2 +- .../contribute/translate/guidelines.md | 2 +- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../adguard-browser-extension/mv3-version.md | 2 +- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- .../features/extensions.md | 2 +- .../current/general/extensions.md | 301 ++++++++++++++++++ .../current/general/how-to-install.md | 2 +- .../general/https-filtering/known-issues.md | 37 ++- 154 files changed, 10249 insertions(+), 229 deletions(-) create mode 100644 i18n/be/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/bn/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/cs/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/da/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/de/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/es/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/fa/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/fi/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/fr/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/hr/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/hu/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/it/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/ja/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/ko/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/nl/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/no/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/pl/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/pt-BR/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/pt/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/ro/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/ru/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/sk/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/sl/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/sv/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/ta/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/tr/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/uk/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/vi/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/zh-CN/docusaurus-plugin-content-docs/current/general/extensions.md create mode 100644 i18n/zh-TW/docusaurus-plugin-content-docs/current/general/extensions.md 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/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-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/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-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/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-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/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-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/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-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/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-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/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-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/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-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/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-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/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-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/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-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/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-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/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-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/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-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/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-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/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-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/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-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/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-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/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-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/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..ce2b6946cdf 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/solve-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/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-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-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/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-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/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-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/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-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/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-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/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-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/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..d38d8db148f 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 +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/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/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-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/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-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/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-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/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