Left: | ||
Right: |
LEFT | RIGHT |
---|---|
1 title=Writing Adblock Plus filters | 1 title=Writing Adblock Plus filters |
2 | 2 |
3 | 3 |
4 <p>{{s1 Current Adblock Plus versions allow you to "tweak" your filters in many different ways. This document explains the choices that you have and how they ca n be used.}}</p> | 4 <p>{{s1 Current Adblock Plus versions allow you to "tweak" your filters in many different ways. This document explains the choices that you have and how they ca n be used.}}</p> |
5 | 5 |
6 <p>{{s2 <em>Disclaimer</em>: All filter examples given here are really only ex amples and are not meant to be used.}}</p> | 6 <p>{{s2 <em>Disclaimer</em>: All filter examples given here are really only ex amples and are not meant to be used.}}</p> |
7 | 7 |
8 <h2 id="introduction">{{s3 Introduction to Adblock Plus filters}}</h2> | 8 <h2 id="introduction">{{s3 Introduction to Adblock Plus filters}}</h2> |
9 | 9 |
10 <p>{{s4 The options described in this section should be enough for users who h ave to create a filter occasionally.}}</p> | 10 <p>{{s4 The options described in this section should be enough for users who h ave to create a filter occasionally.}}</p> |
(...skipping 189 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
200 <div id="sponsorad"> | 200 <div id="sponsorad"> |
201 Really cheap tofu, click here! | 201 Really cheap tofu, click here! |
202 </div> | 202 </div> |
203 <textad> | 203 <textad> |
204 Only here you get the best tofu! | 204 Only here you get the best tofu! |
205 </textad> | 205 </textad> |
206 </pre> | 206 </pre> |
207 | 207 |
208 <p>{{s84 You need to download the web page so you will necessarily download th e advertisements. All you can do here is to hide the advertisement so you don't need to see it. That's what element hiding is meant for.}}</p> | 208 <p>{{s84 You need to download the web page so you will necessarily download th e advertisements. All you can do here is to hide the advertisement so you don't need to see it. That's what element hiding is meant for.}}</p> |
209 | 209 |
210 <p>{{s85 The first advertisement above is contained inside an element with cla ss attribute "textad". The following rule will hide exactly any such element: <c ode><fix>##.textad</fix></code>. Here ## marks an element hiding rule while the rest is a selector identifying the elements that need to be hidden. You can hide elements by their id attribute similarly, <code><fix>###sponsorad</fix></code> will hide the second advertisement. And you can hide elements by element name on ly, e.g. <code><fix>##textad</fix></code> for the third advertisement.}}</p> | 210 <p>{{s85 The first advertisement above is contained inside an element with cla ss attribute "textad". The following rule will hide exactly any such element: <c ode><fix>##.textad</fix></code>. Here ## marks an element hiding rule while the rest is a selector identifying the elements that need to be hidden. You can hide elements by their id attribute similarly, <code><fix>###sponsorad</fix></code> will hide the second advertisement. And you can hide elements by element name, e .g. <code><fix>##textad</fix></code> for the third advertisement.}}</p> |
Wladimir Palant
2017/08/01 13:49:36
Nit: "only" doesn't make sense here any more.
ire
2017/08/02 09:56:00
Done.
| |
211 | 211 |
212 <p>{{s86 The <a href="elemhidehelper">Element Hiding Helper extension</a> help s selecting the correct element and writing the corresponding rule without havin g to view the source code of the page. Basic HTML knowledge is useful neverthele ss.}}</p> | 212 <p>{{s86 The <a href="elemhidehelper">Element Hiding Helper extension</a> help s selecting the correct element and writing the corresponding rule without havin g to view the source code of the page. Basic HTML knowledge is useful neverthele ss.}}</p> |
213 | 213 |
214 <p>{{s87 <em>Note</em>: Element hiding works very differently from normal filt ers. This has the implication that no wildcards are supported in element hiding rules.}}</p> | 214 <p>{{s87 <em>Note</em>: Element hiding works very differently from normal filt ers. This has the implication that no wildcards are supported in element hiding rules.}}</p> |
215 | 215 |
216 <h3 id="elemhide_domains">{{s88 Limiting rules to certain domains}}</h3> | 216 <h3 id="elemhide_domains">{{s88 Limiting rules to certain domains}}</h3> |
217 | 217 |
218 <p>{{s89 Usually you want to hide a specific ad on one specific site, you don' t want your rule to be applied on other sites. For example the rule <code><fix># #.sponsor</fix></code> might hide valid code on some sites. But if you write it as <code><fix>example.com##.sponsor</fix></code> it will be applied on <code><fi x>http://example.com/</fix></code> and <code><fix>http://something.example.com/< /fix></code> but not on <code><fix>http://example.org/</fix></code>. You can als o specify multiple domains — simply separate them with commas: <code><fix>domain 1.example,domain2.example,domain3.example##.sponsor</fix></code>.}}</p> | 218 <p>{{s89 Usually you want to hide a specific ad on one specific site, you don' t want your rule to be applied on other sites. For example the rule <code><fix># #.sponsor</fix></code> might hide valid code on some sites. But if you write it as <code><fix>example.com##.sponsor</fix></code> it will be applied on <code><fi x>http://example.com/</fix></code> and <code><fix>http://something.example.com/< /fix></code> but not on <code><fix>http://example.org/</fix></code>. You can als o specify multiple domains — simply separate them with commas: <code><fix>domain 1.example,domain2.example,domain3.example##.sponsor</fix></code>.}}</p> |
219 | 219 |
220 <p>{{s90 If a domain name is preceded with "~", the rule will <strong>not</str ong> be applied on pages from this domain (requires Adblock Plus 1.1 or higher). For example, <code><fix>~example.com##.sponsor</fix></code> will be be applied on pages from any domain but "example.com" and <code><fix>example.com,~foo.examp le.com##.sponsor</fix></code> makes the rule apply on "example.com" domain with the exception of "foo.example.com" subdomain.}}</p> | 220 <p>{{s90 If a domain name is preceded with "~", the rule will <strong>not</str ong> be applied on pages from this domain (requires Adblock Plus 1.1 or higher). For example, <code><fix>~example.com##.sponsor</fix></code> will be be applied on pages from any domain but "example.com" and <code><fix>example.com,~foo.examp le.com##.sponsor</fix></code> makes the rule apply on "example.com" domain with the exception of "foo.example.com" subdomain.}}</p> |
(...skipping 74 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
295 {{s110 The data used for creating the signature is a concatenated list of requ est variables (namely URI, host and user agent) separated by the <code><fix>NUL< /fix></code> character "\0". For example:}} | 295 {{s110 The data used for creating the signature is a concatenated list of requ est variables (namely URI, host and user agent) separated by the <code><fix>NUL< /fix></code> character "\0". For example:}} |
296 </p> | 296 </p> |
297 | 297 |
298 <pre> | 298 <pre> |
299 /index.html?q=foo\0www.example.com\0Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv :30.0) Gecko/20100101 Firefox/30.0 | 299 /index.html?q=foo\0www.example.com\0Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv :30.0) Gecko/20100101 Firefox/30.0 |
300 </pre> | 300 </pre> |
301 | 301 |
302 <p> | 302 <p> |
303 {{s111 Finally, generate the signature for this string by using the signature algorithm SEC_OID_ISO_SHA_WITH_RSA_SIGNATURE (default when using OpenSSL).}} | 303 {{s111 Finally, generate the signature for this string by using the signature algorithm SEC_OID_ISO_SHA_WITH_RSA_SIGNATURE (default when using OpenSSL).}} |
304 </p> | 304 </p> |
LEFT | RIGHT |