=== Unilevel MLM Plan ===
Contributors: LetsCMS
Donate link: https://letscms.com/
Tags: unilevel, mlm, network marketing, genealogy, epin
Requires at least: 6.1
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 2.2
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Run a unilevel MLM network in WordPress: member registration with sponsors, ePins and a graphical genealogy tree.

== Description ==

Unilevel MLM Plan helps you build and manage a unilevel network marketing plan, where every member can sponsor members directly below them up to the number of levels you choose.

= Admin features =

* First user (network owner) registration
* General settings: currency, number of levels, number of referrals per member
* ePin generation (free or paid ePins) with configurable length
* ePin reports with search
* Mark members as paid or unpaid from the Users screen

= Frontend features =

* Registration page for new network members, with live username, email, sponsor and ePin checks
* Register new members directly from the genealogy tree
* Graphical genealogy (downlines) view for members

For more help, see the [Unilevel MLM Plan Documentation](https://www.letscms.com/unilevel-mlm-plan-documentation/).

> ### Our Premium plugins with WordPress support
> [UMW - Unilevel MLM WooCommerce](https://mlmtrees.com/product/umw) - [Overview](https://www.youtube.com/playlist?list=PLn9cGkS1zw3RTk_YZIWAhno7fGVnRKI9M) - [Guidelines](https://www.letscms.com/unilevel-woo-commerce-documentation/)
> [BMW - Binary MLM WooCommerce](https://mlmtrees.com/product/bmw-wordpress) - [Overview](https://www.youtube.com/playlist?list=PLn9cGkS1zw3QMCC-89p5zK39mPtfltkwq) - [Guidelines](https://www.letscms.com/binary-mlm-woocommerce/)
> [UMP - Unilevel MLM Plan](https://mlmtrees.com/product/ump-wordpress) - [Overview](https://www.youtube.com/playlist?list=PLn9cGkS1zw3QhCY1Ycsh2sJfHlZg7Mjee) - [Guidelines](https://www.letscms.com/unilevel-mlm-plan-documentation/)
> [BMP - Binary MLM Plan](https://mlmtrees.com/product/bmp-pro-wordpress) - [Overview](https://www.youtube.com/playlist?list=PLn9cGkS1zw3Q1ZMo94AT9_RP1IPxnirpb) - [Guidelines](https://www.letscms.com/bmp_pro_documentation/)
> [FMW - Force Matrix WooCommerce](https://mlmtrees.com/product/fmw-wordpress) - [Guidelines](https://www.letscms.com/force-matrix-with-woocommerce/)

= Pro version =

For more features, use the Pro version: [Unilevel MLM Plan Pro](https://mlmtrees.com/product/unilevel-mlm-plan-wordpress/).

= Free support =

Please share your issues or feedback with us at letscmsdev@gmail.com.

* Mail: letscmsdev@gmail.com
* Skype: jks0586
* WhatsApp: +91-9717478599
* Support: 24x7

= Paid support =

We provide paid support for the paid version. Cost depends on the work; normal customisation charges are 10 USD/hour.

== Installation ==

= Automatic installation =

1. Log in to your WordPress dashboard.
2. Go to Plugins > Add New.
3. Search for "Unilevel MLM Plan" and click Install Now.
4. Activate the Unilevel MLM Plan plugin.

= Manual installation =

1. Upload the `unilevel-mlm-plan` folder to the `/wp-content/plugins/` directory.
2. Activate Unilevel MLM Plan from the Plugins screen.

After activation, a new "Unilevel MLM Plan" menu appears in the admin. Create the first user (the network owner) there, then set up the general settings. The plugin also creates "Register" and "Downlines" pages.

== External services ==

The genealogy (Downlines) page uses Google Charts to draw the network tree.

* What it does: the bundled Google Charts loader downloads the chart library from Google when a member opens the Downlines page.
* What is sent: the visitor's browser requests the library from www.gstatic.com, which shares the visitor's IP address and browser details with Google. The network data itself is drawn in the browser and is not sent to Google.
* When: only when the Downlines page is viewed.
* Google Charts: [Terms of Service](https://developers.google.com/chart/terms), [Privacy Policy](https://policies.google.com/privacy).

== Changelog ==

= 2.2 =
* Security: only administrators can change a member's payment status. Previously, visitors who were not logged in could change it.
* Security: ePins are now checked on the server during registration, so used or invalid ePins are rejected and one ePin cannot be used twice.
* Security: usernames are validated at registration, and all values in the genealogy tree are escaped.
* Security: the registration referral limit is enforced on the server, and unknown sponsors are rejected.
* Security: admin settings forms now check user permissions.
* Fixed: passwords are no longer altered on registration, and empty passwords are rejected.
* Fixed: the payment status dropdown on the Users screen now saves.
* Fixed: deactivating the plugin no longer deletes pages, menu items or the member role.
* Fixed: uninstalling no longer removes other plugins' settings or pages that only share a title.
* Improved: Register and Downlines pages now display inside your theme's layout, including block themes.
* Improved: the plugin's admin styles load only on its own screens, so other admin pages keep their styling.
* Removed PHP sessions, which were unused and interfered with Site Health and REST API requests.
* Tested up to WordPress 7.1 and PHP 8.5.

== Upgrade Notice ==

= 2.2 =
Important security update: fixes an issue that let visitors who were not logged in change payment status, and prevents ePin reuse. Please update.