This early pre-release of s2Member & s2Member Pro, v161117-RC fixes several bugs, improves compatibility with sites using SSL, improves IP Address detection and compatibility with sites using CloudFlare, and improves the s2Member Pro Remote Operations API. If you would like to help us test, please review the instructions (and the changelog) below.
Download Release Candidate
- s2Member Framework v161117-RC — s2member-161117-RC.zip (i.e., the free version and framework required by s2Member Pro).
- s2Member Pro Add-On v161117-RC — s2member-pro-161117-RC.zip (must be logged into your s2Member.com account as a customer).
Installation Instructions (i.e., to test this early release)
On a test site, please follow the manual upgrade instructions provided by these articles:
- Manual Upgrade Instructions for s2Member Framework
- Manual Upgrade Instructions for s2Member Pro Add-On
Reporting Problems w/ this Release Candidate
Please report bugs and feedback on GitHub.
Unified Changelog for s2Member & s2Member Pro v161117-RC
(s2Member Pro) Bug Fix: Stripe refund notifications via the Stripe Webhook were always interpreted by s2Member as full refunds. This release corrects this bug so that s2Member will handle partial refunds via the Stripe API properly in all cases. Props @raamdev for reporting.
(s2Member/s2Member Pro) Bug Fix: Updating profile via
[s2Member-Profile /]when changing email addresses may leave the old email address on configured email list servers in some scenarios. Props @renzms for reporting. For further details see issue #1007.
(s2Member/s2Member Pro) Bug Fix: Username/password email being sent to users whenever Custom Passwords are enabled in your s2Member configuration and registration occurs via the default
wp-login.php?action=registerform. Fixed in this release. See also: issue #870 if you'd like additional details.
(s2Member/s2Member Pro) SSL Compatibility & Option Deprecation: In previous versions of s2Member there was a setting in the UI that allowed you to force non-SSL redirects to the Login Welcome Page. By popular demand, this setting has been deprecated and removed from the UI.
New Approach: The new approach taken in the latest release of s2Member is to automatically detect when a non-SSL redirection should occur, and when it should not occur (i.e., when the default WordPress core behavior should remain as-is).
s2Member does this by looking at the
FORCE_SSL_ADMINsettings in WordPress, and also at your configured
siteurloption in WordPress. If you are not forcing SSL logins, or your
https://(indicating that your entire site is served over SSL), non-SSL redirects will no longer be forced by s2Member, which resolves problems on many sites that serve their entire site over SSL (a growing trend over the past couple years).
FORCE_SSL_ADMINare true, and your configured
siteurloption in WordPress does NOT begin with
https://(e.g., just plain
http://), then a non-SSL redirect is forced, as necessary, in order to avoid login cookie conflicts; i.e., the old behavior is preserved by this automatic detection.
Overall, this new approach improves compatibility with WordPress core, particularly on sites that serve all of their pages over
https://(as recommended by Google).
Backward Compatibility: As noted previously, the old option that allowed you to configure s2Member to force non-SSL redirects to the Login Welcome Page has been officially deprecated and removed from the UI. However, the old option does still exist internally, but only for backward compatibility. A WordPress filter is exposed that allows developers to alter the old setting if necessary. You can use the filter to force a
<?php add_filter('ws_plugin__s2member_login_redirection_always_http', '__return_true'); // OR add_filter('ws_plugin__s2member_login_redirection_always_http', '__return_false');
(s2Member/s2Member Pro) IP Detection: This release improves s2Member's ability to determine the current user's IP address. s2Member now searches through
REMOTE_ADDR(in that order) to locate the first valid public IP address. Either IPv4 or IPv6. Among other things, this improves s2Member's compatibility with sites using CloudFlare. See also: issue #526 if you'd like additional details.
(s2Member Pro) JSON API: In the pro version it is now possible to use the s2Member Pro Remote Operations API to send and receive JSON input/output. This makes the Remote Operations API in s2Member compatible with a variety of scripting languages, not just PHP; i.e., prior to this release the Remote Operations API required that you always use PHP's
unserialize()functions when making API calls. The use of
unserialize()are no longer a requirement since input/output data is now sent and received in the more portable JSON format. For new code samples, please see: WordPress Dashboard → s2Member → API / Scripting → Pro API For Remote Operations. See also: issue #987 if you'd like additional details on this change.
Note: The old s2Member Pro Remote Operations API has been deprecated but will continue to function just like before (via
unserialize()) for the foreseeable future. Moving forward, we recommend the new JSON code samples. Again, you will find those under: WordPress Dashboard → s2Member → API / Scripting → Pro API For Remote Operations
(s2Member/s2Member Pro) Enforce data types when determining PHP constants. See this GitHub issue if you'd like further details.
(s2Member/s2Member Pro) Phing Build Routines: Starting with this release, developers working on the s2Member project are now able to perform builds of the software via the
websharks/phingsproject; i.e., the structure of the plugin directories has been changed (slightly) to conform to Phing and PSR4 standards. This makes it easier for our developers to prepare and release new versions of the software in the future.
Please note that when this version leaves beta and an official release is made, the WordPress Plugin Updater will automatically detect the new version on WordPress.org and ask you to upgrade. If you're using s2Member Pro, you will also be asked to complete an upgrade of the s2Member Pro Add-On right after you upgrade the s2Member Framework. For more information, please review Automatic Updates Through WordPress (Recommended).