strangerstudios / Pmpro Addon Packages

=== Paid Memberships Pro - Addon Packages === Contributors: strangerstudios Tags: pmpro, paid memberships pro, ecommerce Requires at least: 4 Tested up to: 5.5 Stable tag: 0.8

Allow PMPro members to purchase access to specific pages. This plugin is meant to be a temporary solution until support for multiple membership levels is added to PMPro.

== Description == You must have the latest version of Paid Memberships Pro installed (currently 1.8.5).

Story

• Admin designates a post as an "addon package".
• Sets a price for access to the post. (pmproap_price)
• Selects which membership levels can purchase the package. (pmproap_levels)
• For users without access, the page will show a link to purchase at the bottom of the page.
• Purchase goes to either a new checkout page or the PMPro checkout page with some parameters passed in.
• After checking out, they are taken to a new confirmation page or the PMPro confirmation page with extra info.
• After purchasing, the user ID is added to post meta (pmproap_users). The post ID is also added to user meta (pmproap_posts).

Limitations

• Only one time charges.
• No tax.
• No discount codes.

== Installation ==

1. Upload the pmpro-addon-packages directory to the /wp-content/plugins/ directory of your site.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Edit a post or page to set a price for it.

== Using the Addon Packages Shortcode == The [pmpro_addon_packages] shortcode allows you to display a "shop" like page of available addon packages (all pages and posts with a defined pmproap_price). Add the shortcode to a page with your desired attributes.

Shortcode attributes include:

• checkout_button: The text displayed on the button linking to checkout. (default: "Buy Now").
• exclude: A comma-separated list of the page IDs to exclude from display (default: none).
• include: Optionally set this attribute to only show subpages of the active page or to show a specific package or list of packages by post ID. Accepts: "subpages", "1", or "1,2,...". (default: shows all pages and posts with an addon package price).
• layout: The layout of the output. (default: table). Accepts "div", "table", "2col", "3col", "4col" (column-type layouts will work with the Memberlite Theme or any theme based on the Foundation 5 grid system).
• link: Hyperlink the post/page title to the single view; accepts “true” or “false” (default: true).
• orderby: Accepts any orderby parameter as defined in the codex. (default: menu_order).
• order: Accepts ASC or DESC as defined in the codex. (default: ASC).
• thumbnail: Optionally hide or show the subpage’s featured image; accepts “thumbnail”, “medium”, “large” or “false”. (default: thumbnail).
• view_button: The text displayed on the button linking to view the single page. (default: "View Now").

If the user has already purchased the addon package, they will see a link to "View". If the user has a valid membership for the addon package, they can purchase without modifying their membership level. If the current user does not have a membership level or is not logged in, they can click the "buy" button to purchase membership and the addon package in one step.

== Frequently Asked Questions ==

= I found a bug in the plugin. =

Please post it in the issues section of GitHub and we'll fix it as soon as we can. Thanks for helping. https://github.com/strangerstudios/pmpro-addon-packages/issues

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

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

Please Note: This plugin is meant as a temporary solution. Most updates and fixes will be reserved for when this functionality is built into Paid Memberships Pro. We may not fix the pmpro-addon-packages plugin itself unless it is critical.

== Changelog == = 0.8 =

• BUG FIX/ENHANCEMENT: Better handling of cases where an addon package post has been trashed, deleted, or set back to draft status.
• ENHANCEMENT: Ready for localization.

= .7.9 =

• BUG FIX: Now keeping addon packages ID in the redirect_to URL when clicking to log in from the checkout page.

= .7.8 =

• BUG FIX: Removed random include of the /adminpages/dashboard.php files which was causing a fatal error in PMPro v2.0, which removes that file.
• BUG FIX/ENHANCEMENT: Switched a !empty() with isset() in the code that saves the meta fields. This prevents the addon package price from being zero'd out if a post is updated via a function call or in some other way where the meta fields aren't present.

= .7.7 =

• ENHANCEMENT: You can now set the include attribute on the pmpro_addon_packages shortcode to a specific post ID or comma-separated list of post IDs to only include those packages in the table.

= .7.6 =

• BUG FIX: Fixed issue with link to addon package shown on invoice pages.

= .7.5 =

• BUG FIX: Using wp_get_current_user() now instead of get_currentuserinfo(). Fixes a warning.

= .7.4 =

• ENHANCEMENT: WordPress Coding Standards and Improved PHPDoc Blocs
• ENHANCEMENT: Added the pmproap_text_level_id filter to adjust the level chosen for the addon packages checkout links.

= .7.3 =

• BUG FIX: Fixed issue where using Quick Edit on a post would set the addon package price to 0.
• BUG FIX: Fixed issues with localization.
• BUG FIX/ENHANCEMENT: Added support for PayPal Standard. (Thanks, Ted Barnett)

= .7.2 =

• BUG: Fixed issue where users were having their expiration date set to Jan 1, 1970 if they checked out for an addon package while having a level with NO previous expiration date.

= .7.1 =

• BUG: No longer changing expiration if user already has the membership level.

= .7 =

• ENHANCEMENT/NOTE: No longer defaulting to a paid level if the user does not have a level. Instead users are directed to the levels page to choose a level.
• ENHANCEMENT: Added addon package to Orders CSV export.
• ENHANCEMENT: Added support for custom post types using the PMPro CPT plugin. (Thanks, dwilmer on GitHub)
• ENHANCEMENT: Added pmproap_supported_post_types filter to add your own post types to be included as potential addon packages.

= .6 =

• BUG: Avoiding some warnings when a post has an addon price but no required level. (We should show a warning to admins though that it doesn't work unless they set a required level.)
• ENHANCEMENT: Wrapped strings for translation. Added pmpro.pot/.po/.mo files.

= .5.1 =

• Updated to use the pmpro_formatPrice() function for addon package price display.
• Fixed bug with notices for non-members and not-logged in users.

= .5 =

• FEATURE: Added [pmpro_addon_packages] shortcode which can be used to show a list of all pages marked as addon packages. See the description section above for instructions on how to use.

= .4.5 =

• If no free level is available for an addon package, the checkout link will now default to the first required level when non-members view the page.

= .4.4 =

• Adding an order note like "Addon Package: Sample Page (#2)" when checking out for an addon package.

= .4.3 =

• Changes to pmproap_pmpro_text_filter() function to avoid warnings and also show a special message when all access levels are set. (Thanks, Merwan.)

= .4.2 =

• Added optional "expires in X days" global
• Fixed bug in pmpro_addon_packages shortcode.
• Supporting non-default wp-content directories. (Thanks, Adam-Moss on GitHub)

= .4.1 =

• Added pmproap_action_add_to_package and pmproap_action_remove_from_package hooks. (Thanks, DanHarrison)

= .4 =

• Added shortcode to show addon packages.
• Fixed confirmation URL to properly add the ap parameter. The "continue on to ..." link now appears in the membership confirmation. (Thanks, jons7)

= .3 =

• Updating text a bit for cases where you are checking out for a level you already have to purchase a package.

= .2 =

• Wrapped some functions in if(!function_exists("...")) for PMPro 1.7.5 support.

= .1.3 =

• The pmproap_profile_fields function can now take either a user_id or user object. This will fix some bugs.
• Using the pmpro_paypal_express_return_url_parameters filter to add the 'ap' param to the PayPal Express return URL to make this plugin more compatible with PayPal Express.

= .1.2 =

• Added the pmproap_all_access_levels filter to allow developers to designate certain levels as "all access levels", which will have access to all addon packages without being charged. Some code to use this: https://gist.github.com/3845777
• Added purchased packages to the edit user/profile page with the ability to add/remove packages.

= .1.1 =

• Changed what text is shown when a page is locked.
• If you don't have a required level, when viewing a locked page, the checkout link will choose a free membership level to switch to if one is available.

= .1 =

• Initial release.