Расширения

Пользовательские скрипты

Пользовательские скрипты (мы также называем их «‎расширениями»‎) — это мини-программы, написанные на языке JavaScript. Они модифицируют или расширяют функциональность одного или нескольких сайтов. Многие пользователи AdGuard уже наверняка знакомы с такими расширениями, как Помощник AdGuard, Блокировщик всплывающей рекламы и AdGuard Extra.

Supported apps

AdGuard может значительно расширять функциональность сайтов, работая как менеджер пользовательских скриптов. You can add your custom scripts or manage the existing ones in our three products: AdGuard for Windows, AdGuard for Android, and AdGuard for Mac.

Лучшие варианты вне AdGuard

These userscripts are not developed by AdGuard, and therefore we can't give a 100% guarantee that they are safe and/or work at all times. However, in our experience they deserve a recommendation because they've all earned their good reputation.

Don't track me Google

Этот скрипт удаляет функцию отслеживания Google из ссылок в результатах поиска Google. Это ускоряет загрузку результатов поиска и позволяет скопировать URL-адрес ссылки, щёлкнув по нему правой кнопкой мыши или нажав на него.

Its source code is available on GitHub. This userscript can be downloaded from GreasyFork and installed in any AdGuard CoreLibs-based app.

microShield

A userscript for people visiting Korean websites and some international websites. The microShield userscript blocks Ad-Shield ads and anti-adblocks. Its original source code is available at asdefuser and AdShield Defuser. This userscript can be installed in AdGuard CoreLibs-based apps, Violentmonkey, Tampermonkey, and quoid/userscripts. Learn more about microShield and how to install it on GitHub.

Где взять больше пользовательских скриптов

Since userscripts are mainly created by enthusiasts, you should be cautious when installing them. Любой скрипт из неизвестного источника несёт в себе потенциальный риск. Тем не менее, существует огромное количество интересных скриптов, которые, если установить их аккуратно и ответственно, могут действительно сделать использование некоторых сайтов более удобным.

Здесь мы опишем несколько популярных каталогов пользовательских скриптов.

Userscript.Zone

Userscript.Zone is a website that allows searching for userscripts by entering a matching URL or domain. The website is easy to use and has a high level of credibility as only scripts from moderated pages are displayed.

Greasy Fork

Greasy Fork is a userscript catalog of Stylish creators. The scripts in this catalog are moderated, so their credibility is much higher.

OpenUserJS.org

OpenUserJS.org is an open-source userscript catalog written in nodeJS. It's not moderated, so keep an eye out for suspicious scripts.

Сообщество

If you like the idea of customizing your browser with userscripts and have questions, you can ask them on one of these websites:

Разработка

Запросить лицензию

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

Для этого отправьте нам сообщение devteam@adguard.com со следующей информацией:

Subject: Userscript author license request

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

Here is a mailto link.

Совместимость

Блок метаданных

Поддерживаемые свойства

@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 проигнорирует эти свойства.

@unwrap

Поддерживаемые функции GM

AdGuard поддерживает как старые функции GM_, так и новый GM4 API, использующий объект GM.

Значения

комментарий

Все перечисленные функции Greasemonkey устарели, но всё ещё поддерживаются.

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 you can find more information about Greasemonkey API.

Пример

// ==UserScript==
// @name Имя, которое показывается пользователю, если локаль английская или неизвестна
// @name:ru Имя, которое показывается пользователю, если локаль русская
// @description Описание, которое показывается пользователю, если локаль английская или неизвестна
// @description:ru Описание, которое показывается пользователю, если локаль русская
// @icon https://myhomepage.com/myuserscript.png
// @version 1.0.0.0
// @downloadURL https://dl.myhomepage.org/myuserscript.user.js
// @updateURL https://dl.myhomepage.org/myuserscript.meta.js
// @homepageURL https://myhomepage. com/myuserscript
// @include *
// @exclude *://website.com/*
// @resource https://myhomepage.com/myuserscript.css
// @require https://myhomepage. com/mylibrary.js
// @grant свойство: настройки
// @grant GM_getValue
// @grant GM_setValue
// @grant GM_deleteValue
// @grant GM_listValues
// @grant GM_getResourceText
// @grant GM_getResourceURL
// @grant GM_addStyle
// @grant GM_log
// @grant GM_setClipboard
// @grant GM_xmlhttpRequest
// @grant unsafeWindow
// @grant GM_info
// @grant GM_openInTab
// @grant GM_registerMenuCommand
// @run-at document-start
// ==/UserScript==
! function(){(
    console.log("I am loaded!");
)}();

Пользовательские стили

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

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

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 support@adguard.com.

How to set up a userstyle in AdGuard

You can download userstyles from various websites. One of the most popular userstyle websites is https://userstyles.world/, which we will use as an example for the following instructions on how to set up the userstyle in AdGuard.

Follow the link above and choose the userstyle you like
Right-click the Install button and choose Copy Link Address
Open AdGuard settings → Extensions
Press the [+] button and paste the userstyle link
Готово!

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

комментарий

We don’t support userstyles that contain @var or @advanced in the metadata. AdGuard also doesn’t support @preprocessor without the default value.

Open AdGuard settings → Extensions
Press the [+] button and choose the Create userstyle option. A new window will appear on your screen
To create a userstyle, first write the title with metadata, for example
```
/* ==UserStyle==
@name New userstyle
@version 1.0
==/UserStyle== */
```

Write the CSS part after the meta data. 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;
  }

Once you’re finished, press Save and Close. Your new userstyle has been successfully added to AdGuard

Пример

/* ==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;
    }
}

Расширения

Пользовательские скрипты

Рекомендуемые скрипты AdGuard

AdGuard Extra

Блокировщик всплывающих окон

Помощник AdGuard (устаревшая версия)

Отключить AMP

Лучшие варианты вне AdGuard

Don't track me Google

microShield

Где взять больше пользовательских скриптов

Userscript.Zone

Greasy Fork

OpenUserJS.org

Сообщество

Разработка

Запросить лицензию

Совместимость

Блок метаданных

Поддерживаемые свойства

Неподдерживаемые свойства

Поддерживаемые функции GM

Значения

Пример

Пользовательские стили

How to set up a userstyle in AdGuard

Пример

Пользовательские скрипты​

Рекомендуемые скрипты AdGuard​

AdGuard Extra​

Блокировщик всплывающих окон​

Помощник AdGuard (устаревшая версия)​

Отключить AMP​

Лучшие варианты вне AdGuard​

Don't track me Google​

microShield​

Где взять больше пользовательских скриптов​

Userscript.Zone​

Greasy Fork​

OpenUserJS.org​

Сообщество​

Разработка​

Запросить лицензию​

Совместимость​

Блок метаданных​

Поддерживаемые свойства​

Неподдерживаемые свойства​

Поддерживаемые функции GM​

Значения​

Пример​

Пользовательские стили​

How to set up a userstyle in AdGuard​

Пример​

Пользовательские скрипты

Рекомендуемые скрипты AdGuard

AdGuard Extra

Блокировщик всплывающих окон

Помощник AdGuard (устаревшая версия)

Отключить AMP

Лучшие варианты вне AdGuard

Don't track me Google

microShield

Где взять больше пользовательских скриптов

Userscript.Zone

Greasy Fork

OpenUserJS.org

Сообщество

Разработка

Запросить лицензию

Совместимость

Блок метаданных

Поддерживаемые свойства

Неподдерживаемые свойства

Поддерживаемые функции GM

Значения

Пример

Пользовательские стили

How to set up a userstyle in AdGuard

Пример