GZCMS Members Only Pages Members Only

• Internal Documentation - This document is Internal ONLY
• External Documentation: https://supportwiki.memberzone.org/Managing_your_GrowthZone_CMS_Website#Add_Members-Only_Pages_to_your_GrowthZone_CMS_Website

Member Only pages is only available for customers using a GrowthZone database and GZCMS.

Revision History

Table of Contents

Revision History. 2

Product Purpose. 4

Document Purpose. 4

Document Audience. 4

Setting up a tenant in GrowthZone for Members-Only. 4

Enabling Members-Only on a Site. 4

Configuring Members-Only for a Site. 4

Adding Pages to Members-Only section. 5

Login / Logout link shortcode. 5

Viewing a page that is Protected. 5

Terminology. 5

Known Issues. 5

Product Purpose

The purpose of the product is to have an area on their GZCMS website where customers (site owners) can create private pages for their members to access by authenticating using the GrowthZone Association platform, through the use of oath.

It is helpful to find out what type of content needs to go on these pages and what the actual intent or purpose is for using these. It may be as simple as using the Info Hub in a lot of cases.

Document Purpose

The purpose of this document is to demonstrate how to utilize the feature(s) within GZCMS.

Document Audience

This document is aimed for the GrowthZone internal web services team.  An external customer document will be created at a later date within the GrowthZone Wiki.

Setting up a tenant in GrowthZone for Members-Only

If API is already enabled, we do not charge the customer for enabling it for Members-Only page functionality. If it is not enabled, there currently is a $550 setup fee, and an ongoing $56/month fee. An email to the Engagement team can help get that in place but the customer needs to be aware that there is a fee involved if they aren't already paying one.

• Login to GrowthZone using your GrowthZone/<username> user
• Navigate to Admin in the left navigation menu
• Search and Click on the tenant ID of choice to ensure ApiAccess module is enabled
• Click on tenant name to open
• In the new tenant window Navigate to Setup from the left navigation menu
• Navigate to OAuth Client Permissions under Applications
• Click Add and enter GZCMS into the input box, and Click Done

Enabling Members-Only on a Site

• Login into the GZCMS site of choice via its Tenant in GrowthZone as a Network Admin
• Navigate to My Sites -> Network Admin -> Sites
• Search for the site to enable Members Only on
• Toggle the Members Only switch for the desired site

Configuring Members-Only for a Site

• Login into the GZCMS site of choice via its Tenant in GrowthZone as a Network Admin
• Navigate to the Sites Dashboard
• Navigate to Settings -> Members-Only
• Enter in the oAuth base URL (this is the URL for the tenant from GrowthZone), e.g., https://tenant.growthzoneapp.com.
• Enter in the oAuth client id (this can be found, in the location from Setting up a tenant in GrowthZone for Members-Only)
• Enter in the oAuth client secret (this can be found, in the location from Setting up a tenant in GrowthZone for Members-Only)
• Click Save Changes
• For Project Managers/Onboarders: Add to their launch tasks if customer is using 'Member Only' pages and where they are located so they can be corrected after doing the search and replace.

Clear Permalinks

After enabling 'members-only-pages, permalinks need to be cleared.  Since by turning on member pages - it’s a different post type in the system, and WP needs to be told to clear out it’s current post structure to accommodate them.

• Go to Settings > Permalinks > (don’t make any changes) > Save Changes

Adding Pages to Members-Only section

• Login into the GZCMS site of choice via its Tenant in GrowthZone either as a Network Admin / Admin or Editor
• Navigate <site name> -> Dashboard -> Members Only
• Click Add New and follow the normal procedure to add a page
• Be sure that any pages published in the Members Only section are set to PUBLIC. Pages set to PRIVATE will not be seen by members and will produce a 404 error when members try to view the page.

Login / Logout link shortcode

The Members-Only plugin has a shortcode which can be used in order to display a Login/Logout (based on the user’s current state) link on pages if required.

The shortcode can be added to a page by adding [gz-members-only-link] to any page, header, footer etc.

Viewing a page that is Protected

There are two ways to view the pages that are protected and part of the Members Only pages.

1.  As a logged in editor/admin/network admin in GZCMS, navigate to the page, since editors and up can edit the page, they can also view the page, without any extra authentication.
2. As a user that is not logged in editor/admin/network admin in GZCMS, you must be a member in GrowthZone for the particular tenant the site belongs to authenticate via OAuth to view the page.

Note:  Assets such as images, and videos, and documents stored in the media library and embedded into the members only pages are NOT protected.

Terminology

Shortcode(s) - Shortcode Explanation

Known Issues

Members only pages breaking after site launch: during pre-launch, there is a search and replace that is done but it also updates the members only base URL - using the members.site.com subdomain or business.site.com subdomain (basically *.sites.com) will break it - it needs to be *.growthzoneapp.com. The *.site.com is not able to pass session info around via subdomains (which would be insecure) - if everything is passed around on the *.growthzoneapp.com subdomain, then its not a problem.

There is also a potential issues where if you use a members.site.com for the Info Hub Login page and members link directly to a members only pages it will error out, we suggest that the info hub login URL always use the *.growthzoneapp.com domain.