Follow

6a. Client Instructions for WP Configuration (copied)

If you're configuring your WordPress site to integrate Cobalt Embedded Web Elements and Single Sign On (SSO), you'll need the following value, provided by Cobalt, before you begin:

1) Your widget site URL

2) Your Web Element Designer URL

3) Your SAML Metadata URL

Once you've been provided these values you can take the steps below:

1) Install and Configure SAML plugin

You will need to set up your site as the Service Provider (SP) using MiniOrange Premium for authentication on your website.

  1. Note: If you’re not familiar with setting up an SP using MiniOrange in WordPress, here is a good walkthrough. Ignore step one of that walkthrough and go straight to step two
  2. If you have a different preferred SP we can help you with that as well (though we will need time to confirm that we can work with that plugin).

In whichever, SAML plugin you use, be sure to set up your various CMS user roles, in their respective Role Mapping fields (e.g. Active Contacts CMS User Role would be assigned to Subscriber role).

 2) Create Generic widget page

Once Cobalt support has provided your Web Element Designer URL, your site content administrator will need to create a reference widget page for the system to use. The page should be called Generic Web Element or Generic Widget and the content area for this page needs to include the HTML source code from the Web Element Generator Homepage.

The HTML should look like the code block below, with the portal widget URL updated to reflect your widget site URL.

<div id="cw-1056591808" style="width: 100%; height: 100%;" class="cobalt-widget" data-loading="true" src="https://hcarwidgets.ramcoams.net/Login.aspx?ReturnUrl=%2fProfile%2fDefault.aspx%3fwidget%3dframe&widget=frame&color=/Resources/css/colors/color.css"></div><script>var js,p=/^http:/.test(document.location)?"http":"https";if(!document.getElementById("cobalt-wjs")){js=document.createElement("script");js.id="cobalt-wjs";js.src="https://hcarwidgets.ramcoams.net/App_Themes/Nevia/js/widget.js";document.getElementsByTagName("head")[0].appendChild(js);}</script>

To grab this HTML, navigate to:

Your Web Element Designer URL and grab the HTML from the left hand side on the configuration pane. Insert this HTML into the Generic Page on your CMS. You MUST copy the HTML from the Web Element Designer.

3) Send metadata and Generic Web Element page URL

Provide Cobalt support staff with the URL of the Generic Web Element page you created as well as the SP metadata for the SAML Plugin. In MiniOrange Premium, it can be found here:

With those value, Cobalt Support will complete the configuration and respond to you when it is complete. Once we've confirmed that the configuration is working, you may then proceed with setting up all of the other embedded Web Elements that you would like to use.

NOTE (on the use of the MiniOrange SAML Plugin):

Once the MiniOrange plugin is setup & configured, your members will be able to log into both RAMCO and the website site with one set of credentials. Members must be logged into the website before attempting to register for an event since most events require a person to have permission to do so.

  • When a member logs into your website, they will land on the homepage that you identified with us and they will have access to everything that you have given them permission for them to see. At this point they will be able to register for any events.
  • If a member has not logged in and they try to register for on an event that is on your calendar, they will be redirected to the embedded login page where they can log in. Once logged in, they will be on the homepage that you had identified with us. To register for the event, they will need to go to the event and go through the registration process.

Some organizations put text on their calendar events telling members that they must be logged in before attempting to register for an event.

NOTE (On WordPress and Cobalt Code):

With the latest versions of WordPress, the embedded Gutenberg editor and other version changes make it so that, while you can embed Cobalt Web Elements, they will not appear. This is due to the newer versions not being able to handle jQuery. The easiest way to correct this is to add this line of code to your site header file:

<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js"></script>    

Add it within these tags:

<head>
</head>

Specifically, add it before this line:

<?php wp_head(); ?>

Here is an example block, including that line:

<head>    
<meta charset="<?php bloginfo( 'charset' ); ?>" />    
<meta name="viewport" content="width=device-width, initial-scale=1" />    
<link rel="profile" href="https://gmpg.org/xfn/11" />   
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js"></script>    
<?php wp_head(); ?>
</head>
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk