Nice Team — NiceThemes

About this plugin↑ Back to Top

Nice Team displays information about your staff members in a clean, responsive and beautiful way. You can show staff members using a shortcode, widgets or template tags (PHP functions).

This plugin is fully integrated with WordPress. It makes use of its native architecture to show team members, and includes a huge set of hooks, so you can customize it in any way you need.

Nice Team works right out of the box with any theme.

Installation↑ Back to Top

Here we cover the basics of plugin installation. You can read more about the subject in this article.

Using The WordPress Dashboard

Navigate to the “Add New” link in the plugins dashboard.
Search for “Nice Team”.
Click “Install Now”.
Activate the plugin on the Plugin dashboard.

Uploading in WordPress Dashboard

Navigate to the “Add New” in the plugins dashboard.
Navigate to the “Upload” area.
Select nice-team.zip from your computer.
Click “Install Now”.
Activate the plugin in the Plugin dashboard.

Using FTP

Download nice-team.zip.
Extract the nice-team directory to your computer.
Upload the nice-team directory to the /wp-content/plugins/ directory.
Activate the plugin in the Plugin dashboard.

Setting up↑ Back to Top

Once you installed and activated the plugin, you can go to Team > Settings and tweak the options there.

Those settings will also be used as the default ones for the shortcode and template tag when you’re not specifying any values for them.

Shortcode↑ Back to Top

The basic usage of the shortcode is just [team]. That will display a list of your members using the settings you entered in Team > Settings.

However, you can specify values for the shortcode using the following fields:

id: Numeric ID of a single member (in case you want to display just one).
columns: The number of columns to be displayed in a staff gallery.
limit: The number of members to be displayed in a staff gallery. A value of zero means nothing will be displayed. Use -1 for no limit.
image_size: Size (in pixels) for the member’s image.
orderby: The ordering criteria that will be used to display your members. Accepted values: ID, title, menu_order, date, random.
order: The sorting criteria that will be used to display your members. Accepted values: asc (ascendant), desc (descendant).
category: Comma-separated numeric IDs of staff categories (teams) that you want to display. A value of zero means that all categories will be considered.
exclude_category: Comma-separated numeric IDs of staff categories (teams) that you want to exclude. A value of zero means that no categories will be excluded.
include_children: Choose if you want to show members of sub-categories (or sub-teams) in the list. Accepted values: 1 (show), 0 (hide).
member: Show or hide the name of the member. Accepted values: 1 (show), 0 (hide).
avatar: Show or hide the image of the member. Accepted values: 1 (show), 0 (hide).
url: Show or hide the link to the member’s website. Accepted values: 1 (show), 0 (hide).
email: Show or hide the member’s email. Accepted values: 1 (show), 0 (hide).
twitter: Show or hide the link to the member’s Twitter profile. Accepted values: 1 (show), 0 (hide).
facebook: Show or hide the link to the member’s Facebook profile. Accepted values: 1 (show), 0 (hide).
linkedin: Show or hide the link to the member’s LinkedIn profile. Accepted values: 1 (show), 0 (hide).
avoidcss: Choose if you want to remove the default styles for the current list of members. Accepted values: 1 (avoid styles), 0 (not avoid styles).

If any of these values is not declared explicitly, the default value will be the one set in Staff > Settings.

A typical usage of the shortcode with these fields would be the following:

[staff columns="2" limit="5" orderby="date" order="asc" category="20,34"]

Template tag (PHP function)↑ Back to Top

You can include members in your own templates by using our nice_team() function. This is a very basic usage example:

<?php
if ( function_exists( 'nice_team' ) ) :
    nice_team();
endif;
?>

As it happens with the shortcode, that code snippet will display a list of your members using the settings you entered in Staff > Settings. However, you can give the function an array of options with specific values on how to show the list of members:

id: Numeric ID of a single member (in case you want to display just one).
columns: The number of columns to be displayed in a staff gallery.
limit: The number of members to be displayed in a staff gallery. A value of zero means nothing will be displayed. Use -1 for no limit.
image_size: Size (in pixels) for the member’s image.
orderby: The ordering criteria that will be used to display your members. Accepted values: ID, title, menu_order, date, random.
order: The sorting criteria that will be used to display your members. Accepted values: asc (ascendant), desc (descendant).
category: Comma-separated numeric IDs of staff categories (teams) that you want to display. A value of zero means that all categories will be considered.
exclude_category: Comma-separated numeric IDs of staff categories (teams) that you want to exclude. A value of zero means that no categories will be excluded.
include_children: Choose if you want to show members of sub-categories (or sub-teams) in the list. Accepted values: 1 (show), 0 (hide).
member: Show or hide the name of the member. Accepted values: 1 (show), 0 (hide).
avatar: Show or hide the image of the member. Accepted values: 1 (show), 0 (hide).
url: Show or hide the link to the member’s website. Accepted values: 1 (show), 0 (hide).
email: Show or hide the member’s email. Accepted values: 1 (show), 0 (hide).
twitter: Show or hide the link to the member’s Twitter profile. Accepted values: 1 (show), 0 (hide).
facebook: Show or hide the link to the member’s Facebook profile. Accepted values: 1 (show), 0 (hide).
linkedin: Show or hide the link to the member’s LinkedIn profile. Accepted values: 1 (show), 0 (hide).
avoidcss: Choose if you want to remove the default styles for the current list of members. Accepted values: 1 (avoid styles), 0 (not avoid styles).

If any of these values is not declared explicitly, the default value will be the one set in Staff > Settings.

Using these options, you can have something like this in your code:

<?php
if ( function_exists( 'nice_team' ) ) :
    nice_team( array(
        'columns'  => 2,
        'limit'    => 5,
        'orderby'  => 'date',
        'order'    => 'asc',
        'category' => '20,32',
    ) );
endif;
?>

Changing the slug↑ Back to Top

By default, the links to your members will look something like http://my-site.me/team/member-name. If you want to change that team base to something more fit to your needs, you can do so going to Team > Settings > Advanced, and modifying the “Member Slug” option.

Using custom CSS↑ Back to Top

You can load a custom stylesheet by using wp_enqueue_script() and adding your custom CSS to your own file. However, if you really want to get rid of the default CSS of Nice Team, so you can avoid overriding our styles, you can check the “Avoid Plugin CSS” option in Team > Settings.

Using custom templates↑ Back to Top

Inside wp-content/plugins/nice-team/public/templates you will find the following default templates:

single-member: The default template for all single staff members.
team-category: The default template for a team’s index.
team-archive: The default template for the index of the team_member custom post type.

All you need to do is copy these files to wp-content/themes/my-theme/team, and modify them to your own needs.

If you want more specific templates, you can take a look at the Template Hierarchy article in the Codex.