Writing Adblock Plus filters Introd

Writing Adblock Plus filters

Introduction to Adblock Plus filters
Basic filter rules
Defining exception rules
Matching at beginning/end of an address
Marking separator characters
Comments
Special comments
Advanced features
Specifying filter options
Using regular expressions
Element hiding
Basic rules
Limiting rules to certain domains
Attribute selectors
Advanced selectors
Exception rules
Simplified element hiding syntax
Implementing a sitekey on the server

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 can be used.

Disclaimer: All filter examples given here are really only examples and are not meant to be used.
Introduction to Adblock Plus filters

The options described in this section should be enough for users who have to create a filter occasionally.
Basic filter rules

The most trivial filter you can define is of course the address of banner you want to block. However, often this address changes every time you open a page. For example it could be http://example.com/ads/banner123.gif where 123 is a random number. Here blocking the complete address won't help you, you need a more general filter — like http://example.com/ads/banner*.gif. Or maybe even http://example.com/ads/*.

Note: Make sure that you are not replacing too much by wildcards. The filter http://example.com/* will definitely block all banners but it will also block everything else from example.com that you still might want to see.
Defining exception rules

Sometimes you will notice that one of your filters that is usually working quite well blocks in some case blocks something that it shouldn't be blocking. You don't want to remove this filter but you still don't want it to match in this one case.

That's what exception rules are good for — they allow you to define cases where filters shouldn't be applied. For example if you are unhappy with your filter adv blocking http://example.com/advice.html, you can define an exception rule @@advice. Exception rules are no different from filter rules, you can use wildcards or regular expressions. You only have to precede them by @@ to indicate an exception rule.

Exception rules can do more. If an exception rule starts with http:// or https:// (optionally with a pipe before it) it will make whole pages an exception. For example, if your exception rule is @@|http://example.com and you open some page from example.com — Adblock Plus will be entirely disabled on this page and nothing will be blocked.
Matching at beginning/end of an address

Usually Adblock Plus treats every filter as if it had a wildcard at its beginning and end, e.g. there is not difference between the filters ad and *ad*. While this is usually unproblematic, sometimes you wish that the filter you defined only matches at the beginning or end of an address. For example you might want to block all Flash, but if you add the filter swf the address http://example.com/swf/index.html will also be blocked.

Solution to this problem: add a pipe symbol to the filter to show that there should be definitely the end of the address at this point. For example the filter swf| will block http://example.com/annoyingflash.swf but not http://example.com/swf/index.html. And the filter |http://baddomain.example/ will block http://baddomain.example/banner.gif but not http://gooddomain.example/analyze?http://baddomain.example.

Sometimes one wants to block http://example.com/banner.gif as well as https://example.com/banner.gif and http://www.example.com/banner.gif. This can be achieved by putting two pipe symbols in front of the filter which makes sure the filter matches at the beginning of the domain name: ||example.com/banner.gif will block all these addresses while not blocking http://badexample.com/banner.gif or http://gooddomain.example/analyze?http://example.com/banner.gif (requires Adblock Plus 1.1 or higher).
Marking separator characters

Often you need to accept any separator character in a filter. For example, you might write a filter that blocks http://example.com/ and http://example.com:8000/ but not http://example.com.ar/. Here the symbol ^ can be used as a placeholder for a single separator character: http://example.com^ (requires Adblock Plus 1.1 or higher).

Separator character is anything but a letter, a digit, or one of the following: _ - . %. The end of the address is also accepted as separator. In the following example all separator characters are shown in red: http://example.com:8000/foo.bar?a=12&b=%D1%82%D0%B5%D1%81%D1%82. So this address can be blocked with the filter ^example.com^ or ^%D1%82%D0%B5%D1%81%D1%82^ or ^foo.bar^.
Comments

Any rule that starts with an exclamation mark is considered a comment. It will still show up in the filter list but in grey instead of black. Adblock Plus will ignore this rule for actual blocking so it is safe to write there whatever you want. You can place a comment rule above a real filter to describe what it is doing. Or you can put a comment on top of your filter list stating your authorship (most filter list authors do that).
Special comments

Special comments will only have an effect in downloaded filter lists, not in custom filters. They can set a number of parameters for the filter list:

! Homepage: http://example.com/

This comment determines which webpage should be linked as filter list homepage.

! Title: FooList

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.

! Expires: 5 days

This comment sets the update interval for the filter list, the value can be given in days (e.g. 5 days) or hours (e.g. 8 hours). 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.

! Checksum: OaopkIiiAl77sSHk/VAWDA

This comment makes sure that accidental corruption of the data won't result in broken filters. For example, some firewall software might modify the filter */adnetwork/* on download in an attempt to protect the user against ads. It will remove part of the filter so that Adblock Plus will only see the filter **. A checksum comment in the filter list protects against this scenario, any modifications will have the result that the checksum no longer matches and Adblock Plus will ignore the data.

To calculate the checksum the following steps need to be performed:
Remove the existing checksum comment if any.
Encode filter list text using UTF-8 encoding.
Convert all line breaks to Unix style (replace
by
if present).
Remove empty lines (replace sequences of the
character by a single
character).
Calculate the base64-encoded MD5 checksum of the text, remove trailing = characters if any.

You can also have a look at the Python-based reference implementations to validate a checksum and to add a checksum to a file.

! Redirect: http://example.com/list.txt

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 "canonical" address of the filter list.

! Version: 1234

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.

Advanced features

The features described in this section are usually used only by power users and filterlist creators. Feel free to skip it.
Specifying filter options

Adblock Plus allows you to specify a number of options to modify the behavior of a filter. You list these options separated with commas after a dollar sign ($) at the end of the filter, for example:

*/ads/*$script,match-case

Here */ads/* is the actual filter and script and match-case are its options. Currently the following options are supported:

Type options: determine which types of elements a filter can block (or whitelist in case of an exception rule). Multiple type options can be specified to indicate that the filter should be applied to several types of elements. Possible types are:
script — external scripts loaded via HTML script tag
image — regular images, typically loaded via HTML img tag
stylesheet — external CSS stylesheet files
object — content handled by browser plugins, e.g. Flash or Java
xmlhttprequest — requests started by the XMLHttpRequest object
object-subrequest — requests started plugins like Flash
subdocument — embedded pages, usually included via HTML frames
document — the page itself (only exception rules can be applied to the page)
elemhide — for exception rules only, similar to document but only disables element hiding rules on the page rather than all filter rules (Adblock Plus 1.2 and higher required)
other — types of requests not covered in the list above
The type options background, xbl, ping and dtd are outdated and should no longer be used.
Inverse type options: specify the element types the filter should not be applied to. Possible inverse type options: ~script, ~image, ~stylesheet, ~object, ~xmlhttprequest, ~object-subrequest, ~subdocument, ~document, ~elemhide, ~other
Restriction to third-party/first-party requests: If the third-party option is specified, the filter is only applied to req

Kết quả (Việt) 1:

Writing Adblock Plus filters Introduction to Adblock Plus filters Basic filter rules Defining exception rules Matching at beginning/end of an address Marking separator characters Comments Special comments Advanced features Specifying filter options Using regular expressions Element hiding Basic rules Limiting rules to certain domains Attribute selectors Advanced selectors Exception rules Simplified element hiding syntax Implementing a sitekey on the serverCurrent Adblock Plus versions allow you to "tweak" your filters in many different ways. This document explains the choices that you have and how they can be used.Disclaimer: All filter examples given here are really only examples and are not meant to be used.Introduction to Adblock Plus filtersThe options described in this section should be enough for users who have to create a filter occasionally.Basic filter rulesThe most trivial filter you can define is of course the address of banner you want to block. However, often this address changes every time you open a page. For example it could be http://example.com/ads/banner123.gif where 123 is a random number. Here blocking the complete address won't help you, you need a more general filter — like http://example.com/ads/banner*.gif. Or maybe even http://example.com/ads/*.Note: Make sure that you are not replacing too much by wildcards. The filter http://example.com/* will definitely block all banners but it will also block everything else from example.com that you still might want to see.Xác định quy định ngoại lệĐôi khi bạn sẽ nhận thấy rằng một trong các bộ lọc của bạn thường làm việc khá tốt khối trong một số trường hợp khối một cái gì đó mà nó không nên ngăn chặn. Bạn không muốn để loại bỏ bộ lọc này nhưng bạn vẫn không muốn nó sẽ trùng khớp trong trường hợp một trong những này.Đó là những gì quy định ngoại lệ là tốt cho — chúng cho phép bạn để xác định các trường hợp mà bộ lọc không nên được áp dụng. Ví dụ: nếu bạn không hài lòng với bộ lọc của bạn adv http://example.com/advice.html chặn, bạn có thể xác định một ngoại lệ quy tắc @@advice. Ngoại lệ quy định là không có khác nhau từ quy tắc lọc, bạn có thể sử dụng ký tự đại diện hoặc biểu thức thông thường. Bạn chỉ phải đứng trước chúng bằng Anh... để cho biết các quy tắc ngoại lệ.Ngoại lệ quy tắc có thể làm nhiều hơn nữa. Nếu quy tắc ngoại lệ bắt đầu với http:// hoặc https:// (tùy chọn với một ống trước khi nó) nó sẽ làm cho toàn bộ trang một ngoại lệ. Ví dụ, nếu quy tắc ngoại lệ của bạn @@ | http://example.com và bạn mở một số trang từ example.com — Adblock Plus sẽ được hoàn toàn vô hiệu hóa trên Trang này và không có gì sẽ bị chặn.Phù hợp với đầu/cuối của địa chỉAdblock Plus thường đối xử với mỗi bộ lọc như nếu nó có một ký tự đại diện tại của nó bắt đầu và kết thúc, ví dụ như có không phải là sự khác biệt giữa quảng cáo bộ lọc và * quảng cáo *. Trong khi đây là thường unproblematic, đôi khi bạn muốn có bộ lọc bạn đã xác định chỉ phù hợp với ở đầu hoặc cuối của một địa chỉ. Ví dụ: bạn có thể muốn chặn tất cả Flash, nhưng nếu bạn thêm bộ lọc swf http://example.com/swf/index.html địa chỉ cũng sẽ bị chặn.Các giải pháp cho vấn đề này: thêm một biểu tượng ống để các bộ lọc để hiển thị rằng không nên có chắc chắn cuối địa chỉ tại thời điểm này. Ví dụ: bộ lọc swf| sẽ chặn http://example.com/annoyingflash.swf nhưng không http://example.com/swf/index.html. Và bộ lọc | http://baddomain.example/ sẽ chặn http://baddomain.example/banner.gif nhưng không http://gooddomain.example/analyze?http: / / baddomain.example.Đôi khi ai muốn chặn http://example.com/banner.gif cũng như https://example.com/banner.gif và http://www.example.com/banner.gif. Điều này có thể đạt được bằng cách đặt hai ống biểu tượng ở phía trước của các bộ lọc mà làm cho chắc chắn phù hợp với bộ lọc đầu tên miền: ||example.com/banner.gif sẽ chặn tất cả các địa chỉ này trong khi không chặn http://badexample.com/banner.gif hoặc http://gooddomain.example/analyze?http://example.com/banner.gif (yêu cầu Adblock Plus 1.1 hoặc cao hơn).Đánh dấu phân cách nhân vậtThường, bạn cần phải chấp nhận bất kỳ ký tự phân tách trong một bộ lọc. Ví dụ, bạn có thể viết một bộ lọc chặn http://example.com/ và http://example.com:8000 / nhưng không http://example.com.ar/. Đây là biểu tượng ^ có thể được sử dụng như một giữ chỗ cho một ký tự phân tách duy nhất: http://example.com ^ (yêu cầu Adblock Plus 1.1 hoặc cao hơn).Separator character is anything but a letter, a digit, or one of the following: _ - . %. The end of the address is also accepted as separator. In the following example all separator characters are shown in red: http://example.com:8000/foo.bar?a=12&b=%D1%82%D0%B5%D1%81%D1%82. So this address can be blocked with the filter ^example.com^ or ^%D1%82%D0%B5%D1%81%D1%82^ or ^foo.bar^.CommentsAny rule that starts with an exclamation mark is considered a comment. It will still show up in the filter list but in grey instead of black. Adblock Plus will ignore this rule for actual blocking so it is safe to write there whatever you want. You can place a comment rule above a real filter to describe what it is doing. Or you can put a comment on top of your filter list stating your authorship (most filter list authors do that).Special commentsSpecial comments will only have an effect in downloaded filter lists, not in custom filters. They can set a number of parameters for the filter list: ! Homepage: http://example.com/ This comment determines which webpage should be linked as filter list homepage. ! Title: FooList 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. ! Expires: 5 days This comment sets the update interval for the filter list, the value can be given in days (e.g. 5 days) or hours (e.g. 8 hours). 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. ! Checksum: OaopkIiiAl77sSHk/VAWDA This comment makes sure that accidental corruption of the data won't result in broken filters. For example, some firewall software might modify the filter */adnetwork/* on download in an attempt to protect the user against ads. It will remove part of the filter so that Adblock Plus will only see the filter **. A checksum comment in the filter list protects against this scenario, any modifications will have the result that the checksum no longer matches and Adblock Plus will ignore the data. To calculate the checksum the following steps need to be performed: Remove the existing checksum comment if any. Encode filter list text using UTF-8 encoding. Convert all line breaks to Unix style (replace
by
if present). Remove empty lines (replace sequences of the
character by a single
character). Calculate the base64-encoded MD5 checksum of the text, remove trailing = characters if any. You can also have a look at the Python-based reference implementations to validate a checksum and to add a checksum to a file. ! Redirect: http://example.com/list.txt 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 "canonical" address of the filter list. ! Version: 1234 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.Advanced featuresThe features described in this section are usually used only by power users and filterlist creators. Feel free to skip it.Specifying filter optionsAdblock Plus allows you to specify a number of options to modify the behavior of a filter. You list these options separated with commas after a dollar sign ($) at the end of the filter, for example:*/ads/*$script,match-caseHere */ads/* is the actual filter and script and match-case are its options. Currently the following options are supported: Type options: determine which types of elements a filter can block (or whitelist in case of an exception rule). Multiple type options can be specified to indicate that the filter should be applied to several types of elements. Possible types are: script — external scripts loaded via HTML script tag image — regular images, typically loaded via HTML img tag stylesheet — external CSS stylesheet files object — content handled by browser plugins, e.g. Flash or Java xmlhttprequest — requests started by the XMLHttpRequest object object-subrequest — requests started plugins like Flash subdocument — embedded pages, usually included via HTML frames document — the page itself (only exception rules can be applied to the page) elemhide — for exception rules only, similar to document but only disables element hiding rules on the page rather than all filter rules (Adblock Plus 1.2 and higher required) other — types of requests not covered in the list above The type options background, xbl, ping and dtd are outdated and should no longer be used. Inverse type options: specify the element types the filter should not be applied to. Possible inverse type options: ~script, ~image, ~stylesheet, ~object, ~xmlhttprequest, ~object-subrequest, ~subdocument, ~document, ~elemhide, ~other Restriction to third-party/first-party requests: If the third-party option is specified, the filter is only applied to req

Kết quả (Việt) 2:

Viết Adblock Plus lọc Giới thiệu về Adblock Plus lọc các quy tắc lọc cơ bản Định nghĩa quy tắc ngoại lệ Matching đầu / kết thúc của một địa chỉ ghi dấu ký tự phân cách Comments nhận xét ​​đặc biệt các tính năng nâng cao Chỉ định tùy chọn bộ lọc Sử dụng biểu thức thông thường phần tử ẩn quy tắc cơ bản Hạn chế quy tắc để lĩnh vực nhất định Attribute selectors selectors nâng cao quy tắc ngoại lệ Giản yếu tố ẩn cú pháp thực hiện một sitekey trên máy chủ phiên bản hiện tại Adblock Plus cho phép bạn "tinh chỉnh" bộ lọc của bạn theo nhiều cách khác nhau. Tài liệu này giải thích những lựa chọn mà bạn có và làm thế nào họ có thể được sử dụng. Disclaimer:. Tất cả những ví dụ lọc đưa ra ở đây là thực sự chỉ là ví dụ và không có nghĩa là để được sử dụng Giới thiệu để Adblock Plus lọc Các tùy chọn được mô tả trong phần này nên là đủ cho người sử dụng ai có để tạo ra một bộ lọc đôi. bộ lọc cơ bản quy tắc lọc tầm thường nhất mà bạn có thể định nghĩa của khóa học là địa chỉ của biểu ngữ bạn muốn chặn. Tuy nhiên, thường địa chỉ này thay đổi mỗi khi bạn mở một trang. Ví dụ như nó có thể là http://example.com/ads/banner123.gif nơi 123 là một số ngẫu nhiên. Đây chặn các địa chỉ đầy đủ sẽ không giúp bạn, bạn cần một bộ lọc tổng quát hơn - như http://example.com/ads/banner*.gif. . Hoặc thậm chí có thể http://example.com/ads/* Lưu ý: Hãy chắc chắn rằng bạn không phải thay thế quá nhiều bởi các kí hiệu. Các bộ lọc http://example.com/* chắc chắn sẽ chặn tất cả các biểu ngữ nhưng nó cũng sẽ chặn tất cả mọi thứ khác từ example.com rằng bạn vẫn có thể muốn xem. quy tắc ngoại lệ Defining Đôi khi bạn sẽ nhận thấy rằng một trong những bộ lọc của bạn mà thường là làm việc khá tốt các khối trong một số trường hợp khối một cái gì đó mà nó không nên được ngăn chặn. Bạn không muốn để loại bỏ bộ lọc này nhưng bạn vẫn không muốn nó để phù hợp trong một trường hợp này. Đó là những gì quy tắc ngoại lệ là tốt cho - họ cho phép bạn xác định các trường hợp bộ lọc không được áp dụng. Ví dụ nếu bạn không hài lòng với quảng cáo bộ lọc của bạn chặn http://example.com/advice.html, bạn có thể xác định lời khuyên một quy tắc ngoại lệ@@. Quy tắc ngoại lệ không khác nhau từ các quy tắc lọc, bạn có thể sử dụng các kí hiệu hay biểu thức thông thường. Bạn chỉ phải đi trước họ bởi@@để chỉ ra một quy tắc ngoại lệ. quy tắc ngoại lệ có thể làm nhiều hơn nữa. Nếu một quy tắc ngoại lệ bắt đầu bằng http: // hoặc https: // (tùy chọn với một đường ống trước khi nó) nó sẽ làm cho toàn bộ trang một ngoại lệ. Ví dụ, nếu quy tắc ngoại lệ của bạn là@@| http: //example.com và bạn mở một số trang từ example.com - Adblock Plus sẽ được hoàn toàn bị vô hiệu hóa trên trang này và không có gì sẽ bị chặn. Matching đầu / kết thúc của một địa chỉ thường Adblock Plus đối xử với mọi bộ lọc như thể nó đã có một ký tự đại diện ở đầu và cuối của nó, ví dụ như không có sự khác biệt giữa quảng cáo và bộ lọc * quảng cáo *. Trong khi điều này là thường có vấn đề, ​​đôi khi bạn muốn rằng các bộ lọc bạn xác định chỉ phù hợp ở đầu hoặc cuối của một địa chỉ. Ví dụ, bạn có thể muốn chặn tất cả các Flash, nhưng nếu bạn thêm các bộ lọc swf địa chỉ http://example.com/swf/index.html cũng sẽ bị chặn. Giải pháp cho vấn đề này: thêm một biểu tượng ống để các bộ lọc để cho rằng nên có chắc chắn kết thúc của địa chỉ vào thời điểm này. Ví dụ như các bộ lọc swf | sẽ chặn http://example.com/annoyingflash.swf nhưng không http://example.com/swf/index.html. Và các bộ lọc | http: //baddomain.example/ sẽ chặn http: //baddomain.example/banner.gif nhưng không http: //gooddomain.example/analyze http: //baddomain.example?. Đôi khi người ta muốn chặn http://example.com/banner.gif cũng như https://example.com/banner.gif và http://www.example.com/banner.gif. Điều này có thể đạt được bằng cách đặt hai biểu tượng ống ở phía trước của bộ lọc mà làm cho chắc chắn rằng bộ lọc phù hợp vào đầu của tên miền: || example.com/banner.gif sẽ chặn tất cả các địa chỉ trong khi không chặn http: // badexample .com / banner.gif hoặc http:? //gooddomain.example/analyze http:. //example.com/banner.gif (yêu cầu Adblock Plus 1.1 hoặc cao hơn) đánh dấu ký tự phân Thường thì bạn cần phải chấp nhận bất kỳ ký tự phân cách trong một bộ lọc. Ví dụ, bạn có thể viết một bộ lọc để chặn http://example.com/ và http://example.com:8000/ nhưng không http://example.com.ar/. Dưới đây là biểu tượng ^ có thể được sử dụng để thay thế cho một ký tự phân cách duy nhất: http: //example.com^ (yêu cầu Adblock Plus 1.1 hoặc cao hơn). nhân vật Separator là bất cứ điều gì nhưng một lá thư, một số, hoặc một trong các cách sau: _ -. %. Sự kết thúc của địa chỉ cũng được chấp nhận như là dấu phân cách. Trong ví dụ sau tất cả các ký tự phân cách được hiển thị bằng màu đỏ: http://example.com:8000/foo.bar?a=12&b=%D1%82%D0%B5%D1%81%D1%82. Vì vậy, địa chỉ này có thể bị chặn với các bộ lọc ^ ^ example.com hoặc ^% D1% 82% D0% B5% D1% 81% D1% 82 ^ hay ^ ^ foo.bar. Bình luận Bất kỳ quy tắc bắt đầu với một dấu chấm than là xem nhận xét. Nó sẽ vẫn hiển thị trong danh sách bộ lọc nhưng trong màu xám thay vì màu đen. Adblock Plus sẽ bỏ qua quy tắc này cho chặn thực tế do đó, nó là an toàn để viết có bất cứ điều gì bạn muốn. Bạn có thể đặt một quy tắc bình luận trên một bộ lọc thực tế để mô tả những gì nó đang làm. Hoặc bạn có thể đặt một bình luận trên đầu danh sách bộ lọc của bạn nói tác giả của bạn (hầu hết các tác giả danh sách bộ lọc làm điều đó). nhận xét ​​đặc biệt nhận xét ​​đặc biệt sẽ chỉ có hiệu lực trong danh sách bộ lọc tải, không phải trong các bộ lọc tùy chỉnh. Họ có thể thiết lập một số thông số cho các danh sách bộ lọc: ! Trang chủ: http://example.com/ Nhận xét ​​này sẽ xác định trang web nên được liên kết như danh sách bộ lọc trang web. ! Tiêu đề: FooList bình luận này đặt ra một tiêu đề cố định cho các danh sách bộ lọc. Nếu nhận xét ​​này là hiện nay người dùng sẽ không còn có thể thay đổi tiêu đề. ! Hết hạn: 5 ngày comment này sẽ đặt khoảng cập nhật cho các danh sách bộ lọc, các giá trị có thể được đưa ra trong ngày (ví dụ như 5 ngày) hay giờ (ví dụ như 8 giờ). Bất kỳ giá trị từ 1 giờ và 14 ngày là có thể. Lưu ý rằng bản cập nhật sẽ không nhất thiết phải xảy ra sau khi khoảng thời gian này. Lần cập nhật thực tế là hơi ngẫu nhiên và phụ thuộc vào một số yếu tố bổ sung để giảm tải máy chủ. ! Checksum: OaopkIiiAl77sSHk / VAWDA comment này để chắc chắn rằng tham nhũng tình cờ của các dữ liệu sẽ không dẫn đến bộ lọc bị hỏng. Ví dụ, một số phần mềm tường lửa có thể sửa đổi các bộ lọc * / adnetwork / * trên tải về trong một nỗ lực để bảo vệ người dùng chống lại các quảng cáo. Nó sẽ loại bỏ một phần của các bộ lọc để Adblock Plus sẽ chỉ nhìn thấy các bộ lọc **. Một nhận xét ​​checksum trong danh sách bộ lọc bảo vệ chống lại kịch bản này, bất kỳ sửa đổi sẽ có kết quả phù hợp nhất với các checksum không còn và Adblock Plus sẽ bỏ qua các dữ liệu. Để tính toán checksum các bước sau đây cần phải được thực hiện: Hủy bỏ các comment checksum hiện tại nếu bất kỳ. Mã hóa bộ lọc danh sách văn bản sử dụng UTF-8 mã hóa. Chuyển đổi tất cả các dòng phá vỡ phong cách Unix (thay thế r bởi n nếu có). Hủy bỏ các dòng trống (thay thế trình tự của các ký tự n bởi một nhân vật n duy nhất). Tính base64 mã hóa MD5 checksum của văn bản, loại bỏ dấu = nhân vật nếu có. Bạn cũng có thể có một cái nhìn tại các triển khai tham chiếu Python dựa trên để xác nhận một checksum và để thêm một checksum cho một tập tin. ! Chuyển: http://example.com/list.txt bình luận này cho thấy danh sách bộ lọc đã chuyển đến một địa chỉ download mới. Adblock Plus sẽ bỏ qua bất kỳ nội dung tập tin vượt ra ngoài bình luận đó và ngay lập tức cố gắng tải về từ địa chỉ mới. Trong trường hợp thành công các địa chỉ trong danh sách bộ lọc sẽ được cập nhật trong các thiết lập. Nhận xét ​​này được bỏ qua nếu địa chỉ mới là giống như địa chỉ hiện tại, nghĩa là nó có thể được sử dụng để thực thi các "kinh điển" địa chỉ của các danh sách bộ lọc. ! Version: 1234 Nhận xét ​​này định nghĩa một phiên bản số của danh sách bộ lọc. Số phiên bản này sẽ được hiển thị trong báo cáo vấn đề và có thể được sử dụng để xác minh rằng bản báo cáo đề cập đến các phiên bản hiện tại của danh sách bộ lọc. Tính năng nâng cao Các tính năng được mô tả trong phần này thường được sử dụng bởi người sử dụng điện và người sáng tạo filterlist. Cảm thấy tự do để bỏ qua nó. Chỉ định tùy chọn bộ lọc Adblock Plus cho phép bạn chỉ định một số tùy chọn để thay đổi hành vi của một bộ lọc. Bạn liệt kê các tùy chọn tách bằng dấu phẩy sau một dấu đô la ($) vào cuối của bộ lọc, ví dụ như: * / quảng cáo / * $ kịch bản, trận đấu-trường hợp đây * / quảng cáo / * là các bộ lọc thực tế và kịch bản và match- trường hợp là lựa chọn của mình. Hiện nay các tùy chọn sau đây được hỗ trợ: Loại tùy chọn: xác định loại của các yếu tố một bộ lọc có thể chặn (hoặc danh sách trắng trong trường hợp của một quy tắc ngoại lệ). Nhiều tùy chọn loại có thể được chỉ định để chỉ ra rằng các bộ lọc nên được áp dụng cho một số dạng của các yếu tố. Loại có thể là: kịch bản - kịch bản bên ngoài nạp qua thẻ script HTML hình ảnh - hình ảnh thường xuyên, thường nạp thông qua HTML tag img stylesheet - file CSS stylesheet bên ngoài phản đối - nội dung xử lý bởi trình duyệt bổ sung, ví dụ như Flash hay Java XMLHttpRequest - yêu cầu bắt đầu bởi các đối tượng XMLHttpRequest đối tượng subrequest - yêu cầu bắt đầu plugin như Flash subdocument - nhúng trang, thường bao gồm thông qua khung HTML tài liệu - trang riêng của mình (chỉ quy định trường hợp ngoại lệ có thể được áp dụng cho trang) elemhide - chỉ quy định ngoại lệ, tương tự như tài liệu nhưng chỉ vô hiệu hóa ẩn yếu tố các quy định về trang hơn là tất cả các quy tắc lọc (Adblock Plus 1.2 và yêu cầu cao hơn) khác - kiểu yêu cầu không nằm trong danh sách trên . Các tùy chọn loại nền, XBL, ping và dtd là lỗi thời và không còn nên được sử dụng tùy chọn loại Inverse : chỉ định các loại phần tử lọc không nên được áp dụng cho. Kiểu tùy chọn nghịch đảo có thể có: ~ kịch bản, hình ảnh ~, ~ stylesheet, đối tượng ~, ~ XMLHttpRequest, ~ đối tượng subrequest, ~ subdocument, ~ tài liệu, ~ elemhide, ~ khác Hạn chế cho bên thứ ba yêu cầu / bên thứ: Nếu người thứ ba tùy chọn -party được quy định, các bộ lọc chỉ áp dụng cho req