=== CIDRAM ===
Plugin Name: CIDRAM
Contributors: maikuolan
Tags: anti-spam, cidr, firewall, security, waf
Requires at least: 4.8
Tested up to: 7.0
Stable tag: 4.2.0
Requires PHP: 7.2
License: GPLv2
License URI: https://www.gnu.org/licenses/gpl-2.0.html

CIDRAM: A PHP-level CIDR/IP-based firewall solution.

== Description ==

CIDRAM (Classless Inter-Domain Routing Access Manager) is a PHP script designed to protect websites by blocking requests originating from IP addresses regarded as being sources of undesirable traffic, including (but not limited to) traffic from non-human access endpoints, cloud services, spambots, scrapers, etc. It does this by calculating the possible CIDRs of the IP addresses supplied from inbound requests and then attempting to match these possible CIDRs against its signature files (these signature files contain lists of CIDRs of IP addresses regarded as being sources of undesirable traffic); If matches are found, the requests are blocked.

== Installation ==

# Installing via the plugins dashboard.

1. Before you begin, ensure that you're logged in as an administrator with the necessary permissions to install, update and edit plugins (after activating the plugin but before modifying the plugin configuration file, do not log out from this account).
2. From the plugins dashboard, click the "Add New Plugin" button. From the page that appears, type "CIDRAM" into the "Search Plugins" text field, and press enter. A button to install CIDRAM should appear, and CIDRAM should automatically install when you click on that button.
3. Before activating the plugin, it is advisable to understand the various configuration directives available to the plugin, what they do, and how to change them. Go to `https://cidram.github.io/`, scroll the page until you reach the "Documentation" subheading; Choose your language, and read through "Section 5: Configuration Options"; The information presented relates to the configuration directives available to the plugin.
4. Please read through the "Frequently Asked Questions" before activating!
5. From the plugins dashboard, click the "Activate" button located directly below where you see "CIDRAM".

# Installing manually.

Please refer to the installation instructions provided by the documentation available at `https://cidram.github.io/`.

== Frequently Asked Questions ==

Please refer to `https://github.com/CIDRAM/Docs/blob/master/readme.en.md#user-content-SECTION8`

== Screenshots ==

1. Screenshot of the CIDRAM Front-End homepage.
2. Screenshot of the CIDRAM "Access Denied" page.

== Changelog ==

Please refer to `https://github.com/CIDRAM/CIDRAM/blob/v4/Changelog.md`.

== Requirements ==

- PHP >= 7.2.0
- PCRE

== Updating ==

Note: CIDRAM does not interact in any way with your database, and stores its own configuration settings, customisations, and related materials as flatfiles within its own directory. If you've not changed any of the default configuration settings and if you're not using any customisations for this plugin, updating normally via the plugins dashboard, without need for any additional steps, should be sufficient and shouldn't cause any problems. However, if you've modified the configuration settings for CIDRAM, or if you've made any customisations, I would recommend making backups of all of these prior to updating, due to that updating will overwrite all settings and customisations (after updating, you can then restore your customisations from your backups). Alternatively, if you update via the CIDRAM front-end updates page, all settings and customisations should be preserved.
