SHOW ME (5:59)

Using this gadget, you can add a member directory to a page on your Wild Apricot site, allowing visitors to see a list of your members, search for members, and view member profiles.

https://cdn.elev.io/file/uploads/jEC8HySvDwISUdSg8iqChOB9kMRsiM1RCnIFiA0173M/mG291bYLvpUzQS0XiH7CWeUWq2wgBDQoVZ_VPg39jpo/member directory w pics-jQQ.png

Visitors can search for members within the directory, using simple or advanced search functions. Clicking on a member listing within the directory will display that member's profile (subject to their privacy settings). Whether a member appears in the directory also depends on that member's privacy settings.

You cannot add a member directory gadget – or any other singular gadget – to a page template or system page, or to a page containing another singular gadget.

You can control which members appear in the directory, restricting the list by membership level, member groups, or saved searches. You can also control which fields are displayed for each member and the order in which member records are sorted.

You can create multiple member directory pages, each with different settings. For example, you could set up different member directories for members and non-members, or for different regions.

You can also control which fields are displayed for each member and the order in which member records are sorted.

You can restrict access to the page on which the member directory appears by membership level or member groupas part of the page settings.

You can embed a Wild Apricot members directory into another website using widgets.

Adding a member directory

To add a member directory to a page on your Wild Apricot site, follow these steps:

  1. Go to Sites pages (under the Website menu) and create or begin editing the site page where you want the member directory to appear.
  2. Click the Gadgets icon to display the list of available gadgets.
  3. Drag the member directory gadget from the list, and drop it where you want it to appear on the page. You can insert it into a section within a layout, or above or below a layout. https://cdn.elev.io/file/uploads/jEC8HySvDwISUdSg8iqChOB9kMRsiM1RCnIFiA0173M/iMFJc0-VzSHrnyuCqHtqlUv1GQ9nVrmZmZv_GHWvfnI/dragging%20member%20directory%20gadget-608.png
    When a layout cell or placeholder is empty, a Drop gadget or layout here prompt will be displayed. When you drag a gadget over an empty layout cell or placeholder, it turns green, indicating that you can drop the gadget there. When you drag a gadget above or below a layout, a prompt will appear indicating that you can drop the gadget before or after the layout.
  4. After you have dropped the gadget in the desired location, hover your pointer over it and click the Settings icon. https://cdn.elev.io/file/uploads/jEC8HySvDwISUdSg8iqChOB9kMRsiM1RCnIFiA0173M/8jckjG23DKNv3VMF6pwNE-BFYCVm57Bbuv2w7T79zj8/member%20directory%20gadget%20settings%20icon-JTc.png
  5. From the gadget settings panel on the left, choose the desired settings for your member directory. You can control which member records are displayed and in what order, and which fields are displayed for each member and in what order. For more information, see Member directory settings (below).
  6. Click Save to save the changes to the page.

For instructions on restricting access to the page, see Page access and visibility.

Member directory settings

Now that you have added a member directory gadget to your page, you can adjust the member directory gadget settings to control – among other things – which member records are displayed and in what order, and which fields are displayed for each member and in what order.

Gadget settings appear in a panel on the left side (which can be hidden to maximize the page design area). To display the settings panel, you position your pointer over the gadget – while editing a site page on which it appears – then click the gadget's Settings icon.

Controlling who appears in the directory

To control the kinds of members to be included in the member directory, choose from the following options under Members to include within the member directory gadget settings:

All members
Include all members with a membership status of Active or Pending Renewal.

From saved search
Use a saved member search to limit members to those that match the saved search criteria. When you choose this option, you can choose from a list of your saved member searches.
https://cdn.elev.io/file/uploads/jEC8HySvDwISUdSg8iqChOB9kMRsiM1RCnIFiA0173M/46mniocOrPrWLc_Pu_7yaxXNiy12dhXz-0uPCLDRdyg/selecting%20saved%20search-uM8.png

This option will only appear if you have a saved member search.

Selected levels
Restrict the list to members at selected membership levels. When you click this option, you can choose one or more membership levels. If you check the All levels option then all levels – including any levels added in the future – will be selected.

Selected groups
Restrict the list to members belonging to selected member groups. When you click this option, you can choose one or more member groups. If you check the All groups option then all groups – including any groups added in the future – will be selected. https://cdn.elev.io/file/uploads/jEC8HySvDwISUdSg8iqChOB9kMRsiM1RCnIFiA0173M/aBNjebcD-Mo615dAj_xl-aGyVSBb9AWQtvePu5m6hXA/restricting%20by%20membership%20level-wAA.png

Show bundle administrator only
Indicates whether to include only bundle administrators and exclude individual members of bundles. The profiles of individual bundle members will still be accessible from the bundle administrator's profile even if individual members are excluded.

Setting the sorting order

To control the order in which members are listed in the directory, follow these steps:

  1. Within the member directory gadget settings, click the Customize result layout button.
    https://cdn.elev.io/file/uploads/jEC8HySvDwISUdSg8iqChOB9kMRsiM1RCnIFiA0173M/Mc2CesCkWSpqhh2Pi9UbA_J_B76xO33aCjZcJahKPBQ/customize%20result%20layout%20button-mSs.png
  2. On the dialog that appears, click the Sort by drop-down under Sorting order and choose the field to sort the member records by. You can choose any common or membership fields except multi-line text, radio button, or multiple choice fields.

    The sort order field must have its member privacy settings set to Anybody. If you want to restrict access to the field, you can restrict access within its field settings.

    You can choose to sort in ascending or descending order. If you want to display matching records in random order, select the Random option instead of a field.
  3. Optionally, choose up to 2 more fields to sort by from the Then by drop-downs. The records will be displayed in order according to the values of the first field, then any duplicate values will sorted by the second field, and so on. For example, you might want to sort by membership level then by last name, and finally by first name.
    https://cdn.elev.io/file/uploads/jEC8HySvDwISUdSg8iqChOB9kMRsiM1RCnIFiA0173M/3xnnXMUy3rXUMnymJHIACy67QHoFLCkBsTbTx_ewnNk/choosing%20sort%20fields-ql8.png
  4. Click Apply to apply your changes.
  5. Click Save to save changes to the page.

Controlling the information displayed for each member

To control what information is displayed for each member in the directory, follow these steps:

  1. Within the member directory gadget settings, click the Customize result layout button.
  2. Within the Search results layout area on the dialog that appears, you can choose up to 4 columns to be displayed for each member, and pick up to 3 database fields to be combined in each column. For example, you could combine first name and last name in column 1; organization and email address in column 2; and city and state in column 3. For each column, you can specify the column width and the column heading.
    https://cdn.elev.io/file/uploads/jEC8HySvDwISUdSg8iqChOB9kMRsiM1RCnIFiA0173M/zixvJjq0LgU8PEEReSGIdmjRsowiszR81MkyDBg4FJo/search%20results%20layout-FhY.png
  3. Click Apply to apply your changes.
  4. Click Save to save changes to the page.
When searching for members using the simple search, only those columns you choose here will be searched. Information stored for a contact but not displayed on the screen cannot be used to find matching members.

For each column, you can also specify the column heading and control the column width.

The first field of the first column will automatically appear as a link to the member's public profile page.

Controlling search options

To control how visitors can search the member directory, enable or disable the following options under Search options within the member directory gadget settings.

Enable quick filtering in simple search
Allows visitors to filter the member list by selecting a particular field value. https://cdn.elev.io/file/uploads/jEC8HySvDwISUdSg8iqChOB9kMRsiM1RCnIFiA0173M/S79suhBKRCVRrQfbnU8WLx-CMrB5949nx2DLDIElVic/browsing%20member%20directory-ZqQ.png

When you enable this option, you can choose up to 4 contact or membership fields – multiple choice, radio buttons, and dropdown field types only – for the visitor to use to filter the list.

https://cdn.elev.io/file/uploads/jEC8HySvDwISUdSg8iqChOB9kMRsiM1RCnIFiA0173M/6LiVv7iTklrWiAsQoVTSwt4Ag6UZYib_GrOLD27xfr8/membership%20fields%20for%20browsing-W9g.png

Enable advanced search
Controls whether an Advanced search option is available from the member directory.

https://cdn.elev.io/file/uploads/jEC8HySvDwISUdSg8iqChOB9kMRsiM1RCnIFiA0173M/C7jSDj_YQzP2HcbvsYArzryfyTYpEWhVQimui0rq8nM/advanced member search option-akw.png

If the advanced search option is enabled, you can choose the fields to be available for visitors to search by.
https://cdn.elev.io/file/uploads/jEC8HySvDwISUdSg8iqChOB9kMRsiM1RCnIFiA0173M/Z58youzn8IXkUNxfYpEgmPCwTJWkk6zcjYOieNfoPS8/search%20member%20search%20fields-Iwo.png

Show advanced search by default
Choose whether the member directory is initially displayed with advanced search fields rather than a link to the advanced search function. https://cdn.elev.io/file/uploads/jEC8HySvDwISUdSg8iqChOB9kMRsiM1RCnIFiA0173M/xzcyCAOVgO5FqElIlha-GGlUhAR54hW8WOgDbUMoycc/advanced%20member%20directory%20search-o5I.png

Other settings

The following settings are also available for member directory gadgets:

Margins
The amount of space – in pixels – that appears outside the gadget. You can set top, bottom, left, and right margins separately.

HTML ID
A unique identifier by which the gadget can be referenced within custom CSS or JavaScript code. The identifier is automatically generated but can be replaced with a more readable or memorable one (e.g. MyMemberDirectoryGadget).

CSS class
The name of a CSS class defined on the CSS customization screen.

Inline style
CSS code to control the behavior or appearance of the gadget. For example, you could enter width: 250px; to control the gadget width.

Adding a title and description

You can add a title and description for a member directory by inserting a content gadget ahead of the member directory gadget.

Within the content gadget, you can format the title and description using text styles.

https://cdn.elev.io/file/uploads/jEC8HySvDwISUdSg8iqChOB9kMRsiM1RCnIFiA0173M/KN0aSL5qVmUVEUmPjyI-t7-ms2nbIi4CSqmj3D7Qt9k/content plus member directory gadget-Vww.png

For more information on inserting text and using text styles, see Using the content editor.

Changing colors and fonts

You can change the colors and text styles used on your member directory from the Colors and styles screen.

For more advanced fine-tuning, you can use CSS customization and theme overrides.

For member directory gadgets, you can modify the following elements from the Colors and styles screen:

Filter field name

  • General formatting or Typography > Text/Normal

Filter field values

  • General formatting or Typography > Text/Normal, Link

"Advanced search/Simple search"

  • General formatting or Typography > Text/Normal, Link

Search box

  • General formatting or Typography > Text/Normal

Directory headings

  • General formatting or Typography > Text/Normal
    (Blueprint, Nature, Memo, Glass, Keynote, Notebook, Aurora themes)
  • Table > Header
    (Business Casual, Fiesta, and Granite themes)
  • Table > Column headings
    (Bookshelf, Building Blocks, Clean Lines, Dark Impact, Firma, Homestead, Kaleidoscope, Showcase, Skyline, Terra, Tinted Tiles, Treehouse, Whiteboard, White Space themes)

Directory entries

  • General formatting or Typography > Text/Normal
  • Table> Table row
    (Nature, Memo, Glass, Keynote, Notebook, Aurora themes)

Public profile links

  • General formatting or Typography > Link
  • Table > Table row, Table links
    (except for Nature, Memo, Glass, Keynote, Notebook, Aurora themes)

Advanced search labels

  • General formatting or Typography > Text
  • Form > Label(s)
    (except for Nature, Memo, Glass, Keynote, Notebook, Aurora themes)
  • Form > Text
    (Nature, Memo, Glass, Keynote, Notebook, Aurora themes)

Advanced search values

  • General formatting or Typography > Text
  • Form >Option title
    (except for Nature, Memo, Glass, Keynote, Notebook, Aurora themes)
  • Form > Text
    (Nature, Memo, Glass, Keynote, Notebook, Aurora themes)

Any changes you make will be applied to other gadgets that use the same settings.

Privacy options

Both members and site administrators can control the kind of information exposed to the public through the member directory. Members can control whether their profile is viewable by others, and if so, which fields are viewable by members and non-members. Members who have set their profiles to private will not appear in the member directory at all. (For more information, see Member privacy settings.)

Administrators can control which fields appear in the member database, and which of these are viewable by members and non-members.

Displaying email addresses within a member directory on a publicly accessible page can expose those email addresses to spammers and scammers.

Troubleshooting

Selected fields not appearing in directory

If the fields you have selected within the Search results layout section are not appearing in your member directory, check the following:

  • the access settings for the selected field(s)
  • the member privacy settings for the field(s)

Members not sorted by selected sorting field

If the members in the directory aren't being sorted by the sorting field you chose, check the member privacy settings for that field. It needs to be set to Anybody to work as a sorting field. If you want to restrict access to the field, you can restrict access within its field settings, but only after checking the field's privacy settings (since privacy settings are not displayed for admin-only fields).

Member directory not sorting in the chosen order

Sometimes when you set your member directory to sort by a particular order – say, alphabetical order – it stills displays members in random order. To fix this, change the sorting order to anything else, save your changes, then go back and set the order to your desired option. Once you save this change, the member directory should sort members in the order you chose.

Members not appearing in member directory

To be listed in the member directory the following conditions must apply:

  • Member must be in active (or pending renewal) status.
  • Member has agreed to show their profile to others (see Member privacy settings).
  • The member belongs to one of the membership levels you have selected to appear in that directory gadget. (See Controlling who appears in the directory.)

Remember that you can only search for information that appears on your membership directory, so if you are not displaying the membership level, you will not be able to find members by entering their levels in the search box.