Adding whitelisted domains via the filter storage file

Place to exchange experience about rolling out Adblock Plus to many computers, preconfiguring the extension etc.

Adding whitelisted domains via the filter storage file

Postby p_hill » Tue Aug 19, 2014 3:25 pm

Adblock Plus currently stores all filters and filter lists in use into one file. How this file is named and where it is placed, depends on the platform, Adblock Plus (ABP) is used at:

The following paths are examples and need to be adapted to your drive and user names.
  • Internet Explorer: C:\Users\IEUser\AppData\LocalLow\Adblock Plus for IE\patterns.ini
  • Google Chrome: C:\Users\IEUser\AppData\Local\Google\Chrome\User Data\Default\File System\004\p\00\00000000
    For Chrome, please note that the path's part "004" is the number of how many extensions are installed at the time Adblock Plus is was added to Chrome.
  • Opera: C:\Users\IEUser\AppData\Roaming\Opera Software\Opera Stable\File System\000\p\00\00000000
    For Opera, please note that the path's part "004" is the number of how many extensions are installed at the time Adblock Plus is was added to Opera.
  • Firefox: C:\Users\IEUser\AppData\Roaming\Mozilla\Firefox\Profiles\79cqr13z.default\adblockplus\patterns.ini
    For Firefox please note that the path part "79cqr13z.default" is the unique name of your Firefox profile.

Please note that notepad (aka Windows Editor) does not always show the line breaks in that file correctly, which makes working with it very hard. It is therefore highly recommended to use a decent editor instead, for example GVIM for Windows.

In the files above, above, besides some very short preferences version header, the basic structure is always one section [Subscription] including the meta data of each filter list in use followed by one section [Subscription filters] containing all its filters. While most of the possible values are only relevant, if you want to provide an own filter list subsription, merely described at https://adblockplus.org/en/filters#comments, manually adding whitelisted domains, for example for your intranet pages, can be done by adding sections as follows, eg at the end of the document:

Code: Select all
[Subscription]
url=~user~1337
title=Custom group

[Subscription filters]
@@||foofoo.com^$document
@@||moepbar.nl^$document
@@||blubbfoo.de^$document


"1337" can be anything being a unique identifier among all Subscription sections in the file.
"Custom group" can be anything

The added domain exceptions will also show up in ABP's filter settings page. They can also be deleted by the user there. Please note that if the ABP user adds further domain exceptions either via the filter settings page or by clicking "Disable on this page" in the icon menu, it is possible that those entries will land within the same section than the one you just added. If you want to avoid this, for example to be able to clearly distinguish between the ones that you added and the ones that the user added, you can simply make sure that another [Subscription] / [Subscription filters] section pair exists with the additional key/value pair "defaults=whitelist" under the [Subscription] section. This tells ABP to put all domain exceptions created via the application itself into this section pair's [Subscription filters] section.
p_hill
ABP QA Manager
 
Posts: 431
Joined: Mon Feb 03, 2014 6:26 pm
Location: Cologne

Re: Adding whitelisted domains via the filter storage file

Postby Gingerbread Man » Wed Aug 20, 2014 8:43 am

Firefox profiles are user-specific. How is this at all helpful to someone who wants to ensure all users have the same filter subscriptions?
User avatar
Gingerbread Man
 
Posts: 1339
Joined: Fri Aug 12, 2011 5:28 am

Re: Adding whitelisted domains via the filter storage file

Postby p_hill » Wed Aug 20, 2014 8:59 am

I explicitly wrote that they are. As the path's pattern is the same, it is still possible to get there. And in the end, it's all, you can do at the moment, which to improve is the reason for this whole subforum to then in the end implement the most wanted features.
p_hill
ABP QA Manager
 
Posts: 431
Joined: Mon Feb 03, 2014 6:26 pm
Location: Cologne

Re: Adding whitelisted domains via the filter storage file

Postby rebuse » Wed May 18, 2016 9:49 pm

Please update default place!
rebuse
 
Posts: 5
Joined: Sat Oct 24, 2015 5:41 pm


Return to Large scale deployments of ABP

Who is online

Users browsing this forum: No registered users and 2 guests