From e798c65d2eab7b1bb5c9b5468a54ec2b961a44b4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Kevin=20R=C3=B6bert?= Date: Sun, 27 Oct 2019 15:23:22 +0000 Subject: [PATCH] Update Rules file --- Technical-details/Rules-file.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/Technical-details/Rules-file.md b/Technical-details/Rules-file.md index 49c1cb9..e8ccf58 100644 --- a/Technical-details/Rules-file.md +++ b/Technical-details/Rules-file.md @@ -51,6 +51,12 @@ The data.min.json file is mostly equals to the data.json file. But with the Clea From the version 1.5a, every rule has the following structure: `([\\/|\\?]|(&|&))(=[^\\/|\\?|&]*)`. The only difference between the rules, are the **field names**. The **field names** can still be regular expressions, but they don't have to handle the "well formed field check". +**rawRules**: Because there are other elements in a URL that should be filtered, besides "well formed fields", there is also the **rawRules** property. Regular expressions formulated in this property can refer to the entire URL and not just to individual fields. They are therefore applied directly to the URL. + +**referralMarketing**: Since version 1.9.0 you can allow **referral marketing** in ClearURLs. Previously these fields were always removed. Since some people want to support other people through referral marketing, referral marketing can be allowed in the settings. If referral marketing is allowed, the regular expressions in this array are no longer filtered. **By default referral marketing is not allowed**. + +**forceRedirection**: Some websites, such as Google, have manipulated URLs (`` tags) in such a way that the URL is no longer called normally, but via a built-in script. The result is that a simple redirect of the URL does no longer works. So that the URL can still be forwarded by ClearURLs, there is the property **forceRedirection**, which writes the URL into the main_frame object of the browser. + Every other propertie is equals to the **data.json** file. The example from the **data.json** file looks like the following as a **data.min.json** file: @@ -63,12 +69,19 @@ The example from the **data.json** file looks like the following as a **data.min "rules": [ "trackingField", ], + "rawRules": [ + "\\/ref=[^\\/|\\?]*" + ], + "referralMarketing": [ + "([\\/|\\?|#]|(&|&))+(tag=[^\\/|\\?|&]*)" + ], "exceptions": [ ".*(domain name\\.).*(\\/re).*\\/redirector.html\\/.*" ], "redirections": [ ".*domain name\\..*\\/.*url\\?.*url=((https%3A%2F%2F|http%3A%2F%2F)[^&]*)" - ] + ], + "forceRedirection": false } } }