Getting Started with Our Team

Our Team is a free plugin for displaying team members on your website.

Note: This product and its documentation has not been updated in 2+ years, and we do not provide support for it. Use at your own risk.

Installation ↑ Back to top

To install, go to WordPress Admin in Plugins > Add New.

After installation, a new menu called Team Members appears.

Screen Shot 2013-11-04 at 20.18.04

Adding a Team Member ↑ Back to top

To add a new team member, go to Team Members > Add New:

  1. Add a team members name in the title field.
  2. Add a biography in the post editor.
  3. Add a Gravatar e-mail in the Team Member Details panel. Setting a Featured Image overrides the Gravatar image.
  4. Add a role in the Team Member Details panel.
  5. Add a URL in the Team Member Details panel.
  6. Add a contact email for the Team Member. This outputs a direct link to email the team member on the frontend.
  7. Add a telephone number for the Team Member. This outputs a direct link to phone the team member on the frontend.
  8. Add a Twitter username in the Team Member Details panel.
  9. Optionally map a team member to a WordPress user on the existing web site. If the mapped user has added a biography on their profile page, this outputs on the frontend along with a link to that user’s post archive.
  10. Click Publish.

Instead of Gravatar, you can add an image via the Featured Image panel.

Usage ↑ Back to top

You have three options for displaying your team members. Insert them with: a shortcode, a widget or directly into a PHP template file or custom plugin.

Widget ↑ Back to top

To add team members as a widget go to: Appearance > Widgets to find the Team Members Widget. You can modify the following settings:

Screen Shot 2013-11-04 at 20.22.01

Shortcode ↑ Back to top

To insert team members into a post or page with a shortcode, use this example as a guide:

[woothemes_our_team limit="10" size="100"]

You can find all available parameters listed below and include them in your shortcode, if desired.

From version 1.4.0 of Our Team, you can use the Admin help tab to find shortcode arguments.

The Our Team shortcode help tab.
The Our Team shortcode help tab.
Note: You do not need to wrap the parameter for the shortcode in quotes. However, you should wrap the value in quotes. Use the example above as a guide.

PHP ↑ Back to top

To display your team members via a theme or a custom plugin, use the following code:

<?php do_action( 'woothemes_our_team' ); ?>

Additional Parameters ↑ Back to top

To add arguments, use any of the following with syntax provided below:

  • ‘limit’ => 5 (the maximum number of items to display)
  • ‘per_row’ => 3 (the number of items to display per row)
  • ‘orderby’ => ‘menu_order’ (how to order the items – accepts all default WordPress ordering options)
  • ‘order’ => ‘DESC’ (the order direction)
  • ‘id’ => 0 (display a specific item)
  • ‘display_author’ => true (whether or not to display the author information)
  • ‘display_additional’ => false (global toggle for displaying additional information such as social media account, address, etc.)
  • ‘display_avatar’ => true (whether or not to display the author avatar)
  • ‘display_url’ => true (whether or not to display the URL information)
  • ‘display_role’ => true (whether or not to display the team members role)
  • ‘display_twitter’ => true (whether or not to display a link to the team members Twitter profile)
  • ‘display_author_archive’ => true (display the team members author archive link if specified)
  • ‘contact_email’ => true (display the team members contact email)
  • ‘tel’ => true (display the team members telephone number)
  • ‘effect’ => ‘fade’ (options: ‘fade’, ‘none’)
  • ‘pagination’ => false (display pagination at the of the list
  • ‘echo’ => true (whether to display or return the data – useful with the template tag)
  • ‘size’ => 50 (the pixel dimensions of the image)
  • ‘title’ => ” (an optional title)
  • ‘before’ => ‘<div>’ (the starting HTML, wrapping the team members)
  • ‘after’ => ‘</div>’ (the ending HTML, wrapping the team members)
  • ‘before_title’ => ‘<h2>’ (the starting HTML, wrapping the title)
  • ‘after_title’ => ‘</h2>’ (the ending HTML, wrapping the title)
  • ‘category’ => 0 (the ID/slug of the category to filter by)

Options for the “orderby” parameter are:

  • ‘none’
  • ‘ID’
  • ‘title’
  • ‘date’
  • ‘menu_order’
<?php do_action( 'woothemes_our_team', array( 'limit' => 10, 'display_role' => false ) ); ?>

The same arguments apply to the shortcode, which is [woothemes_our_team], and the template tag, which is <?php woothemes_our_team(); ?>.

Usage Examples

Adjusting the limit and image dimension using arguments in the three possible methods:

do_action() call:

<?php do_action( 'woothemes_our_team', array( 'limit' => 10, 'size' => 100 ) ); ?>

woothemes_our_team() template tag:

<?php woothemes_our_team( array( 'limit' => 10, 'size' => 100 ) ); ?>

FAQ ↑ Back to top

The plugin looks unstyled when I activate it. Why? ↑ Back to top

Our Team is a lean plugin that aims to be as clean and clear as possible. We have not loaded preset CSS styling to allow full control over the styling within your theme or child theme.

We have a basic tutorial that helps you get started with styling by applying layout to the team member output.

I do not need the ‘Role’ field, can I disable that? ↑ Back to top

Yes. In fact you can disable all default fields individually. To disable the role field add:

add_filter( 'woothemes_our_team_member_role', '__return_false' );

In your theme’s functions.php file, replace ‘_role’ with ‘_url’, or ‘_twitter’ (for example) to disable other fields.

I need to add another field, can I do it without touching core files? ↑ Back to top

Yes. To add a new field in the backend, add the following to your theme’s functions.php file:

add_filter( 'woothemes_our_team_member_fields', 'woothemes_our_team_my_new_fields' );
function woothemes_our_team_my_new_fields( $fields ) {
    $fields['misc'] = array(
        'name' => __( 'Misc Detail', 'woothemes-our-team' ),
        'description' => __( 'Some miscellaneous detail', 'woothemes-our-team' ),
        'type' => 'text',
        'default' => '',
        'section' => 'info'
    );
    return $fields;
}

Then to display the contents of that field on the frontend, add:

add_filter( 'woothemes_our_team_member_fields_display', 'woothemes_our_team_my_new_fields_display' );
function woothemes_our_team_my_new_fields_display( $member_fields ) {
    global $post;
    if ( '' != $post->misc ) {
        $member_fields .= '<li class="misc">' . $post->misc . '</li><!--/.misc-->' . "\n";
    }
    return $member_fields;
}

How do I contribute? ↑ Back to top

We encourage everyone to contribute their ideas, thoughts and code snippets. This can be done by forking the repository over at GitHub.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top