<p>Текущие версии Adblock Plus позволяют вам &quot;настраивать&quot; фильтры многими разными способами. Этот документ расскажет о выборе, который у вас есть, и о том, как его использовать.</p>

<p><em>Ответственность</em>: Все примеры фильтров приведённые здесь являются только примерами и не предназначены для использования.</p>

<h2 id="introduction">Введение</h2>

<p>Параметров описанных в этом разделе должно быть достаточно для создания фильтров по мере необходимости.</p>

<h3 id="basic">Основные правила</h3>

<p>Наиболее простой фильтр это адрес баннера, который вы хотите заблокировать. Однако, часто этот адрес изменяется каждый раз при загрузке страницы. Например, он может быть <code>http://example.com/ads/banner123.gif</code> где 123 -случайное число. В этом случае блокирование по адресу вам не поможет, вам нужен более общий фильтр, такой как <code>http://example.com/ads/banner*.gif</code>. Или, может быть, даже <code>http://example.com/ads/*</code>.</p>

<p><em>Примечание</em>: Убедитесь, что вы не обобщили слишком многое. Фильтр <code>http://example.com/*</code> безусловно, заблокирует все баннеры, но также заблокирует всё остальное с example.com то, что вы можете захотеть увидеть.</p>

<h3 id="whitelist">Исключающие правила</h3>

<p>Иногда вы можете заметить, что один из ваших фильтров обычно работающий нормально, блокирует то, что не должно быть блокировано. Вы не хотите удалять этот фильтр, но вы также не хотите, чтобы это продолжалось.</p>

<p>Для этого случая есть исключающие правила - они позволяют вам определить, в каком случае фильтры не должны применяться. Например, если фильтр <code>adv</code> блокирует <code>http://example.com/advice.html</code>, вы можете установить исключающее правило <code>@@advice</code>. Исключающие правила не отличаются правил фильтров, вы можете использовать символы обобщения или регулярные выражения. Только вы должны начинать их с <code>@@</code>, указывающее на исключающее правило.</p>

<p>Exception rules can do more. If you specify <code>$document</code> option you will get an exception for the entire page. For example, if your exception rule is <code>@@||example.com^$document</code> and you open some page from example.com — Adblock Plus will be entirely disabled on this page and nothing will be blocked.</p>

<h3 id="anchors">Соответствие началу/концу адреса</h3>

<p>Обычно Adblock Plus обрабатывает каждый фильтр так,как если бы он имел обобщения в начале и в конце. Например, нет разницы между фильтрами <code>ad</code> и <code>*ad*</code>.Обычно это не является проблемой, но иногда вы можете захотеть, чтобы ваш фильтр соответствовал в начале или в конце адресов. Например, вы можете захотеть заблокировать весь Flash, но если вы добавите фильтр <code>swf</code> , адрес <code>http://example.com/swf/index.html</code> также будет заблокирован.</p>

<p>Решение проблемы: добавьте к фильтру символ |, чтобы показать, что конец адреса находится в этой точке. Например, фильтр <code>swf|</code> будет блокировать <code>http://example.com/annoyingflash.swf</code> , но не <code>http://example.com/swf/index.html</code>. А фильтр <code>|http://baddomain.example/</code> будет блокировать <code>http://baddomain.example/banner.gif</code> , но не <code>http://gooddomain.example/analyze?http://baddomain.example</code>.</p>

<p id="flexible-anchors">Иногда хочется заблокировать <code>http://example.com/banner.gif</code> вместе с <code>https://example.com/banner.gif</code> и <code>http://www.example.com/banner.gif</code>. Этого можно достичь добавлением пары символов | в начало фильтра соответствующего началу доменного имени: <code>||example.com/banner.gif</code> заблокирует все эти адреса и не тронет <code>http://badexample.com/banner.gif</code> или <code>http://gooddomain.example/analyze?http://example.com/banner.gif</code> (необходим Adblock Plus 1.1 и выше).</p>

<h3 id="separators">Разделительные символы</h3>

<p>Часто вам нужно будет применить в фильтре любой разделительный символ. Например, вы можете написать фильтр, который блокирует <code>http://example.com/</code> и <code>http://example.com:8000/</code> , но не <code>http://example.com.ar/</code>. Здесь символ ^ может быть использован как указатель для одного разделительного символа: <code>http://example.com^</code> (необходим Adblock Plus 1.1 и выше).</p>

<p>Разделителем может быть любой символ кроме буквы, цифры и следующих символов: _ - . %. К концу адреса также применим разделитель. В следующем примере все разделители показаны красным: http:<b style="color: red;">//</b>example.com<b style="color: red;">:</b>8000<b style="color: red;">/</b>foo.bar<b style="color: red;">?</b>a<b style="color: red;">=</b>12<b style="color: red;">&amp;</b>b<b style="color: red;">=</b>%D1%82%D0%B5%D1%81%D1%82. Также этот адрес может быть блокирован фильтром <code>^example.com^</code> или <code>^%D1%82%D0%B5%D1%81%D1%82^</code> или <code>^foo.bar^</code>.</p>

<h3 id="comments">Комментарии</h3>

<p>Любое правило, начинающееся с восклицательного знака содержит комментарий. Оно отображается в списке фильтров серым цветом. Adblock Plus будет игнорировать это правило при блокировании, так что можете спокойно писать там всё, что хотите. Вы можете расположить комментарий выше реального фильтра, чтобы описать для чего он нужен. Или вы можете разместить комментарий с указанием вашего авторства вверху списка фильтров (так делают большинство авторов).</p>

<h4 id="special-comments">Special comments</h4>

<p>
Special comments will only have an effect in downloaded filter lists, not in custom filters.
Special comments must be given at the top of the filter list right below the header.
They can set a number of parameters for the filter list:
</p>

<ul>
<li>
<p>
<code>! Homepage: http://example.com/</code>
</p>
<p>
This comment determines which webpage should be linked as filter list homepage.
</p>
</li>
<li>
<p>
<code>! Title: FooList</code>
</p>
<p>
This comment sets a fixed title for the filter list. If this comment is present the user will no longer be able to change
the title.
</p>
</li>
<li>
<p>
<code>! Expires: 5 days</code>
</p>
<p>
This comment sets the update interval for the filter list, the value can be given in days (e.g. <code>5 days</code>) or hours
(e.g. <code>8 hours</code>). Any value between 1 hour and 14 days is possible. Note that the update
will not necessarily happen after this time interval. The actual update time is slightly randomized and depends on
some additional factors to reduce server load.
</p>
</li>
<li>
<p>
<code>! Redirect: http://example.com/list.txt</code>
</p>
<p>
This comment indicates that the filter list has moved to a new download address. Adblock Plus will ignore any file
contents beyond that comment and immediately try downloading from the new address. In case of success the address
of the filter list will be updated in the settings. This comment is ignored if the new address is the same as the
current address, meaning that it can be used to enforce the &quot;canonical&quot; address of the filter list.
</p>
</li>
<li>
<p>
<code>! Version: 1234</code>
</p>
<p>
This comment defines a numerical version of the filter list. This version number will be displayed in issue reports
and can be used to verify that the report refers to the current version of the filter list.
</p>
</li>
</ul>

<h3 id="advanced">Расширенные возможности</h3>

<p>Возможности, описанные в этом разделе, обычно используются опытными пользователями или создателями подписок. Вы можете пропустить его.</p>

<h4 id="options">Специфические опции фильтра</h4>

<p>Adblock Plus позволяет вам определить число параметров, изменяющих поведение фильтра. Список этих параметров располагается в конце фильтра после знака доллара ($) и разделяется запятыми, например:</p>

<pre>
*/ads/*$script,match-case
</pre>

<p>Здесь <code>*/ads/*</code> текущий фильтр <code>script</code> и <code>match-case</code> его параметры. В настоящее время поддерживаются следующие параметры:</p>

<ul>
<li>Типы параметров: определяют, какие типы элементов могут быть заблокированы фильтром (или пропущены в случае исключающего правила). Составной тип параметров, может быть определен, чтобы показать, что фильтр может быть применен к нескольким типам элементов. Доступные типы:
<ul>
<li><code>script</code> — внешние файлы скриптов загруженные через HTML-тэг SCRIPT</li>
<li><code>image</code> — обычные изображения, загруженные через HTML-тэг IMG</li>
<li><code>stylesheet</code> — внешние CSS-файлы стилей</li>
<li><code>object</code> — содержимое, управляемое плагинами браузера, напр. Flash или Java</li>
<li><code>xmlhttprequest</code> — requests started using the <a href="https://xhr.spec.whatwg.org/"><code>XMLHttpRequest</code> object</a> or <a href="https://fetch.spec.whatwg.org/"><code>fetch()</code> API</a></li>
<li><code>object-subrequest</code> — запросы инициированные плагинами вроде Flash</li>
<li><code>subdocument</code> — встроенные страницы, обычно при помощи HTML-фреймов</li>
<li><code>ping</code> — requests started by <a href="https://developer.mozilla.org/docs/Web/HTML/Element/a#attr-ping"><code>&lt;a ping&gt;</code></a> or <a href="https://developer.mozilla.org/docs/Web/API/Navigator/sendBeacon"><code>navigator.sendBeacon()</code></a> (Adblock Plus 2.7.1 or higher required)</li>
<li><code>websocket</code> — requests initiated via <a href="https://developer.mozilla.org/docs/Web/API/WebSocket"><code>WebSocket</code> object</a> (Adblock Plus 2.8 or higher required)</li>
<li><code>webrtc</code> — connections opened via <a href="https://developer.mozilla.org/docs/Web/API/RTCPeerConnection"><code>RTCPeerConnection</code> instances</a> to ICE servers (Adblock Plus 1.13.3 for Chrome and Opera, 3.0 for Firefox, or higher required)</li>
<li><code>document</code> — сама страница (только <a href="#whitelist">исключающие правила</a> могут быть применены к этой странице)</li>
<li><code>elemhide</code> — только для исключающих правил, схоже с <code>document</code> но отключает только <a href="#elemhide">правила скрытия элементов</a>, а не все правила фильтрации на странице (требуется Adblock Plus 1.2 и выше)</li>
<li><code>generichide</code> — for exception rules only, similar to <code>elemhide</code> but only disables <a href="#generic-specific">generic</a> element hiding rules on the page (Adblock Plus 2.6.12 or higher required)</li>
<li><code>genericblock</code> — for exception rules only, just like <code>generichide</code> but disables <a href="#generic-specific">generic</a> blocking rules (Adblock Plus 2.6.12 or higher required)</li>
<li><code>popup</code> — pages opened in a new tab or window</li>
<li><code>other</code> — типы запросов не перечисленные выше</li>
</ul>
The type options <code>background</code>,
<code>xbl</code> and <code>dtd</code> are outdated
and should no longer be used.
</li>
<li>Обратные типы параметров: определяет типы элементов, фильтр к которым применяться <strong>не</strong> должен. Доступные параметры обратных типов: <code>~script</code>, <code>~image</code>, <code>~stylesheet</code>, <code>~object</code>, <code>~xmlhttprequest</code>, <code>~object-subrequest</code>, <code>~subdocument</code>, <code>~document</code>, <code>~elemhide</code>, <code>~other</code></li>
<li>Ограничение на сторонние/собственные запросы: Если указана опция <code>third-party</code>, то фильтр применяется лишь к запросам ресурсов из внешних источников. Аналогично, <code>~third-party</code> ограничивает фильтр запросами из того-же источника, что и открытая страница.</li>
<li>Ограничители доменов: Параметр <code>domain=example.com</code> означает, что фильтр должен быть применён только на страницах домена &quot;example.com&quot;. Множество доменов можно установить, используя &quot;|&quot; как разделитель: с параметром <code>domain=example.com|example.net</code> фильтр будет применён только на страницах доменов &quot;example.com&quot; или &quot;example.net&quot;. Если доменное имя начинается с &quot;~&quot;, фильтр <strong>не</strong> должен применяться на страницах этого домена. Например, <code>domain=~example.com</code> показывает, что фильтр должен применяться на страницах любого домена, но &quot;example.com&quot; и <code>domain=example.com|~foo.example.com</code> ограничивает фильтр доменом &quot;example.com&quot; исключая поддомен &quot;foo.example.com&quot;.</li>
<li>
Sitekey restrictions: The option <code>sitekey=abcdsitekeydcba</code> means that the filter should only be applied on pages that provide a public key and a signature which can be verified by that very same public key that is also contained in the filter (but without the trailing =). Multiple sitekeys can be specified using &quot;|&quot; as separator: with the option <code>sitekey=abcdsitekeydcba|bcdesitekeyedcb</code> the filter will only be applied on pages providing either sitekey &quot;abcdsitekeydcba&quot; or &quot;bcdesitekeyedcb&quot;. This is similar to domain restrictions but allows covering scenarios where a single filter should apply to a very large number of domains. Note that sitekey restrictions require <a href="#sitekey_server">modifications on the server-side</a>.
</li>
<li>
Content Security Policies: The option <code>csp=script-src: 'none'</code> causes a Content Security Policy header of <code>script-src: 'none'</code> to be injected into HTTP responses for requested documents matching the filter — assuming that exception rules with the same option don't also match and that the document isn’t whitelisted. The Content Security Policy <code>script-src: 'none'</code> would in turn block all scripts — including inline — for the document. This filter option should generally be avoided, except as a last resort to counter advanced circumvention. (Adblock Plus 3.1 or higher required.)
</li>
<li><code>match-case</code> — определяет фильтр, который применяется только к адресам с совпадением букв, например фильтр <code>*/BannerAd.gif$match-case</code> будет блокировать <code>http://example.com/BannerAd.gif</code>, но не <code>http://example.com/bannerad.gif</code>.</li>
<li><code>collapse</code> — эта опция принудительно включает скрытие для данного элемента не смотря на значение глобальной настройки «Прятать метки на месте заблокированных элементов». Соответственно опция <code>~collapse</code> выключает скрытие свободного места от данного элемента.</li>
<li>
<code>donottrack</code> — для каждого адреса, который подходит под правило блокирования с этим параметром и не соответствует никаким исключающим правилам с этим параметром, Adblock Plus будет посылать <a href="http://donottrack.us/">заголовок Do-Not-Track</a> (необходим Adblock Plus 1.3.5 или выше). Для обратной совместимости рекомендуется использовать этот параметр с противоречивыми параметрами типа. Это гарантирует, что в старых версиях Adblock Plus этот фильтр ничего не заблокирует: <code>*$donottrack,image,~image</code>
</li>
<li>
Rewrite the URL with the option <code>rewrite=</code>. You may want to create a regular expression filter to perform the rewrite operation. In that case, you can use <code>$n</code> in the rewrite argument, with <code>n</code> being a number between 1 and 100, to insert the n-th parenthesis submatch of the filter regular expression. Anything not explicitly matched by it will be added in the rewritten string. For example <code>/(server\.com\/assets\/file.php)\?.*$/$rewrite=$1</code> will strip everything that comes after &quot;.php&quot; and redirects the request to the resulting URL. If there is no query string (i.e. no '?'), this filter won't match. The rewrite parameter has the same syntax as JavaScript’s <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replace#Specifying_a_string_as_a_parameter"><code>String.prototype.replace()</code></a>. The resulting URL must have the same origin; in case it is rewritten to a relative URL, the origin gets added back. Also, rewrite for scripts, subdocuments, objects, requests from within objects (like Flash) are not possible for security reason; even if explicitly stated by the filter. If both, a filter with/without <code>$rewrite</code> option matches, the behavior is undefined, i.e. the request might either be blocked or redirected. (Adblock Plus 3.2 or higher required.)
</li>
</ul>

<h4 id="regexps">Использование регулярных выражений</h4>

<p>Если желаете добиться большего контроля над тем, к чему ваши фильтры подходят, а к чему нет, то можете использовать регулярные выражения. Например, фильтр <code>/banner\d+/</code> подойдёт к <code>banner123</code> и <code>banner321</code> , но не <code>banners</code>. Изучите <a href="https://developer.mozilla.org/en/Core_JavaScript_1.5_Guide/Regular_Expressions#Writing_a_Regular_Expression_Pattern">документацию по регулярным выражениям</a> и сможете составлять их сами.</p>

<p><em>Примечание</em>: Для повышения производительности рекомендуется не использовать регулярные выражения, если этого можно избежать.</p>

<h2 id="elemhide">Скрытие элементов</h2>

<h3 id="elemhide_basic">Основные правила</h3>

<p>Иногда вы будете встречать рекламу, которая не может быть заблокирована потому, что она была внедрена как текст в саму веб-страницу. Если вы посмотрите исходный код такой страницы, то найдёте нечто вроде этого:</p>

<pre>&lt;div class=&quot;textad&quot;&gt;
Cheapest tofu, only here and now!
&lt;/div&gt;
&lt;div id=&quot;sponsorad&quot;&gt;
Really cheap tofu, click here!
&lt;/div&gt;
&lt;textad&gt;
Only here you get the best tofu!
&lt;/textad&gt;
</pre>

<p>Для корректного отображения страницу необходимо полностью, а значит и реклама будет скачана и этого нельзя избежать. Всё, что тут можно сделать - скрыть то, что не желаете видеть. Для этого и применяются правила скрытие элементов.</p>

<p>Первый рекламный слоган выше находится внутри элемента DIV с классом «textad». Следующее правило скроет скроет именно такую комбинацию: <code>##.textad</code>. Тут «##» является признаком правила скрытия, а остальное — селектором, определяющим скрываемый элемент. Скрывать элементы по их атрибуту ID можно аналогичным образом, <code>###sponsorad</code> скроет второй слоган. Указывать имя самого элемента не обязательно, фильтр <code>##textad</code> так же будет работать (* тоже не обязательна). Также можно скрывать элементы лишь по их имени. Например, <code>{4}</code> скроет третий рекламный слоган.</p>

<p>Расширение <a href="/ru/elemhidehelper" hreflang="ru">Element Hiding Helper</a> поможет в выборе нужного элемента и написании соответствующего правила без изучения исходного кода страницы. Базовые знания в HTML желательны в любом случае.</p>

<p><em>Примечание</em>: Правила скрытие кардинально отличается от обычных фильтров. Например, не поддерживаются привычные символы масок — они имеют другое значение и применение.</p>

<h3 id="elemhide_domains">Ограничение правил определенными доменами</h3>

<p>Обычно вы хотите скрыть определенную рекламу на определенном сайте и не хотите, чтобы это правило применялось на других сайтах. Например, правило <code>##.sponsor</code> может скрыть полезный код на некоторых сайтах. Но если вы напишете его как <code>example.com##.sponsor</code> оно будет применено на <code>http://example.com/</code> и <code>http://something.example.com/</code> но не на <code>http://example.org/</code>. Вы также можете определить множество доменов - просто разделите их запятыми: <code>domain1.example,domain2.example,domain3.example##.sponsor</code>.</p>

<p>Если доменному имени предшествует &quot;~&quot;, правило <strong>не</strong> будет применяться на страницах этого домена (требуется Adblock Plus 1.1 и выше). Например, <code>~example.com##.sponsor</code> будет применяться на страницах с других доменов, &quot;example.com&quot; и <code>example.com,~foo.example.com##.sponsor</code> делает правило применимым к домену &quot;example.com&quot; с исключением поддомена &quot;foo.example.com&quot;.</p>

<p><em>Примечание</em>: Из-за способа, который применяется при скрытии элементов, вы можете использовать только полные доменные имена. Нельзя использовать другие части адресов и нельзя использовать <code>domain</code> как замену <code>domain.example,domain.test</code>.</p>

<p><em>Примечание</em>: Правила скрытия элементов с ограничением доменов могут использоваться для скрытия элементов интерфейса браузера. Например, правило <code>browser##menuitem#javascriptConsole</code> скроет пункт Консоль JavaScript в меню Инструменты браузера Firefox.</p>

<h3 id="elemhide_attributes">Селекторы атрибутов</h3>

<p>С некоторыми рекламными вставками справиться не так просто - их рекламный текст не имеет ни id, ни атрибута class. Вы можете использовать другие атрибуты для их скрытия, например <code>##table[width=&quot;80%&quot;]</code> будет скрывать таблицы атрибут width у которых установлен в 80%. Если вы не хотите определять полное значение атрибута, <code>##div[title*=&quot;adv&quot;]</code> будет скрывать все элементы div с атрибутом заголовка, содержащим строку &quot;adv&quot;. Вы также можете проверять начало и конец атрибута, например <code>##div[title^=&quot;adv&quot;][title$=&quot;ert&quot;]</code> будет скрывать элементы div начинающиеся с &quot;adv&quot; и заканчивающиеся &quot;ert&quot;. Как видите, вы также можете использовать множество состояний — <code>table[width=&quot;80%&quot;][bgcolor=&quot;white&quot;]</code> будет подходить для таблиц с атрибутом width установленным в 80% и атрибутом bgcolor установленным в white.</p>

<h3 id="elemhide_css">Дополнительные селекторы</h3>

<p>В принципе любой CSS селектор моно работающий в Firefox можно использовать для скрытия. Например следующее правило скроет всё, что вложено в элемент DIV с классом «adheader»: <code>##.adheader + *</code>. Полный список CSS селекторов смотрите в <a href="http://www.w3.org/TR/css3-selectors/">спецификации CSS от W3C</a> (учтите: на данный момент Firefox поддерживает ещё не все селекторы). Please keep in mind that browsers are slower to process these selectors than selectors based on <code>class</code> or <code>id</code> attribute only.</p>

<p><em>Примечание</em>: Эта функция для продвинутых пользователей, необходимо свободное владение CSS селекторами, чтоб их корректно использовать. Adblock Plus не способен проверить синтаксис добавляемого селектора и если использовать неправильный синтаксис, то можно сломать другие (корректные) фильтры. Проверяйте консоль ошибок JavaScript на предмет сообщений об ошибках в CSS.</p>

<h3 id="elemhide-emulation">Extended CSS selectors (Adblock Plus specific)</h3>

<p>
Sometimes the standard CSS selectors aren't powerful enough to hide an advertisement. For those cases we have added some new selectors, namely <code>:-abp-has()</code>, <code>:-abp-contains()</code> and <code>:-abp-properties()</code> (requires Adblock Plus 1.13.3 or higher for Chrome and Opera).
</p>
<p>
When writing an element hiding filter that makes use of these extended selectors you must use the <code>#?#</code> syntax, e.g. <code>example.com#?#selector</code>. But it's important to note that doing so carries a performance impact, so do so sparingly and make sure those filters are specific to as few domains and elements as possible.
</p>
<h4>:-abp-properties()</h4>
<p>
<code>:-abp-properties(properties)</code> will select elements based upon stylesheet properties. For example <code>:-abp-properties(width:300px;height:250px;)</code> will select elements that have a corresponding CSS rule in a stylesheet which sets the <code>width</code> and <code>height</code> to the values <code>300px</code> and <code>250px</code> respectively. Property names are matched case-insensitively. Furthermore, wildcards can be used so that <code>:-abp-properties(width:*px;height:250px;)</code> will match any width specified in pixels and a height of 250 pixels.
</p>
<p>
You can also use <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions">regular expressions</a> by surrounding the properties expression with &quot;/&quot;. For example, <code>:-abp-properties(/width:30[2-8]px;height:250px;/)</code> will match widths between 302 and 308 pixels and a height of 250 pixels.
</p>
<p>
<em>Note</em>: The <a href="https://adblockplus.org/development-builds/new-css-property-filter-syntax">older syntax</a> for the CSS property filters is deprecated and will be automatically converted to the new format . The syntax to select the style properties remain the same. For example, <code>[-abp-properties='width:300px;height:250px;']</code> will be converted to <code>:-abp-properties(width:300px;height:250px;)</code>.
</p>
<p>
<code>:-abp-properties()</code> will also select elements using the style properties found in their pseudo-elements, like <code>::before</code> and <code>::after</code>. For example, <code>:-abp-properties(content:'Advertisment')</code> will match elements where the string <em>Advertisment</em> is found in either their <code>::before</code> or <code>::after</code> pseudo element.
</p>
<h4>:-abp-has()</h4>
<p>
<code>:-abp-has(selector)</code> will select elements based on their content. For example <code>:-abp-has(&gt; div &gt; a.advertiser)</code> will select elements that contain as a direct descendant a <code>&lt;div&gt;</code> that contains an <code>&lt;a&gt;</code> with the class <code>advertiser</code>. The inner selector can be relative to the element scope, and can use any of the pseudo-selectors, including <code>:-abp-has()</code> and will determine whether the selection will occur.
</p>
<h4>:-abp-contains()</h4>
<p>
<code>:-abp-contains(text)</code> will select elements based on their text content. For example, <code>div.sidebar &gt; span:-abp-contains(Advertisment)</code> will select the <code>&lt;span&gt;</code> elements within a <code>&lt;div&gt;</code>, with a class of <code>sidebar</code> that contains the word &quot;Advertisment&quot;. In practice, you'd want to combine this with a <code>:-abp-has()</code> to select the outer container — something like <code>div.sidebar &gt; div:-abp-has(span:-abp-contains(Advertisment))</code> to select the container that would contain an advertisement label.
</p>

<h3 id="elemhide_exceptions">Исключения</h3>

<p>
Правила-исключения «выключают» отдельные правила блокировки и скрытия на определённых доменах. В основном они полезны авторам подписок, дополняющих сторонние подписки, которые они не могут изменить. Например, правило <code>##.textad</code> можно выключить на <code>example.com</code> добавив исключение <code>example.com#@#.textad</code>. Комбинация этих двух правил идентична по эффекту одному　правилу <code>~example.com##.textad</code>. Применять такие исключения рекомендуется только в случае, когда изменить само правило скрытия не представляется возможным, во всех остальных случаях лучше изменить само правило.
These exceptions will be applied to <a href="#elemhide-emulation">advanced pseudo-selector rules</a> as well.
</p>

<h3 id="generic-specific">Generic / Specific filters</h3>

<p>With the <code>$generichide</code> and <code>$genericblock</code> filter options the distinction between generic and specific filters becomes important.</p>
<p>We classify a filter to be <strong>specific</strong> if it matches one or more domains or matches a sitekey. If a filter has no domains specified (or only domain exceptions) and no sitekey then it counts as <strong>generic</strong>. For example, <code>example.com##.textad</code> is a specific filter, whereas both <code>##.textad</code> and <code>~example.com##.textad</code> are generic.</p>
<p>Note that with blocking rules the domain must be specified under the $domain option for them to be considered specific. For example, <code>||example.com^</code> is considered generic whereas <code>*/ads/*$domain=example.com</code> is site-specific.</p>

<h2 id="sitekey_server">Implementing a sitekey on the server</h2>

<p>
For a <a href="#options">sitekey-restricted filter</a> to apply, a webpage needs to return base64-encoded versions of the public key and a signature which Adblock Plus can validate. Currently, this means including them in both the HTTP response header (<code>X-Adblock-Key: abcdpublickeydcba_abcdsignaturedcba</code>) and the root tag of the document (<code>&lt;html data-adblockkey=&quot;abcdpublickeydcba_abcdsignaturedcba&quot;&gt;</code>).
</p>

<p>
First you need to create a private RSA key (preferably 512 bit to keep the transfer volume low) and then a DER representation of the public key.
</p>

<p>
The data used for creating the signature is a concatenated list of request variables (namely URI, host and user agent) separated by the <code>NUL</code> character &quot;\0&quot;. For example:
</p>

<pre>
/index.html?q=foo\0www.example.com\0Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:30.0) Gecko/20100101 Firefox/30.0
</pre>

<p>
Finally, generate the signature for this string by using the signature algorithm SEC_OID_ISO_SHA_WITH_RSA_SIGNATURE (default when using OpenSSL).
</p>


</div>