{"id":205901,"date":"2024-10-09T18:36:46","date_gmt":"2024-10-09T18:36:46","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/mc-professional-authentication-and-user-sync\/"},"modified":"2024-11-01T15:44:16","modified_gmt":"2024-11-01T15:44:16","slug":"memberclicks-professional-authentication","status":"publish","type":"plugin","link":"https:\/\/lmo.wordpress.org\/plugins\/memberclicks-professional-authentication\/","author":23118560,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.2","stable_tag":"1.0.2","tested":"6.6.5","requires":"6.6","requires_php":"7.2","requires_plugins":null,"header_name":"MC Professional Authentication and User Sync","header_author":"MemberClicks","header_description":"Provides SSO (Single Sign-On) with MemberClicks Professional to restrict content based on member group. Sync user records for consistent access.","assets_banners_color":"ffffff","last_updated":"2024-11-01 15:44:16","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/memberclicks.com\/","header_plugin_uri":"","header_author_uri":"http:\/\/memberclicks.com\/","rating":0,"author_block_rating":0,"active_installs":20,"downloads":2882,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"memberclicks","date":"2024-10-09 17:24:07"},"1.0.1":{"tag":"1.0.1","author":"memberclicks","date":"2024-10-09 18:36:30"},"1.0.2":{"tag":"1.0.2","author":"memberclicks","date":"2024-11-01 15:44:16"}},"upgrade_notice":{"1.0.0":"<ul>\n<li>Initial release<\/li>\n<\/ul>"},"ratings":[],"assets_icons":{"icon.svg":{"filename":"icon.svg","revision":3166051,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1609x522.png":{"filename":"banner-1609x522.png","revision":3166051,"resolution":"1609x522","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3166051,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3166051,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3180054,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3166051,"resolution":"3","location":"assets","locale":""}},"screenshots":{"1":"Settings for the MC Professional Authentication and User Sync plugin","2":"MC Professional SSO login button","3":"MC Professional API client settings"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[232900,232899,34104,2469,713],"plugin_category":[],"plugin_contributors":[232901],"plugin_business_model":[],"class_list":["post-205901","plugin","type-plugin","status-publish","hentry","plugin_tags-mc-professional","plugin_tags-memberclicks","plugin_tags-membership-management","plugin_tags-sso","plugin_tags-user-authentication","plugin_contributors-memberclicks","plugin_committers-memberclicks"],"banners":{"banner":"https:\/\/ps.w.org\/memberclicks-professional-authentication\/assets\/banner-772x250.png?rev=3166051","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/memberclicks-professional-authentication\/assets\/icon.svg?rev=3166051","icon":"https:\/\/ps.w.org\/memberclicks-professional-authentication\/assets\/icon.svg?rev=3166051","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/memberclicks-professional-authentication\/assets\/screenshot-1.png?rev=3166051","caption":"Settings for the MC Professional Authentication and User Sync plugin"},{"src":"https:\/\/ps.w.org\/memberclicks-professional-authentication\/assets\/screenshot-2.png?rev=3180054","caption":"MC Professional SSO login button"},{"src":"https:\/\/ps.w.org\/memberclicks-professional-authentication\/assets\/screenshot-3.png?rev=3166051","caption":"MC Professional API client settings"}],"raw_content":"<!--section=description-->\n<p>The MC Professional Authentication and User Sync plugin allows you to offer exclusive member content on your WordPress site by restricting access to some or all areas of your site. As the administrator, you have control over permissions with the flexibility to set content access based on the member types and group affiliations that are already set up within your MC Professional system.<\/p>\n\n<p>To log in to your restricted WordPress site, your members can utilize convenient single sign-on (SSO) with their regular MC Professional credentials and will be able to access specific content and pages based on your settings. You even can customize the WordPress site login screen. Additionally, the plugin enables you to sync user records across your MC Professional system and WordPress site to ensure you have one consistent source of truth for user authentication.<\/p>\n\n<p>The plugin reaches out to MemberClicks Professional servers using the domain and API credentials that you enter in the plugin settings page. The plugin uses standard OAuth2 protocols to authenticate members, and data is transferred over secure connections. You can find Terms of Use, Privacy Policy and other legal documents in the <a href=\"https:\/\/memberclicks.com\/legal\/\">Legal Center<\/a>.<\/p>\n\n<!--section=installation-->\n<p>To set up the MC Professional Authentication and User Sync plugin on your WordPress site, follow these steps:<\/p>\n\n<ol>\n<li>Log in to your WordPress site.<\/li>\n<li>Navigate to the <strong>Dashboard<\/strong>.<\/li>\n<li>On the left side menu, hover over the <em>Plugins<\/em> menu item and click <strong>Add New Plugin<\/strong>.<\/li>\n<li>Search for the <em>MC Professional Authentication and User Sync<\/em> plugin.<\/li>\n<li>Once you locate the <em>MC Professional Authentication and User Sync<\/em> plugin, click the <strong>Install Now<\/strong> button.<\/li>\n<li>After the installation is complete, click the <strong>Activate<\/strong> button.<\/li>\n<li>In your <strong>Dashboard<\/strong>, from the left side menu, locate and open <strong>MC Professional<\/strong>.<\/li>\n<li>To use the MC Professional Authentication and User Sync plugin, you must configure the <strong>API client<\/strong> in <strong>MC Professional<\/strong> account. Instructions on configuring the API client can be found <a href=\"https:\/\/help.memberclicks.com\/hc\/en-us\/articles\/18581108667021-API-Management\">here<\/a>.\n\n<ul>\n<li>Select the following grant types for authentication:\n\n<ol>\n<li>Authorization Code<\/li>\n<li>Resource Owner Password Credentials<\/li>\n<li>Client Credentials<\/li>\n<\/ol><\/li>\n<li>The admin group must be selected and have the appropriate access (edit or read-only) configured in the <strong>Group Attribute Security<\/strong> settings.<\/li>\n<li>Enter the <strong>Redirect URI<\/strong>. This has to be your WordPress site address. You can copy it from the plugin settings. The redirect URI should not end in a trailing slash.<\/li>\n<li>Save the API Client.<\/li>\n<\/ul><\/li>\n<li>On the MC Professional Authentication and User Sync settings page, enter your MC Professional API <em>Client ID<\/em>, <em>Client Secret<\/em>, and <em>Domain<\/em> in the format orgid.memberclicks.net.\nYou can obtain these values from the created API Client in API Management in MC Professional.<\/li>\n<li>Modify any additional settings to customize your plugin. For example, you can customize <strong>Login button label<\/strong>.\nThe plugin adds an SSO button to the WordPress login screen, allowing you to customize its label with your preferred text. We recommend including your organization name in the login button label.<\/li>\n<li>Click the <strong>Save Changes<\/strong> button.<\/li>\n<li>You can <strong>Test API Client Credentials<\/strong>.  This will check if the client credentials (such as API key) are correct and properly configured.<\/li>\n<li>Once the plugin settings are set you can also <strong>Synchronize WordPress roles<\/strong>.\nThis will update your WordPress roles with your MC Professional member groups. No existing roles will be removed.<\/li>\n<\/ol>\n\n<p>After following these steps, your WordPress site should be successfully integrated with MC Professional for authentication and user synchronization.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id='how%20do%20i%20configure%20the%20api%20client%20in%20mc%20professional%3F'><h3>How do I configure the API client in MC Professional?<\/h3><\/dt>\n<dd><p>This article on <a href=\"https:\/\/help.memberclicks.com\/hc\/en-us\/articles\/18581108667021-API-Management\">API management<\/a> will guide you through the steps to configure the API client.<\/p>\n\n<p>The API Client requires the following grant types for authentication: Authorization Code, Resource Owner Password Credentials, Client Credentials.<\/p>\n\n<p>The admin group must be selected and have the appropriate access (edit or read-only) configured in the Group Attribute Security settings. Learn more about Group Attribute Security <a href=\"https:\/\/help.memberclicks.com\/hc\/en-us\/articles\/15793025617421-Group-attribute-security\">here<\/a>.<\/p><\/dd>\n<dt id='how%20do%20members%20log%20in%20utilizing%20their%20mc%20professional%20credentials%3F'><h3>How do members log in utilizing their MC Professional credentials?<\/h3><\/dt>\n<dd><p>Installing the MC Professional Authentication and User Sync plugin adds an SSO button to the WordPress login screen.<\/p>\n\n<p>When members click the MC Professional login button, they are redirected to your MC Professional site to enter their credentials. After logging in, they are redirected back to your WordPress site.<\/p>\n\n<p>If members enter their MC Professional credentials, username and password, in the WordPress login form instead of using the SSO button, they will be authorized in WordPress site but not in the MC Professional website.<\/p><\/dd>\n<dt id='how%20do%20i%20restrict%20wordpress%20content%20to%20mc%20professional%20members%3F'><h3>How do I restrict WordPress content to MC Professional members?<\/h3><\/dt>\n<dd><p>To restrict WordPress content to MC Professional members, you must first install a content management plugin.<\/p>\n\n<p>The following content management plugins have been tested:<\/p>\n\n<ul>\n<li><a href=\"https:\/\/wordpress.com\/plugins\/content-control\">Content Control \u2013 The Ultimate Content Restriction Plugin<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.com\/plugins\/restrict-user-access\">Restrict User Access \u2013 Ultimate Membership &amp; Content Protection<\/a><\/li>\n<li><a href=\"https:\/\/wordpress.com\/plugins\/block-visibility\">Block Visibility \u2013 Conditional Visibility Control for Block Editor<\/a><\/li>\n<\/ul>\n\n<p>After installing and activating the content management plugin, you can control content access in WordPress based on user roles. You can synchronize user roles in WordPress with your member groups in MC Professional.<\/p><\/dd>\n<dt id='how%20do%20i%20update%20member%20profile%20data%20to%20ensure%20it%20is%20synchronized%20between%20mc%20professional%20and%20wordpress%3F'><h3>How do I update member profile data to ensure it is synchronized between MC Professional and WordPress?<\/h3><\/dt>\n<dd><p>When a member logs in with SSO for the first time, a new user with \"mc_pro_user_{user ID}\" username is created in WordPress, and will populate their WordPress profile with data including First Name, Last Name, Contact Name, and Email. The member\u2019s role within WordPress is automatically assigned based on their associated membership groups in MC Professional.<\/p>\n\n<p>With each login, the WordPress user is synchronized with current MC Professional member profile data, making sure the information in WordPress stays up to date. Any changes made to users in WordPress are not synchronized back to the MC Professional member profile.<\/p>\n\n<p><strong>For this reason, member profile data should be updated exclusively in MC Professional.<\/strong><\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Login page UI enhancements<\/li>\n<li>Bug fix for duplicate email addresses<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Fix plugin upload<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"Provides SSO (Single Sign-On) with MemberClicks Professional to restrict content based on member group. Sync user records for consistent access.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/205901","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=205901"}],"author":[{"embeddable":true,"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/memberclicks"}],"wp:attachment":[{"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=205901"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=205901"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=205901"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=205901"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=205901"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/lmo.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=205901"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}