Name Directory

About this plugin

Questions

What does the shortcode look like?

The shortcode for this Name Directory plugin is like this:
[namedirectory dir=1]

The 1 in this example is the internal ID of the directory, the rest of the shortcode should always look like this.

I created a directory, how do I show it on my site?

1. Go to the Name Directory settings page
2. Hover over the directory you want to add to the page.
3. A few options should show now, like Delete, Manage and Shortcode – see screenshot https://ps.w.org/name-directory/assets/screenshot-2.png
4. Click ‘Shortcode’, a little textbox will show now.
5. Copy-and-paste the content of the textbox into the page you want the plugin to show up.
6. Save and view the page to see the result.

Can I customize the appearance / styling of the Name Directory?

Yes you can, with CSS. If you know your way around CSS you might already know that you can style elements by their class name or HTML structure.
This plugin was written with styling / CSS in mind. Using the HTML inspector of your favourite browser you should be able to discover the classnames, but here are a few popular classes:

• .name_directory_index: Index links (the letters A-Z)
• .name_directory_name_box > strong: Name / Entry title
• .name_directory_name_box > div: Name / Entry descriptiong
• .name_directory_total: Total count of names / entries
• .name_directory_index > form: Search form
• .name_directory_submit_bottom_link: Link to submit form
• .name_directory_active: Currently active character on index
• .name_directory_empty: Indicates that there a no entries for character
• .name_directory_character_header: Indicates a new starting-letter header
• #name_directory_search_input_box: Search input box
• #name_directory_search_input_button: Search button

Also, I do offer help on styling / CSS if you are willing to make a small donation.
Please contact me at the Support Forums or my website to discuss this.

Is there a bulk-add or csv import in this plugin?

Since v1.7, yes there is! You can import a .csv-file into a directory.

1. Go to the Name Directory settings page
2. Hover over the directory you want to import names into.
3. A few options should show now, like Delete, Manage and Import – see this screenshot for an example
4. Click ‘Import’
5. Select your .csv-file
6. Upload

You can add names, descriptions and submitter entries, just the first column (name) is required. Good to know: the first row is always ignored (they should be headers).
You can download an example import file to take a look at the format.

Might your first try does not work, please use https://www.freefileconvert.com to convert your file into a valid CSV file.
Also, importing works best if you export the files with ‘UTF-8’ character set, ANSI does not always work.

If you need any help, contact me on the Support Forums.

Can I export my directory?

Since v1.8, yes you can! This export is also compatible with the import-functionality offcourse. If you want to export, use the following steps:

1. Go to the Name Directory settings page
2. Hover over the directory you want to export.
3. A few options should show now, like Delete, Manage, Import and also Export – see this screenshot for an example
4. Click ‘Export’
5. On the new page click the button and your .csv-file will be downloaded

Are there demo’s / examples to see the plugin in action?

Yes, every now and then I come across an installed version of the plugin. Here is an incomplete list.

1. Dutch Budgie website – How to name your bird
2. Alabama Orthopaedic Society – Member list
3. Hattem24 Begrippenlijst – Nieuws over Hattem (Dutch local newssite with a glossary)
4. Convertus – Paid Search Terms
5. Venlo’s Waordeboek (Dutch Limburgian Dialect Dictionary)
6. Donegal Member Directory (multiple directories)
7. Prairie Health (multiple columns and icons)
8. International Association of Oil & Gas Producers
9. Coin Collector Blog
10. SBS ShopRI – Vendor List
11. Certficate Holders in Ghana
12. Tuscany Cookie Class Terms

If you see a dead link, would you please let me know?

Can I try the plugin myself before I install it?

Yes, click here for in instant demo-website with Name Directory installed

Can I use HTML in the name description?

Yes, this is possible! Please do be careful to use valid HTML only though.