From f81e9d041560fa67c4d3aba69f2f68e31bf1ac72 Mon Sep 17 00:00:00 2001 From: Dasha_Bugayova Date: Wed, 21 Aug 2024 17:28:45 +0800 Subject: [PATCH 01/39] [AGM-2125] Userstyles article in KB --- docs/general/userstyles.md | 72 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 docs/general/userstyles.md diff --git a/docs/general/userstyles.md b/docs/general/userstyles.md new file mode 100644 index 00000000000..1127fe032cc --- /dev/null +++ b/docs/general/userstyles.md @@ -0,0 +1,72 @@ +--- +title: Userstyles in AdGuard Ad Blocker (Experimental) +sidebar_position: 9 +--- + +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 user experience, so you will need some knowledge of HTML and CSS. + +:::info Supported apps + +Currently, two AdGuard apps allow to create and manage userstyles: AdGuard for Windows and AdGuard for Mac. + +::: + +This is an experimental feature, so if you encounter any problems while adding or creating the userstyle, please contact our [support team](support@adguard.com). + +## How to set up a userstyle in AdGuard + +You can download userstyles from different websites. One of the most popular userstyles websites is [https://userstyles.world/](https://userstyles.world/explore), which we will take as an example for the following instruction on how to set up the userstyle in AdGuard. + + 1. Press the link and choose the userstyle you like + + 1. Right-click the *Install* button and choose *Copy Link Address* + + 1. Open AdGuard settings → *Extensions* + + 1. Press the [+] button and paste the userstyle link + +If you’re familiar with CSS rules, you can also create the userstyles yourself. + +:::note + +We don’t support userstyles that include `@var` and `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. + +::: + + 1. Open AdGuard settings → *Extensions* + + 1. Press the [+] button and choose the *Create userstyle* option. A new window will appear on your screen + + 1. To create a userstyle, first write the title with metadata, for example + + `/* ==UserStyle==` + + `@name New userstyle` + + `@version 1.0` + + `==/UserStyle== */` + + 1. After the metadata, write the CSS part. AdGuard supports website domain names matching (`@-moz-document domain(…), …`) + + `body {` + + ` background: gray;` + + `}` + + Or + + `@-moz-document domain('example.org'),` + + `domain('example.net'),` + + `domain('example.com') body {` + + ` background: gray;` + + `}` + + 5. Press *Save and Close* From 6115b21940cf370909193d48f60e2ed784554af4 Mon Sep 17 00:00:00 2001 From: Dasha_Bugayova Date: Wed, 21 Aug 2024 17:30:40 +0800 Subject: [PATCH 02/39] Update userstyles.md --- docs/general/userstyles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/userstyles.md b/docs/general/userstyles.md index 1127fe032cc..84fc58f309a 100644 --- a/docs/general/userstyles.md +++ b/docs/general/userstyles.md @@ -69,4 +69,4 @@ We don’t support userstyles that include `@var` and `@advanced` in the metadat `}` - 5. Press *Save and Close* + 1. Press *Save and Close* From fd4f247e759874a0b139052298b7a34afb257eb9 Mon Sep 17 00:00:00 2001 From: Dasha_Bugayova Date: Wed, 21 Aug 2024 18:31:37 +0800 Subject: [PATCH 03/39] edited the instruction list --- docs/general/userstyles.md | 50 ++++++++++++++++++-------------------- 1 file changed, 23 insertions(+), 27 deletions(-) diff --git a/docs/general/userstyles.md b/docs/general/userstyles.md index 84fc58f309a..26e3044648f 100644 --- a/docs/general/userstyles.md +++ b/docs/general/userstyles.md @@ -19,13 +19,13 @@ This is an experimental feature, so if you encounter any problems while adding o You can download userstyles from different websites. One of the most popular userstyles websites is [https://userstyles.world/](https://userstyles.world/explore), which we will take as an example for the following instruction on how to set up the userstyle in AdGuard. - 1. Press the link and choose the userstyle you like +1. Press the link and choose the userstyle you like - 1. Right-click the *Install* button and choose *Copy Link Address* +1. Right-click the *Install* button and choose *Copy Link Address* - 1. Open AdGuard settings → *Extensions* +1. Open AdGuard settings → *Extensions* - 1. Press the [+] button and paste the userstyle link +1. Press the [+] button and paste the userstyle link If you’re familiar with CSS rules, you can also create the userstyles yourself. @@ -41,32 +41,28 @@ We don’t support userstyles that include `@var` and `@advanced` in the metadat 1. To create a userstyle, first write the title with metadata, for example - `/* ==UserStyle==` - - `@name New userstyle` - - `@version 1.0` - - `==/UserStyle== */` + ``` + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` 1. After the metadata, write the CSS part. AdGuard supports website domain names matching (`@-moz-document domain(…), …`) - `body {` - - ` background: gray;` - - `}` + ``` + body { + background: gray; + } + ``` Or - `@-moz-document domain('example.org'),` - - `domain('example.net'),` - - `domain('example.com') body {` - - ` background: gray;` - - `}` - - 1. Press *Save and Close* + ``` + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` + 1. Press *Save and Close* \ No newline at end of file From 50d0e062cbe69e06cad4eddc840f91779075f30b Mon Sep 17 00:00:00 2001 From: Dasha_Bugayova Date: Wed, 21 Aug 2024 18:41:00 +0800 Subject: [PATCH 04/39] fixed --- docs/general/userstyles.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/general/userstyles.md b/docs/general/userstyles.md index 26e3044648f..ee520f58706 100644 --- a/docs/general/userstyles.md +++ b/docs/general/userstyles.md @@ -1,23 +1,23 @@ --- -title: Userstyles in AdGuard Ad Blocker (Experimental) +title: Userstyles (Experimental) sidebar_position: 9 --- 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 user experience, so you will need some knowledge of HTML and CSS. +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 to create and manage userstyles: AdGuard for Windows and AdGuard for Mac. +Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows and AdGuard for Mac. ::: -This is an experimental feature, so if you encounter any problems while adding or creating the userstyle, please contact our [support team](support@adguard.com). +This is an experimental feature, so if you encounter any problems while adding or creating the userstyle, please contact our support team at support@adguard.com. ## How to set up a userstyle in AdGuard -You can download userstyles from different websites. One of the most popular userstyles websites is [https://userstyles.world/](https://userstyles.world/explore), which we will take as an example for the following instruction on how to set up the userstyle in AdGuard. +You can download userstyles from various websites. One of the most popular userstyles websites is [https://userstyles.world/](https://userstyles.world/explore), which we will take as an example for the following instructions on how to set up the userstyle in AdGuard. 1. Press the link and choose the userstyle you like @@ -31,7 +31,7 @@ If you’re familiar with CSS rules, you can also create the userstyles yourself :::note -We don’t support userstyles that include `@var` and `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. +We don’t support userstyles that contain `@var` and `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. ::: @@ -48,7 +48,7 @@ We don’t support userstyles that include `@var` and `@advanced` in the metadat ==/UserStyle== */ ``` - 1. After the metadata, write the CSS part. AdGuard supports website domain names matching (`@-moz-document domain(…), …`) + 1. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`) ``` body { From bcefe43230c46f2ede5a06dcf4a6c0862076eadd Mon Sep 17 00:00:00 2001 From: Helen Date: Wed, 21 Aug 2024 14:00:03 +0300 Subject: [PATCH 05/39] specify a language before fenced code blocks, add a single newline character, fix a broken link --- docs/general/userstyles.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/general/userstyles.md b/docs/general/userstyles.md index ee520f58706..e567f73396f 100644 --- a/docs/general/userstyles.md +++ b/docs/general/userstyles.md @@ -13,7 +13,7 @@ Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard f ::: -This is an experimental feature, so if you encounter any problems while adding or creating the userstyle, please contact our support team at support@adguard.com. +This is an experimental feature, so if you encounter any problems while adding or creating the userstyle, please contact our support team at . ## How to set up a userstyle in AdGuard @@ -41,7 +41,7 @@ We don’t support userstyles that contain `@var` and `@advanced` in the metadat 1. To create a userstyle, first write the title with metadata, for example - ``` + ```CSS /* ==UserStyle== @name New userstyle @version 1.0 @@ -50,7 +50,7 @@ We don’t support userstyles that contain `@var` and `@advanced` in the metadat 1. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`) - ``` + ```CSS body { background: gray; } @@ -58,11 +58,12 @@ We don’t support userstyles that contain `@var` and `@advanced` in the metadat Or - ``` + ```CSS @-moz-document domain('example.org'), domain('example.net'), domain('example.com') body { background: gray; } ``` - 1. Press *Save and Close* \ No newline at end of file + + 1. Press *Save and Close* From 9c743f5c91c32f2617415c94dac115bca9fa42fa Mon Sep 17 00:00:00 2001 From: Helen Date: Wed, 21 Aug 2024 14:06:58 +0300 Subject: [PATCH 06/39] fix indentation --- docs/general/userstyles.md | 48 +++++++++++++++++++------------------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/general/userstyles.md b/docs/general/userstyles.md index e567f73396f..1178e823fed 100644 --- a/docs/general/userstyles.md +++ b/docs/general/userstyles.md @@ -35,35 +35,35 @@ We don’t support userstyles that contain `@var` and `@advanced` in the metadat ::: - 1. Open AdGuard settings → *Extensions* +1. Open AdGuard settings → *Extensions* - 1. Press the [+] button and choose the *Create userstyle* option. A new window will appear on your screen +1. Press the [+] button and choose the *Create userstyle* option. A new window will appear on your screen - 1. To create a userstyle, first write the title with metadata, for example +1. To create a userstyle, first write the title with metadata, for example - ```CSS - /* ==UserStyle== - @name New userstyle - @version 1.0 - ==/UserStyle== */ - ``` + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` - 1. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`) +1. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`) - ```CSS - body { - background: gray; - } - ``` + ```CSS + body { + background: gray; + } + ``` - Or + Or - ```CSS - @-moz-document domain('example.org'), - domain('example.net'), - domain('example.com') body { - background: gray; - } - ``` + ```CSS + @-moz-document domain('example.org'), + domain('example.net'), + domain('example.com') body { + background: gray; + } + ``` - 1. Press *Save and Close* +1. Press *Save and Close* From 1bee2efa32d5c4e5e9cb83b8c4fda2261152e561 Mon Sep 17 00:00:00 2001 From: Dasha_Bugayova Date: Thu, 22 Aug 2024 19:39:16 +0800 Subject: [PATCH 07/39] Update userstyles.md --- docs/general/userstyles.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/general/userstyles.md b/docs/general/userstyles.md index 1178e823fed..98788d7334c 100644 --- a/docs/general/userstyles.md +++ b/docs/general/userstyles.md @@ -19,7 +19,7 @@ This is an experimental feature, so if you encounter any problems while adding o You can download userstyles from various websites. One of the most popular userstyles websites is [https://userstyles.world/](https://userstyles.world/explore), which we will take as an example for the following instructions on how to set up the userstyle in AdGuard. -1. Press the link and choose the userstyle you like +1. Follow the link above and choose the userstyle you like 1. Right-click the *Install* button and choose *Copy Link Address* @@ -27,6 +27,8 @@ You can download userstyles from various websites. One of the most popular users 1. Press the [+] button and paste the userstyle link +1. Done! + If you’re familiar with CSS rules, you can also create the userstyles yourself. :::note @@ -48,7 +50,7 @@ We don’t support userstyles that contain `@var` and `@advanced` in the metadat ==/UserStyle== */ ``` -1. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`) +1. Write the CSS part after the meta data. AdGuard supports website domain names matching (`@-moz-document domain(…), …`). For example: ```CSS body { @@ -56,7 +58,7 @@ We don’t support userstyles that contain `@var` and `@advanced` in the metadat } ``` - Or + Or: ```CSS @-moz-document domain('example.org'), @@ -66,4 +68,4 @@ We don’t support userstyles that contain `@var` and `@advanced` in the metadat } ``` -1. Press *Save and Close* +1. Once you’re finished, press *Save and Close*. Your new userstyle has been successfully added to AdGuard From 171213c6452a092cc778d7558b83a9a42773d0da Mon Sep 17 00:00:00 2001 From: puglieri Date: Thu, 12 Sep 2024 13:51:43 -0300 Subject: [PATCH 08/39] Update known-issues.md --- docs/general/https-filtering/known-issues.md | 33 +++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/docs/general/https-filtering/known-issues.md b/docs/general/https-filtering/known-issues.md index 177ca1855f8..99c17a4a174 100644 --- a/docs/general/https-filtering/known-issues.md +++ b/docs/general/https-filtering/known-issues.md @@ -30,7 +30,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](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) + +- By visiting the section *Recent activity* on AdGuard for Android or *Filtering log* on 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. + +On 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](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) + +On 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 section *TLS*, click *View website certificate*. + +![Filtering log AdGuard for Windows](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) + +On AdGuard for Mac: + +1. Click the gear icon. On the dropdown 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](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency From 0e838da034e6170d6a50ef547e5043d29d0f95df Mon Sep 17 00:00:00 2001 From: puglieri <112409628+puglieri@users.noreply.github.com> Date: Mon, 16 Sep 2024 08:51:29 -0300 Subject: [PATCH 09/39] Update docs/general/https-filtering/known-issues.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/https-filtering/known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/https-filtering/known-issues.md b/docs/general/https-filtering/known-issues.md index 99c17a4a174..4ac0ae592d1 100644 --- a/docs/general/https-filtering/known-issues.md +++ b/docs/general/https-filtering/known-issues.md @@ -57,7 +57,7 @@ On AdGuard for Windows: On AdGuard for Mac: -1. Click the gear icon. On the dropdown menu, go to *Advanced* → *Filtering log...*. +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*. From cfa83104a5edbbfad1adbbd120042a86508a6d19 Mon Sep 17 00:00:00 2001 From: puglieri <112409628+puglieri@users.noreply.github.com> Date: Mon, 16 Sep 2024 08:51:51 -0300 Subject: [PATCH 10/39] Update docs/general/https-filtering/known-issues.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/https-filtering/known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/https-filtering/known-issues.md b/docs/general/https-filtering/known-issues.md index 4ac0ae592d1..8d3c30e48f7 100644 --- a/docs/general/https-filtering/known-issues.md +++ b/docs/general/https-filtering/known-issues.md @@ -51,7 +51,7 @@ On 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 section *TLS*, click *View website certificate*. +3. Under the *TLS* section, click *View website certificate*. ![Filtering log AdGuard for Windows](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) From 9e4ce2b437799acff5de46fa77cef04eda732fcf Mon Sep 17 00:00:00 2001 From: puglieri <112409628+puglieri@users.noreply.github.com> Date: Mon, 16 Sep 2024 08:52:12 -0300 Subject: [PATCH 11/39] Update docs/general/https-filtering/known-issues.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/https-filtering/known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/https-filtering/known-issues.md b/docs/general/https-filtering/known-issues.md index 8d3c30e48f7..cae1c90e274 100644 --- a/docs/general/https-filtering/known-issues.md +++ b/docs/general/https-filtering/known-issues.md @@ -36,7 +36,7 @@ This problem can be solved in 2 ways: ![Certificate Browser Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) -- By visiting the section *Recent activity* on AdGuard for Android or *Filtering log* on 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. +- 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. On AdGuard for Android: From e0ffe62be7ef9eb32b0b40e5611c1c0ad26451b8 Mon Sep 17 00:00:00 2001 From: puglieri <112409628+puglieri@users.noreply.github.com> Date: Mon, 16 Sep 2024 09:32:36 -0300 Subject: [PATCH 12/39] Update known-issues.md --- docs/general/https-filtering/known-issues.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/general/https-filtering/known-issues.md b/docs/general/https-filtering/known-issues.md index cae1c90e274..d63f5b6b627 100644 --- a/docs/general/https-filtering/known-issues.md +++ b/docs/general/https-filtering/known-issues.md @@ -38,7 +38,7 @@ This problem can be solved in 2 ways: - 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. -On AdGuard for Android: +In AdGuard for Android: 1. Click the Statistics icon on the navigation bar. 2. Go to *Recent activity*. @@ -47,7 +47,7 @@ On AdGuard for Android: ![Recent activity AdGuard for Android](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) -On AdGuard for Windows: +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. @@ -55,7 +55,7 @@ On AdGuard for Windows: ![Filtering log AdGuard for Windows](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) -On AdGuard for Mac: +In AdGuard for Mac: 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. From e5fa55f10c5411d6921e7e866ec324d0104e914f Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Tue, 17 Sep 2024 15:08:15 +0800 Subject: [PATCH 13/39] Update docs/general/userstyles.md Co-authored-by: Vasily Bagirov --- docs/general/userstyles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/userstyles.md b/docs/general/userstyles.md index 98788d7334c..16573ce0367 100644 --- a/docs/general/userstyles.md +++ b/docs/general/userstyles.md @@ -13,7 +13,7 @@ Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard f ::: -This is an experimental feature, so if you encounter any problems while adding or creating the userstyle, please contact our support team at . +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 From 830f92ca8e68310f0fec7a2c1b60490292dd9a5f Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Tue, 17 Sep 2024 15:08:31 +0800 Subject: [PATCH 14/39] Update docs/general/userstyles.md Co-authored-by: Vasily Bagirov --- docs/general/userstyles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/userstyles.md b/docs/general/userstyles.md index 16573ce0367..3f47c509957 100644 --- a/docs/general/userstyles.md +++ b/docs/general/userstyles.md @@ -33,7 +33,7 @@ If you’re familiar with CSS rules, you can also create the userstyles yourself :::note -We don’t support userstyles that contain `@var` and `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. +We don’t support userstyles that contain `@var` or `@advanced` in the metadata. AdGuard also doesn’t support `@preprocessor` without the `default` value. ::: From e03e3bd52cc718b2fcbbd2570d9f389ebe4049d7 Mon Sep 17 00:00:00 2001 From: Dasha_Bugayova Date: Tue, 17 Sep 2024 20:00:44 +0800 Subject: [PATCH 15/39] fixed the order --- docs/general/account/_category_.json | 2 +- docs/general/how-to-install.md | 2 +- docs/general/license/_category_.json | 2 +- docs/general/userstyles.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/general/account/_category_.json b/docs/general/account/_category_.json index 8a0e9e96b90..837fa4da6f0 100644 --- a/docs/general/account/_category_.json +++ b/docs/general/account/_category_.json @@ -1,5 +1,5 @@ { - "position": 6, + "position": 7, "label": "AdGuard account", "collapsible": true, "collapsed": true diff --git a/docs/general/how-to-install.md b/docs/general/how-to-install.md index bae3060668a..106a29529a8 100644 --- a/docs/general/how-to-install.md +++ b/docs/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/docs/general/license/_category_.json b/docs/general/license/_category_.json index fb0e0f10490..30c829a5962 100644 --- a/docs/general/license/_category_.json +++ b/docs/general/license/_category_.json @@ -1,5 +1,5 @@ { - "position": 7, + "position": 8, "label": "License", "collapsible": true, "collapsed": true diff --git a/docs/general/userstyles.md b/docs/general/userstyles.md index 3f47c509957..7f526fbb2f8 100644 --- a/docs/general/userstyles.md +++ b/docs/general/userstyles.md @@ -1,6 +1,6 @@ --- title: Userstyles (Experimental) -sidebar_position: 9 +sidebar_position: 6 --- 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. From 98b84ddc9a8afca726e5855008fb3a87bc0c2acc Mon Sep 17 00:00:00 2001 From: puglieri <112409628+puglieri@users.noreply.github.com> Date: Tue, 17 Sep 2024 10:15:19 -0300 Subject: [PATCH 16/39] Update known-issues.md --- docs/general/https-filtering/known-issues.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/docs/general/https-filtering/known-issues.md b/docs/general/https-filtering/known-issues.md index d63f5b6b627..7707abcf96d 100644 --- a/docs/general/https-filtering/known-issues.md +++ b/docs/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. @@ -34,34 +36,34 @@ 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](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-browser.png) +![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. -In AdGuard for Android: +#### 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](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) +![Recent activity AdGuard for Android *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-android.png) -In AdGuard for Windows: +#### 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](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) +![Filtering log AdGuard for Windows *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-win.png) -In AdGuard for Mac: +#### 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](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) +![Filtering log AdGuard for Mac *border](https://cdn.adtidy.org/content/kb/ad_blocker/general/cert-mac.png) ### Certificate Transparency From 7fdd994f93d07e6703ddcacca8d09b7deeb2988a Mon Sep 17 00:00:00 2001 From: puglieri <112409628+puglieri@users.noreply.github.com> Date: Tue, 17 Sep 2024 11:05:05 -0300 Subject: [PATCH 17/39] Update known-issues.md --- docs/general/https-filtering/known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/https-filtering/known-issues.md b/docs/general/https-filtering/known-issues.md index 7707abcf96d..8697f58139d 100644 --- a/docs/general/https-filtering/known-issues.md +++ b/docs/general/https-filtering/known-issues.md @@ -36,7 +36,7 @@ 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) + ![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. From e0a9088c247901940ea0ebe8b06b33c220d59b14 Mon Sep 17 00:00:00 2001 From: Dasha_Bugayova Date: Thu, 19 Sep 2024 19:02:48 +0800 Subject: [PATCH 18/39] added info about the versions --- docs/general/userstyles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/userstyles.md b/docs/general/userstyles.md index 7f526fbb2f8..f675265aa07 100644 --- a/docs/general/userstyles.md +++ b/docs/general/userstyles.md @@ -9,7 +9,7 @@ AdGuard has the option to upload or create your own userstyles. This is an advan :::info Supported apps -Currently, two AdGuard apps allow you to create and manage userstyles: AdGuard for Windows and AdGuard for Mac. +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. ::: From 76df1d026f1b3b6ecee4af0ab49eaf54b182d734 Mon Sep 17 00:00:00 2001 From: Dasha_Bugayova Date: Tue, 1 Oct 2024 18:37:21 +0800 Subject: [PATCH 19/39] create extensions article --- .../features/extensions.md | 2 +- docs/general/extensions.md | 301 ++++++++++++++++++ docs/general/userstyles.md | 71 ----- 3 files changed, 302 insertions(+), 72 deletions(-) create mode 100644 docs/general/extensions.md delete mode 100644 docs/general/userstyles.md diff --git a/docs/adguard-for-windows/features/extensions.md b/docs/adguard-for-windows/features/extensions.md index f0ac6065d34..1a4944eaf98 100644 --- a/docs/adguard-for-windows/features/extensions.md +++ b/docs/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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +AdGuard can significantly broaden website functionality working as a [user script 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/docs/general/extensions.md b/docs/general/extensions.md new file mode 100644 index 00000000000..95c45c6a1be --- /dev/null +++ b/docs/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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). + +:::note + +This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} + +As 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 credibility, since only scripts from moderated pages are displayed. + +#### Greasy Fork + +[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. + +#### OpenUserJS.org + +[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. + +#### Community + +If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 userstyles websites is [https://userstyles.world/](https://userstyles.world/explore), which we will take 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 + +1. Right-click the *Install* button and choose *Copy Link Address* + +1. Open AdGuard settings → *Extensions* + +1. Press the [+] button and paste the userstyle link + +1. 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* + +1. Press the [+] button and choose the *Create userstyle* option. A new window will appear on your screen + +1. To create a userstyle, first write the title with metadata, for example + + ```CSS + /* ==UserStyle== + @name New userstyle + @version 1.0 + ==/UserStyle== */ + ``` + +1. 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; + } + ``` + +1. 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/docs/general/userstyles.md b/docs/general/userstyles.md deleted file mode 100644 index f675265aa07..00000000000 --- a/docs/general/userstyles.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Userstyles (Experimental) -sidebar_position: 6 ---- - -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 userstyles websites is [https://userstyles.world/](https://userstyles.world/explore), which we will take 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 - -1. Right-click the *Install* button and choose *Copy Link Address* - -1. Open AdGuard settings → *Extensions* - -1. Press the [+] button and paste the userstyle link - -1. 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* - -1. Press the [+] button and choose the *Create userstyle* option. A new window will appear on your screen - -1. To create a userstyle, first write the title with metadata, for example - - ```CSS - /* ==UserStyle== - @name New userstyle - @version 1.0 - ==/UserStyle== */ - ``` - -1. 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; - } - ``` - -1. Once you’re finished, press *Save and Close*. Your new userstyle has been successfully added to AdGuard From 706026d06d60f58446172c74c058d9cc2a5b202c Mon Sep 17 00:00:00 2001 From: Dasha_Bugayova Date: Tue, 1 Oct 2024 18:54:04 +0800 Subject: [PATCH 20/39] fixed the order, deleted the userscripts article --- docs/general/account/_category_.json | 2 +- docs/general/extensions.md | 10 +- docs/general/license/_category_.json | 2 +- docs/general/userscripts.md | 250 --------------------------- 4 files changed, 7 insertions(+), 257 deletions(-) delete mode 100644 docs/general/userscripts.md diff --git a/docs/general/account/_category_.json b/docs/general/account/_category_.json index 837fa4da6f0..8a0e9e96b90 100644 --- a/docs/general/account/_category_.json +++ b/docs/general/account/_category_.json @@ -1,5 +1,5 @@ { - "position": 7, + "position": 6, "label": "AdGuard account", "collapsible": true, "collapsed": true diff --git a/docs/general/extensions.md b/docs/general/extensions.md index 95c45c6a1be..b68b94ec474 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -101,9 +101,9 @@ Here is a [mailto link](mailto:devteam@adguard.com?Subject=Userscript%20author%2 #### Compatibility -##### Metadata block +#### Metadata block -###### Supported properties +#### Supported properties ```text @name @@ -133,7 +133,7 @@ Here is a [mailto link](mailto:devteam@adguard.com?Subject=Userscript%20author%2 @icon64URL ``` -###### Unsupported properties +#### Unsupported properties These properties will be simply ignored by AdGuard. @@ -141,11 +141,11 @@ These properties will be simply ignored by AdGuard. @unwrap ``` -##### Supported GM functions +#### Supported GM functions AdGuard supports both old GM\_ functions and new GM4 API that use GM object. -###### Values +#### Values :::note diff --git a/docs/general/license/_category_.json b/docs/general/license/_category_.json index 30c829a5962..fb0e0f10490 100644 --- a/docs/general/license/_category_.json +++ b/docs/general/license/_category_.json @@ -1,5 +1,5 @@ { - "position": 8, + "position": 7, "label": "License", "collapsible": true, "collapsed": true diff --git a/docs/general/userscripts.md b/docs/general/userscripts.md deleted file mode 100644 index 041a2019af9..00000000000 --- a/docs/general/userscripts.md +++ /dev/null @@ -1,250 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, -as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. -All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. -`@var` and `@advanced` tags are not supported. -The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). -The `media-document()` function is not supported. -The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. -If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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; - } -} -``` From 2741cfeafedcf48f4822d398fd01fdd59f8b31f1 Mon Sep 17 00:00:00 2001 From: Dasha_Bugayova Date: Wed, 2 Oct 2024 00:09:41 +0800 Subject: [PATCH 21/39] Update docusaurus.config.js --- docusaurus.config.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docusaurus.config.js b/docusaurus.config.js index c3112ed05ae..7b6105606a5 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -160,7 +160,7 @@ module.exports = { }, { label: 'userscripts', - to: '/general/userscripts', + to: '/general/extensions', }, ], }, From 83da2e84f5321340e80c02271eb30e42f313e30a Mon Sep 17 00:00:00 2001 From: Dasha_Bugayova Date: Wed, 2 Oct 2024 00:32:04 +0800 Subject: [PATCH 22/39] Create userscripts.md --- docs/general/userscripts.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 docs/general/userscripts.md diff --git a/docs/general/userscripts.md b/docs/general/userscripts.md new file mode 100644 index 00000000000..cb75f2f9534 --- /dev/null +++ b/docs/general/userscripts.md @@ -0,0 +1,5 @@ +--- +title: Userscripts +sidebar_position: 10 +toc_max_heading_level: 4 +--- From d680f84797a22857fcc9ddd76c156a18d5b73146 Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:02:11 +0800 Subject: [PATCH 23/39] Update docs/adguard-for-windows/features/extensions.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/adguard-for-windows/features/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/adguard-for-windows/features/extensions.md b/docs/adguard-for-windows/features/extensions.md index 1a4944eaf98..49f92719641 100644 --- a/docs/adguard-for-windows/features/extensions.md +++ b/docs/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.md). 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) From ce7bc1d4e4fe8cef858eb396f6491ac2acabb681 Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:02:24 +0800 Subject: [PATCH 24/39] Update docs/general/extensions.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/extensions.md b/docs/general/extensions.md index b68b94ec474..3d8690c8f19 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -15,7 +15,7 @@ AdGuard can significantly broaden website functionality by acting as a userscrip ### 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 expose yourself to a certain risk, as some scripts may be harmful to your computer. +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 From f4508e5db0b92ced385d825bcbf25fc23b18efde Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:02:42 +0800 Subject: [PATCH 25/39] Update docs/general/extensions.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/extensions.md b/docs/general/extensions.md index 3d8690c8f19..d82c9cfc9ad 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -25,7 +25,7 @@ An extension that blocks ads in difficult cases when the usual filter-based appr #### AdGuard Popup Blocker -The name speaks for itself: it blocks pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it on [GitHub](https://github.com/AdguardTeam/PopupBlocker). +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) From dec60cbb8998a7f83d2fe84e4b84412093c141bd Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:02:56 +0800 Subject: [PATCH 26/39] Update docs/general/extensions.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/extensions.md b/docs/general/extensions.md index d82c9cfc9ad..4540006460e 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -35,7 +35,7 @@ This custom extension is designed to control filtering directly from the browser :::note -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your can learn how to install AdGuard Assistant on [GitHub](https://github.com/AdguardTeam/AdguardAssistant). +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). ::: From e25eb54099fc7366dddc55924b371d0f7244c1e4 Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:03:32 +0800 Subject: [PATCH 27/39] Update docs/general/extensions.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/extensions.md b/docs/general/extensions.md index 4540006460e..507adb35cd4 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -47,7 +47,7 @@ A script that is only pre-installed in AdGuard for Android. It disables AMP (Acc ### 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 as they've all earned their good reputation. +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 From 0b02014cfca206ff08fd9d94b44d39702b4a1642 Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:03:48 +0800 Subject: [PATCH 28/39] Update docs/general/extensions.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/extensions.md b/docs/general/extensions.md index 507adb35cd4..11532064136 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -57,7 +57,7 @@ Its source code is [available on GitHub](https://github.com/Rob--W/dont-track-me #### microShield -A userscript for people who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. Its original source code is available at [asdefuser](https://github.com/seia-soto/userscripts/tree/master/sources/asdefuser) and [AdShield Defuser](https://github.com/seia-soto/adshield-defuser). This userscript can be installed in AdGuard CoreLibs-based apps, Violentmonkey, Tampermonkey, and [quoid/userscripts](https://github.com/quoid/userscripts). Learn more about microShield and how to install it on [GitHub](https://github.com/List-KR/microShield). +A userscript for people visiting Korean websites and some international websites. The 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} From cd79e53f4df309b2111f54b37ca8649d40990f65 Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:03:56 +0800 Subject: [PATCH 29/39] Update docs/general/extensions.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/extensions.md b/docs/general/extensions.md index 11532064136..68db70576c8 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -219,7 +219,7 @@ AdGuard has the option to upload or create your own userstyles. This is an advan :::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. +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. ::: From 51fa9ade661622da6330c610f7f984b2d53395b3 Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:04:11 +0800 Subject: [PATCH 30/39] Update docs/general/extensions.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/extensions.md b/docs/general/extensions.md index 68db70576c8..22efa6f6b9a 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -61,7 +61,7 @@ A userscript for people visiting Korean websites and some international websites ### Where can you get more userscripts?{#more-userscripts} -As 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. +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. From f373e3819fca653b261b075eb7f43d3aa1580cdb Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:04:24 +0800 Subject: [PATCH 31/39] Update docs/general/extensions.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/extensions.md b/docs/general/extensions.md index 22efa6f6b9a..25dd00fbaa2 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -227,7 +227,7 @@ This is an experimental feature, so if you encounter any problems while adding o ### How to set up a userstyle in AdGuard -You can download userstyles from various websites. One of the most popular userstyles websites is [https://userstyles.world/](https://userstyles.world/explore), which we will take as an example for the following instructions on how to set up the 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 From 6b6544bbd3a685f988106dc8b39d227d62eb6a16 Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:04:38 +0800 Subject: [PATCH 32/39] Update docs/general/extensions.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/extensions.md b/docs/general/extensions.md index 25dd00fbaa2..9459482dfaa 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -89,7 +89,7 @@ If you like the idea of personifying your browser with the help of userscripts, #### Request license -If you are developing your own custom script and want to test how it works with AdGuard, request a beta license key for the app. +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: From 6f110eda8d4d97407ab37ca959b4df852d5a7920 Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:04:50 +0800 Subject: [PATCH 33/39] Update docs/general/extensions.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/extensions.md b/docs/general/extensions.md index 9459482dfaa..5d3792879dc 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -79,7 +79,7 @@ Here we will describe some of the most popular userscript catalogs. #### Community -If you like the idea of personifying your browser with the help of userscripts, and you have any questions, you can ask them on one of these websites: +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) From d9c0b3a8a717b3b099098e7729985a1b7576e013 Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:05:01 +0800 Subject: [PATCH 34/39] Update docs/general/extensions.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/extensions.md b/docs/general/extensions.md index 5d3792879dc..6dbdf122b35 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -75,7 +75,7 @@ Here we will describe some of the most popular userscript catalogs. #### OpenUserJS.org -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. +[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 From 8fa3352ca32c176421a7480566de518e6f6b691a Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:05:15 +0800 Subject: [PATCH 35/39] Update docs/general/extensions.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/extensions.md b/docs/general/extensions.md index 6dbdf122b35..94104db6b53 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -67,7 +67,7 @@ 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 credibility, since only scripts from moderated pages are displayed. +[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 From ba3f486da2abdd5d19397a1b52e6d491c36cc14e Mon Sep 17 00:00:00 2001 From: Dasha_Bu <67567540+DashaBu@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:05:37 +0800 Subject: [PATCH 36/39] Update docs/general/extensions.md Co-authored-by: Helen <58733007+el-termikael@users.noreply.github.com> --- docs/general/extensions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/extensions.md b/docs/general/extensions.md index 94104db6b53..6d0b3e31a91 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -71,7 +71,7 @@ Here we will describe some of the most popular userscript catalogs. #### Greasy Fork -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. +[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 From 93e9be2dc9aa150559282f8dbe4dbb1af46729b6 Mon Sep 17 00:00:00 2001 From: Dasha_Bugayova Date: Tue, 8 Oct 2024 16:06:20 +0800 Subject: [PATCH 37/39] Update extensions.md --- docs/general/extensions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/general/extensions.md b/docs/general/extensions.md index b68b94ec474..c341ba12f70 100644 --- a/docs/general/extensions.md +++ b/docs/general/extensions.md @@ -19,7 +19,7 @@ These userscripts come directly from the AdGuard developers, and we can guarante #### AdGuard Extra -An extension that blocks ads in difficult cases when the usual filter-based approach is not enough. AdGuard Extra comes pre-installed with all premium AdGuard versions, 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). +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) @@ -31,7 +31,7 @@ The name speaks for itself: it blocks pop-ups — one of the most annoying types #### AdGuard Assistant (legacy version) -This custom extension is designed to control filtering directly from the browser page (manual blocking, exclusion of the site, etc.). +This custom extension is designed to control filtering directly from the browser page (manual blocking, allowlisting, etc.). :::note From d9af87781c026e0040b05adae0a010ee4c0b7817 Mon Sep 17 00:00:00 2001 From: Dasha_Bugayova Date: Fri, 11 Oct 2024 18:36:28 +0800 Subject: [PATCH 38/39] extensions --- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/be/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/bn/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/cs/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/da/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/de/docusaurus-theme-classic/footer.json | 2 +- i18n/en/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/es/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/fa/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/fi/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/fr/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/hr/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/hu/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/it/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/ja/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/ko/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/nl/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/no/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/pl/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/pt-BR/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/pt/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/ro/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/ru/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/sk/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/sl/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/sv/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/ta/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/tr/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/uk/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/vi/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/zh-CN/docusaurus-theme-classic/footer.json | 2 +- .../current/adguard-for-windows/features/extensions.md | 2 +- i18n/zh-TW/docusaurus-theme-classic/footer.json | 2 +- 61 files changed, 61 insertions(+), 61 deletions(-) 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/be/docusaurus-theme-classic/footer.json b/i18n/be/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/be/docusaurus-theme-classic/footer.json +++ b/i18n/be/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/bn/docusaurus-theme-classic/footer.json b/i18n/bn/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/bn/docusaurus-theme-classic/footer.json +++ b/i18n/bn/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 7d9c5dcee4f..d4bf7066b20 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/userscripts). Uživatelé AdGuardu mohou přidávat své vlastní skripty a také spravovat stávající. +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í. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/cs/docusaurus-theme-classic/footer.json b/i18n/cs/docusaurus-theme-classic/footer.json index 9d4e10b20e7..66b60c97248 100644 --- a/i18n/cs/docusaurus-theme-classic/footer.json +++ b/i18n/cs/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Uživatelské skripty", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Zakoupit licenci", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/da/docusaurus-theme-classic/footer.json b/i18n/da/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/da/docusaurus-theme-classic/footer.json +++ b/i18n/da/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 c2bd00c022d..f2c087c1fb6 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/userscripts). Sie können ihre eigenen Skripte hinzufügen und bestehende Skripte verwalten. +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. ![Erweiterungen \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/de/docusaurus-theme-classic/footer.json b/i18n/de/docusaurus-theme-classic/footer.json index 422990d08bb..0903be6148f 100644 --- a/i18n/de/docusaurus-theme-classic/footer.json +++ b/i18n/de/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Benutzerskripte", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Lizenz kaufen", diff --git a/i18n/en/docusaurus-theme-classic/footer.json b/i18n/en/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/en/docusaurus-theme-classic/footer.json +++ b/i18n/en/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 67b5064687b..4e281975840 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/userscripts). Los usuarios de AdGuard pueden añadir sus propios scripts, así como gestionar los existentes. +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. ![Extensiones \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/es/docusaurus-theme-classic/footer.json b/i18n/es/docusaurus-theme-classic/footer.json index 876c499e590..6c128f4a245 100644 --- a/i18n/es/docusaurus-theme-classic/footer.json +++ b/i18n/es/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Comprar licencia", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/fa/docusaurus-theme-classic/footer.json b/i18n/fa/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/fa/docusaurus-theme-classic/footer.json +++ b/i18n/fa/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/fi/docusaurus-theme-classic/footer.json b/i18n/fi/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/fi/docusaurus-theme-classic/footer.json +++ b/i18n/fi/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 7bd955178a4..212f7421e60 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/userscripts). Les utilisateurs d'AdGuard peuvent ajouter leurs propres scripts et gérer les scripts existants. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/fr/docusaurus-theme-classic/footer.json b/i18n/fr/docusaurus-theme-classic/footer.json index bf23674b658..0f153a5f45d 100644 --- a/i18n/fr/docusaurus-theme-classic/footer.json +++ b/i18n/fr/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Scripts utilisateur", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Acheter une licence", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/hr/docusaurus-theme-classic/footer.json b/i18n/hr/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/hr/docusaurus-theme-classic/footer.json +++ b/i18n/hr/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/hu/docusaurus-theme-classic/footer.json b/i18n/hu/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/hu/docusaurus-theme-classic/footer.json +++ b/i18n/hu/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 5293eaadd73..9bf54936cbc 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/userscripts). Gli Utenti di AdGuard possono aggiungere i propri script, nonché gestire quelli esistenti. +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. ![Estensioni \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/it/docusaurus-theme-classic/footer.json b/i18n/it/docusaurus-theme-classic/footer.json index 434634e1856..8117fbe8351 100644 --- a/i18n/it/docusaurus-theme-classic/footer.json +++ b/i18n/it/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Script utente", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Acquista Licenza", 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 1ad3b4d15b3..50a0b1ff7e4 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/userscripts)として、ウェブサイトの機能を大幅に拡張することができます。 AdGuard のユーザーは、独自のスクリプトを追加したり、既存のスクリプトを管理したりできます。 +AdGuard は[ユーザースクリプトマネージャ](/general/extensions)として、ウェブサイトの機能を大幅に拡張することができます。 AdGuard のユーザーは、独自のスクリプトを追加したり、既存のスクリプトを管理したりできます。 ![拡張機能画面 \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/ja/docusaurus-theme-classic/footer.json b/i18n/ja/docusaurus-theme-classic/footer.json index f95b0e0fbf0..98962a8f9e5 100644 --- a/i18n/ja/docusaurus-theme-classic/footer.json +++ b/i18n/ja/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "ユーザースクリプト", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "ライセンスを購入する", 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 6999c493f01..32776dd1894 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/userscripts) 역할을 수행하여 웹사이트 기능을 크게 확장할 수 있습니다. AdGuard 사용자는 자체 스크립트를 추가할 수 있을 뿐만 아니라 기존 스크립트를 관리할 수도 있습니다. +AdGuard는 [유저스크립트 관리자](/general/extensions) 역할을 수행하여 웹사이트 기능을 크게 확장할 수 있습니다. AdGuard 사용자는 자체 스크립트를 추가할 수 있을 뿐만 아니라 기존 스크립트를 관리할 수도 있습니다. ![확장 프로그램 \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/ko/docusaurus-theme-classic/footer.json b/i18n/ko/docusaurus-theme-classic/footer.json index 4d8e959b53a..aec6e25e1d4 100644 --- a/i18n/ko/docusaurus-theme-classic/footer.json +++ b/i18n/ko/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "유저스크립트", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/nl/docusaurus-theme-classic/footer.json b/i18n/nl/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/nl/docusaurus-theme-classic/footer.json +++ b/i18n/nl/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/no/docusaurus-theme-classic/footer.json b/i18n/no/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/no/docusaurus-theme-classic/footer.json +++ b/i18n/no/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/pl/docusaurus-theme-classic/footer.json b/i18n/pl/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/pl/docusaurus-theme-classic/footer.json +++ b/i18n/pl/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 16d965d8bbf..f167a43dd1b 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/userscripts). Os usuários do AdGuard podem adicionar seus próprios scripts, bem como gerenciar os existentes. +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. ![Extensões \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/pt-BR/docusaurus-theme-classic/footer.json b/i18n/pt-BR/docusaurus-theme-classic/footer.json index fe87553b847..9eb5f9a726d 100644 --- a/i18n/pt-BR/docusaurus-theme-classic/footer.json +++ b/i18n/pt-BR/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Comprar licença", 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 af305b67447..148c96e1679 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/pt/docusaurus-theme-classic/footer.json b/i18n/pt/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/pt/docusaurus-theme-classic/footer.json +++ b/i18n/pt/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/ro/docusaurus-theme-classic/footer.json b/i18n/ro/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/ro/docusaurus-theme-classic/footer.json +++ b/i18n/ro/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 d45183b65d2..19f8c1d65d3 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/userscripts). Пользователи AdGuard могут добавлять собственные скрипты, а также управлять существующими. +AdGuard может значительно расширить функциональность сайта, работая в качестве [менеджера пользовательских скриптов](/general/extensions). Пользователи AdGuard могут добавлять собственные скрипты, а также управлять существующими. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/ru/docusaurus-theme-classic/footer.json b/i18n/ru/docusaurus-theme-classic/footer.json index 947160a5392..0a2779bfa0a 100644 --- a/i18n/ru/docusaurus-theme-classic/footer.json +++ b/i18n/ru/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Пользовательские скрипты", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Купить лицензию", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/sk/docusaurus-theme-classic/footer.json b/i18n/sk/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/sk/docusaurus-theme-classic/footer.json +++ b/i18n/sk/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/sl/docusaurus-theme-classic/footer.json b/i18n/sl/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/sl/docusaurus-theme-classic/footer.json +++ b/i18n/sl/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/sv/docusaurus-theme-classic/footer.json b/i18n/sv/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/sv/docusaurus-theme-classic/footer.json +++ b/i18n/sv/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/ta/docusaurus-theme-classic/footer.json b/i18n/ta/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/ta/docusaurus-theme-classic/footer.json +++ b/i18n/ta/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 73673a4b6f5..40764a643b8 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/userscripts). AdGuard Kullanıcıları kendi betiklerini ekleyebilir ve mevcut olanları yönetebilir. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/tr/docusaurus-theme-classic/footer.json b/i18n/tr/docusaurus-theme-classic/footer.json index 9d618fb5bbf..acef9887137 100644 --- a/i18n/tr/docusaurus-theme-classic/footer.json +++ b/i18n/tr/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Kullanıcı Betikleri", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Lisans Satın Al", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/uk/docusaurus-theme-classic/footer.json b/i18n/uk/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/uk/docusaurus-theme-classic/footer.json +++ b/i18n/uk/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/vi/docusaurus-theme-classic/footer.json b/i18n/vi/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/vi/docusaurus-theme-classic/footer.json +++ b/i18n/vi/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", 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 9ba272d3afa..016a2ab3556 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/userscripts)以显著扩展网站功能。 AdGuard 用户可以添加自己的脚本，也可以管理现有脚本。 +AdGuard 可作为[用户脚本管理器](/general/extensions)以显著扩展网站功能。 AdGuard 用户可以添加自己的脚本，也可以管理现有脚本。 ![扩展 \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/zh-CN/docusaurus-theme-classic/footer.json b/i18n/zh-CN/docusaurus-theme-classic/footer.json index 53231c15e57..82a42d442e5 100644 --- a/i18n/zh-CN/docusaurus-theme-classic/footer.json +++ b/i18n/zh-CN/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "用户脚本", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "购买许可", 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 0dda1ff7459..260fa0e83b3 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/userscripts). AdGuard Users can add their own scripts, as well as manage existing ones. +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. ![Extensions \*mobile\_border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/userscripts.png) diff --git a/i18n/zh-TW/docusaurus-theme-classic/footer.json b/i18n/zh-TW/docusaurus-theme-classic/footer.json index 927b9e1794e..e3258e04917 100644 --- a/i18n/zh-TW/docusaurus-theme-classic/footer.json +++ b/i18n/zh-TW/docusaurus-theme-classic/footer.json @@ -73,7 +73,7 @@ }, "link.item.label.userscripts": { "message": "Userscripts", - "description": "The label of footer link with label=userscripts linking to /general/userscripts" + "description": "The label of footer link with label=userscripts linking to /general/extensions" }, "link.item.label.purchase_license": { "message": "Purchase License", From 32fefe0748184eb0ae84fcb93add02623eecb201 Mon Sep 17 00:00:00 2001 From: Dasha_Bugayova Date: Fri, 11 Oct 2024 18:50:16 +0800 Subject: [PATCH 39/39] deleted userscripts.md --- docs/general/userscripts.md | 5 - .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ .../current/general/userscripts.md | 243 ------------------ 30 files changed, 7052 deletions(-) delete mode 100644 docs/general/userscripts.md delete mode 100644 i18n/bn/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/cs/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/da/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/de/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/es/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/fa/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/fi/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/fr/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/hr/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/hu/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/it/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/ja/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/ko/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/nl/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/no/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/pl/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/pt-BR/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/pt/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/ro/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/ru/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/sk/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/sl/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/sv/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/ta/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/tr/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/uk/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/vi/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/zh-CN/docusaurus-plugin-content-docs/current/general/userscripts.md delete mode 100644 i18n/zh-TW/docusaurus-plugin-content-docs/current/general/userscripts.md diff --git a/docs/general/userscripts.md b/docs/general/userscripts.md deleted file mode 100644 index cb75f2f9534..00000000000 --- a/docs/general/userscripts.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: Userscripts -sidebar_position: 10 -toc_max_heading_level: 4 ---- diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/general/userscripts.md b/i18n/bn/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/bn/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/cs/docusaurus-plugin-content-docs/current/general/userscripts.md b/i18n/cs/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 3e1c386efc9..00000000000 --- a/i18n/cs/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Uživatelské skripty -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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. - -:::notePodporované aplikace - -AdGuard může výrazně rozšířit funkčnost webových stránek tím, že funguje jako správce uživatelských skriptů. V našich třech produktech můžete přidávat vlastní skripty nebo spravovat ty stávající: [AdGuard pro Windows](/adguard-for-windows/features/extensions), [AdGuard pro Android](/adguard-for-android/features/settings#userscripts) a [AdGuard pro macOS](/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 expose 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 je předinstalován ve všech prémiových verzích AdGuardu, takže pro jeho aktivaci nemusíte nic dělat. 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í. Více informací o tomto uživatelském skriptu a jeho instalaci najdete na [GitHubu](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 - -Název mluví sám za sebe: blokuje vyskakovací okna — jeden z nejotravnějších typů reklam na webových stránkách. Více informací o tomto uživatelském skriptu, jeho klíčových funkcích a o tom, jak jej nainstalovat najdete na [GitHubu](https://github.com/AdguardTeam/PopupBlocker). - -![AdGuard blokátor vyskakovacích oken](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) - -### AdGuard asistent (starší verze) - -Toto vlastní rozšíření je určeno k ovládání filtrování přímo ze stránky prohlížeče (ruční blokování, vyloučení webu atd.). - -:::note - -Tato verze Asistenta je starší a nemá smysl ji používat v nových systémech, protože byla nahrazena plnohodnotným [Asistentem prohlížeče](https://adguard.com/adguard-assistant/overview.html). Pokud však pro váš prohlížeč neexistuje Asistent prohlížeče, může vám pomoci starší asistent. Pokud je to váš případ, můžete se dozvědět, jak nainstalovat AdGuard asistent na [GitHubu](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. Více informací o tomto uživatelském skriptu a jeho instalaci najdete na [GitHubu](https://github.com/AdguardTeam/DisableAMP). - -![Zakázat 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 as 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 - -Uživatelský skript pro lidi, kteří navštěvují korejské a některé mezinárodní webové stránky. Uživatelský skript microShield blokuje Ad-Shield a anti-adblock. Jeho původní zdrojový kód je k dispozici na [asdefuser](https://github.com/seia-soto/userscripts/tree/master/sources/asdefuser) a [AdShield Defuser](https://github.com/seia-soto/adshield-defuser). Tento uživatelský skript lze nainstalovat v AdGuard CoreLibs, Violentmonkey, Tampermonkey a [quoid/userscripts](https://github.com/quoid/userscripts). Více informací o tomto uživatelském skriptu a jeho instalaci najdete na [GitHubu](https://github.com/List-KR/microShield). - -## Kde můžete získat další uživatelské skripty?{#more-userscripts} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) je katalog uživatelských skriptů od tvůrců Stylish. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) je open source katalog uživatelských skriptů napsaný v nodeJS. Není moderován, takže si dávejte pozor na podezřelé skripty. - -### Komunita - -Pokud se vám myšlenka personifikace prohlížeče pomocí uživatelských skriptů líbí a máte nějaké dotazy, můžete je položit na jedné z těchto webových stránek: - -- [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 - -Pokud vyvíjíte vlastní skript a chcete si vyzkoušet, jak s AdGuardem funguje, požádejte o licenční klíč pro beta verzi aplikace. - -Chcete-li ji získat, zašlete e-mail na adresu devteam@adguard.com a uveďte následující informace: - -**Předmět:** Žádost o autorskou licenci uživatelského skriptu - -**Popis:** Řekněte nám prosím o uživatelských skriptech, na kterých pracujete. - -Zde je [odkaz](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 -``` - -[Zde](https://wiki.greasespot.net/GM.info) najdete další informace o rozhraní 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/da/docusaurus-plugin-content-docs/current/general/userscripts.md b/i18n/da/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/da/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/de/docusaurus-plugin-content-docs/current/general/userscripts.md b/i18n/de/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 3d9ba03e5fe..00000000000 --- a/i18n/de/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Benutzerskripte -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 Unterstützte 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 expose 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 ist bei allen Premium-Versionen von AdGuard vorinstalliert, Sie müssen also nichts tun, um es zu aktivieren. Wenn Sie es jedoch zusammen mit AdGuard Browsererweiterung oder einem anderen Werbeblocker verwenden möchten, müssen Sie eine zusätzliche Erweiterung verwenden. Auf [GitHub](https://github.com/AdguardTeam/AdGuardExtra) erfahren Sie mehr über dieses Benutzerskript und wie man es installiert. - -![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) - -### AdGuard Pop-up-Blocker - -Der Name spricht für sich selbst: Es blockiert Pop-ups, eine der lästigsten Arten von Werbung auf Websites. Auf [GitHub](https://github.com/AdguardTeam/PopupBlocker) erfahren Sie mehr über dieses Benutzerskript, seine wichtigsten Funktionen und wie man es installiert. - -![AdGuard Pop-up-Blocker](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) - -### AdGuard-Assistent (alte Version) - -Diese benutzerdefinierte Erweiterung wurde entwickelt, um die Filterung direkt von der Browserseite aus zu steuern (manuelles Sperren, Ausschluss der Website usw.). - -:::note - -Diese Version des Assistenten ist veraltet und macht auf neuen Systemen keinen Sinn mehr. Sie wurde durch den vollwertigen [Browser-Assistenten](https://adguard.com/adguard-assistant/overview.html) ersetzt. Der Legacy-Assistent kann jedoch hilfreich sein, wenn es für Ihren Browser keinen Browser-Assistenten gibt. Wenn dies bei Ihnen der Fall ist, können Sie auf [GitHub](https://github.com/AdguardTeam/AdguardAssistant) erfahren, wie Sie den AdGuard-Assistenten installieren. - -::: - -### AMP deaktivieren - -Ein Skript, das nur in AdGuard für Android vorinstalliert ist. Es deaktiviert AMP (Accelerated Mobile Pages) auf der Google-Suchergebnisseite. Auf [GitHub](https://github.com/AdguardTeam/DisableAMP) erfahren Sie mehr über dieses Benutzerskript und wie man es installiert. - -![AMP deaktivieren](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 as 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 - -Ein Benutzerskript für Leute, die koreanische und einige internationale Websites besuchen. Das microShield-Benutzerskript blockiert Ad-Shield-Werbung und Anti-Adblock. Der ursprüngliche Quellcode ist unter [asdefuser](https://github.com/seia-soto/userscripts/tree/master/sources/asdefuser) und [AdShield Defuser](https://github.com/seia-soto/adshield-defuser) verfügbar. Dieses Benutzerskript kann in AdGuard CoreLibs-basierten Anwendungen, Violentmonkey, Tampermonkey und [quoid/userscripts](https://github.com/quoid/userscripts) installiert werden. Auf [GitHub](https://github.com/List-KR/microShield) finden Sie weitere Informationen über microShield und wie man es installiert. - -## Wo kann man weitere Benutzerskripte erhalten? {#more-userscripts} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) ist ein Benutzerskript-Katalog der Entwickler von Stylish. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. Da es keine Moderation gibt, sollten Sie auf verdächtige Skripte achten. - -### Community - -Wenn Ihnen die Idee gefällt, Ihren Browser mit Hilfe von Benutzerskripten zu personifizieren, und Sie Fragen haben, können Sie diese auf einer dieser Websites stellen: - -- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) -- [FreeNode](https://webchat.freenode.net/#greasemonkey) -- [Reddit](https://www.reddit.com/r/userscripts/) - -## Entwicklung - -### Lizenz anfordern - -Wenn Sie Ihr eigenes benutzerdefiniertes Skript entwickeln und testen möchten, wie es mit AdGuard funktioniert, können Sie einen Beta-Lizenzschlüssel für die App anfordern. - -Um sie zu erhalten, senden Sie bitte eine E-Mail an devteam@adguard.com mit den folgenden Informationen: - -**Betreff:** Userscript author license request - -**Body:** Please tell us about the userscripts you are working on. - -Hier ist ein [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 -``` - -[Hier](https://wiki.greasespot.net/GM.info) finden Sie weitere Informationen zur 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/es/docusaurus-plugin-content-docs/current/general/userscripts.md b/i18n/es/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index fe878fe2e94..00000000000 --- a/i18n/es/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 Aplicaciones compatibles - -AdGuard puede ampliar significativamente la funcionalidad del sitio web al actuar como administrador de scripts de usuario. Puedes agregar tus scripts personalizados o administrar los existentes en nuestros tres productos: [AdGuard para Windows](/adguard-for-windows/features/extensions), [AdGuard para Android](/adguard-for-android/features/settings#userscripts)y [ y AdGuard para 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. Para algunos de los scripts de usuario desarrollados por terceros que consideramos buenos y confiables, [desplázate hacia abajo hasta la siguiente sección](#top-picks). También puedes encontrar algunos de los [sitios web populares con scripts](#more-userscripts) a continuación, pero recuerda que cada vez que descargas un script de usuario de una fuente desconocida, te expones a cierto riesgo, ya que algunos scripts pueden ser dañinos a tu computadora. - -### AdGuard Extra - -Una extensión que bloquea anuncios en casos difíciles cuando el enfoque habitual basado en filtros no es suficiente. AdGuard Extra viene preinstalado con todas las versiones premium de AdGuard, por lo que no necesitas hacer nada para habilitarlo. 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. Obtén más información sobre este script de usuario y cómo instalarlo en [GitHub](https://github.com/AdguardTeam/AdGuardExtra). - -![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) - -### AdGuard Popup Blocker - -El nombre habla por sí solo: bloquea las ventanas emergentes, uno de los tipos de anuncios más molestos en las páginas web. Obtén más información sobre este script de usuario, sus características clave y cómo instalarlo en [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) - -Esta extensión personalizada está diseñada para controlar el filtrado directamente desde la página del navegador (bloqueo manual, exclusión del sitio, etc.). - -:::note - -Esta versión del Asistente es heredada y no tiene sentido usarla en sistemas nuevos, ya que ha sido reemplazada por el [Asistente de navegador](https://adguard.com/adguard-assistant/overview.html)completo. Pero el Asistente antiguo puede ser de ayuda si no hay un Asistente de navegador para tu navegador. Si este es tu caso, puedes aprender cómo instalar AdGuard Assistant en [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. Obtén más información sobre este script de usuario y cómo instalarlo en [GitHub](https://github.com/AdguardTeam/DisableAMP). - -![Deshabilitar AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) - -## Mejores opciones fuera de AdGuard{#top-picks} - -AdGuard no desarrolla estos scripts de usuario y, por lo tanto, no podemos ofrecer una garantía del 100% de que sean seguros y/o funcionen en todo momento. Sin embargo, según nuestra experiencia, merecen una recomendación ya que todos se han ganado su buena reputación. - -### 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. - -Tu código fuente es [disponible en GitHub](https://github.com/Rob--W/dont-track-me-google). Este script de usuario se puede descargar desde [GreasyFork](https://greasyfork.org/en/scripts/428243-don-t-track-me-google) e instalar en cualquier aplicación basada en AdGuard CoreLibs. - -### microShield - -Un script de usuario para personas que visitan sitios web coreanos y algunos sitios web internacionales. El script de usuario de microShield bloquea la publicidad de Ad-Shield y el antibloqueo de publicidad. Tu código fuente original está disponible en [asdefuser](https://github.com/seia-soto/userscripts/tree/master/sources/asdefuser) y [AdShield Defuser](https://github.com/seia-soto/adshield-defuser). Este script de usuario se puede instalar en aplicaciones basadas en AdGuard CoreLibs, Violentmonkey, Tampermonkey y [quoid/userscripts](https://github.com/quoid/userscripts). Más información sobre microShield y cómo instalarlo en [GitHub](https://github.com/List-KR/microShield). - -## ¿Dónde conseguir más scripts de usuario?{#more-userscripts} - -Como los scripts de usuario son creados principalmente por entusiastas, debes tener cuidado al instalarlos. 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) es un sitio web que permite buscar scripts de usuario ingresando una URL o dominio coincidente. El sitio web es fácil de usar y tiene una alta credibilidad, ya que sólo se muestran los scripts de las páginas moderadas. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) es un catálogo de scripts de usuario de los creadores de Stylish. Los scripts de este catálogo pasan por moderación, por lo que su credibilidad es mucho mayor. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) es un catálogo de scripts de usuario de código abierto escrito en nodeJS. No tiene moderación, así que mantente alerta ante cualquier script sospechoso. - -### Comunidad - -Si te gusta la idea de personalizar tu navegador con la ayuda de scripts de usuario, y tienes alguna duda, puedes preguntarlo en uno de estos sitios web: - -- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) -- [FreeNode](https://webchat.freenode.net/#greasemonkey) -- [Reddit](https://www.reddit.com/r/userscripts/) - -## Desarrollo - -### Solicitar licencia - -Si estás desarrollando tu propio script personalizado y deseas probar cómo funciona con AdGuard, solicita una clave de licencia beta para la aplicación. - -Para obtenerlo, envía un correo electrónico a devteam@adguard.com con la siguiente información: - -**Asunto:** Solicitud de licencia de autor de script de usuario - -**Cuerpo:** Cuéntanos sobre los scripts de usuario en los que estás trabajando. - -Aquí hay un [enlace mailto](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 -``` - -[Aquí](https://wiki.greasespot.net/GM.info) puedes encontrar más información sobre la API de Greasemonkey. - -### 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 - -Los productos AdGuard brindan soporte limitado para estilos de usuario. Las tags de metadatos `@var` y `@advanced` no son compatibles, así como cualquier valor de la etiqueta de metadatos `@preprocessor` excepto `predeterminado`. - -### Metadatos - -El bloque de metadatos se escribe utilizando comentarios de estilo CSS, comenzando con `===UserStyle===` y terminando con `===/UserStyle===`. Todas las tags de metadatos que son compatibles con los scripts de usuario también son compatibles con los estilos de usuario, aunque algunas de ellas no tienen significado y se ignoran. Las etiquetas `@var` y `@advanced` no son compatibles. El único valor admitido de la tag `@preprocessor` es `predeterminado`. - -### Contenido - -El contenido de un estilo de usuario es CSS simple con soporte para la regla at [`@-moz-document`](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). La función `media-document()` no es compatible. El estilo de usuario solo se aplicará a las páginas que coincidan con una o más de las reglas `@-moz-document`. Si el estilo de usuario no contiene ninguna regla `@-moz-document`, no se aplicará. - -### 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/fa/docusaurus-plugin-content-docs/current/general/userscripts.md b/i18n/fa/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/fa/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/userscripts.md b/i18n/fi/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/fi/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/userscripts.md b/i18n/fr/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 995fc1f4a92..00000000000 --- a/i18n/fr/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Scripts utilisateur -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 Applications prises en charge - -AdGuard peut accroître considérablement les fonctionnalités des sites web en agissant comme un gestionnaire de scripts utilisateur. Vous pouvez ajouter vos scripts personnalisés ou gérer ceux existants dans nos trois produits : [AdGuard pour Windows](/adguard-for-windows/features/extensions), [AdGuard pour Android](/adguard-for-android/features/settings#userscripts)et [AdGuard pour 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. Pour certains des scripts utilisateur développés par d'autres que nous considérons comme bons et fiables, [faites défiler jusqu'à la section suivante](#top-picks). Vous pouvez également trouver ci-dessous certains des [sites web populaires avec des scripts](#more-userscripts) , mais n'oubliez pas que chaque fois que vous téléchargez un script utilisateur à partir d'une source inconnue, vous vous exposez à un certain risque, car certains scripts peuvent être dangereux pour votre ordinateur. - -### 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 est préinstallée avec toutes les versions premium d'AdGuard, vous n'avez donc rien à faire pour l'activer. 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. Apprenez-en plus sur ce script utilisateur et comment l'installer sur [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 - -Le nom parle de lui-même : il bloque les pop-ups, l'un des types de publicités les plus agaçants sur les pages web. Pour apprendre plus sur ce script utilisateur, ses principales fonctionnalités et la manière de l'installer, consultez [GitHub](https://github.com/AdguardTeam/PopupBlocker). - -![Bloqueur AdGuard de fenêtres pop-up](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) - -### Assistant AdGuard (ancienne version) - -Cette extension personnalisée est conçue pour contrôler le filtrage directement depuis la page du navigateur (blocage manuel, exclusion du site, etc.). - -:::note - -Cette version de l'assistant est obsolète et inutile à utiliser sur les nouveaux systèmes, puisqu'elle a été remplacée par l'[Assistant de navigateur](https://adguard.com/adguard-assistant/overview.html) complet séparé. Mais l'ancien Assistant peut être utile s'il n'y a pas d'Assistant de navigateur pour votre navigateur. Si c’est votre cas, vous pouvez apprendre comment installer l'Assistant AdGuard sur [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. Apprenez plus sur ce script utilisateur et comment l'installer sur [GitHub](https://github.com/AdguardTeam/DisableAMP). - -![Désactiver AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) - -## Meilleurs choix en dehors d'AdGuard{#top-picks} - -Ces scripts utilisateur ne sont pas développés par AdGuard et nous ne pouvons donc pas garantir à 100 % qu'ils sont sûrs et/ou fonctionnent à tout moment. Cependant, d'après notre expérience, ils méritent une recommandation car ils ont tous gagné leur bonne réputation. - -### 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. - -Son code source est [disponible sur GitHub](https://github.com/Rob--W/dont-track-me-google). Ce script utilisateur peut être téléchargé depuis [GreasyFork](https://greasyfork.org/en/scripts/428243-don-t-track-me-google) et installé dans n'importe quelle application basée sur AdGuard CoreLibs. - -### microShield - -Un script utilisateur pour les personnes qui visitent des sites web coréens et certains sites web internationaux. Le script utilisateur microShield bloque la publicité Ad-Shield et l'anti-adblock. Son code source d'origine est disponible sur [asdefuser](https://github.com/seia-soto/userscripts/tree/master/sources/asdefuser) et [AdShield Defuser](https://github.com/seia-soto/adshield-defuser). Ce script utilisateur peut être installé dans les applications basées sur AdGuard CoreLibs, Violentmonkey, Tampermonkey et [quoid/userscripts](https://github.com/quoid/userscripts). Apprenez-en davantage sur microShield et comment l'installer sur [GitHub](https://github.com/List-KR/microShield). - -## Où trouver d'autres scripts utilisateur ?{#more-userscripts} - -Les userscripts étant principalement créés par des passionnés, il faut être bien prudent lors de leur installation. 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) est un site web qui permet de rechercher des scripts utilisateurs en saisissant une URL ou un domaine correspondant. Le site web est facile à utiliser et bénéficie d'une grande crédibilité, car seuls les scripts des pages modérées sont affichés. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) est un catalogue de scripts utilisateur réalisé par les créateurs de Stylish. Les scripts de ce catalogue sont soumis à une modération, leur crédibilité est donc beaucoup plus élevée. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) est un catalogue de scripts utilisateur open source écrit en nodeJS. Il n'y a pas de modération, alors restez attentif à tout script suspect. - -### Communauté - -Si vous aimez l’idée de personnifier votre navigateur à l’aide de scripts utilisateur et vous avez des questions, vous pouvez les poser sur l’un de ces sites : - -- [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 - -Si vous développez votre propre script personnalisé et souhaitez tester son fonctionnement avec AdGuard, demandez une clef de licence bêta pour l'application. - -Pour l'obtenir, veuillez envoyer un email à devteam@adguard.com avec les informations suivantes : - -**Objet :** Userscript author license request - -**Message :** Veuillez nous parler des scripts utilisateur sur lesquels vous travaillez. - -Voici un [lien d'envoi d'email](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 -``` - -Vous trouverez [ici](https://wiki.greasespot.net/GM.info) plus d'informations sur l'API Greasemonkey. - -### Exemple - -```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 - -Les produits AdGuard offrent une prise en charge limitée des styles d'utilisateur. Les balises de métadonnées `@var` et `@advanced` ne sont pas prises en charge, ainsi que toute valeur de la balise de métadonnées `@preprocessor` à l'exception de la valeur `par défaut`. - -### Métadonnées - -Le bloc de métadonnées est rédigé à l'aide de commentaires de style CSS, commençant par `===UserStyle===` et se terminant par `===/UserStyle===`. Toutes les balises de métadonnées prises en charge pour les scripts utilisateur sont également prises en charge pour les styles utilisateur, bien que certaines d'entre elles n'aient aucune signification et soient ignorées. Les balises `@var` et `@advanced` ne sont pas prises en charge. La seule valeur prise en charge de la balise `@preprocessor` est `par défaut`. - -### Contenu - -Le contenu d'un style utilisateur est du CSS simple avec prise en charge de [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). La fonction `media-document()` n'est pas prise en charge. Le style utilisateur ne sera appliqué qu'aux pages qui correspondent à une ou plusieurs des règles `@-moz-document`. Si le style utilisateur ne contient aucune règle `@-moz-document` , il ne sera pas appliqué. - -### Exemple - -```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/userscripts.md b/i18n/hr/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/hr/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/userscripts.md b/i18n/hu/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/hu/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/it/docusaurus-plugin-content-docs/current/general/userscripts.md b/i18n/it/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 9eac6de2a7c..00000000000 --- a/i18n/it/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 App supportate - -AdGuard può ampliare significativamente la funzionalità del sito web, agendo da gestore di userscript. Puoi aggiungere i tuoi script personalizzati o gestire quelli esistenti nei nostri tre prodotti: [AdGuard per Windows](/adguard-for-windows/features/extensions), [AdGuard per Android](/adguard-for-android/features/settings#userscripts) e [AdGuard per 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. Per alcuni degli script utente sviluppati da altri che consideriamo buoni e affidabili, [scorri verso il basso fino alla sezione successiva](#top-picks). Di seguito puoi anche trovare alcuni dei [siti web popolari con script](#more-userscripts), ma ricorda che ogni volta che scarichi uno script utente da una fonte sconosciuta, ti esponi a un certo rischio, poiché alcuni script potrebbero essere dannosi al tuo computer. - -### AdGuard Extra - -C'è un'estensione che blocca gli annunci in casi difficili, quando il solito approccio basato sui filtri non è sufficiente. AdGuard Extra è preinstallato in tutte le versioni premium di AdGuard, quindi, non devi fare nulla per abilitarla. Tuttavia, se desideri utilizzarla insieme all'Estensione di browser AdGuard o qualsiasi altro bloccatore di annunci, dovrai utilizzare un'ulteriore estensione. Scopri di più su questo script utente e su come installarlo, su [GitHub](https://github.com/AdguardTeam/AdGuardExtra). - -![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) - -### AdGuard Popup Blocker - -Il nome dice tutto: blocca i popup, uno dei tipi più fastidiosi di annunci sulle pagine web. Scopri di più su questo script utente, sulle sue funzionalità principali e su come installarlo, su [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) - -Questa estensione personalizzata è progettata per controllare il filtraggio direttamente dalla pagina web (blocco manuale, esclusione del sito, etc.). - -:::note - -Questa versione di Assistant è ereditaria e non ha senso utilizzarla sui nuovi sistemi, poiché è stata sostituita dalla versione completa di [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). Ma l'Assistant ereditario potrebbe tornare utile se non esiste alcun Browser Assistant per il tuo browser. Se questo è il tuo caso, puoi scoprire come installare AdGuard Assistant su [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. Scopri di più su questo script utente e su come installarlo, su [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} - -Questi script utente non sono sviluppati da AdGuard e quindi non possiamo garantire al 100% che siano sicuri e/o funzionino sempre. Tuttavia, secondo la nostra esperienza, meritano una raccomandazione poiché si sono tutti guadagnati una buona reputazione. - -### 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. - -Il suo codice sorgente è [disponibile su GitHub](https://github.com/Rob--W/dont-track-me-google). Questo script utente può essere scaricato da [GreasyFork](https://greasyfork.org/en/scripts/428243-don-t-track-me-google) e installato in qualsiasi app basata su AdGuard CoreLibs. - -### microShield - -Uno script utente per coloro che visitano siti web coreani e alcuni siti web internazionali. Lo script utente microShield blocca gli annunci di Ad-Shield e l'anti-blocco degli annunci. Il suo codice sorgente originali è disponibile su [asdefuser](https://github.com/seia-soto/userscripts/tree/master/sources/asdefuser) e su [AdShield Defuser](https://github.com/seia-soto/adshield-defuser). Questo script utente si può installare nelle app basate su AdGuard CoreLibs, Violentmonkey, Tampermonkey e [quoid/userscripts](https://github.com/quoid/userscripts). Scopri di più su microShield e su come installarlo su [GitHub](https://github.com/List-KR/microShield). - -## Dove puoi ottenere altri userscript?{#more-userscripts} - -Poiché gli script utente sono creati principalmente da appassionati, dovresti essere cauto quando li installi. 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) è un sito web che consente di cercare userscript immettendo un URL o un dominio corrispondente. Il sito web è facile da usare e ha un'elevata credibilità, poiché vengono visualizzati solo gli script provenienti da pagine moderate. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) è un catalogo di userscript dai creatori di Stylish. Gli script in questo catalogo sono sottoposti a moderazione, quindi, la loro credibilità è molto più elevata. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) è un catalogo di userscript open source, scritto in nodeJS. Non prevede moderazione, quindi stai attento a eventuali script sospetti. - -### Comunità - -Se ti piace l'idea di personalizzare il tuo browser con l'aiuto degli userscript e hai qualsiasi domanda, puoi porle su uno di questi siti web: - -- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) -- [FreeNode](https://webchat.freenode.net/#greasemonkey) -- [Reddit](https://www.reddit.com/r/userscripts/) - -## Sviluppo - -### Richiedi la licenza - -Se stai sviluppando il tuo script personalizzato e desideri testare come funziona con AdGuard, richiedi una chiave di licenza beta per l'app. - -Per ottenerla, sei pregato di inviare un'email a devteam@adguard.com con le seguenti informazioni: - -**Soggetto:** Userscript author license request - -**Corpo:** Sei pregato di parlarci degli userscript a cui stai lavorando. - -Ecco il [link per inviare la mail](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 -``` - -[Qui](https://wiki.greasespot.net/GM.info) puoi trovare ulteriori informazioni sull'API di Greasemonkey. - -### 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 - -I prodotti AdGuard forniscono un supporto limitato per gli stili utente. I tag di metadati `@var` e `@advanced` non sono supportati, così come qualsiasi valore del tag di metadati `@preprocessor`, tranne `default`. - -### Metadati - -Il blocco dei metadati è scritto utilizzando commenti in stile CSS, iniziando con `===UserStyle===` e terminando con `===/UserStyle===`. Tutti i tag dei metadati supportati per gli userscript sono supportati anche per gli userstyle, anche se alcuni di essi non hanno alcun significato e vengono ignorati. I tag `@var` e `@advanced` non sono supportati. L'unico valore supportato del tag `@preprocessor` è `predefinito`. - -### Contenuto - -Il contenuto di uno stile utente è un semplice CSS con supporto per la regola [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). La funzione `media-document()` non è supportata. Lo stile utente verrà applicato solo alle pagine che corrispondono a una o più regole `@-moz-document`. Se lo stile utente non contiene alcuna regola `@-moz-document`, non verrà applicato. - -### 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/ja/docusaurus-plugin-content-docs/current/general/userscripts.md b/i18n/ja/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 62d3d3620cf..00000000000 --- a/i18n/ja/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: ユーザースクリプト -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -ユーザースクリプト（私たちは "エクステンション"とも呼んでいます）は、事実上、JavaScriptで書かれたミニプログラムです。 ユーザースクリプトは1つまたは複数のウェブサイトの機能を変更または拡張します。 AdGuardユーザーの多くは、「AdGuard アシスタント」「ポップアップブロッカー」「AdGuard Extra」などのユーザースクリプトをすでにご存知かもしれません。 - -:::note Supported apps - -AdGuard はユーザースクリプトマネージャとして、ウェブサイトの機能を大幅に拡張することができます。 ３つのAdGuard製品（[AdGuard for Windows](/adguard-for-windows/features/extensions)、[AdGuard for Android](/adguard-for-android/features/settings#userscripts)、[AdGuard for Mac](/adguard-for-mac/features/extensions)）で、カスタムスクリプトを追加したり、既存のスクリプトを管理することができます。 - -::: - -## お勧めのAdGuardスクリプト - -これらのユーザースクリプトはAdGuardの開発者から直接提供されたもので、効果的で安全です。 他のユーザーによって開発されたユーザースクリプトのうち、AdGuardが優れていて信頼できると考えるものについては、[下のセクションにスクロールダウン](#top-picks)してください。 以下に、[いろんなスクリプトを紹介する人気ウェブサイトを](#more-userscripts)も載せていますが、未知のソースからユーザースクリプトをダウンロードする場合は、コンピュータに有害なスクリプトをダウンロードしてしまう可能性があり、一定のリスクに身をさらすことになることにご注意ください。 - -### AdGuard Extra - -通常のフィルタベースアプローチでは不十分な場合に、広告をブロックしてくれる拡張機能。 AdGuard Extraは、AdGuardのすべてのプレミアム版にプリインストールされているため、有効にするために何もする必要はありません。 ただし、AdGuard ブラウザ拡張機能やその他の広告ブロッカーと一緒に使用したい場合は、追加の拡張機能を使用する必要があります。 このユーザースクリプトの詳細とインストール方法については[GitHub](https://github.com/AdguardTeam/AdGuardExtra)をご覧ください。 - -![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) - -### AdGuard ポップアップブロッカー - -その名の通り、ウェブページ上の最も迷惑な広告カテゴリのひとつであるポップアップ広告をブロックします。 このユーザースクリプトの詳細、主な機能、インストール方法については[GitHub](https://github.com/AdguardTeam/PopupBlocker)をご覧ください。 - -![AdGuard ポップアップブロッカー](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) - -### AdGuard アシスタント (レガシー版) - -このカスタム拡張機能は、ブラウザのページから直接フィルタリングを制御することを可能にします（手動ブロック、サイトの除外などの管理）。 - -:::note - -このバージョンのアシスタントはレガシー版であり、現在、本格的な新 [AdGuard ブラウザアシスタント](https://adguard.com/adguard-assistant/overview.html)に置き換えられているため、新しいシステムやデバイスで使用する意味はありません。 しかし、お使いのブラウザにAdGuardブラウザアシスタントがない場合は、レガシー版アシスタントが役に立つかもしれません。 このような場合は、[GitHub](https://github.com/AdguardTeam/AdguardAssistant)でAdGuard アシスタントのインストール方法をご確認いただけます。 - -::: - -### AMPを無効化 - -Android版AdGuardにのみプリインストールされているスクリプト。 Google 検索結果ページで AMP (Accelerated Mobile Pages) を無効にします。 このユーザースクリプトの詳細とインストール方法については[GitHub](https://github.com/AdguardTeam/DisableAMP)をご覧ください。 - -![AMPを無効化](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) - -## AdGuard以外でおすすめのスクリプト - -これらのユーザースクリプトは、AdGuardによって開発されたものではないため、安全性および/または機能性することを100%保証することはできません。 しかし、私たちの経験では、以下のものは全部、良い評判を得ているので、推薦に値します。 - -### Don't track me Google - -このスクリプトは、Googleの検索結果のリンクからGoogleのトラッキング機能を削除します。 検索結果の読み込みを高速化し、右クリックやタップでリンクURLをコピーできるようにします。 - -ソースコードは[GitHubで公開されています](https://github.com/Rob--W/dont-track-me-google)。 このユーザースクリプトは[GreasyForkから](https://greasyfork.org/en/scripts/428243-don-t-track-me-google)ダウンロードし、AdGuard CoreLibsベースのアプリにインストールすることができます。 - -### microShield - -韓国のウェブサイトや一部の国際ウェブサイトを訪問する人のためのユーザースクリプト。 microShield ユーザースクリプトは、Ad-Shield 広告とアンチアドブロック（広告ブロック対策技術）をブロックします。 オリジナルのソースコードは、 [asdefuser](https://github.com/seia-soto/userscripts/tree/master/sources/asdefuser) および [AdShield Defuser](https://github.com/seia-soto/adshield-defuser)で確認できます。 このユーザースクリプトは、AdGuard CoreLibsベースのアプリ、Violentmonkey、Tampermonkey、および[quoid/userscripts](https://github.com/quoid/userscripts)にインストールできます。 microShieldの詳細とインストール方法については、[GitHub](https://github.com/List-KR/microShield)をご覧ください。 - -## さらに多くのユーザースクリプトはどこで入手できますか？ - -ユーザースクリプトは主に愛好家によって作成されるため、インストールする際には注意が必要です。 未知のソースからのスクリプトは、潜在的なリスクを伴います。 しかし、注意深く責任を持ってインストールすれば、ウェブサイトの利用をより便利にしてくれる興味深いスクリプトは実に多種多様です。 - -以下で、最も人気なユーザースクリプト・カタログのいくつかをご紹介します。 - -### Userscript.Zone - -[Userscript.Zone](https://www.userscript.zone)は、一致するURLまたはドメインを入力してユーザースクリプトを検索できるウェブサイトです。 このウェブサイトは使いやすく、モデレートされたページのスクリプトだけが表示されるため、信頼性も高いです。 - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/)は、Stylishのクリエイターによるユーザースクリプトのカタログです。 このカタログに掲載されているスクリプトは、モデレーションを受けているため、その信頼性はさらに高いです。 - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/)はnodeJSで書かれたオープンソースのユーザースクリプトカタログです。 モデレーションがないので、不審なスクリプトに注意してください。 - -### コミュニティ - -ユーザースクリプトの助けを借りてブラウザを擬人化するというアイデアが好きな方で、何か質問がある場合は以下のウェブサイトのいずれかで質問することができます: - -- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) -- [FreeNode](https://webchat.freenode.net/#greasemonkey) -- [Reddit](https://www.reddit.com/r/userscripts/) - -## 開発者向け - -### AdGuardライセンスをリクエストする - -独自のカスタムスクリプトを開発中で、AdGuardとの連携をテストしたい場合は、AdGuardアプリのベータ版ライセンスキーをリクエストしてください。 - -ご希望の方は、以下の情報を明記の上、devteam@adguard.com にご連絡ください: - -**件名:** Userscript author license request - -**本文:** 現在取り組んでいるユーザースクリプトについて教えてください（できれば英語でお願いします）。 - -よかったらこちらの[mailtoリンク](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 -``` - -Greasemonkey APIについての詳細は[こちら](https://wiki.greasespot.net/GM.info)をご覧ください。 - -### 例: - -```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!"); -)}(); -``` - -## ユーザースタイル - -AdGuard製品では、ユーザースタイルを限定的にサポートしています。 `@var` および `@advanced` メタデータタグはサポートされていません。また、 `@preprocessor` メタデータタグの任意の値 ( `default`を除く) もサポートされていません。 - -### Metadata - -メタデータブロックは、 `===UserStyle===` で始まり、 `===/UserStyle===`で終わる CSS スタイルのコメントを使用して記述されます。 ユーザースクリプトでサポートされているすべてのメタデータタグは、ユーザースタイルでもサポートされています。（一部のタグ意味ないため無視されますが。） `@var` および `@advanced` タグはサポートされていません。 `@preprocessor` タグでサポートされている値は、 `default` のみです。 - -### Content - -ユーザースタイルのコンテンツは、 [`@-moz-document` @-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document)をサポートするプレーン CSS です。 `media-document()` 関数はサポートされていません。 ユーザースタイルは、 `@-moz-document` ルールの 1 つ以上に一致するページにのみ適用されます。 ユーザースタイルに `@-moz-document` ルールが全く含まれていない場合は、そのユーザースタイルは適用されません。 - -### 例: - -```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/userscripts.md b/i18n/ko/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 844c1bf4f7b..00000000000 --- a/i18n/ko/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: 유저스크립트 -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -유저스크립트('확장 프로그램'이라고도 함)는 사실상 자바스크립트로 작성된 미니 프로그램입니다. 하나 이상의 웹사이트의 기능을 수정하거나 확장합니다. 많은 AdGuard 사용자는 이미 AdGuard 어시스턴트, 팝업 차단기 및 AdGuard Extra와 같은 유저스크립트에 익숙할 것입니다. - -:::note 지원되는 앱 - -AdGuard는 유저스크립트 관리자 역할을 수행하여 웹사이트 기능을 크게 확장할 수 있습니다. 사용자 정의 스크립트를 추가하거나 기존 스크립트를 [Windows용 AdGuard](/adguard-for-windows/features/extensions), [Android용 AdGuard](/adguard-for-android/features/settings#userscripts) 및 [Mac용 AdGuard](/adguard-for-mac/features/extensions)에서 관리할 수 있습니다. - -::: - -## 권장 AdGuard 스크립트 - -이러한 유저스크립트는 AdGuard에서 개발되었습니다. 효과적이고 안전하게 작동한다는 것을 보장할 수 있습니다. 다른 사람이 개발한 유저스크립트 중 훌륭하고 신뢰할 수 있는 일부 유저스크립트를 보려면 [다음 섹션으로 스크롤하세요](#top-picks). 아래에서 [스크립트가 있는 인기 웹사이트](#more-userscripts)를 찾을 수도 있지만, 일부 스크립트는 컴퓨터에 유해할 수 있으므로 알 수 없는 출처에서 유저스크립트를 다운로드할 때마다 특정 위험에 노출될 수 있다는 점을 기억하세요. - -### AdGuard Extra - -일반적인 필터 기반 접근 방식으로는 충분하지 않은 어려운 경우에 광고를 차단하는 확장 프로그램입니다. AdGuard Extra는 모든 프리미엄 AdGuard 버전에 사전 설치되어 제공되므로 활성화하기 위해 별도의 작업을 수행할 필요가 없습니다. 하지만 AdGuard 브라우저 확장 프로그램이나 다른 광고 차단기와 함께 사용하려면 추가 확장 프로그램을 사용해야 합니다. 이 유저스크립트에 대한 자세한 내용과 설치 방법은 [GitHub](https://github.com/AdguardTeam/AdGuardExtra)에서 확인할 수 있습니다. - -![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) - -### AdGuard 팝업 차단기 - -AdGuard 팝업 차단기는 웹 페이지에서 가장 성가신 광고 유형 중 하나인 팝업을 차단합니다. [GitHub](https://github.com/AdguardTeam/PopupBlocker)에서 이 유저스크립트의 주요 기능과 설치 방법에 대해 자세히 알아보세요. - -![AdGuard 팝업 차단기](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) - -### AdGuard 어시스턴트(이전 버전) - -이 확장 프로그램은 브라우저 페이지에서 직접 필터링(수동 차단, 사이트 제외 등)을 제어할 수 있도록 설계되었습니다. - -:::note - -이 어시스턴트 버전은 이전 버전이며 본격적인 [브라우저 어시스턴트로](https://adguard.com/adguard-assistant/overview.html) 대체되었으므로 새 시스템에서 사용할 필요가 없습니다. 하지만 사용 중인 브라우저에 브라우저 어시스턴트가 없는 경우, 이전 어시스턴트가 도움이 될 수 있습니다. [GitHub](https://github.com/AdguardTeam/AdguardAssistant)에서 AdGuard 어시스턴트를 설치하는 방법을 알아보세요. - -::: - -### AMP 비활성화 - -Android용 AdGuard에만 사전 설치된 스크립트입니다. Google 검색 결과 페이지에서 AMP(가속화된 모바일 페이지)를 비활성화합니다. 이 유저스크립트에 대한 자세한 내용과 설치 방법은 [GitHub](https://github.com/AdguardTeam/DisableAMP)에서 확인할 수 있습니다. - -![AMP 비활성화](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) - -## AdGuard 외부에서 추천하는 제품{#top-picks} - -이러한 유저스크립트는 AdGuard에서 개발한 것이 아니므로 항상 안전하게 작동한다고 100% 보장할 수 없습니다. 하지만 저희의 경험에 비추어 볼 때 모두 좋은 평판을 얻었기 때문에 추천할 만한 가치가 있습니다. - -### Don't track me Google - -이 스크립트는 Google 검색 결과의 링크에서 Google의 추적 기능을 제거합니다. 검색 결과 로딩 속도가 빨라지고 마우스 오른쪽 버튼을 클릭하거나 탭하여 링크 URL을 복사할 수 있습니다. - -소스 코드는 [GitHub](https://github.com/Rob--W/dont-track-me-google)에서 확인할 수 있습니다. 이 유저스크립트는 [GreasyFork](https://greasyfork.org/en/scripts/428243-don-t-track-me-google)에서 다운로드하여 모든 AdGuard CoreLibs 기반 앱에 설치할 수 있습니다. - -### microShield - -한국어 웹사이트 및 일부 해외 웹사이트 방문자를 위한 유저스크립트입니다. microShield 유저스크립트는 Ad-Shield 광고 및 안티블록을 차단합니다. 원본 소스 코드는 [asdefuser](https://github.com/seia-soto/userscripts/tree/master/sources/asdefuser) 및 [AdShield Defuser](https://github.com/seia-soto/adshield-defuser)에서 확인할 수 있습니다. 이 유저스크립트는 AdGuard CoreLibs 기반 앱, Violentmonkey, Tampermonkey, [quoid/userscripts](https://github.com/quoid/userscripts)에 설치할 수 있습니다. [GitHub](https://github.com/List-KR/microShield)에서 microShield에 대한 자세한 내용과 설치 방법을 알아보세요. - -## 더 많은 유저스크립트는 어디서 구할 수 있나요?{#more-userscripts} - -대부분의 경우 유저스크립트는 아마추어가 만들므로 특정 스크립트를 설치할 때 매우 주의해야 합니다. 출처를 알 수 없는 스크립트는 잠재적인 위험을 수반합니다. 하지만 신중하게 설치하면 일부 웹사이트를 더 편리하게 사용할 수 있는 흥미로운 스크립트가 많이 있습니다. - -아래에서 가장 인기 있는 일부 유저스크립트 카탈로그에 대해 설명합니다. - -### Userscript.Zone - -[Userscript.Zone](https://www.userscript.zone)은 일치하는 URL 또는 도메인을 입력하여 유저스크립트를 검색할 수 있는 웹사이트입니다. 이 웹사이트는 사용하기 쉽고 안정적입니다. 스크립트는 조정된 페이지에서만 표시됩니다. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/)는 Stylish 크리에이터의 유저스크립트 카탈로그입니다. 이 카탈로그의 스크립트는 검토됩니다. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/)는 nodeJS로 작성된 오픈 소스 유저스크립트 카탈로그입니다. 검토가 없으므로 의심스러운 스크립트에 주의하세요. - -### 커뮤니티 - -사용자 스크립트를 통해 브라우저를 의인화하는 아이디어가 마음에 드시고 궁금한 점이 있으시면 다음 웹사이트에서 질문할 수 있습니다. - -- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) -- [FreeNode](https://webchat.freenode.net/#greasemonkey) -- [Reddit](https://www.reddit.com/r/userscripts/) - -## 개발 - -### 라이선스 요청 - -자체 사용자 정의 스크립트를 개발 중이고 AdGuard와 함께 작동하는 방식을 테스트하려면 앱의 베타 라이선스 키를 요청하세요. - -라이선스 키를 받으려면 다음 정보를 포함하여 devteam@adguard.com으로 이메일을 보내주십시오. - -**제목:** 유저스크립트 작성자 라이선스 요청 - -**본문:** 작업 중인 유저스크립트에 대해 알려주세요. - -이메일을 보내려면 [여기](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 -``` - -[여기](https://wiki.greasespot.net/GM.info)에서 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!"); -)}(); -``` - -## 유저스타일 - -AdGuard 제품은 제한된 방식으로 유저스타일을 지원합니다. `@var` 및 `@advanced` 메타데이터 태그는 지원되지 않습니다. 그리고 `기본값`을 제외한 `@preprocessor` 메타데이터 태그의 값은 지원되지 않습니다. - -### 메타데이터 - -메타데이터 블록은 `===UserStyle===`로 시작하고 `===/UserStyle===`로 끝나는 CSS 스타일 주석을 사용하여 작성됩니다. 유저스크립트에 지원되는 모든 메타데이터 태그는 유저스타일에도 지원되지만 일부 태그는 의미가 없어 무시됩니다. `@var` 및 `@advanced` 태그는 지원되지 않습니다. `@preprocessor` 태그의 지원되는 값은 `기본값`뿐입니다. - -### 콘텐츠 - -유저스타일의 콘텐츠는 [`@-moz-document` 규칙](https://developer.mozilla.org/en-US/docs/Web/CSS/@document)을 지원하는 간단한 CSS입니다. 이 `media-document()` 기능은 지원되지 않습니다. 유저스타일은 `@-moz-document` 규칙 중 하나 이상과 일치하는 페이지에만 적용됩니다. 유저스타일에 `@-moz-document` 규칙이 포함되어 있지 않으면 적용되지 않습니다. - -### 예시 - -```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/userscripts.md b/i18n/nl/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/nl/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/userscripts.md b/i18n/no/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/no/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/userscripts.md b/i18n/pl/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/pl/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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-BR/docusaurus-plugin-content-docs/current/general/userscripts.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index bce22e4868d..00000000000 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 Aplicativos compatíveis - -O AdGuard pode ampliar significativamente a funcionalidade de sites, agindo como um gerenciador de userscripts. Você pode adicionar seus scripts personalizados ou gerenciar os existentes em nossos três produtos: [AdGuard para Windows](/adguard-for-windows/features/extensions), [AdGuard para Android](/adguard-for-android/features/settings#userscripts) e [AdGuard para 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. Para alguns dos scripts de usuário desenvolvidos por terceiros que consideramos bons e confiáveis, [role para baixo até a próxima seção](#top-picks). Você também pode encontrar alguns dos [sites populares com scripts](#more-userscripts) abaixo, mas lembre-se de que sempre que você baixa um userscript de uma fonte desconhecida, você se expõe a um certo risco, pois alguns scripts podem ser prejudiciais para o seu computador. - -### AdGuard Extra - -Uma extensão que bloqueia anúncios em casos difíceis, quando a abordagem usual baseada em filtros não é suficiente. O AdGuard Extra vem pré-instalado com todas as versões premium do AdGuard, então você não precisa fazer nada para ativá-lo. 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. Saiba mais sobre este userscript e como instalá-lo no [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 - -O nome fala por si: ele bloqueia pop-ups, um dos tipos de anúncios mais irritantes em páginas da web. Saiba mais sobre este userscript, seus principais recursos e como instalá-lo no [GitHub](https://github.com/AdguardTeam/PopupBlocker). - -![Bloqueador de pop-ups do AdGuard](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) - -### Assistente AdGuard (versão antiga) - -Esta extensão personalizada foi projetada para controlar a filtragem diretamente da página do navegador (bloqueio manual, exclusão do site, etc.). - -:::note - -Essa versão do Assistant é antiga e não faz sentido usá-la em novos sistemas, pois foi substituída pelo [Assistente de navegador](https://adguard.com/adguard-assistant/overview.html). Mas o Assistente antigo pode ser útil se não houver um Assistente de Navegador para o seu navegador. Se este for o seu caso, você pode aprender como instalar o Assistente AdGuard no [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. Saiba mais sobre este userscript e como instalá-lo no [GitHub](https://github.com/AdguardTeam/DisableAMP). - -![Desativar AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) - -## Principais opções fora do AdGuard{#top-picks} - -Esses scripts de usuário não são desenvolvidos pela AdGuard e, portanto, não podemos dar 100% de garantia de que eles são seguros e/ou funcionam em todos os momentos. No entanto, de acordo com a nossa experiência, eles merecem uma recomendação, pois todos conquistaram a sua boa reputação. - -### 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. - -Seu código fonte está [disponível no GitHub](https://github.com/Rob--W/dont-track-me-google). Este userscript pode ser baixado de [GreasyFork](https://greasyfork.org/en/scripts/428243-don-t-track-me-google) e instalado em qualquer aplicativo baseado em no CoreLibs do AdGuard. - -### microShield - -Um userscript para pessoas que visitam sites coreanos e alguns sites internacionais. O userscript do microShield bloqueia anúncios e anti-adblock do Ad-Shield. Seu código-fonte original está disponível em [asdefuser](https://github.com/seia-soto/userscripts/tree/master/sources/asdefuser) e [AdShield Defuser](https://github.com/seia-soto/adshield-defuser). Este userscript pode ser instalado em aplicativos baseados no CoreLibs do AdGuard, Violentmonkey, Tampermonkey e [quoid/userscripts](https://github.com/quoid/userscripts). Saiba mais sobre o microShield e como instalá-lo no [GitHub](https://github.com/List-KR/microShield). - -## Onde obter mais userscripts?{#more-userscripts} - -Como os userscripts são criados principalmente por entusiastas, você deve ter cuidado ao instalá-los. 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) é um site que permite a busca por userscripts inserindo uma URL ou domínio correspondente. O site é fácil de usar e tem alta credibilidade, já que apenas scripts de páginas moderadas são exibidos. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) é um catálogo de userscripts dos criadores do Stylish. Os scripts neste catálogo passam por moderação, então sua credibilidade é muito maior. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) é um catálogo de userscripts de código aberto escrito em nodeJS. Ele não tem moderação, portanto, fique atento a qualquer script suspeito. - -### Comunidade - -Se você gosta da ideia de personalizar seu navegador com a ajuda de userscripts e tem alguma dúvida, pode perguntar em um destes sites: - -- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) -- [FreeNode](https://webchat.freenode.net/#greasemonkey) -- [Reddit](https://www.reddit.com/r/userscripts/) - -## Desenvolvimento - -### Solicitar licença - -Se você estiver desenvolvendo seu próprio script personalizado e quiser testar como ele funciona com o AdGuard, solicite uma chave de licença beta para o aplicativo. - -Para obtê-la, envie um email para devteam@adguard.com com as seguintes informações: - -**Assunto:** Solicitação de licença de autor do Userscript - -**Corpo da mensagem:** Por favor, conte-nos sobre os userscripts nos quais você está trabalhando. - -Aqui está um [link mailto](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 -``` - -[Aqui](https://wiki.greasespot.net/GM.info) você pode encontrar mais informações sobre a API Greasemonkey. - -### 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 - -Os produtos AdGuard oferecem suporte limitado para estilos de usuário. As tags de metadados `@var` e `@advanced` não são compatíveis, assim como qualquer valor da tag de metadados `@preprocessor` exceto `padrão`. - -### Metadados - -O bloco de metadados é escrito usando comentários no estilo CSS, começando com `===UserStyle===` e terminando com `===/UserStyle===`. Todas as tags de metadados suportadas para userscripts também são suportadas para userstyles, embora algumas delas não tenham significado e sejam ignoradas. As tags `@var` e `@advanced` não são suportadas. O único valor suportado da tag `@preprocessor` é `default`. - -### Conteúdo - -O conteúdo de um estilo de usuário é CSS simples com suporte para [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). A função `media-document()` não é compatível. O estilo de usuário só será aplicado a páginas que correspondam a uma ou mais das regras `@-moz-document`. Se o estilo de usuário não contiver nenhuma regra `@-moz-document`, ele não será aplicado. - -### 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/docusaurus-plugin-content-docs/current/general/userscripts.md b/i18n/pt/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/pt/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/userscripts.md b/i18n/ro/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/ro/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/ru/docusaurus-plugin-content-docs/current/general/userscripts.md b/i18n/ru/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 33aa19c21e4..00000000000 --- a/i18n/ru/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Пользовательские скрипты -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -Пользовательские скрипты (мы также называем их «‎расширениями»‎) — это мини-программы, написанные на языке JavaScript. Они модифицируют или расширяют функциональность одного или нескольких сайтов. Многие пользователи AdGuard уже наверняка знакомы с такими расширениями, как Помощник AdGuard, Блокировщик всплывающей рекламы и AdGuard Extra. - -:::note Поддерживаемые приложения - -AdGuard может значительно расширять функциональность сайтов, работая как менеджер пользовательских скриптов. Добавлять собственные скрипты или управлять существующими вы можете в трёх наших продуктах: [AdGuard для Windows](/adguard-for-windows/features/extensions), [AdGuard для Android](/adguard-for-android/features/settings#userscripts) и [AdGuard для Mac](/adguard-for-mac/features/extensions). - -::: - -## Рекомендуемые скрипты AdGuard - -Эти пользовательские скрипты разработаны в AdGuard, и мы можем гарантировать, что они эффективны и безопасны. Есть и другие пользовательские скрипты, разработанными другими людьми, которые мы считаем хорошими и надёжными. Чтобы ознакомиться с ними, [прокрутите страницу вниз до следующего раздела](#top-picks). Вы также можете найти некоторые [популярные сайты со скриптами](#more-userscripts) ниже, но помните, что всякий раз, когда вы загружаете пользовательский скрипт из неизвестного источника, вы подвергаете себя определённому риску, поскольку некоторые скрипты могут быть опасны для вашего компьютера. - -### AdGuard Extra - -Расширение, которое блокирует рекламу в сложных случаях, когда привычного подхода, основанного на фильтрах, недостаточно. AdGuard Extra предустановлен во всех премиум-версиях AdGuard, поэтому вам не нужно ничего делать для его включения. Однако, если вы хотите использовать его вместе с Браузерным расширением AdGuard или любым другим блокировщиком рекламы, вам понадобится дополнительное расширение. Узнайте больше об этом пользовательском скрипте и о том, как его установить, [на GitHub](https://github.com/AdguardTeam/AdGuardExtra). - -![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) - -### Блокировщик всплывающих окон - -Он блокирует один из самых раздражающих типов рекламы — всплывающие окна. Узнайте больше об этом пользовательском скрипте, его ключевых функциях и о том, как его установить, [на GitHub](https://github.com/AdguardTeam/AdGuardExtra). - -![Блокировщик всплывающих окон](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) - -### Помощник AdGuard (устаревшая версия) - -Расширение, предназначенное для управления фильтрацией прямо со страницы браузера (ручная блокировка, занесение сайта в исключения и т. д.). - -:::note - -Это устаревшая версия Помощника и нет смысла использовать её на новых системах, потому что её давно заменил [Браузерный Помощник](https://adguard.com/adguard-assistant/overview.html). Но старый Помощник может пригодиться, если для вашего браузера нет Браузерного помощника. Если это ваш случай, узнайте, как установить Помощник AdGuard [на GitHub](https://github.com/AdguardTeam/AdguardAssistant). - -::: - -### Отключить AMP - -Скрипт, который предустановлен только в AdGuard для Android. Он отключает AMP (Accelerated Mobile Pages или «ускоренные мобильные страницы») на странице результатов поиска Google. Узнайте больше об этом пользовательском скрипте и о том, как его установить, [на GitHub](https://github.com/AdguardTeam/DisableAMP). - -![Отключить AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) - -## Лучшие варианты вне AdGuard{#top-picks} - -Эти пользовательские скрипты не разработаны AdGuard, поэтому мы не можем дать 100% гарантию, что они безопасны и/или работают всегда. Однако, исходя из нашего опыта, они заслуживают рекомендации, поскольку заслужили свою хорошую репутацию. - -### Don't track me Google - -Этот скрипт удаляет функцию отслеживания Google из ссылок в результатах поиска Google. Это ускоряет загрузку результатов поиска и позволяет скопировать URL-адрес ссылки, щёлкнув по нему правой кнопкой мыши или нажав на него. - -Его исходный код [доступен на GitHub](https://github.com/Rob--W/dont-track-me-google). Этот пользовательский скрипт можно загрузить с [GreasyFork](https://greasyfork.org/en/scripts/428243-don-t-track-me-google) и установить в любое приложение AdGuard на базе CoreLibs. - -### microShield - -Пользовательский скрипт для тех, кто посещает корейские и некоторые международные сайты. Пользовательский скрипт microShield блокирует рекламу Ad-Shield и антиблокировщики рекламы. Его исходный код доступен на [asdefuser](https://github.com/seia-soto/userscripts/tree/master/sources/asdefuser) и на [AdShield Defuser](https://github.com/seia-soto/adshield-defuser). Этот пользовательский скрипт можно установить в приложениях на основе AdGuard CoreLibs, Violentmonkey, Tampermonkey и [quoid/userscripts](https://github.com/quoid/userscripts). Узнайте больше о microShield и о том, как его установить, [на GitHub](https://github.com/AdguardTeam/DisableAMP). - -## Где взять больше пользовательских скриптов{#more-userscripts} - -По большей части пользовательские скрипты создаются любителями, поэтому, устанавливая тот или иной скрипт, нужно быть очень осторожными. Любой скрипт из неизвестного источника несёт в себе потенциальный риск. Тем не менее, существует огромное количество интересных скриптов, которые, если установить их аккуратно и ответственно, могут действительно сделать использование некоторых сайтов более удобным. - -Здесь мы опишем несколько популярных каталогов пользовательских скриптов. - -### Userscript.Zone - -[Userscript.Zone](https://www.userscript.zone) — это сайт, который позволяет искать пользовательские скрипты по URL или домену. Сайт простой в использовании и надёжный: скрипты отображаются только с модерируемых страниц. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) — каталог пользовательских скриптов от авторов Stylish. Скрипты в этом каталоге проходят модерацию. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) — каталог пользовательских скриптов с открытым кодом, написанный на nodeJS. В нём нет модерации, поэтому будьте внимательны к любым подозрительным скриптам. - -### Сообщество - -Если вы хотите персонализировать браузер при помощи пользовательских скриптов и у вас есть какие-либо вопросы на эту тему, задать их можно на любом из этих сайтов: - -- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) -- [FreeNode](https://webchat.freenode.net/#greasemonkey) -- [Reddit](https://www.reddit.com/r/userscripts/) - -## Разработка - -### Запросить лицензию - -Если вы разрабатываете свой пользовательский скрипт и хотите протестировать, как он работает с AdGuard, запросите бета-лицензию для приложения. - -Для этого отправьте нам сообщение devteam@adguard.com со следующей информацией: - -**Тема:** Запрос лицензии для автора пользовательского скрипта - -**Текст письма:** Расскажите о пользовательском скрипте, над которым вы работаете. - -Нажмите [сюда](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 -``` - -[Здесь](https://wiki.greasespot.net/GM.info) вы найдёте больше информации о 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!"); -)}(); -``` - -## Пользовательские стили - -Продукты AdGuard поддерживают пользовательские стили с ограничениями. Не поддерживаются теги метаданных `@var` и `@advanced`, а также любое значение тега метаданных `@preprocessor`, кроме `default`. - -### Метаданные - -Блок метаданных пишется с использованием комментариев в стиле CSS, начиная с `===UserStyle===` и заканчивая `===/UserStyle===`. Все теги метаданных, которые поддерживаются в пользовательских скриптах, поддерживаются и в пользовательских стилях, хотя некоторые из них не имеют смысла и игнорируются. Теги `@var` и `@advanced` не поддерживаются. Единственное поддерживаемое значение тега `@preprocessor` — `default`. - -### Содержимое - -Содержимое пользовательского стиля — это простой CSS с поддержкой [правила `@-moz-document`](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). Функция `media-document()` не поддерживается. Пользовательский стиль будет применяться только к страницам, которые соответствуют одному или нескольким правилам `@-moz-document`. Если пользовательский стиль не содержит правил `@-moz-document`, он не будет применяться. - -### Пример - -```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/userscripts.md b/i18n/sk/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/sk/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/userscripts.md b/i18n/sl/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/sl/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/userscripts.md b/i18n/sv/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/sv/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/userscripts.md b/i18n/ta/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/ta/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/tr/docusaurus-plugin-content-docs/current/general/userscripts.md b/i18n/tr/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 90fc3f6567e..00000000000 --- a/i18n/tr/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Kullanıcı Betikleri -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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). - -::: - -## 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 expose 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, tüm premium AdGuard sürümleriyle önceden yüklenmiş olarak gelir, dolayısıyla etkinleştirmek için herhangi bir şey yapmanıza gerek yoktur. 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it on [GitHub](https://github.com/AdguardTeam/PopupBlocker). - -![AdGuard Açılır Pencere Engelleyici](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, exclusion of the site, etc.). - -:::not - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. Durumunuz buysa, AdGuard Asistanı [GitHub'da ](https://github.com/AdguardTeam/AdguardAssistant) nasıl yükleyeceğinizi öğrenebilirsiniz. - -::: - -### 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. Bu kullanıcı betiği ve [GitHub'da](https://github.com/AdguardTeam/DisableAMP) nasıl yükleneceği hakkında daha fazla bilgi edinin. - -![AMP'yi devre dışı bırak](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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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 - -Kendi özel betiğinizi geliştiriyor ve AdGuard ile nasıl çalıştığını test etmek istiyorsanız, uygulama için bir beta lisans anahtarı talep edin. - -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 - -:::not - -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 - -AdGuard ürünleri kullanıcı stilleri için sınırlı destek sağlar. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Üst veriler - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### İçerik - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### Ö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/uk/docusaurus-plugin-content-docs/current/general/userscripts.md b/i18n/uk/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/uk/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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/userscripts.md b/i18n/vi/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/vi/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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-CN/docusaurus-plugin-content-docs/current/general/userscripts.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 9a9c3c5b60e..00000000000 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: 用户脚本 -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -用户脚本（我们也称之为「扩展」）实质上是用 JavaScript 编写的小程序。 用户脚本修改或扩展一个或多个网站的功能。 许多 AdGuard 用户已经熟悉 AdGuard 助手、弹窗拦截器和 AdGuard Extra 等用户脚本。 - -:::note 支持的应用程序 - -AdGuard 可作为用户脚本管理器以显著扩展网站功能。 用户可以在我们的三款产品中添加自定义脚本或管理现有脚本：[Windows版 AdGuard](/adguard-for-windows/features/extensions)、[Android版 AdGuard](/adguard-for-android/features/settings#userscripts) 和 [Mac版 AdGuard](/adguard-for-mac/features/extensions)。 - -::: - -## 推荐的 AdGuard 脚本 - -AdGuard 开发人员创建这些用户脚本，我们可以保证它们有效且安全。 还有其他人开发创建的自定义脚本，我们认为这些脚本也很好，很可靠。要多了解这些脚本，请[向下滚动到下一部份](#top-picks)。 用户还可以在下面找到一些[流行的脚本网站](#more-userscripts)。请记住，只要您从未知来源下载用户脚本，就会面临一定的风险，因为某些脚本可能对您的计算机造成危害。 - -### AdGuard Extra - -该扩展可以在通常的过滤方法无法解决问题的情况下屏蔽广告。 AdGuard Extra 预装在所有 AdGuard 高级版本中，因此，无需安装其他软件。 不过，如果有用户想将 AdGuard Extra 与 AdGuard 浏览器扩展或其他广告拦截器一起使用，需要使用一个额外的扩展。 在 [GitHub](https://github.com/AdguardTeam/AdGuardExtra) 上了解有关此用户脚本的更多信息，以及如何安装它。 - -![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/general/adguard-extra.png) - -### AdGuard 弹窗拦截器 - -AdGuard 弹窗拦截器能屏蔽最恼人的广告类型之一，即弹出式广告。 在 [GitHub](https://github.com/AdguardTeam/PopupBlocker) 上了解有关此用户脚本、其主要功能以及安装方法的更多信息。 - -![AdGuard 弹窗拦截器](https://cdn.adtidy.org/content/kb/ad_blocker/general/popup-blocker-installation.png) - -### AdGuard 助手（旧版） - -这是一款自定义扩展，旨在直接在浏览器页面上管理过滤（手动屏蔽、排除网站等等）。 - -:::note - -这是一个过时的助手版本，在较新的系统上使用它没有意义，因为它早已被[新版本的浏览器助手](https://adguard.com/adguard-assistant/overview.html)所取代。 不过，如果您的浏览器没有浏览器助手，旧版助手可能会有所帮助。 如果是这种情况，请在 [GitHub](https://github.com/AdguardTeam/AdguardAssistant) 上了解如何安装 AdGuard 助手。 - -::: - -### 禁用 AMP - -这是一个仅在 Android 版 AdGuard 中预安装的脚本。 它禁用 Google 搜索结果页面上的 AMP（加速移动页面）。 在 [GitHub](https://github.com/AdguardTeam/DisableAMP) 上了解有关此用户脚本的更多信息，以及如何安装它。 - -![禁用 AMP](https://cdn.adtidy.org/content/kb/ad_blocker/general/disable-amp-installation.png) - -## AdGuard 以外的最佳脚本选择{#top-picks} - -以下用户脚本并非由 AdGuard 开发，因此我们无法 100% 保证其安全和/或始终有效。 不过，根据我们的经验，这些脚本值得推荐，因为它们都赢得了良好的声誉。 - -### Don't track me Google - -该脚本移除 Google 搜索结果中链接的 Google 跟踪功能。 它加快搜索结果的加载速度，允许用户右键单击或点击复制链接 URL。 - -[在 GitHub 上](https://github.com/Rob--W/dont-track-me-google)可以查看其源代码。 该用户脚本可以从 [GreasyFork](https://greasyfork.org/en/scripts/428243-don-t-track-me-google) 上下载并安装在任何基于 AdGuard CoreLibs 的应用程序中。 - -### microShield - -这是一个可以用于访问韩国和一些国际网站的用户定制的脚本。 microShield 用户脚本可以阻止 Ad-Shield 广告和反广告拦截器。 在 [asdefuser](https://github.com/seia-soto/userscripts/tree/master/sources/asdefuser) 和 [AdShield Defuser](https://github.com/seia-soto/adshield-defuser) 网站上可以查看其原始源代码。 该用户脚本可以安装在基于 AdGuard CoreLibs 的应用程序、Violentmonkey、Tampermonkey 和 [quoid/userscripts](https://github.com/quoid/userscripts) 中。 在 [GitHub](https://github.com/List-KR/microShield) 上了解有关 microShield 的更多信息以及如何安装它。 - -## 在哪里查看更多自定义脚本{#more-userscripts} - -由于用户脚本主要由爱好者创建，因此在安装时应小心谨慎。 任何来源不明的脚本都有潜在风险。 不过，也有大量有用的脚本。如果认真负责地选择，确实可以使网页更易于浏览。 - -下面我们将介绍一些最常用的用户脚本。 - -### Userscript.Zone - -[Userscript.Zone](https://www.userscript.zone) 是一个可以通过输入匹配的 URL 或域名来搜索用户脚本的网站。 该网站使用方便，可信度高，因为它只显示经过审核的网页脚本。 - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) 是由 Stylish 创建者创建的用户脚本目录。 本目录中的脚本都经过审核。 - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) 是一个以 nodeJS 编写的开源用户脚本目录。 其没有审核功能，因此请对任何可疑脚本保持警惕。 - -### 社区 - -如您想在用户脚本的帮助下个性化您的浏览器但遇到问题，您可在以下网站进行询问： - -- [Stackoverflow](https://stackoverflow.com/questions/tagged/userscripts) -- [FreeNode](https://webchat.freenode.net/#greasemonkey) -- [Reddit](https://www.reddit.com/r/userscripts/) - -## 开发 - -### 申请许可证 - -如果您正在开发自己的自定义脚本，并希望测试它与 AdGuard 配合使用，请申请获得 Beta 测试版许可证密钥。 - -要获取许可证，请发送电子邮件至 devteam@adguard.com 并附上以下信息： - -**主题：**创建用户脚本的许可证请求 - -**正文：**请告知我们您正在开发的用户脚本。 - -[点击此处](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 -``` - -您可在[此处](https://wiki.greasespot.net/GM.info)找到关于 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!"); -)}(); -``` - -## 用户样式 - -AdGuard 对用户样式提供有限的支持。 `@var` 和 `@advanced` 元数据， 以及 `@preprocessor` （ `default` 除外）元数据标签不受支持。 - -### 元数据 - -元数据使用 CSS 样式的注释编写，以 `===UserStyle===` 开头，以 `===/UserStyle===` 结尾。 用户脚本支持的所有元数据也同样支持用户样式，但其中有些标记没有意义，会被忽略。 不支持 `@var` 和 `@advanced` 标签。 `@preprocessor` 标签唯一支持的值是 `default`。 - -### 内容 - -用户样式的内容是 CSS，支持 [`@-moz-document`](https://developer.mozilla.org/en-US/docs/Web/CSS/@document) 规则。 `media-document()` 函数不受支持。 用户样式仅适用于符合一个或多个 `@-moz-document` 规则的页面。 如果用户样式不包含任何 `@-moz-document` 规则，无法应用它。 - -### 示例 - -```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/userscripts.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/userscripts.md deleted file mode 100644 index 6a15c03b043..00000000000 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/userscripts.md +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Userscripts -sidebar_position: 5 -toc_max_heading_level: 4 ---- - -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 expose 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 with all premium AdGuard versions, 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 pop-ups — one of the most annoying types of ads on web pages. Learn more about this userscript, its key features, and how to install it 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, exclusion of the site, etc.). - -:::note - -This version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged [Browser Assistant](https://adguard.com/adguard-assistant/overview.html). But the legacy Assistant might be of help if there is no Browser Assistant for your browser. If this is your case, your 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 as 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 who visit Korean websites and some international websites. The microShield userscript blocks Ad-Shield advertisement and anti-adblock. 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} - -As 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 credibility, since only scripts from moderated pages are displayed. - -### Greasy Fork - -[Greasy Fork](https://greasyfork.org/) is a userscript catalog by Stylish creators. The scripts in this catalog undergo moderation, so their credibility is much higher. - -### OpenUserJS.org - -[OpenUserJS.org](https://openuserjs.org/) is an open source userscript catalog written in nodeJS. It doesn't have moderation so stay alert to any suspicious scripts. - -### Community - -If you like the idea of personifying your browser with the help of userscripts, and you have any 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, 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 - -AdGuard products provide limited support for userstyles. `@var` and `@advanced` metadata tags are not supported, as well as any value of the `@preprocessor` metadata tag except `default`. - -### Metadata - -The metadata block is written using CSS-style comments, starting with `===UserStyle===` and ending with `===/UserStyle===`. All metadata tags that are supported for userscripts are also supported for userstyles, although some of them have no meaning and are ignored. `@var` and `@advanced` tags are not supported. The only supported value of the `@preprocessor` tag is `default`. - -### Content - -The content of a userstyle is plain CSS with support for the [`@-moz-document` at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@document). The `media-document()` function is not supported. The userstyle will only be applied to pages that match one or more of the `@-moz-document` rules. If the userstyle does not contain any `@-moz-document` rules, it will not be applied. - -### 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; - } -} -```