' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_before_left_sections", get_defined_vars ()); if (apply_filters("ws_plugin__s2member_during_scripting_page_during_left_sections_display_api_easy_way", true, get_defined_vars ())) { do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_before_api_easy_way", get_defined_vars ()); echo '

' . "\n"; echo '

The Extremely Easy Way (no scripting required)

' . "\n"; echo '

From your s2Member Restriction Options panel, you may restrict access to certain Posts, Pages, Tags, Categories, and/or URIs based on a Member\'s Level. The s2Member Restriction Options panel makes it easy for you. All you do is type in the basics of what you want to restrict access to, and those sections of your site will be off limits to non-Members. That being said, there are times when you might need to have greater control over which portions of your site can be viewed by non-Members, or Members at different Levels; with different Capabilities. This is where API Scripting with Conditionals comes in.

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_api_easy_way", get_defined_vars ()); echo '

' . "\n"; echo '

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_after_api_easy_way", get_defined_vars ()); } if (apply_filters("ws_plugin__s2member_during_scripting_page_during_left_sections_display_api_simple_way", true, get_defined_vars ())) { do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_before_api_simple_way", get_defined_vars ()); if (is_multisite () && c_ws_plugin__s2member_utils_conds::is_multisite_farm () && !is_main_site ()) { echo '

' . "\n"; echo '

Simple Conditionals (via WordPress Shortcodes)

' . "\n"; echo '

In an effort to give you even more control over access restrictions, s2Member makes Simple Conditionals available to you from within WordPress, using Shortcodes that are fully compatible with both the Visual Editor, and also the HTML Tab in WordPress. In this section, we\'ll demonstrate several functions that are possible using Shortcodes: is_user_logged_in(), is_user_not_logged_in(), user_is(user_id, role), user_is_not(user_id, role), user_can(user_id, capability), user_cannot(user_id, capability), current_user_is(role), current_user_is_not(role), current_user_can(capability), current_user_cannot(capability). To make use of these functions, please follow our code samples below. Using Shortcodes, it\'s easy to build Simple Conditionals within your content; based on a Member\'s Level, or even based on Custom Capabilities. s2Member\'s Shortcodes can be used inside a Post/Page, and also inside Text Widgets.

' . "\n"; echo '

There are two different Shortcodes being demonstrated here:
1. s2If (for testing simple conditional expressions).
2. s2Get (to get an API Constant value, a Custom Field, or meta key).

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_api_simple_way_farm", get_defined_vars ()); echo '' . "\n"; echo '

Example #1: Full access for anyone that is logged in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-is-user-logged-in-farm.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #2: The same as example #1, but this uses [else] syntax.

' . "\n"; if(!c_ws_plugin__s2member_utils_conds::pro_is_installed()) echo '

NOTE: the use of [else] requires s2Member Pro.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-is-user-logged-in-else-farm.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #3: Full access for any Member with a Level >= 1; also using [else] syntax.

' . "\n"; if(!c_ws_plugin__s2member_utils_conds::pro_is_installed()) echo '

NOTE: the use of [else] requires s2Member Pro.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-current-user-can-full-access-farm.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #4: Specific content for each different Member Level.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-current-user-is-specific-content-farm.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #5: The same as example #4, but this uses [else] syntax & nesting.

' . "\n"; if(!c_ws_plugin__s2member_utils_conds::pro_is_installed()) echo '

NOTE: the use of [else] requires s2Member Pro.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-current-user-is-specific-content-else-farm.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #6: Simple Conditionals w/ integrated use of [s2Get /].

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-s2-conditional-supplements-1-farm.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #7: Using multiple Conditionals together; also nesting other Shortcodes.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-s2-conditional-supplements-2-farm.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #8: Using multiple Conditionals together; also nesting Conditionals.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-s2-conditional-supplements-3-farm.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Membership Levels provide incremental access:

' . "\n"; echo '

* A Member with Level 4 access, will also be able to access Levels 0, 1, 2 & 3.
* A Member with Level 3 access, will also be able to access Levels 0, 1 & 2.
* A Member with Level 2 access, will also be able to access Levels 0 & 1.
* A Member with Level 1 access, will also be able to access Level 0.
* A Subscriber with Level 0 access, will ONLY be able to access Level 0.
* A public Visitor will have NO access to protected content.

' . "\n"; echo '

* WordPress Subscribers are at Membership Level 0. If you\'re allowing Open Registration, Subscribers will be at Level 0 (a Free Subscriber). WordPress Administrators, Editors, Authors, and Contributors have Level 4 access, with respect to s2Member. All of their other Roles/Capabilities are left untouched.

' . "\n"; echo '' . "\n"; echo '

s2Member supports many Conditional Tags in WordPress. Including: is_user_logged_in(), is_user_not_logged_in(), user_is(user_id, role), user_is_not(user_id, role), user_can(user_id, capability), user_cannot(user_id, capability), current_user_is(role), current_user_is_not(role), current_user_can(capability), current_user_cannot(capability), is_admin(), is_blog_admin(), is_user_admin(), is_network_admin(), is_404(), is_home(), is_front_page(), is_singular(ID|slug|{slug,ID})", is_single(ID|slug|{slug,ID}), is_page(ID|slug|{slug,ID}), is_page_template(file.php), is_attachment(), is_feed(), is_archive(), is_search(), is_category(ID|slug|{slug,ID}), is_tax(taxonomy,term), is_tag(slug|{slug,slug})", has_tag(slug|{slug,slug})", is_author(ID|slug|{slug,ID}), is_date(), is_day(), is_month(), is_time(), is_year(), is_sticky(ID), is_paged(), is_preview(), is_comments_popup(), in_the_loop(), comments_open(), pings_open(), has_excerpt(ID), has_post_thumbnail(ID).

' . "\n"; echo '

Passing arguments into a Simple Conditional:

' . "\n"; echo '

1. True/false → ex: current_user_can() / !current_user_can()
2. False explicitly → ex: current_user_cannot()
3. Passing an ID → ex: is_page(24)
4. Passing a Slug → ex: is_page(my-cool-page)
5. Passing an Array → ex: is_page({my-cool-page,24,about,contact-form})

' . "\n"; echo '

*Tip: do NOT use spaces inside Conditionals.
BAD is_page(My Membership Options Page)
- use slugs or IDs instead, no spaces.

' . "\n"; echo '

Implementing AND/OR Conditional expressions:

' . "\n"; echo '

*Tip: do NOT mix AND/OR expressions.
BAD is_user_logged_in() AND is_page(1) OR is_page(2)
- use one or the other; do NOT mix AND/OR together.

' . "\n"; echo '

If you need to have both types of logic, use nesting...

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-s2-conditional-nesting-farm.x-php")) . '

' . "\n"; echo '

Another example, if you use [else] when nesting...

' . "\n"; if(!c_ws_plugin__s2member_utils_conds::pro_is_installed()) echo '

NOTE: the use of [else] requires s2Member Pro.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-s2-conditional-nesting-else-farm.x-php")) . '

' . "\n"; echo '

' . "\n"; } else // Otherwise, we can display the standardized version of this information. { echo '

' . "\n"; echo '

Simple Conditionals (via WordPress Shortcodes)

' . "\n"; echo '

In an effort to give you even more control over access restrictions, s2Member makes Simple Conditionals available to you from within WordPress, using Shortcodes that are fully compatible with both the Visual Editor, and also the HTML Tab in WordPress. In this section, we\'ll demonstrate several functions that are possible using Shortcodes: is_user_logged_in(), is_user_not_logged_in(), user_is(user_id, role), user_is_not(user_id, role), user_can(user_id, capability), user_cannot(user_id, capability), current_user_is(role), current_user_is_not(role), current_user_can(capability), current_user_cannot(capability), current_user_is_for_blog(blog_id,role), current_user_is_not_for_blog(blog_id,role), current_user_can_for_blog(blog_id,capability), current_user_cannot_for_blog(blog_id,capability). To make use of these functions, please follow our code samples below. Using Shortcodes, it\'s easy to build Simple Conditionals within your content; based on a Member\'s Level, or even based on Custom Capabilities. s2Member\'s Shortcodes can be used inside a Post/Page, and also inside Text Widgets.

' . "\n"; echo '

There are two different Shortcodes being demonstrated here:
1. s2If (for testing simple conditional expressions).
2. s2Get (to get an API Constant value, a Custom Field, or meta key).

' . "\n"; echo '

Please see this KB article to learn more: s2Member Simple Shortcode Conditionals

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_api_simple_way", get_defined_vars ()); echo '' . "\n"; echo '

' . "\n"; echo '' . "\n"; echo '

Example #1: Full access for anyone that is logged in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-is-user-logged-in.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #2: The same as example #1, but this uses [else] syntax.

' . "\n"; if(!c_ws_plugin__s2member_utils_conds::pro_is_installed()) echo '

NOTE: the use of [else] requires s2Member Pro.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-is-user-logged-in-else.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #3: Full access for any Member with a Level >= 1; also using [else] syntax.

' . "\n"; if(!c_ws_plugin__s2member_utils_conds::pro_is_installed()) echo '

NOTE: the use of [else] requires s2Member Pro.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-current-user-can-full-access.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #4: Specific content for each different Member Level.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-current-user-is-specific-content.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #5: The same as example #4, but this uses [else] syntax & nesting.

' . "\n"; if(!c_ws_plugin__s2member_utils_conds::pro_is_installed()) echo '

NOTE: the use of [else] requires s2Member Pro.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-current-user-is-specific-content-else.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #6: Simple Conditionals w/ integrated use of [s2Get /].

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-s2-conditional-supplements-1.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #7: Using multiple Conditionals together; also nesting other Shortcodes.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-s2-conditional-supplements-2.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #8: Using multiple Conditionals together; also nesting Conditionals.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-s2-conditional-supplements-3.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Membership Levels provide incremental access:

' . "\n"; echo '

' . "\n"; echo '' . "\n"; echo '

s2Member supports ALL Conditional Tags in WordPress. Including, but not limited to: is_user_logged_in(), is_user_not_logged_in(), user_is(user_id, role), user_is_not(user_id, role), user_can(user_id, capability), user_cannot(user_id, capability), current_user_is(role), current_user_is_not(role), current_user_can(capability), current_user_cannot(capability), current_user_is_for_blog(blog_id,role), current_user_is_not_for_blog(blog_id,role), current_user_can_for_blog(blog_id,capability), current_user_cannot_for_blog(blog_id,capability), is_multisite(), is_main_site(), is_super_admin(), is_admin(), is_blog_admin(), is_user_admin(), is_network_admin(), is_404(), is_home(), is_front_page(), is_comments_popup(), is_singular(ID|slug|{slug,ID})", is_single(ID|slug|{slug,ID}), is_page(ID|slug|{slug,ID}), is_page_template(file.php), is_attachment(), is_feed(), is_trackback(), is_archive(), is_search(), is_category(ID|slug|{slug,ID}), is_tax(taxonomy,term), is_tag(slug|{slug,slug})", has_tag(slug|{slug,slug})", is_author(ID|slug|{slug,ID}), is_date(), is_day(), is_month(), is_time(), is_year(), is_sticky(ID), is_paged(), is_preview(), is_comments_popup(), in_the_loop(), comments_open(), pings_open(), has_excerpt(ID), has_post_thumbnail(ID), is_active_sidebar(ID|number).

' . "\n"; echo '

Passing arguments into a Simple Conditional:

' . "\n"; echo '

*Tip: do NOT use spaces inside Conditionals.
BAD is_page(My Membership Options Page)
- use slugs or IDs instead, no spaces.

' . "\n"; echo '

Implementing AND/OR Conditional expressions:

' . "\n"; echo '

*Tip: do NOT mix AND/OR expressions.
BAD is_user_logged_in() AND is_page(1) OR is_page(2)
- use one or the other; do NOT mix AND/OR together.

' . "\n"; echo '

If you need to have both types of logic, use nesting...

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-s2-conditional-nesting.x-php")) . '

' . "\n"; echo '

Another example, if you use [else] when nesting...

' . "\n"; if(!c_ws_plugin__s2member_utils_conds::pro_is_installed()) echo '

NOTE: the use of [else] requires s2Member Pro.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/sc-s2-conditional-nesting-else.x-php")) . '

' . "\n"; echo '

' . "\n"; } do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_after_api_simple_way", get_defined_vars ()); } if (apply_filters("ws_plugin__s2member_during_scripting_page_during_left_sections_display_api_advanced_way", (!is_multisite () || !c_ws_plugin__s2member_utils_conds::is_multisite_farm () || is_main_site ()), get_defined_vars ())) { do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_before_api_advanced_way", get_defined_vars ()); echo '

' . "\n"; echo '

The Advanced Way (some PHP scripting required)

' . "\n"; echo '

In an effort to give you even more control over access restrictions, s2Member makes some PHP functions, and also some PHP Constants, available to you from within WordPress. In this section, we\'ll demonstrate several functions: is_user_logged_in(), is_user_not_logged_in(), user_is(user_id, role), user_is_not(user_id, role), user_can(user_id, capability), user_cannot(user_id, capability), current_user_is("role"), current_user_is_not("role"), current_user_can("capability"), current_user_cannot("capability"), current_user_is_for_blog($blog_id,"role"), current_user_is_not_for_blog($blog_id,"role"), current_user_can_for_blog($blog_id,"capability"), & current_user_cannot_for_blog($blog_id,"capability"). To make use of these functions, please follow our PHP code samples below. Using PHP, is a very powerful way to build Advanced Conditionals within your content; based on a Member\'s Level, Custom Capabilities, and/or other factors. In order to use PHP scripting inside your Posts/Pages, you\'ll need to install this handy plugin (ezPHP).

' . "\n"; echo '

See also this related KB article: s2Member Simple Shortcode Conditionals

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_api_advanced_way", get_defined_vars ()); echo '' . "\n"; echo '

' . "\n"; echo '' . "\n"; echo '

Example #1: Full access for anyone that is logged in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/is-user-logged-in.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #2: Full access for any Member with a Level >= 1.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-can-full-access.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #3: Specific content for each different Member Level.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-is-specific-content.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #4: Using s2Member API Conditionals, supplementing WordPress core functions.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/s2-conditional-supplements-1.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #5: Using s2Member API Conditionals, supplementing WordPress core functions.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/s2-conditional-supplements-2.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #6: Using multiple Conditionals together, and even nesting Conditionals.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/s2-conditional-supplements-3.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #7: Using s2Member API Constants, instead of conditional functions.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-can-constants-1.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #8: Using s2Member API Constants, instead of conditional functions.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-can-constants-2.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Membership Levels provide incremental access:

' . "\n"; echo '

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_after_api_advanced_way", get_defined_vars ()); } if (apply_filters("ws_plugin__s2member_during_scripting_page_during_left_sections_display_api_queries", (!is_multisite () || !c_ws_plugin__s2member_utils_conds::is_multisite_farm () || is_main_site ()), get_defined_vars ())) { do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_before_api_queries", get_defined_vars ()); echo '

' . "\n"; echo '

Advanced Query Conditionals (some PHP scripting required)

' . "\n"; echo '

s2Member provides several built-in API Functions that are tailored to meet the needs of developers integrating s2Member into their themes. Such as: is_protected_by_s2member($id, "[category,tag,post,page,singular,uri]"), is_permitted_by_s2member($id, "[category,tag,post,page,singular,uri]"), is_category_protected_by_s2member($cat_id), is_category_permitted_by_s2member($cat_id), is_tag_protected_by_s2member($tag_id [slug or tag name]), is_tag_permitted_by_s2member($tag_id [slug or tag name]), is_post_protected_by_s2member($post_id), is_post_permitted_by_s2member($post_id), is_page_protected_by_s2member($page_id), is_page_permitted_by_s2member($page_id), is_uri_protected_by_s2member($uri [or full url]), is_uri_permitted_by_s2member($uri [ or full url]).

' . "\n"; echo '

In addition, there are two special functions that can be applied by theme authors before making custom queries: attach_s2member_query_filters(), detach_s2member_query_filters(). These can be used before and after a call to query_posts() for example. s2Member will automatically filter all protected content (not available to the current User/Member).

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_api_queries", get_defined_vars ()); echo '' . "\n"; echo '

' . "\n"; echo '' . "\n"; echo '

Example #1: Pre-filtering custom queries in WordPress.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/custom-queries.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #2: OR, instead of pre-filtering; check Access Restrictions in The Loop.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/custom-queries-loop.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #3: Checking Tag Restrictions.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/specific-tag-restrictions.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #4: Checking Category Restrictions.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/specific-category-restrictions.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #5: Checking Page Restrictions.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/specific-page-restrictions.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Example #6: Checking Post Restrictions, including Custom Post Types.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/specific-post-restrictions.x-php")) . '

' . "\n"; echo '

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_after_api_queries", get_defined_vars ()); } if (apply_filters("ws_plugin__s2member_during_scripting_page_during_left_sections_display_custom_capabilities", (!is_multisite () || !c_ws_plugin__s2member_utils_conds::is_multisite_farm () || is_main_site ()), get_defined_vars ())) { do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_before_custom_capabilities", get_defined_vars ()); echo '

' . "\n"; echo '

Packaging Together Custom Capabilities w/ Membership

' . "\n"; echo '' . "\n"; echo '

Using one of s2Member\'s Payment Button and/or Form Generators, you can add Custom Capabilities in comma-delimited format. s2Member builds upon existing functionality offered by WordPress Roles/Capabilities. s2Member supports Free Subscribers (at Level #0), and several Primary Roles created by the s2Member plugin (i.e., s2Member Levels 1-4, or up to the number of configured Levels). Each s2Member Level (aka: s2Member Role) provides the Capability current_user_can("access_s2member_level0"), 1, 2, 3, 4, where access_s2member_level[0-4] is the Capability associated with each Role; and Membership Levels provide incremental access (i.e., Level #4 Members can also access content at Levels 0, 1, 2, and 3 beneath them). In short, these Level-based permissions are the default Capabilities that come with each Membership Level being sold on your site.

' . "\n"; echo '

Now, if you\'d like to package together some variations of each Membership Level that you\'re selling, you can! All you do is add Custom Capabilities whenever you create your Payment Button and/or Form Shortcode (there is a field in the Button & Form Generators where you can enter Custom Capabilities). You can sell Membership Packages that come with Custom Capabilities, and even with custom prices.

' . "\n"; echo '

Custom Capabilities are an extension to a feature that already exists in WordPress. The current_user_can() function, can be used to test for these additional Capabilities that you allow. Whenever a Member completes the checkout process, after having purchased a Membership from you (one that included Custom Capabilities), s2Member will add those Custom Capabilities to the account for that specific Member.

' . "\n"; echo '

Custom Capabilities are always prepended with access_s2member_ccap_. You fill in the last part, with ONLY lowercase alpha-numerics and/or underscores. For example, let\'s say you want to sell Membership Level #1, as is. But, you also want to sell a slight variation of Membership Level #1, that includes the ability to access the Music & Video sections of your site. So, instead of selling this additional access under a whole new Membership Level, you could just sell a modified version of Membership Level #1. Add the the Custom Capabilities: music,videos. Once a Member has these Capabilities, you can test for these Capabilities using current_user_can("access_s2member_ccap_music") and current_user_can("access_s2member_ccap_videos").

' . "\n"; echo '

The important thing to realize, is that Custom Capabilities, are just that. They\'re custom. s2Member only deals with the default Capabilities that it uses. If you start using Custom Capabilities, you MUST use Simple or Advanced Conditionals (i.e., current_user_can() logic) to test for them. Either in your theme files with PHP, or in Posts/Pages using Simple Conditionals (powered by Shortcodes).

' . "\n"; echo '' . "\n"; echo '

See also: This KB article: s2Member Roles/Capabilities (Including bbPress Support).

'."\n"; echo '

See also: This VIDEO tutorial: Using Custom Capabilities with s2Member (by Lead Developer Jason Caldwell).

'."\n"; echo '' . "\n"; echo '

New: In the latest versions of s2Member, you can automatically require certain Custom Capabilities on a per Post/Page basis. So now, s2Member (if you prefer) CAN handle Custom Capabilities for you automatically! Whenever you edit a Post/Page (i.e., there is a Meta Box for s2Member in your Post/Page editing station)... you can tell s2Member to require certain Custom Capabilities that you type in, using comma-delimited format. In other words, you will need to type in some of the trigger words that you used whenever you created your Payment Buttons/Forms. This way paying Members will have the Custom Capabilities to view different kinds of content that you offer.

' . "\n"; echo '

New: By default, a Checkout Button or Form generated by s2Member is designed to (Add) Custom Capabilities to any that may or may not already exist for a particular User/Member. However, starting with s2Member v110815+, you can tell s2Member to (Remove All) Custom Capabilities, and then (Add) only the new ones that you specify. This is accomplished on a per Form/Button basis by preceding your comma-delimited list of Custom Capabilities with `-all`. For further details on this topic, click the [?] icon next to the Custom Capabilities field in any Button/Form Generator supplied by s2Member.

' . "\n"; echo '

New: Independent Custom Capabilities. You can now sell one or more Custom Capabilities using Buy Now functionality, to "existing" Users/Members, regardless of which Membership Level they have on your site (i.e., you could even sell Independent Custom Capabilities to Users at Membership Level #0, normally referred to as Free Subscribers, if you like). So this is quite flexible. For further details, please check your Dashboard, under: s2Member → PayPal Buttons → Capability (Buy Now) Buttons.

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_custom_capabilities", get_defined_vars ()); echo '' . "\n"; echo '

TIP: In addition to this documentation, you may also want to have a look at the s2Member Codex.
' . "\n"; echo 'See Also: s2Member Codex → API Constants, and s2Member Codex → API Functions.
' . "\n"; echo 'See Also: Plugins → Enhanced Capability Manager (may come in handy for some).

' . "\n"; echo '' . "\n"; echo '

Custom Capabilities: (music,videos):

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-can-ccaps-1.x-php")) . '

' . "\n"; echo '

Custom Capabilities: (ebooks,reports,tips):

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-can-ccaps-2.x-php")) . '

' . "\n"; echo '

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_after_custom_capabilities", get_defined_vars ()); } if (apply_filters("ws_plugin__s2member_during_scripting_page_during_left_sections_display_custom_capability_files", (!is_multisite () || !c_ws_plugin__s2member_utils_conds::is_multisite_farm () || is_main_site ()), get_defined_vars ())) { do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_before_custom_capability_files", get_defined_vars ()); echo '

' . "\n"; echo '

Restricting Files, Based On Custom Capabilities

' . "\n"; echo '

If you\'re NOT familiar with Custom Capabilities yet, please read the section above, titled: Custom Capability Packages, and also see: s2Member → Download Options, both as primers; BEFORE you read this section. Once you understand the basic concept of Custom Capabilities & Protected File Downloads, you\'ll see that (by default) s2Member does NOT handle File Download Protection with respect to Custom Capabilities. That\'s where Custom Capability Sub-directories come in.

' . "\n"; echo '

You can create Custom Capability Sub-directories under: ' . esc_html (c_ws_plugin__s2member_utils_dirs::doc_root_path ($GLOBALS["WS_PLUGIN__"]["s2member"]["c"]["files_dir"])) . '. For instance, if you have a Custom Capability music, you can place protected files that should ONLY be accessible to Members with access_s2member_ccap_music, inside: /' . esc_html (c_ws_plugin__s2member_utils_dirs::basename_dir_app_data ($GLOBALS["WS_PLUGIN__"]["s2member"]["c"]["files_dir"])) . '/access-s2member-ccap-music/. Some examples are provided below.

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_custom_capability_files", get_defined_vars ()); echo '' . "\n"; echo '

' . "\n"; echo '' . "\n"; echo '

Custom Capabilities: (music,videos)

' . "\n"; echo '

Now, here are some link examples, using Custom Capability Sub-directories:

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/ccap-file-downloads.x-php")) . '

' . "\n"; echo '

These links will ONLY work for Members who are logged-in, with the proper Capabilities.

' . "\n"; echo '' . "\n"; echo '

Membership Levels: (this also works fine)

' . "\n"; echo '

Sub-Directory: /' . esc_html (c_ws_plugin__s2member_utils_dirs::basename_dir_app_data ($GLOBALS["WS_PLUGIN__"]["s2member"]["c"]["files_dir"])) . '/access-s2member-level0
Sub-Directory: /' . esc_html (c_ws_plugin__s2member_utils_dirs::basename_dir_app_data ($GLOBALS["WS_PLUGIN__"]["s2member"]["c"]["files_dir"])) . '/access-s2member-level1
Sub-Directory: /' . esc_html (c_ws_plugin__s2member_utils_dirs::basename_dir_app_data ($GLOBALS["WS_PLUGIN__"]["s2member"]["c"]["files_dir"])) . '/access-s2member-level2
Sub-Directory: /' . esc_html (c_ws_plugin__s2member_utils_dirs::basename_dir_app_data ($GLOBALS["WS_PLUGIN__"]["s2member"]["c"]["files_dir"])) . '/access-s2member-level3
Sub-Directory: /' . esc_html (c_ws_plugin__s2member_utils_dirs::basename_dir_app_data ($GLOBALS["WS_PLUGIN__"]["s2member"]["c"]["files_dir"])) . '/access-s2member-level4

' . "\n"; echo '

Protected File: /' . esc_html (c_ws_plugin__s2member_utils_dirs::basename_dir_app_data ($GLOBALS["WS_PLUGIN__"]["s2member"]["c"]["files_dir"])) . '/access-s2member-level0/tiger.doc
Protected File: /' . esc_html (c_ws_plugin__s2member_utils_dirs::basename_dir_app_data ($GLOBALS["WS_PLUGIN__"]["s2member"]["c"]["files_dir"])) . '/access-s2member-level1/zebra.pdf
Protected File: /' . esc_html (c_ws_plugin__s2member_utils_dirs::basename_dir_app_data ($GLOBALS["WS_PLUGIN__"]["s2member"]["c"]["files_dir"])) . '/access-s2member-level2/elephant.doc
Protected File: /' . esc_html (c_ws_plugin__s2member_utils_dirs::basename_dir_app_data ($GLOBALS["WS_PLUGIN__"]["s2member"]["c"]["files_dir"])) . '/access-s2member-level3/rhino.pdf
Protected File: /' . esc_html (c_ws_plugin__s2member_utils_dirs::basename_dir_app_data ($GLOBALS["WS_PLUGIN__"]["s2member"]["c"]["files_dir"])) . '/access-s2member-level4/lion.doc

' . "\n"; echo '

Now, here are some link examples, using Member Level Sub-directories:

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/level-file-downloads.x-php")) . '

' . "\n"; echo '

These links will ONLY work for Members who are logged-in, with an adequate Membership Level.

' . "\n"; echo '

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_after_custom_capability_files", get_defined_vars ()); } if (apply_filters("ws_plugin__s2member_during_scripting_page_during_left_sections_display_api_advanced_dripping", (!is_multisite () || !c_ws_plugin__s2member_utils_conds::is_multisite_farm () || is_main_site ()), get_defined_vars ())) { do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_before_api_advanced_dripping", get_defined_vars ()); echo '

' . "\n"; echo '

Dripping Content (some PHP scripting may be required)

' . "\n"; echo '

Content Dripping is the gradual, pre-scheduled release of premium website content to paying Members. This has become increasingly popular, because it allows older Members; those who have paid you more, due to recurring charges; to acquire access to more content progressively; based on their original paid registration time. It also gives you (as the site owner), the ability to launch multiple membership site portals, operating on autopilot, without any direct day-to-day involvement in a content release process. The [s2Drip] shortcode is the easiest way to drip content. The other methods (shown below) require some PHP scripting. In order to use PHP scripting inside your Posts/Pages, you\'ll need to install this handy plugin (ezPHP).

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_api_advanced_dripping", get_defined_vars ()); echo '' . "\n"; echo '

' . "\n"; echo '' . "\n"; echo '

A very simple way to drip content; via the [s2Drip] Shortcode:

' . "\n"; if(!c_ws_plugin__s2member_utils_conds::pro_is_installed()) echo '

NOTE: the use of [s2Drip] requires s2Member Pro.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/s2drip-example1.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

To drip content using S2MEMBER_CURRENT_USER_PAID_REGISTRATION_DAYS:

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-paid-registration-days-dripping.x-php")) . '

' . "\n"; echo '

There are more examples on this page, under the sub-section "s2Member PHP/API Constants". You\'ll see that s2Member provides you with access to several PHP/API Constants, which will assist you in dripping content. Some of the most relevant API Constants include: S2MEMBER_CURRENT_USER_PAID_REGISTRATION_TIME, S2MEMBER_CURRENT_USER_PAID_REGISTRATION_DAYS, S2MEMBER_CURRENT_USER_REGISTRATION_TIME, S2MEMBER_CURRENT_USER_REGISTRATION_DAYS; and there are many others.

' . "\n"; echo '' . "\n"; echo '

Very Advanced Content Dripping (some PHP required)

' . "\n"; echo '

If you plan on dripping content in VERY advanced ways, you can tap into s2Member\'s recorded history of all Paid Registration Times. (i.e., ' . esc_html ('') . ') will give you a timestamp at which a Member first paid for Level#1 access. If they\'ve never paid for Level#1 access, the function will return 0. s2Member keeps a recorded history of timestamps associated with each Level that a Member gains access to, throughout the lifetime of their account.

' . "\n"; echo '

Here is the function documentation for PHP/WordPress developers:

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/s2member-paid-registration-time.x-php")) . '

' . "\n"; echo '

Here are some actual examples that should give you some ideas:

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/s2member-paid-registration-time-examples.x-php")) . '

' . "\n"; echo '

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_after_api_advanced_dripping", get_defined_vars ()); } if (apply_filters("ws_plugin__s2member_during_scripting_page_during_left_sections_display_api_constants", true, get_defined_vars ())) { do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_before_api_constants", get_defined_vars ()); if (is_multisite () && c_ws_plugin__s2member_utils_conds::is_multisite_farm () && !is_main_site ()) { echo '

' . "\n"; echo '

Using s2Get w/ s2Member API Constants

' . "\n"; echo '

A Constant, is an identifier (a name) for a simple value. Below is a comprehensive list that includes all of the defined Constants available to you. We recommend using some of these Constants in the creation of your Login Welcome Page; which is described in the s2Member General Options Panel. These are NOT required, but you can get pretty creative with your Login Welcome Page if you know how to use the [s2Get constant="" /] Shortcode for WordPress.

' . "\n"; echo '

For example, you might use [s2Get constant="S2MEMBER_CURRENT_USER_ACCESS_LABEL" /] to display the type of Membership a Customer has.

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_api_constants_farm", get_defined_vars ()); echo '' . "\n"; echo '

S2MEMBER_VERSION
This will always be a (string) with the current s2Member version. Available since s2Member 3.0. Dated versions began with s2Member v110604.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_LOGIN_COUNTER
This will always be (int) -1 or higher (representing the number of times a User/Member has logged into your site). -1 if no User is logged in. 0 if the current User has NEVER logged in.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_IS_LOGGED_IN
This will always be (bool) true or false. True if a User/Member is currently logged in with an Access Level >= 0.

' . "\n"; echo '

See: S2MEMBER_CURRENT_USER_ACCESS_LEVEL below for a full explanation.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_IS_LOGGED_IN_AS_MEMBER
This will always be (bool) true or false. True if a Member is currently logged in with an Access Level >= 1.

' . "\n"; echo '

See: S2MEMBER_CURRENT_USER_ACCESS_LEVEL below for a full explanation.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_ACCESS_LEVEL
This will always be (int) -1 thru 4 (or, up to the total number Membership Levels you\'ve configured). -1 if not logged in. 0 if logged in as a Free Subscriber.

' . "\n"; echo '

Membership Levels provide incremental access:

' . "\n"; echo '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_ACCESS_LABEL
This will always be a (string) containing the Membership Label associated with the current User\'s account. Empty if not logged in.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_SUBSCR_ID
This will always be a (string) containing the current User\'s Paid Subscr. ID. If they\'ve NOT paid yet, this will be an empty string. Also empty if not logged in.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_SUBSCR_OR_WP_ID
This will always be a (string) containing the current User\'s Paid Subscr. ID. If they\'ve NOT paid yet, this will be their WordPress User ID#. Empty if not logged in.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_SUBSCR_GATEWAY
This will always be a (string) containing the current User\'s Paid Subscr. Gateway. If they\'ve NOT paid yet, this will be empty. Empty if not logged in.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_CUSTOM
This will always be a (string) containing the current User\'s Custom String; associated with their s2Member Profile. Empty if not logged in.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_REGISTRATION_TIME
This will always be an (int); in the form of a Unix timestamp. 0 if not logged in. This holds the recorded time at which the User originally registered their Username for access to your site; for free or otherwise. * Note: this is NOT the same as S2MEMBER_CURRENT_USER_PAID_REGISTRATION_TIME, which could be used as an alternative, depending on your intended usage.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_PAID_REGISTRATION_TIME
This will always be an (int); in the form of a Unix timestamp. However, this will be 0 if they\'re not logged in; or if they\'ve never paid you at all (i.e., if they\'re still a Free Subscriber). This holds the recorded time at which the Member originally registered their Username (or upgraded for) any type of "paid" access to your site. This value is preserved for the lifetime of their account, even if they upgrade, and even if they\'re demoted at some point. Once this value is recorded, it never changes under any circumstance. * Note: this is NOT the same as S2MEMBER_CURRENT_USER_REGISTRATION_TIME, which could be used as an alternative, depending on your intended usage.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_PAID_REGISTRATION_DAYS
This will always be an (int), representing the number of days that have passed. However, this will be 0 if they\'re not logged in; or if they\'ve never paid you at all (i.e., if they\'re still a Free Subscriber). This is the number of days that have passed since the Member originally registered their Username (or upgraded for) any type of "paid" access to your site. The underlying timestamp behind this value is preserved for the lifetime of their account, even if they upgrade, and even if they\'re demoted at some point. Once the underlying timestamp behind this value is recorded, it never changes under any circumstance. * Note: this is NOT the same as S2MEMBER_CURRENT_USER_REGISTRATION_DAYS, which could be used as an alternative, depending on your intended usage.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_REGISTRATION_DAYS
This will always be an (int). 0 if not logged in. This is the number of days that have passed since the User originally registered their Username for access to your site; for free or otherwise. * Note: this is NOT the same as S2MEMBER_CURRENT_USER_PAID_REGISTRATION_DAYS, which could be used as an alternative, depending on your intended usage.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_DISPLAY_NAME
This will always be a (string) containing the current User\'s Display Name. Empty if not logged in.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_FIRST_NAME
This will always be a (string) containing the current User\'s First Name. Empty if not logged in.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_LAST_NAME
This will always be a (string) containing the current User\'s Last Name. Empty if not logged in.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_LOGIN
This will always be a (string) containing the current User\'s Username. Empty if not logged in.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_EMAIL
This will always be a (string) containing the current User\'s Email Address. Empty if not logged in.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_IP
This will always be a (string) containing the current User\'s IP Address, even when/if NOT logged-in. Taken from $_SERVER["REMOTE_ADDR"]. Empty if browsing anonymously.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_REGISTRATION_IP
This is a (string) containing the IP Address the current User had at the time they registered. Taken from $_SERVER["REMOTE_ADDR"]. Empty if not logged in.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_ID
This will always be an (int) containing the current User\'s ID# in WordPress. However, it will be 0 if not logged in.

' . "\n"; echo '' . "\n"; #echo '

S2MEMBER_CURRENT_USER_FIELDS
This will always be a JSON encoded array, in (string) format. An empty JSON encoded array, in (string) format, if not logged in. This JSON encoded array will contain the following fields: id, ip, reg_ip, email, login, first_name, last_name, display_name, subscr_id, subscr_or_wp_id, subscr_gateway, custom. If you\'ve configured additional Custom Fields, those Custom Fields will also be added to this array. You can do print_r(json_decode(S2MEMBER_CURRENT_USER_FIELDS, true)); to get a full list for testing.

' . "\n"; #echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_DOWNLOADS_ALLOWED
This will always be an (int) value >= 0. This indicates how many unique files they\'re allowed to download. 0 means no access.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_DOWNLOADS_ALLOWED_IS_UNLIMITED
This will always be (bool) true or false. A value of true means their allowed downloads are >= 999999999, and false means it is not. This is useful if you are allowing unlimited (999999999) downloads on some Membership Levels. You can display `Unlimited` instead of a number.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_DOWNLOADS_CURRENTLY
This will always be an (int) value >= 0. This indicates how many unique files they\'ve downloaded in the current period.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_DOWNLOADS_ALLOWED_DAYS
This will always be an (int) value >= 0. This indicates how many total days make up the current period. 0 means no access.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_PROFILE_MODIFICATION_PAGE_URL
This is a Stand-Alone URL where a User can modify their Profile. In addition to this Stand-Alone version, s2Member also makes a Shortcode available which produces an Inline Profile Editing Form. Use [s2Member-Profile /] in any Post/Page, or even in a Text Widget if you like.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_FILE_DOWNLOAD_LIMIT_EXCEEDED_PAGE_URL
This is the full URL to the Limit Exceeded Page (informational).

' . "\n"; echo '

S2MEMBER_FILE_DOWNLOAD_LIMIT_EXCEEDED_PAGE_ID
This is the Page ID that was used to generate the full URL.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_MEMBERSHIP_OPTIONS_PAGE_URL
This is the full URL to the Membership Options Page (the signup page).

' . "\n"; echo '

S2MEMBER_MEMBERSHIP_OPTIONS_PAGE_ID
This is the Page ID that was used to generate the full URL.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_LOGIN_WELCOME_PAGE_URL
This is the full URL to the Login Welcome Page (the User\'s account page). * This could also be the full URL to a Special Redirection URL (if you configured one). See s2Member → General Options → Login Welcome Page.

' . "\n"; echo '

S2MEMBER_LOGIN_WELCOME_PAGE_ID
This is the Page ID that was used to generate the full URL. * In the case of a Special Redirection URL, this ID is not really applicable.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_LOGIN_PAGE_URL
This is the full URL to the Membership Login Page (the WordPress login page).

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_LOGOUT_PAGE_URL
This is the full URL to the Membership Logout Page (the WordPress logout page).

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_LEVELn_LABEL
This is the (string) Label that you configured for a particular Membership Level #. Replace n with a numeric Membership Level #.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_LEVELn_FILE_DOWNLOADS_ALLOWED
This is the (int) allowed downloads for a particular Membership Level #. Replace n with a numeric Membership Level #.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_LEVELn_FILE_DOWNLOADS_ALLOWED_DAYS
This is the (int) allowed download days for a particular Membership Level #. Replace n with a numeric Membership Level #.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_FILE_DOWNLOAD_INLINE_EXTENSIONS
This is the (string) list of extensions to display inline.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_REG_EMAIL_FROM_NAME
This is the Name that outgoing email messages are sent by.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_REG_EMAIL_FROM_EMAIL
This is the Email Address that outgoing messages are sent by.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_NOTIFY_URL
This is the URL on your system that receives PayPal IPN responses.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_RETURN_URL
This is the URL on your system that receives PayPal return variables.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_BUSINESS
This is the Email Address that identifies your PayPal Business.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_ENDPOINT
PayPal Endpoint Domain (changes when Sandbox Mode is enabled).

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_API_ENDPOINT
PayPal API Endpoint Domain (changes when Sandbox Mode is enabled).

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_API_USERNAME
This is the API Username associated with your PayPal Business.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_API_PASSWORD
This is the API Password associated with your PayPal Business.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_API_SIGNATURE
This is the API Signature associated with your PayPal Business.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_PDT_IDENTITY_TOKEN
This is the PDT Identity Token associated with your PayPal Business.

' . "\n"; echo '' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_list_of_api_constants_farm", get_defined_vars ()); echo '

S2MEMBER_CURRENT_USER_VALUE_FOR_PP_ON0 ... This auto-fills the on0 value in PayPal Button Codes. If a Button Code is presented to a logged-in Member, this will auto-fill the value for the on0 input variable, with the string: "Referencing Customer ID". Otherwise, it will be set to a default value of: "Originating Domain".

' . "\n"; echo '

S2MEMBER_CURRENT_USER_VALUE_FOR_PP_OS0 ... This auto-fills the os0 value in PayPal Button Codes. If a Button Code is presented to a logged-in Member, this will auto-fill the value for the os0 input variable, with the value of S2MEMBER_CURRENT_USER_SUBSCR_OR_WP_ID. Otherwise, it will be set to a default value of $_SERVER["HTTP_HOST"] (the originating domain name).

' . "\n"; echo '

S2MEMBER_CURRENT_USER_VALUE_FOR_PP_ON1 ... This auto-fills the on1 value in PayPal Button Codes. This always contains the string: "Customer IP Address".

' . "\n"; echo '

S2MEMBER_CURRENT_USER_VALUE_FOR_PP_OS1 ... This auto-fills the os1 value in PayPal Button Codes. This always contains the value of $_SERVER["REMOTE_ADDR"] (the Customer\'s IP address).

' . "\n"; echo '

These four Constants above are special. They\'re used by the PayPal Button Generator for s2Member. This is how s2Member identifies an existing Member (and/or a Free Subscriber), who is already logged in when they click a PayPal Modification Button that was generated for you by s2Member. Instead of forcing a Member (and/or a Free Subscriber) to re-register for a new account, s2Member can identify their existing account, and update it, according to the modified terms in your Button Code. Specifically, these three Button Code parameters: on0, os0, modify, work together in harmony. If you\'re using the Shortcode Format for PayPal Buttons, you won\'t even see these, because they\'re added internally by the Shortcode processor. Anyway, they\'re just documented here for clarity; you probably won\'t use these directly; the Button Generator pops them in.

' . "\n"; echo '

' . "\n"; } else // Otherwise, we can display the standardized version of this information. { echo '

' . "\n"; echo '

You Have Access To PHP Constants (some PHP scripting required)

' . "\n"; echo '

A Constant, is an identifier (i.e., a name) for a simple value in PHP scripting. Below is a comprehensive list that includes all of the PHP defined Constants available to you. All of these Constants are also available through JavaScript as Global Variables. Example code has been provided in the documentation below. If you\'re a web developer, we suggest using some of these Constants in the creation of your Login Welcome Page; which is described in the s2Member General Options Panel. These are NOT required, but you can get pretty creative with the Login Welcome Page, if you know a little PHP.

' . "\n"; echo '

If you don\'t know any PHP, you can use the [s2Get constant="NAME_OF_CONSTANT" /] Shortcode for WordPress. For example, you might use [s2Get constant="S2MEMBER_CURRENT_USER_ACCESS_LABEL" /] to display the type of Membership a Customer has. The [s2Get constant="" /] Shortcode will work for any of the API Constants documented below.

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_api_constants", get_defined_vars ()); echo '' . "\n"; echo '

Before you read any further, you should install this handy plugin: ezPHP.
' . "\n"; echo 'You\'ll need to have this plugin installed to use PHP code in Posts/Pages.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_VERSION
This will always be a (string) with the current s2Member version. Available since s2Member 3.0. Dated versions began with s2Member v110604.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/version.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-login-counter.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_IS_LOGGED_IN
This will always be (bool) true or false. True if a User/Member is currently logged in with an Access Level >= 0.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-is-logged-in.x-php")) . '

' . "\n"; echo '

See: S2MEMBER_CURRENT_USER_ACCESS_LEVEL below for a full explanation.

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_IS_LOGGED_IN_AS_MEMBER
This will always be (bool) true or false. True if a Member is currently logged in with an Access Level >= 1.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-is-logged-in-as-member.x-php")) . '

' . "\n"; echo '

See: S2MEMBER_CURRENT_USER_ACCESS_LEVEL below for a full explanation.

' . "\n"; echo '' . "\n"; echo '

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-access-level.x-php")) . '

' . "\n"; echo '

Membership Levels provide incremental access:

' . "\n"; echo '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_ACCESS_LABEL
This will always be a (string) containing the Membership Label associated with the current User\'s account. Empty if not logged in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-access-label.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_SUBSCR_ID
This will always be a (string) containing the current User\'s Paid Subscr. ID. If they\'ve NOT paid yet, this will be an empty string. Also empty if not logged in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-subscr-id.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-subscr-or-wp-id.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_SUBSCR_GATEWAY
This will always be a (string) containing the current User\'s Paid Subscr. Gateway. If they\'ve NOT paid yet, this will be empty. Empty if not logged in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-subscr-gateway.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_CUSTOM
This will always be a (string) containing the current User\'s Custom String; associated with their s2Member Profile. Empty if not logged in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-custom.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_REGISTRATION_TIME
This will always be an (int); in the form of a Unix timestamp. 0 if not logged in. This holds the recorded time at which the User originally registered their Username for access to your site; for free or otherwise. This is useful if you want to drip content over an extended period of time, based on how long someone has been registered (period); regardless of whether they are/were paying you. * Note: this is NOT the same as S2MEMBER_CURRENT_USER_PAID_REGISTRATION_TIME, which could be used as an alternative, depending on your intended usage.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-registration-time.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_REGISTRATION_DAYS
This will always be an (int). 0 if not logged in. This is the number of days that have passed since the User originally registered their Username for access to your site; for free or otherwise. This is useful if you want to drip content over an extended period of time, based on how long someone has been registered (period); regardless of whether they are/were paying you. * Note: this is NOT the same as S2MEMBER_CURRENT_USER_PAID_REGISTRATION_DAYS, which could be used as an alternative, depending on your intended usage.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-registration-days.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_PAID_REGISTRATION_TIME
This will always be an (int); in the form of a Unix timestamp. However, this will be 0 if they\'re not logged in; or if they\'ve never paid you at all (i.e., if they\'re still a Free Subscriber). This holds the recorded time at which the Member originally registered their Username (or upgraded for) any type of "paid" access to your site. This value is preserved for the lifetime of their account, even if they upgrade, and even if they\'re demoted at some point. Once this value is recorded, it never changes under any circumstance. This is useful if you want to drip content over an extended period of time, based on how long someone has been a "paying" Member (period); regardless of their original or existing Membership Level. * Note: this is NOT the same as S2MEMBER_CURRENT_USER_REGISTRATION_TIME, which could be used as an alternative, depending on your intended usage.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-paid-registration-time.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_PAID_REGISTRATION_DAYS
This will always be an (int), representing the number of days that have passed. However, this will be 0 if they\'re not logged in; or if they\'ve never paid you at all (i.e., if they\'re still a Free Subscriber). This is the number of days that have passed since the Member originally registered their Username (or upgraded for) any type of "paid" access to your site. The underlying timestamp behind this value is preserved for the lifetime of their account, even if they upgrade, and even if they\'re demoted at some point. Once the underlying timestamp behind this value is recorded, it never changes under any circumstance. This is useful if you want to drip content over an extended period of time, based on how long someone has been a "paying" Member (period); regardless of their original or existing Membership Level. * Note: this is NOT the same as S2MEMBER_CURRENT_USER_REGISTRATION_DAYS, which could be used as an alternative, depending on your intended usage.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-paid-registration-days.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_DISPLAY_NAME
This will always be a (string) containing the current User\'s Display Name. Empty if not logged in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-display-name.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_FIRST_NAME
This will always be a (string) containing the current User\'s First Name. Empty if not logged in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-first-name.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_LAST_NAME
This will always be a (string) containing the current User\'s Last Name. Empty if not logged in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-last-name.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_LOGIN
This will always be a (string) containing the current User\'s Username. Empty if not logged in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-login.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_EMAIL
This will always be a (string) containing the current User\'s Email Address. Empty if not logged in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-email.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_IP
This will always be a (string) containing the current User\'s IP Address, even when/if NOT logged in. Taken from $_SERVER["REMOTE_ADDR"]. Empty if browsing anonymously.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-ip.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_REGISTRATION_IP
This will always be a (string) containing the current User\'s original IP Address during registration. Taken from $_SERVER["REMOTE_ADDR"]. Empty if not logged in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-registration-ip.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_ID
This will always be an (int) containing the current User\'s ID# in WordPress. However, it will be 0 if not logged in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-id.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-fields.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_DOWNLOADS_ALLOWED
This will always be an (int) value >= 0. This indicates how many unique files they\'re allowed to download. 0 means no access.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-downloads-allowed.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-downloads-allowed-is-unlimited.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_DOWNLOADS_CURRENTLY
This will always be an (int) value >= 0. This indicates how many unique files they\'ve downloaded in the current period.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-downloads-currently.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_CURRENT_USER_DOWNLOADS_ALLOWED_DAYS
This will always be an (int) value >= 0. This indicates how many total days make up the current period. 0 means no access.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-downloads-allowed-days.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

' . "\n"; echo '

Code Sample #1 (standard link):

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-profile-modification-page-url-1.x-php")) . '

' . "\n"; echo '

Code Sample #2 (open the link in a popup window):

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-profile-modification-page-url-2.x-php")) . '

' . "\n"; echo '

Code Sample #3 (embed the form into a Post/Page using an IFRAME tag):

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-profile-modification-page-url-3.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_FILE_DOWNLOAD_LIMIT_EXCEEDED_PAGE_URL
This is the full URL to the Limit Exceeded Page (informational).

' . "\n"; echo '

S2MEMBER_FILE_DOWNLOAD_LIMIT_EXCEEDED_PAGE_ID
This is the Page ID that was used to generate the full URL.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/file-download-limit-exceeded-page-url.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_MEMBERSHIP_OPTIONS_PAGE_URL
This is the full URL to the Membership Options Page (the signup page).

' . "\n"; echo '

S2MEMBER_MEMBERSHIP_OPTIONS_PAGE_ID
This is the Page ID that was used to generate the full URL.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/membership-options-page-url.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

' . "\n"; echo '

S2MEMBER_LOGIN_WELCOME_PAGE_ID
This is the Page ID that was used to generate the full URL. * In the case of a Special Redirection URL, this ID is not really applicable.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/login-welcome-page-url.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_LOGIN_PAGE_URL
This is the full URL to the Membership Login Page (the WordPress login page).

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/login-page-url.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_LOGOUT_PAGE_URL
This is the full URL to the Membership Logout Page (the WordPress logout page).

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/logout-page-url.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_LEVELn_LABEL
This is the (string) Label that you created for a particular Membership Level #. Replace n with a numeric Membership Level #..

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/leveln-label.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_LEVELn_FILE_DOWNLOADS_ALLOWED
This is the (int) allowed downloads for a particular Membership Level #. Replace n with a numeric Membership Level #.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/leveln-file-downloads-allowed.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_LEVELn_FILE_DOWNLOADS_ALLOWED_DAYS
This is the (int) allowed download days for a particular Membership Level #. Replace n with a numeric Membership Level #.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/leveln-file-downloads-allowed-days.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_FILE_DOWNLOAD_INLINE_EXTENSIONS
This is the (string) list of extensions to display inline.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/file-download-inline-extensions.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_REG_EMAIL_FROM_NAME
This is the Name that outgoing email messages are sent by.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/reg-email-from-name.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_REG_EMAIL_FROM_EMAIL
This is the Email Address that outgoing messages are sent by.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/reg-email-from-email.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_NOTIFY_URL
This is the URL on your system that receives PayPal IPN responses.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/paypal-notify-url.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_RETURN_URL
This is the URL on your system that receives PayPal return variables.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/paypal-return-url.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_ENDPOINT
This is the Endpoint Domain to the PayPal server (changes when Sandbox Mode is enabled).

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/paypal-endpoint.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_API_ENDPOINT
This is the Endpoint Domain to the PayPal API server (changes when Sandbox Mode is enabled).

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/paypal-api-endpoint.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_BUSINESS
This is the Email Address that identifies your PayPal Business.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/paypal-business.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_API_USERNAME
This is the API Username associated with your PayPal Business.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/paypal-api-username.x-php")) . '

' . "\n"; echo '

* For security purposes, this is NOT included in the JS/API (JavaSript API).

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_API_PASSWORD
This is the API Password associated with your PayPal Business.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/paypal-api-password.x-php")) . '

' . "\n"; echo '

* For security purposes, this is NOT included in the JS/API (JavaSript API).

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_API_SIGNATURE
This is the API Signature associated with your PayPal Business.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/paypal-api-signature.x-php")) . '

' . "\n"; echo '

* For security purposes, this is NOT included in the JS/API (JavaSript API).

' . "\n"; echo '' . "\n"; echo '

S2MEMBER_PAYPAL_PDT_IDENTITY_TOKEN
This is the PDT Identity Token associated with your PayPal Business.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/paypal-pdt-identity-token.x-php")) . '

' . "\n"; echo '

* For security purposes, this is NOT included in the JS/API (JavaSript API).

' . "\n"; echo '' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_list_of_api_constants", get_defined_vars ()); echo '

' . "\n"; echo '

S2MEMBER_CURRENT_USER_VALUE_FOR_PP_ON1 ... This auto-fills the on1 value in PayPal Button Codes. This always contains the string: "Customer IP Address".

' . "\n"; echo '

S2MEMBER_CURRENT_USER_VALUE_FOR_PP_OS1 ... This auto-fills the os1 value in PayPal Button Codes. This always contains the value of $_SERVER["REMOTE_ADDR"] (the Customer\'s IP address).

' . "\n"; echo '

These four Constants are special. They are used by the PayPal Button Generator for s2Member. This is how s2Member identifies an existing Member (and/or a Free Subscriber), who is already logged in when they click a PayPal Modification Button that was generated for you by s2Member. Instead of forcing a Member (and/or a Free Subscriber) to re-register for a new account, s2Member can identify their existing account, and update it, according to the modified terms in your Button Code. Specifically, these three Button Code parameters: on0, os0, modify, work together in harmony. If you\'re using the Shortcode Format for PayPal Buttons, you won\'t even see these, because they\'re added internally by the Shortcode processor. Anyway, they\'re just documented here for clarity; you probably won\'t use these directly; the Button Generator pops them in.

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/current-user-value-for-pp-on0-os0-on1-os1.x-php")) . '

' . "\n"; echo '

' . "\n"; } do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_after_api_constants", get_defined_vars ()); } if (apply_filters("ws_plugin__s2member_during_scripting_page_during_left_sections_display_api_js_globals", true, get_defined_vars ())) { do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_before_api_js_globals", get_defined_vars ()); echo '

' . "\n"; echo '

You Also Have Access To JS Globals (some JavaScript knowledge required)

' . "\n"; echo '

Unless noted otherwise, all of the PHP Constants, are also available through JavaScript, as Global Variables (with the exact same names/types as their PHP counterparts). s2Member automatically loads it\'s compressed JavaScript API into your theme for WordPress. s2Member is very intelligent about the way it loads (and maintains) it\'s JavaScript API. You can rely on the JavaScript Globals, the same way you rely on PHP Constants. The only exceptions are related to security. Variables that include private server-side details, like Identity Tokens and other API service credentials, will be excluded automatically.

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_api_js_globals", get_defined_vars ()); echo '

' . "\n"; echo '

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_after_api_js_globals", get_defined_vars ()); } if (apply_filters("ws_plugin__s2member_during_scripting_page_during_left_sections_display_api_mop_vars", (!is_multisite () || !c_ws_plugin__s2member_utils_conds::is_multisite_farm () || is_main_site ()), get_defined_vars ())) { do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_before_api_mop_vars", get_defined_vars ()); echo '

' . "\n"; echo '

Membership Options Page Variables (some scripting required)

' . "\n"; echo '

At the core of s2Member, is it\'s ability to protect content (i.e., Posts, Pages, Tags, Categories, URI word fragments, etc). Whenever a public User, or even an existing Member attempts to access an area of your site that is unavailable to them; either because they are not logged-in, not a paying Member at all; or maybe they are logged-in, but they don\'t have access to content you\'ve protected at a higher Membership Level; s2Member will always redirect these unauthenticated requests to your Membership Options Page.

' . "\n"; echo '

So your Membership Options Page is a key element of your site. It serves as the focal point of your s2Member installation. Understanding this, you can see it becomes important for s2Member to provide information about what the User/Member was attempting to access (before they were redirected to the Membership Options Page). This is where s2Member\'s MOP Vars come in (i.e., Membership Options Page Variables). Whenever s2Member redirects a User/Member to your Membership Options Page, it will include these important MOP Variables in the query string of the URL. These Variables can be used to provide more informative messages; or even to provide a different set of Membership Options (e.g., Payment Buttons), based on what a User/Member was attempting to access.

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_api_mop_vars", get_defined_vars ()); echo '' . "\n"; echo '

TIP: If you\'re running s2Member Pro, there is a NEW simplified way to deal with MOP Vars using the [s2MOP] Shortcode.
' . "\n"; echo '

' . "\n"; echo '

PHP Code Sample: This may give you some other ideas [click here].

' . "\n"; echo '' . "\n"; echo '' . "\n"; echo '

s2Member MOP Vars (Explained) ...

' . "\n"; echo '

' . c_ws_plugin__s2member_utils_strings::highlight_php (file_get_contents (dirname (__FILE__) . "/code-samples/api-mop-vars.x-php")) . '

' . "\n"; echo '' . "\n"; echo '

Backward compatibility (the old way): The structure of s2Member\'s MOP Vars changed again in Apr, 2014. However, s2Member still provides the same MOP Vars that it used in previous versions, for backward compatibility. These old MOP Variables were more difficult to use; they are now deprecated (i.e., they WILL eventually be removed). Going foward, please go by the new documentation above.

' . "\n"; echo '' . "\n"; echo '

Backward compatibility (the really old way): The structure of s2Member\'s MOP Vars changed a bit in Nov, 2011. However, s2Member still provides the same MOP Vars that it used in previous versions, for backward compatibility. These old MOP Variables were more difficult to use; they are now deprecated (i.e., they WILL eventually be removed). Going foward, please go by the new documentation above.

' . "\n"; echo '' . "\n"; echo '

' . "\n"; echo '' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_after_api_mop_vars", get_defined_vars ()); } if (apply_filters("ws_plugin__s2member_during_scripting_page_during_left_sections_display_api_hooks", (!is_multisite () || !c_ws_plugin__s2member_utils_conds::is_multisite_farm () || is_main_site ()), get_defined_vars ())) { do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_before_api_hooks", get_defined_vars ()); echo '

' . "\n"; echo '

WP Hooks For Theme/Plugin Developers (scripting required)

' . "\n"; echo '

In addition to its API Constants, s2Member also makes several Hooks/Filters available throughout its framework. This makes it possible to build onto (or even modify) s2Member in lots of different ways. If you need to add custom processing routines, modify the behavior of existing processing routines, or tinker with things otherwise; you should use API Hooks/Filters. API Hooks & Filters, give you the ability to "hook into", and/or "filter" processing routines, with files/functions of your own; instead of editing the s2Member plugin files directly. If you don\'t use a Hook/Filter, and instead, you edit the plugin files for s2Member, you\'ll have to merge all of your changes every time a new version of s2Member is released. If you create custom processing routines, you could place those routines into a PHP file here: /wp-content/mu-plugins/s2-hacks.php. If you don\'t have an /mu-plugins/ directory, please create one. These are (mu) MUST USE plugins, which are loaded into WordPress automatically; that\'s what you want!

' . "\n"; echo '

Attn Developers: There are simply too many Hooks/Filters spread throughout s2Member\'s framework (over 1000 total). Rather than documenting each Hook/Filter, it is easier to browse through the files inside: /s2member/src/includes/classes/. Inspecting Hooks/Filters in this way, also leads you to a better understanding of how they work. One way to save time, is to run a search for do_action and/or apply_filters. If you\'re new to the concept of Hooks/Filters for WordPress/s2Member, we suggest this article as a primer. The s2Member Codex also contains information about all Hooks/Filters that come with s2Member.

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_during_api_hooks", get_defined_vars ()); echo '' . "\n"; echo '

' . "\n"; echo '

' . "\n"; do_action("ws_plugin__s2member_during_scripting_page_during_left_sections_after_api_hooks", get_defined_vars ()); } do_action("ws_plugin__s2member_during_scripting_page_after_left_sections", get_defined_vars ()); echo '

API / Scripting

The Extremely Easy Way (no scripting required)

Simple Conditionals (via WordPress Shortcodes)

Simple Conditionals (via WordPress Shortcodes)

The Advanced Way (some PHP scripting required)

Advanced Query Conditionals (some PHP scripting required)

Packaging Together Custom Capabilities w/ Membership

Restricting Files, Based On Custom Capabilities

Dripping Content (some PHP scripting may be required)

Very Advanced Content Dripping (some PHP required)

Using s2Get w/ s2Member API Constants

You Have Access To PHP Constants (some PHP scripting required)

You Also Have Access To JS Globals (some JavaScript knowledge required)

Membership Options Page Variables (some scripting required)

WP Hooks For Theme/Plugin Developers (scripting required)