=== Paid Memberships Pro - Lock Membership Level Add On ===
Contributors: strangerstudios
Tags: paid memberships pro, pmpro, restrict, lock, block, admin
Requires at least: 4.0
Tested up to: 6.4
Stable tag: 1.0.1

Lock membership level changes for specific users or by level.

== Description ==

This add on allows you to lock a specific user from making changes to their membership level (including selecting a new level if they currently do not have a level). This may be useful for problem members that repeatedly purchase and cancel membership.

Additionally, you can use this add on to lock a membership level for a specific term.  This is useful if you want to restrict members from canceling membership until a required number of installment payments are made.

== Installation ==

1. Make sure you have Paid Memberships Pro installed and activated.
1. Upload the `pmpro-lock-membership-level` directory to the `/wp-content/plugins/` directory of your site.
1. Add a new page for the "Membership Locked" message and assign it under Memberships > Page settings. This is the page that members will be redirected to when attempting to cancel or change membership.
1. Add the shortcode [pmpro_membership_locked] to that page. The shortcode's only attribute "message" can be used to customize the default message shown.

== How to Lock a Member ==
1. Locate the member in the PMPro Members List.
1. Edit the member.
1. Under "Lock Membership", click the button to add a lock to restrict the member from changing their membership level.
1. To view a list of all locked members, navigate to Memberships > Locked Members in the WordPress admin.

Note that a locked member will still "expire" if there is an expiration date set on their membership account. The member will change to "no level" or a downgrade level you have specified via custom code upon expiration.

== How to Lock a Membership Level for a Specific Term ==
1. Edit the membership level on the Memberships > Membership Levels > Edit Membership Level page.
1. Under "Lock Membership Level Settings", check the box to lock the membership level.
1. The level can be set to unlock "Never" or after a specified time period (X days, weeks, months, or years).

== How to View Locked Members ==
1. Navigate to the Memberships > Members List page in the WordPress admin.
1. Select "Locked" from the "Show" dropdown.

== Frequently Asked Questions ==

= I found a bug in the plugin. =

Please post it in the GitHub issue tracker here: https://github.com/strangerstudios/pmpro-lock-membership-level/issues

= I need help installing, configuring, or customizing the plugin. =

Please visit our premium support site at https://www.paidmembershipspro.com for more documentation and our support forums.

== Changelog ==
= 1.0.1 - 2024-02-27 =
* BUG FIX: Fixed PHP error when trying to delete a lock for a user when using PMPro v2.x. #30 (@dparker1005)
* BUG FIX: Fixed issue where the lock expiration would show as "Jan 1, 1970" instead of "Never" while editing a user when using PMPro v2.x. #30 (@dparker1005)
* BUG FIX: Fixed conflict with the PMPro Unlock Protocol Add On where this plugin's Edit Member panel may not show. #30 (@dparker1005, @kimcoleman)

= 1.0 - 2024-02-23 =
* FEATURE: When using PMPro v3.0+, now allows locking specific levels for MMPU compatibility. #28 (@dparker1005)
* FEATURE: When using PMPro v3.0+, added a "Locked Membership" panel to the Edit Users page allowing admins to view, add, and update a user's locks. #28 (@kimcoleman, @dparker1005)
* ENHANCEMENT: Updated how locks are saved in the database to allow for multiple locks per user. Locks from pre-1.0 setups will be migrated as "all level" locks. #28 (@dparker1005)
* BUG FIX/ENHANCEMENT: Improved logic to detect when the checkout page or cancellation page should be locked. #28 (@dparker1005)
* REFACTOR: Removed functions that were no longer needed. #28 (@dparker1005)

= 0.4 - 2023-08-17 =
* ENHANCEMENT: Now hiding member action links on the Membership Account page for locked members. #15 (@dparker1005)
* ENHANCEMENT: If the lock page is not set, locked users will instead be redirected to the Membership Account page and an error message will be shown. #15 (@dparker1005)
* ENHANCEMENT: Updating `<h3>` tags to `<h2>` tags for better accessibility. #25 (@michaelbeil)
* BUG FIX/ENHANCEMENT: Updated localization and escaping of strings. #17, #19 (@JarrydLong, @femiyb)
* BUG FIX/ENHANCEMENT: Marking plugin as incompatible with Multiple Memberships Per User for the PMPro v3.0 update. #21 (@dparker1005)
* BUG FIX: Fixed a PHP warning on the plugins page when the user does not have specified capabilities. #22 (@JarrydLong)

= .3 - 2019-11-22 =
* BUG FIX: Fixed issue where dates could save incorrectly with WP 5.3+.

= .2 =
* BUG FIX: Incorrect text domain for translation
* BUG FIX: Partially complete default values for level settings
* BUG FIX: Locked members were able to unlock their profile through the Edit Profile page.
* BUG FIX: Fixed other bugs with the settings on the edit membership level page. (Thanks, Ted Barnett)
* SECURITY: Added sanitization of settings on the edit level and edit user/profile pages.

= .1.1 =
* BUG: Switched get_usermeta and update_usermeta calls to get_user_meta and update_user_meta.

= .1 =
* Initial version.