Article Contents Related Articles Tags
  • No tags found.
Was This Helpful? Last Updated
  • 2013/03/31

Public User Directory

The program allows you to display a public list of all of your members directly on your website. Each member listed on the directory also has a "profile" generated for them which can be customized using the program's templates. Consider this as a "directory of members".

Location

The public list can be found at:

  • http://www.yoursite.com/members/list.php

Activating the Feature

The feature is active by default. You can determine whether a user will have to be logged in or not to view the list using the User List: Require users be logged? option.

Templates

  • Listings page: "Templates > HTML Templates > List Users"
  • Profile page: "Templates > HTML Templates > List Users: View User"

Settings

All settings for this list are located at "Settings » User Control Panel Options".

SettingPurpose
User List: Require users be logged?If set to yes, users will need to be logged into an account to view the user list.
User List: Sort ByThe case sensitive field name that will be used as the basis for sorting the list.

Templates

The user list is controlled by several templates. Note that any custom field caller tag can be used on these templates to display a user's information.

TemplatePurpose
List UsersThe primary user list. Displays all user entries based on the "List Users: Entry" template.
List Users: EntryThis is a sub-template of "List Users". This template will be used to generate and entry for each user on the list.
List Users: View UserThis is the full client listing page. Generally, users click the link on the "List Users: Entry" template to arrive at this location.

Making the List Searchable

You can create a custom search page for the member's list that allows other members to search based on any custom field in the database. Here is an example that allows users to search by zip code, city, or state (note that searches are inclusive, meaning that if a ZIP and city are submitted, users will need to match both to be considered a result):

<form action="/members/list_search.php" method="post" />
<h1>Member Directory Search</h1>

<label>Zip</label>
<input type="text" name="zip" />

<label>City</label>
<input type="text" name="city" />

<label>State</label>
<select name="state" id="state">
<option value="" selected="selected">Please select...</option>
<option value=""></option>
<option value="">STATES</option>
<option value="AL">Alabama</option>
<option value="AK">Alaska</option>
<option value="AZ">Arizona</option>
<option value="AR">Arkansas</option>
<option value="CA">California</option>
<option value="CO">Colorado</option>
<option value="CT">Connecticut</option>
<option value="DE">Delaware</option>
<option value="DC">District of Columbia</option>
<option value="FL">Florida</option>
<option value="GA">Georgia</option>
<option value="HI">Hawaii</option>
<option value="ID">Idaho</option>
<option value="IL">Illinois</option>
<option value="IN">Indiana</option>
<option value="IA">Iowa</option>
<option value="KS">Kansas</option>
<option value="KY">Kentucky</option>
<option value="LA">Louisiana</option>
<option value="ME">Maine</option>
<option value="MD">Maryland</option>
<option value="MA">Massachusetts</option>
<option value="MI">Michigan</option>
<option value="MN">Minnesota</option>
<option value="MS">Mississippi</option>
<option value="MO">Missouri</option>
<option value="MT">Montana</option>
<option value="NE">Nebraska</option>
<option value="NV">Nevada</option>
<option value="NH">New Hampshire</option>
<option value="NJ">New Jersey</option>
<option value="NM">New Mexico</option>
<option value="NY">New York</option>
<option value="NC">North Carolina</option>
<option value="ND">North Dakota</option>
<option value="OH">Ohio</option>
<option value="OK">Oklahoma</option>
<option value="OR">Oregon</option>
<option value="PA">Pennsylvania</option>
<option value="RI">Rhode Island</option>
<option value="SC">South Carolina</option>
<option value="SD">South Dakota</option>
<option value="TN">Tennessee</option>
<option value="TX">Texas</option>
<option value="UT">Utah</option>
<option value="VT">Vermont</option>
<option value="VA">Virginia</option>
<option value="WA">Washington</option>
<option value="DC">Washington D.C.</option>
<option value="WV">West Virginia</option>
<option value="WI">Wisconsin</option>
<option value="WY">Wyoming</option>
<option value=""></option>
<option value="">PROVINCES</option>
<option value="AB">Alberta</option>
<option value="BC">British Columbia</option>
<option value="MB">Manitoba</option>
<option value="NB">New Brunswick</option>
<option value="NF">New Foundland</option>
<option value="NT">Northwest Territories</option>
<option value="NS">Nova Scotia</option>
<option value="ON">Ontario</option>
<option value="PI">Prince Edward Island</option>
<option value="PQ">Quebec</option>
<option value="SA">Saskatchewan</option>
<option value="YT">Yukon Territory</option>
<option value=""></option>
<option value="">International</option>
<option value="INT">Outside the US and Canada</option>
</select>

<input type="submit" value="Search" />
</form>

There are no built-in templates for this, so you will need to manually create and publish this page to your website.

To limit confusion with states, we recommend using the standardized state dropdown found here. For the above form you will need the "Short Form State List".