Name Directory

Description

This plugin adds name/term directories to your WordPress installation. They are like glossaries. The output on your website is like a glossary/index. I recommend you to take a look at the screenshots, they illustrate more than words.

The Name Directory plugin was orginally developed for ParkietenVilla.nl to show a directory of names to name your budgies.

A name directory is a directory that contains entries with the following properties:

  • name
  • description
  • submitter

You can create multiple directories with this plugin. Every directory can be embedded with a very simple shortcode which you can just copy-and-paste in your own pages and posts. Every directory has a few configuration options that customize the layout and functionality of the directory:

  • Show/Hide title
  • Show/Hide description
  • Show/Hide suggestion form
  • Show/Hide submitter name
  • Show/Hide search function (searches names/titles and description)
  • Show/Hide a horizontal rule between the entries
  • Show/Hide all entries when the user has not chosen an index-letter yet
  • Show/Hide the newest entries (and choose an amount of newest entries to show)
  • Choose the amount of columns to display
  • Whether to jump to the name directory when a visitor is using the search box (for onepage websites)
  • When you embed a directory, you can configure it to start with a letter of your choosing. E.g.: start on letter J.

The administration view of this plugin has the familiar look and feel of (the rest of) the WordPress Administration panel. I have done my best to enable some AJAX-features in the administration panel, so you can work efficiently while adding new entries.

Since v1.7 and v1.8, import and export functionality is also supported through .csv-files.

Current supported languages:

Do you want Name Directory to be available in your language? Please help us translate. You can translate directly by going to https://translate.wordpress.org/projects/wp-plugins/name-directory, login with your WordPress account and click Select your language and click ‘Contribute Translation’.

Screenshots

  • The output of a name directory on a standard WordPress website. It's a full-featured name directory (search form, index links, descriptions and submit button)
  • Overview of all the name directories in the WordPress Administration screen for this plugin
  • List of all names in the selected directory and the 'Add name' form
  • Settings screen for a name directory
  • Where to find the Name Directory plugin settings page
  • Another example of the plugin on a website

Installation

Displaying a directory on your 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.

Installing the plugin

Installation is very easy. You can just download this plugin through the Plugin Finder in your WordPress Administration Panel.

If you download the zip-file, installation isn’t that difficult either:

  1. Unzip the file which results into a directory called name-directory
  2. Upload that directory to the /wp-content/plugins/ directory
  3. Activate the plugin through the ‘Plugins’ menu in WordPress
  4. Create a new name directory and add some names
  5. Copy the shortcode and paste it into a post or page to show it on your website

FAQ

Installation Instructions

Displaying a directory on your 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.

Installing the plugin

Installation is very easy. You can just download this plugin through the Plugin Finder in your WordPress Administration Panel.

If you download the zip-file, installation isn’t that difficult either:

  1. Unzip the file which results into a directory called name-directory
  2. Upload that directory to the /wp-content/plugins/ directory
  3. Activate the plugin through the ‘Plugins’ menu in WordPress
  4. Create a new name directory and add some names
  5. Copy the shortcode and paste it into a post or page to show it on your website
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 you install this plugin or directory for me?

Maybe, send me an email to see if we can work this out.

Is there a bulk-add or 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 screenshot for a settings-example https://ps.w.org/name-directory/assets/screenshot-2.png
  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 file at https://ps.w.org/name-directory/assets/name-directory-import-example.csv
If you need any help, contact me on the 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 screenshot for a settings-example https://ps.w.org/name-directory/assets/screenshot-2.png
  4. Click ‘Export’
  5. On the new page click the button and your .csv-file will be downloaded
Can I make the text bigger or another color?

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-search-input-box: Search input box
  • #name-directory-search-input-button: Search button
  • .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
How can I contact you?

You can through this plugin information page or in the Support forums.

Reviews

Wonderful Plugin For Genealogy Lists and Perfect Support 🙂

I needed a plugin for a lot of lists that are used in genealogy and this fit the bill perfectly as I could create the lists, or better yet, use a csv file and import them, which saves alot of time 🙂

Then I had an issue of only 3 records of X number being imported. Posting on the support forum I got that issue solved in a timely manner. (Problem was strange characters appearing that I could not see Support thread here)

A week later I realised that duplicates were not getting added, and in genealogy lists you need to have all of the references. For example if the lists were only surnames and a Smith was in the London births list, a Smith was in the New York marriage lists and a Smith was in the Paris burials list all must be there as they could be different people.

As I had a good result with my other issue I posted again and this time, while the plugin did not have a facility to do that, I got a custom solution! Now how often does that happen? 😀 (Support thread here)

So if you are looking for an plugin to create lists for genealogy, or any other type of list for that matter, do not hesitate to get this one, knowing that if you have problems or issues, help is close at hand.

Thank you so much @jeroenpeters1986 for your wonderful plugin and your perfect support – it is so very much appreciated 🙂

Excellent Support!

Had a slight issue using this plug in on a large non-profit site I’ve been working on. Jeroen responded to my issues quickly, and dug down and spent time to not only find the issue but fix it quickly, push out an update, and it now works just as we needed it to.

My clients are very happy. I can’t say enough about the level of support. It’s not often that developers take the time to help they way that Jeroen has.

Highly recommend not just the plug in, but as a developer as well.

Thanks again Jeroen!

Something wrong with $wpdb

I cannot test your plugin, because something goes wrong with $wpdb variable and new names cannot be inserted.
But for idea I give 5 stars.
I hope that this is a little bug and you will fix that in next updates.
Looking forward to new updates!

Read all 31 reviews

Contributors & Developers

“Name Directory” is open source software. The following people have contributed to this plugin.

Contributors

“Name Directory” has been translated into 4 locales. Thank you to the translators for their contributions.

Translate “Name Directory” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.9.1

  • Compatible with WordPress 4.9.1
  • Ability to limit the amount of words in the description, shown on the frontend of the website. You can manage this in the directory settings. Names with a description which exceeds the setting, are limited with a “Show more” link.
  • Optimized code, rewritten the directory options screen to prevent lots of duplicate code and make it easier for myself to maintain
  • Added some more descriptions to what the directory settings do

1.9.0

  • You can now use words that start with non-latin characters (like Chinese, Arabic, Nordic/Danish, etc)
  • Updated Readme, which includes the Description, Changelog and the Frequently Asked Questions
  • Updated php code to follow development guidelines

1.8.2

  • Compatible with WordPress 4.9 final
  • Update php code to follow development guidelines

1.8.1

  • Compatible with WordPress 4.9b3
  • Removed old translation file, since Name Directory uses the WordPress translation platform
  • Moved an admin add_action hook
  • Updated Export to work with Javascript, possible denying Internet Explorer 9 (and lower) users export
  • Fixed compatibility with AJAX Front-end plugins
  • WordPress moves all divs with class ‘updated’ to the top of the page, which isn’t very handy for the Add-Name form, which is on the bottom of the page. Created a workaround, all success-messages will be displayed above the add-form again.

1.8

  • Added export function, export your name directory to .csv file. Offcourse, it’s compatible with the upload function

1.7.15

  • WND-46: Created a new option the admin for jumping to the searchbox on the front-end, useful on long page or onepage website
  • Support bumped to WordPress 4.8.2

1.7.14

  • WND-45: Better multisite support

1.7.13

  • WND-44: Front-end submit form now requires at least a name

1.7.12

  • WND-42: Option to use latest was broken, treated as L

1.7.11

  • WND-41: Verified translation from translate.wordpress.org
  • WND-40: Fixed bug there selecting only names that start with numbers, everything was shown

1.7.10

  • WND-39: Added name_directory_active class on index to indicate which character was activated
  • WND-39: Added name_directory_empty class on index to indicate there are no entries for a character
  • Started working with the Stable tag: https://wordpress.org/plugins/about/svn/#task-3
  • Removed translations so we can benefit from translate.wordpress.org 🙂
  • Do you want to help me translate this plugin in your own language? Let me know in the support forums! I will credit you!

1.7.9

  • WND-38: Database structure adjust

1.7.8

  • WND-35: Fixed CVS import
  • WND-36: Tested WP 4.4.2

1.7.7

  • WND-24: Fixed Possible XSS vulnerability

1.7.6

  • WordPress 4.3 compatible
  • Added Arabic translation (Thanks Ahmad from http://www.ams.ly)
  • Updated some PHP-code
  • Prevent possible function collisions

1.7.5

  • Updated Norwegian translation (Thanks Mikael!)
  • Some improvements for English language
  • Synced .pot and .po files

1.7.4

  • WND-25: Send e-mailnotification to WordPress admin when a new name is submitted
  • Generated new .pot file and synced all .po files

1.7.3

  • Ordering enhancements
  • Generated new .pot file and synced all .po files

1.7.2

  • WND-32: Show X latest (most recent) names
  • Updated Dutch Translation

1.7.1

  • Added Norwegian translation thanks to Mikael
  • WND-31: Search for searchterm in description (but only if show_description is enabled)
  • Moved common code to helpers, preparing for better code

1.7

  • WND-11: Import names and descriptions by csv-upload, find this option at the manage-screen
  • WND-24: Toggle published-status for name (easily show or hide names)
  • Name in WordPress settings menu is now “Name Directory” instead of “Name Directory Plugin”
  • Extended FAQ
  • Code improvements
  • Updated Dutch Translation

1.6.16

  • WND-26 & WND-28: Honour the Show Description setting in frontend

1.6.15

  • Added little spacers in the admin on the Manage names screen
  • Every name on the front-end got an anchor name

1.6.14

  • Added new translation file
  • Updated Dutch translation

1.6.13

  • WND-23: New option to only show letters on the index when there are entries, so A B D E when there is no entry with C
  • Fixed small legacy db-convert bug
  • Gave the admin panel for directory settings some space

1.6.12

  • Expanded FAQ
  • Updated documentation / edited screenshots
  • Updated information displayed at the WordPress Plugin Repository page

1.6.11

  • Search URL’s didn’t function properly
  • Search argument didn’t work together (selected name and input filter)
  • function didn’t work when WordPress was running without SEO tools
  • URL improvements (also tested with Yoast SEO plugin)

1.6.10

  • URLencoded the # sign, so entries starting with a number will show up

1.6.9

  • WND-21: Checked translation strings. Also edited two fussy strings in the Dutch translation
  • WND-22: Fixed wp-admin paths for WP Multisite users

1.6.8

  • WND-17: Added option which let’s the user choose a default starting-character when displaying the name directory. For example: use [namedirectory dir=”X” start_with=”j”] to start with the letter J.
  • WordPress 4.0 compatibility
  • Added Icon to the installer gallery

1.6.7

  • Updated Russion Translation (Thanks to: Rig Kruger http://rodichi.org)

1.6.6

  • Fixed small display bug

1.6.5

  • Showed submitted name

1.6.4

  • Updated French translations
  • Fixed too-many-slashes issue

1.6.3

  • Updated Dutch translations
  • Fixed display bug.
  • The All-link is hidden when you a visitor HAS to choose a letter from the index

1.6

  • Added option ‘Show all names by default’, this can be disabled to hide all entries if a user hasn’t chosen a letter from the index.

1.5.2

  • Fixed bug in CREATE TABLE and backlink in form, thank you very much MerlIAV for the patch!

1.5.1

  • Fixed bug that prevent saving searchform preference in admin

1.5

  • Added search box on front-end (You can enable this in the name-directory settings)
  • Added support for four-column layout
  • Added Russion Translation (Translated by: Rig Kruger http://rodichi.org)

1.4.3

  • Fixed bug which allowed non-published items to be shown

1.4.2

  • Fixed support for Chinese characters
  • Added French Translation (Translated by: Patrick BARDET http://www.web-studio-creation.fr)

1.4.1

  • Fixed sorting issue at the frontend

1.4

  • WND-19: Added support for HTML in the name description

1.3

  • Name lists can now have multiple columns at the frontend
  • Added css in a separate file
  • Added database upgrade module

1.2.1

  • Plugin url’s are now compatible with third party SEO modules

1.2

  • Added support for submission form on the front-end
  • Added possibility for admin to filter on published/unpublished names
  • Rearranged directory overview for admin, overview now shows totals for published/unpublished

1.1

  • Added double name detection

1.0

  • First major public release

0.5

  • First version for private use