Filtering rules documentation

[avatar]

Hey all!

We have updated the documentation on the filtering rules syntax:
https://adguard.com/en/filterrules.html

Finally, we have a detailed and comprehensive article covering all Adguard capabilities. It is important to note, that creating of your own filtering rules requires some knowledge of web technologies, such as HTML, CSS and Javascript.


Helpful links:

• How webpage is loaded and displayed: https://varvy.com/pagespeed/display.html
• What is CSS: https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_started/What_is_CSS
• CSS selectors explained: https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors
• Regular expressions explained: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions
  
• A great filtering rules visual representation: https://adblockplus.org/filter-cheatsheet
• Adblock plus filtering rules syntax: http://adblockplus.org/en/filters

Helpful tools:

• Fiddler web debugging proxy: http://www.telerik.com/fiddler
• Chrome developer tools: https://developer.chrome.com/devtools

 

[Adam]

Thank you for this, it is helpful.
By the way, I think you forgot to delete this sentence from English documentation.

https://adguard.com/en/filterrules.html#html-filtering-rules-example

And it is also something wrong here - https://adguard.com/en/filterrules.html#elemhide-example

 

[avatar]

Ops, thank you for pointing at it!

 

[SlowMemory]

It seems that $ should be escaped in the replace example.

+)
in https://adguard.com/en/filterrules.html#replace-modifier

://*.damoh.golem.de/$replace=/(<VAST(.|\s)*?>)(.|\s)*<\/VAST>/$1<\/VAST>/i,domain=video.golem.de

in German filter:

://*.damoh.golem.de/$replace=/(<VAST[\s\S]*?>)[\s\S]*<\/VAST>/\$1<\/VAST>/,domain=video.golem.de

 

[vasily_bagirov]

It seems that $ should be escaped in the replace example.

No, it's fine, the regexp starts after '$replace'.

 

[avatar]

We've just updated the documentation, thank you!

 

[Bruno]

hi.

Is it right to say that both rules below will have the same effect - blocking the URL -, meaning both syntax are correct?

||1dollarcash.com^
0.0.0.0 1dollarcash.com

Thanks for the help.

 

[Blaz]

2nd one is hosts file syntax. Use first one.

 

[Bruno]

Thanks.

BTW, do you think is it better to add the rule in Adguard or Host file then?

 

[Blaz]

Better to AdGuard in case some site gets useful content from it you can whitelist that url for that site then.

 

[Bruno]

Thx

 

[Tanathon]

Hi,

I read today (tho I suspected it already) that YouTube channels don't earn anything if ads before & in their videos are blocked. I'm very happy with how well AdGuard works even tho YouTube tries to bypass it but at the same time I would like to support the channels that I am subscribed to. Becoming a Patreon for all of them is simply not possible as there are just too many good channels. Switching AdGuard on and off while watching content on YouTube is a bit cumbersome and carries the risk of forgetting to switch it back on once done. I also don't want to give YouTube green light in general because the amount, type, and length of ads they place is excessive. So what I'd like to do is to define a filter that can detect whether or not I'm watching a video of a subscribed channel and then either blocks or doesn't block ads. Is there a way to search e.g. for the grey "Subscribed" button on a YouTube page and then automatically deactivate the filter for this video? I can identify the HTML element for the button on the YouTube page but when I read the information about filter rules I couldn't find out how to combine those to achieve the wanted effect. Could anyone point me towards the section(s) in the manual dealing with that? I have some knowledge in web technologies but it seems not enough to figure that out myself.

Would be happy for any help provided!

 

[Alex302]

Hi,

I read today (tho I suspected it already) that YouTube channels don't earn anything if ads before & in their videos are blocked. I'm very happy with how well AdGuard works even tho YouTube tries to bypass it but at the same time I would like to support the channels that I am subscribed to. Becoming a Patreon for all of them is simply not possible as there are just too many good channels. Switching AdGuard on and off while watching content on YouTube is a bit cumbersome and carries the risk of forgetting to switch it back on once done. I also don't want to give YouTube green light in general because the amount, type, and length of ads they place is excessive. So what I'd like to do is to define a filter that can detect whether or not I'm watching a video of a subscribed channel and then either blocks or doesn't block ads. Is there a way to search e.g. for the grey "Subscribed" button on a YouTube page and then automatically deactivate the filter for this video? I can identify the HTML element for the button on the YouTube page but when I read the information about filter rules I couldn't find out how to combine those to achieve the wanted effect. Could anyone point me towards the section(s) in the manual dealing with that? I have some knowledge in web technologies but it seems not enough to figure that out myself.

Would be happy for any help provided!

Hi. At the moment this is impossible

 

[Tanathon]

Hi. At the moment this is impossible

Thanks for the answer!

I think I'll then watch all my subscribed content in a second Firefox instance (private window should work) and switch AdGuard off there. This way it shouldn't matter much if I forget to switch it back on as it won't be remembered in other instances.

Also a special thank you for the good work on the filters!! I'm one of those Google/YouTube is trying to push adds on atm even tho AdGuard is activated and it's rather annoying. On the plus side, it has reminded me how miserable life would be if you guys & girls wouldn't be around so a big thank you for that!! I keep fingers crossed that you'll have the upper hand again soon. Until then I just log out of my Google account to get rid of the ads. Found that hint somewhere in the forum and it works great

 

[Sabhi]

 

[Alex302]

Hi. This is server's issue.

 

[Sabhi]

It's still the same can you provide any alternative ?

 

[Alex302]

No. Ask site owner to fix certificate.

 

[Sabhi]

Okay