alexblicharz/staff-list

Wordpress plugin to list the staff / members of a business or organization on a website.

staff-list's Issues

Create Staff List Icon

We should really create an icon for the staff list custom post type. Keep in mind that on small screens the WordPress Navigation is icon only so it is identical to the posts icon.

Here's the current icon:

Here's what the menu looks like shrunk down:

As you can see there are actually three pin icons! One belongs to the default posts, one belongs to this plugin, and one belongs to a custom post type specific to MCL.

Add Clearfix Class

After discussing w/ Alex the cf class I found out it was a clearfix. We may as well keep that in there but just make it more obvious to users what the class if for. We will also obviously need to include it in the plugin and not the theme.

Remove Theme Specific Styling

There is a ton of theme specific styling in the stylesheet. We should remove the specific things like height: x;, float: left;, etc and leave that up to the theme.

I suppose it most likely wont hurt to keep a couple of base styles like list-style: none; that 99% of themes will use anyway.

Add Description Field

We should add an optional Description field using the rich text editor. This will work great for team pages where they write a paragraph or two about the employee.

Change "Enter Title Here" Placeholder Text

The placeholder text for Title field is Enter Title Here which is confusing because just below it is another title field.

We should be more specific. The top one should probably be Name with placeholder text Enter name here and the bottom one we can leave as Title.

Create Semantic Plugin File Name

From the Writing a Plugin page in the WordPress Codex:

The next step is to create a PHP file with a name derived from your chosen Plugin name. For instance, if your Plugin will be called "Fabulous Functionality", you might call your PHP file fabulous-functionality.php. Again, try to choose a unique name. People who install your Plugin will be putting this PHP file into the WordPress Plugins directory in their installation (usually wp-content/plugins/), so no two Plugins they are using can have the same PHP file name.

Another option is to split your Plugin into multiple files. Your WordPress Plugin must have at least one PHP file; it could also contain JavaScript files, CSS files, image files, language files, etc. If there are multiple files, pick a unique name for a directory and a name of your choice (usually the same) for the main PHP file of your Plugin, such as fabulous-functionality and fabulous-functionality.php

To help other developers and users it is a good idea to rename the main plugin file to something more semantic like staff-list.php.

Create Uniform Spacing

Instead of having a mix of spaces and tabs it is usually a good idea to just choose one and stick with it. WordPress recommends tabs so that's what we should do.

You can see the mix of spaces and tabs in this screenshot from Sublime Text 2:

Change the Readme.md to Readme.txt for WordPress

Add editor interface button to add a staff list to editor area

Add a button to the editor toolbar to insert a staff list block. This block would also have 2 drop downs. One to choose the department and the other to choose the way to list it.

Show staff member photo and department on the staff list in the Admin area

Use Stylesheets Instead of Inline Styles

Inline styles work but it is probably a better idea to include style sheets that can be cached.

Add options area to the backend admin area

Add the ability to add or remove fields that the user may or may not have a use for. For example add in a on/off switch for the user phone number.

Print Shortcode in Correct Place Within the Content

Right now the staff list always appears at the top of the page even though the shortcode may be in the center of the page. This should be corrected so that the shortcode prints out where it is placed in the content.

Add Template System

We should add a templating system so that we can easily modify the template layout on any given theme.