https://github.com/khromov/clarity

Ad blocker for WordPress
https://github.com/khromov/clarity

wordpress wordpress-plugin

Last synced: 18 days ago
JSON representation

Ad blocker for WordPress

• Host: GitHub
• URL: https://github.com/khromov/clarity
• Owner: khromov
• Created: 2016-01-28T14:04:12.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2023-11-14T23:29:35.000Z (about 1 year ago)
• Last Synced: 2024-10-14T22:09:24.886Z (about 1 month ago)
• Topics: wordpress, wordpress-plugin
• Language: PHP
• Homepage: https://wp-clarity.dev
• Size: 632 KB
• Stars: 27
• Watchers: 3
• Forks: 7
• Open Issues: 26
• Metadata Files:
  • Readme: readme.txt

Awesome Lists containing this project

README

        
=== Clarity - Ad blocker for WordPress ===

Contributors: khromov

Tags: notifications, ads, adblock

Requires at least: 5.0

Tested up to: 6.3

Requires PHP: 7.0

Stable tag: trunk

License: GPL2

Clarity is an ad blocker for your WordPress admin. It hides obtrusive plugin and theme notifications 

asking you to pay for upgraded version or to collect your personal data.

== Description ==

*Basic usage*

The plugin requires zero configuration. Simply install and activate Clarity and obtrusive ads will disappear. Please see the 

Frequently Asked Questions for information about how to troubleshoot or add new entries to the block list.

== Requirements ==

* PHP 7.0 or higher

== Translations ==

* None

== Installation ==

1. Upload the `clarity-ad-blocker` folder to `/wp-content/plugins/`

2. Activate the plugin (Clarity - Ad blocker for WordPress) through the 'Plugins' menu in WordPress

3. You're done!

== Frequently Asked Questions ==

= Where is the settings page? =

The plugin has no settings page, it works without any need to configure it. If you are still seeing some unwanted banners, see below.

= A plugin I'm using is still showing banners or notifications! =

Clarity works using a visual block list, similar to a browser ad blocker. Plugins have to be added manually.

You can [create an issue](https://github.com/khromov/clarity/issues/new/choose) to ask for a plugin to be supported.

You can also make a GitHub pull requst to the [official block list](https://github.com/khromov/clarity/blob/master/definitions.txt) - 

in that case, add an entry to the `definitions.txt` file with a CSS selector that hides the notification.

= I am a plugin or theme author, how can I avoid being filtered? =

Please [create an issue](https://github.com/khromov/clarity/issues/new/choose) and select "Ask for filter removal".

Generally, your plugin must fulfill the following:

- Your notifications are shown only on an option page that belongs to your plugin, and nowhere else.

- Your notifications are shown only for Administrator role users.

- You have unique CSS classes to make it easy to identify different types of notifications that you use.

== Screenshots ==

1. A collection of popular plugin notification nags

2. Notification nags are hidden after installing and activating Clarity

== Upgrade Notice ==

N/A

== Changelog ==

Clarity receives regular updates to its block list. The versioning standard is `..`. For example version `1.0.220201` means you are running version `1.0` of the plugin using the block list from february 1st, 2022.

You can always find the latest block list here. You can see the latest changes to the block list here.

= 1.3 =

* Improved performance with selector cache

* Fixed a bug on non-unix platforms

= 1.2 =

* Set correct textdomain for translations

= 1.1 =

* Added helpful links in the plugins list

= 1.0 =

* Initial release