Knowledge Base: Creating a Hub Listing on Your Website

Creating a hub list widget allows you to easily embed a list of hubs from your organization on your web site. This is a great way to allow members to browse your hubs and select which groups they would like to join and/or access. The hub listing widget gives you a snippet of code that you can then embed into a web page. The code generates a list of hubs, each a link to the hub's landing page. Depending on how each hub has been set up a person can decide to join the hub, request to join the hub or access the hub from the hub's landing page.

In the management console for your MemberHub Organization click on the Settings tab then click on Widgets in the right-hand navigation. At this point it could be as easy as following the instructions on the screen. However, there's some background information that really helps make sense of how this widget works.

In this first step you have a few different options. First, consider whether you'd like the hub listing to include the hub's description . The "Menu" Display As option will include the hub's Description that can be edited on the General tab for that hub in it's Hub Settings. The listing can then be sorted alphabetically by hub name or chronologically in the order the were created in.

You can also filter the hubs displayed in a listing by using the Tags feature in your management console. As an example, let's say your church website has two different pages; one for adult ministry groups and one for youth ministry groups. You may wish to list two entirely different lists of hubs on those pages. If you've tagged all the hubs that are affiliated with Youth programs with one tag and the hubs affiliated with Adult programs with another tag, you can can create two different hub listing widgets. That Filter By Tag option will generate different code snippets.

Now that you've adjusted all you settings simply copy the generated code snippet and paste it into your webpage. The styling of the list will take on the styling of your current website's CSS so it will look right at home!

Adjusting the Join Settings for Your Hubs

A crucial part to understanding the hub listing widget is understanding the options on the Joins tab for any given hub. Right now would be a great time to read about Using Hub Keys and Join URLs

• If at any time you do NOT want a hub to appear in a listing or in anyway joined by new people uncheck the Allow the hub key and URL joins checkbox. This will automatically remove the hub from your listing. No need to re-copy and paste you widget code.
• If you'd rather keep your hubs wide open for new joins, then uncheck the Require hub administrator approval for hub key and URL joins box and the button on the landing page for that hub will change from Request to Join to Join Hub.