RYO Membership Directory Plugin Administrator Manual
Back to Index
The system is supplied with 16 "standard" templates which define how listings appear in your directory. Here's a look and description of each one.
It helps to remember that each directory has three separate “views” which you control:
- The "Directory View" is the initial view seen by a guest. It’s either a list of members or a list of categories that can be clicked to search for members who have selected that category. We normally like to choose a template that used very little space for each member so more members can be displayed on each page. When the initial view is a list of members, the attribute for this is
directoryview
. - The "Search View" is the list of members seen after a search request, either a keyword request or a category click. You may choose the same template as you did for Directory View or, since it is likely you will display fewer members after a search, choose a template that shows a bit more information. The attribute for this is
searchview
. - The "Detail View" is the detailed information displayed about a single member after clicking that members listing in a directory list or search results list. The attribute for this is
detailview
.
As far as WordPress is concerned this all happens on one Page. In practice, that one Page shows a lot of different information.
If you don't like how a directory looks, choose a different template and specify it on the Directory Page. If you can't find a template that's quite what you want, you can edit the templates to suit in Settings, Templates.
On this page you'll see what the standard templates look like.
Personal Name or Company Name?
RYO Member Directory has been produced in several versions. Each version has different standard templates, but they are all similar. The major difference is how names are displayed. That's why it's important to use the most appropriate version. Example:
Name-Based: Here's an example of a template displaying Name first, in bold type, and company name, if any, in lighter type.
Company-Based: This example shows the same member record in a list with Company Name in bold type and individual name in lighter type.
You could edit a template to make a change like this, but it's easier to install the version with the most appropriate standard templates. (If you decide to reinstall with a different version, after you reinstall go to Settings, Templates and scroll to the bottom of the page so you can reset the templates to the new standard templates.)
Name-Based versions normally sort results by Last Name, and Company-Based versions sort by Company Name. That's not a template function, but an attribute of each directory.
Choosing Templates
If you want to choose a different template than the one the system selects for you, you do it by adding attributes to the shortcode that sets up the directory. Here's an example that modifies a basic memberdirectory to use listtemplate2 for the Directory View but leaves the
Search View and Detail View set to the standard templates.
List Templates for Directory Views and Search Views
These are designed member listings. List Templates may be used for Directory Views and Search Views since both represent lists of members.
listtemplate1: Basic Listing
This list template displays brief textual information about a member.
View includes:
- Name and Company.
- Additional name, if any.
- Member status or levels.
listtemplate2: Basic Listing Plus Image or Gravatar
This list template displays brief textual information about a member.
View includes:
- Uploaded image or Gravatar image.
- Name and Company.
- Additional name, if any.
- Member status or levels.
listtemplate3: Name Only
This list template displays member names.
View includes:
- Name or Company, as appropriate.
listtemplate4: Yearbook Style Listing with Larger Image or Gravatar and Short Text
We call this style "Yearbook" because there's a larger image, about the size of a yearbook photp, displayed with key information and descriptive text.
View includes:
- Uploaded image or Gravatar image.
- Name and Company, as applicable.
- Additional name, if any.
- Member status or levels.
- The first 35 words of Profile text.
listtemplate5: Yearbook Style for Classified Directory with ts2 Text
This template looks exactly like listtemplate4 except that instead of displaying Profile text, it normally displays ts2 text.
View includes:
- Uploaded image or Gravatar image.
- Name and Company, as applicable.
- Additional name, if any.
- Member status or levels.
- The first 35 words of ts2 text.
- If ts2 text is not available, Profile text is displayed.
listtemplate6: Short Classified Ad Text Style with shortened ts2 Text
This template displays a Gravatar, plus Name and the first few words of ts2 text to tempt readers into reading the detail listing.
View includes:
- Uploaded image or Gravatar image.
- Name or Company, as applicable.
- First 16 words of ts2 text.
listtemplate7: Yearbook Style for Member Offers with ts5 Text
This template looks exactly like listtemplate4 except that instead of displaying Profile text, it displays ts5 text.
View includes:
- Uploaded image or Gravatar image.
- Name and Company, as applicable.
- Additional name, if any.
- Member status or levels.
- The first 35 words of ts5 text.
listtemplate8: Short Member Offers Ad Text Style with shortened ts5 Text
This template displays a Gravatar, plus Name and the first few words of ts5 text to tempt readers into reading the detail listing.
View includes:
- Uploaded image or Gravatar image.
- Name or Company, as applicable.
- First 16 words of ts5 text.
listtemplate9: Yearbook Style with Board/Directors and adminnotes Text
This template looks exactly like listtemplate4 except that it is arranged to show members who are directors, on a governing board, officers, or members of a key recognition group.
View includes:
- Uploaded image or Gravatar image.
- Office held or position
- Individual's Name and Company, if applicable.
- Admin Notes text.
- If Admin Notes text is not available, Profile text is displayed.
Detail Templates for Detail Views
The three Detail Templates provided look the same but vary by including different "long text" for different directories.
detailtemplate1: Basic Directory Detail View
This detail template displays an image and all key information about the member.
Additional text displayed includes:
- Profile text.
- RSS Feed info, if any.
- Information from Text Select field ts1.
detailtemplate2: Classified Directory Profile with ts2 text
This detail template displays an image and all key information about the member.
Additional text displayed includes:
- ts2 text.
- If there is no ts2 text, Profile text is displayed.
- RSS Feed info, if any.
- Information from Text Select field ts4.
detailtemplate3: Member Offers Page with ts5 text
This detail template displays an image and all key information about the member.
Additional text displayed includes:
- ts5 text.
- RSS Feed info, if any.
- Information from Text Select field ts7.
Featured Member Templates
These templates are used to display a "Featured Member" each day on your home page or other page in your website.
featuredmember1: Featured Member Template #1
This template places a picture on the left, plus a limited amount of member information.
View includes:
- Uploaded image or Gravatar image.
- Name and Company, as applicable.
- Additional name, if any.
- Member status or levels.
- First 35 words of Profile text.
- Two RSS Headlines from the member's blog or website.
featuredmember2: Featured Member Template #2
This template differs from the one above by placing the image on the right.
View includes:
- Uploaded image or Gravatar image.
- Name and Company, as applicable.
- Additional name, if any.
- Member status or levels.
- First 35 words of Profile text.
- Two RSS Headlines from the member's blog or website.
Featured Member History Page Templates
These templates are used to display a "Featured Member" history page listing members who have been featured as "Featured Member" on your website.
featuredhistory1: Featured Member History List Template #1
View includes:
- Date featured.
- Name or Company, as applicable.
featuredhistory2: Featured Member History List Template #2 (with Gravatar)
View includes:
- Date featured.
- Gravatar image.
- Name or Company, as applicable.
Which Templates and Fields work in Which Directory?
Our Standard Directories are compiled using the following chart:
Directory Type | View | Template, Alternate Templates (and Special Fields) |
---|---|---|
memberdirectory | Directory View | listtemplate1, listtemplate2, listtemplate3, listtemplate4 (profile) |
Search View | listtemplate4 (profile), listtemplate1, listtemplate2, listtemplate3 |
|
Detail View | detailtemplate1 (profile, ts1) | |
yearbook | Directory View | listtemplate4 (profile) |
Search View | listtemplate4 (profile) | |
Detail View | detailtemplate1 (profile, ts1) | |
categorysearch | Directory View | (categories--uses ts1) |
Search View | listtemplate4 (profile), listtemplate1, listtemplate2, listtemplate3 |
|
Detail View | detailtemplate1 (profile, ts1) | |
classifieddirectory | Directory View | (categories--uses ts4) |
Search View | listtemplate5 (ts2/profile), listtemplate6 (ts2) | |
Detail View | detailtemplate2 (ts2/profile, ts4) | |
memberoffers | Directory View | listtemplate7 (ts5), listtemplate8 (ts5) (or, if categories--uses ts7) |
Search View | listtemplate7 (ts5), listtemplate8 (ts5) | |
Detail View | detailtemplate3 (ts5, ts7) | |
boarddirectory | Directory View | listtemplate9 (adminnotes, profile) |
Detail View | detailtemplate1 (profile, ts1) | |
featuredmember | View | featuredtemplate1 (profile), featuredtemplate2 (profile) |
Detail View | (Uses Main Directory) | |
featuredhistory | Directory View | featuredhistory1, featuredhistory2 |
Detail View | detailtemplate1 (profile, ts1) | |
Long Text Fields |
Directory Type |
Fields Used |
memberdirectory | profile, ts1 | |
yearbook | profile, ts1 | |
categorysearch | profile, ts1 | |
classifieddirectory | ts2, ts4 | |
memberoffers | ts5, ts7 | |
boarddirectory | adminnotes/profile | |
featuredmember | profile | |
featuredhistory | (none) | |
Left Over/Spare | promo, ts3, ts6 |