=== Our Team by WooThemes === Contributors: woothemes, mattyza, jameskoster Donate link: http://woothemes.com/ Tags: teams, team members, profiles, widget, shortcode, template-tag Requires at least: 3.8 Tested up to: 3.8 Stable tag: 1.1.0 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Display team member profiles with descriptions and links to social media using our shortcode, widget or template tag. == Description == "Our Team by WooThemes" is a clean and easy-to-use team profile management system for WordPress. Load in your team members and display their profiles via a shortcode, widget or template tag on your website. Assign team members to a user, allowing team members to manage their own description via the bio on the profile page as well as display a link to their author archive. Looking for a helping hand? [View plugin documentation](http://wordpress.org/plugins/our-team-by-woothemes/other_notes/). Looking to contribute code to this plugin? [Fork the repository over at GitHub](http://github.com/woothemes/our-team/). (submit pull requests to the latest "release-" branch) == Usage == To display your team member profiles via a theme or a custom plugin, please use the following code: `<?php do_action( 'woothemes_our_team' ); ?>` To add arguments to this, please use any of the following arguments, using the syntax provided below: * 'limit' => 5 (the maximum number of items to display) * 'per_row' => 3 (when creating rows, how many items display in a single 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_avatar' => true (whether or not to display the author avatar) * 'display_url' => true (whether or not to display the URL information) * '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 class="widget widget_woothemes_our_team">' (the starting HTML, wrapping the team member profiles) * 'after' => '</div>' (the ending HTML, wrapping the team member profiles) * '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) The various options for the "orderby" parameter are: * 'none' * 'ID' * 'title' * 'date' * 'menu_order' `<?php do_action( 'woothemes_our_team', array( 'limit' => 10, 'display_author' => 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 the 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 ) ); ?>` [woothemes_our_team] shortcode: `[woothemes_our_team limit="10" size="100"]` == Installation == Installing "Our Team by WooThemes" can be done either by searching for "Our Team by WooThemes" via the "Plugins > Add New" screen in your WordPress dashboard, or by using the following steps: 1. Download the plugin via WordPress.org. 1. Upload the ZIP file through the "Plugins > Add New > Upload" screen in your WordPress dashboard. 1. Activate the plugin through the 'Plugins' menu in WordPress 1. Place `<?php do_action( 'woothemes_our_team' ); ?>` in your templates, or use the provided widget or shortcode. == Frequently Asked Questions == = The plugin looks unstyled when I activate it. Why is this? = "Our Team by WooThemes" is a lean plugin that aims to keep it's purpose as clean and clear as possible. Thus, we don't load any preset CSS styling, to allow full control over the styling within your theme or child theme. = I don't need the 'Role' field, can I disable that? = You sure can. In fact you can disable all the default fields individually. To disable the role field add: `add_filter( 'woothemes_our_team_member_role', '__return_false' );` To your themes 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? = Yesiree! To add a new field to the backend add the following to your themes `functions.php` file: `add_filter( 'woothemes_our_member_fields', 'my_new_fields' ); function 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 the following: `add_filter( 'woothemes_our_member_fields_display', 'my_new_fields_display' ); function my_new_fields_display( $member_fields ) { global $post; if ( '' != $post->misc ) { $member_fields .= '<li class="misc">' . $post->misc . '</li><!--/.misc-->' . "\n"; } return $member_fields; }` Done! = How can I add custom CSS classes to each team member? = Using the `woothemes_our_team_member_class` filter. Use the following snippet to add 'new-class' to each team member. Obviously you can add logic here to add unique classes per user. `add_filter( 'woothemes_our_team_member_class', 'new_team_member_class' ); function new_team_member_class( $css_class ) { $css_class .= ' new-class'; return $css_class; }` = What does assigning a team member to a user do? = If you assign a team member to a user in your WordPress install a couple of things happen: 1. A link to the team members post archive is output beneath their description. This can be disabled using the `woothemes_our_team_args` filter if you want. 2. That user now has control of what is displayed as their description. If they add some information to their bio from their profile page, that will display instead of any content you added to the team member content. If their bio is empty the standard description will appear as normal. = How do I contribute? = We encourage everyone to contribute their ideas, thoughts and code snippets. This can be done by forking the [repository over at GitHub](http://github.com/woothemes/our-team/). == Screenshots == 1. The team member profile management screen within the WordPress admin. 2. The team members displayed on the front-end with a little CSS to arrange in to columns. == Upgrade Notice = = 1.0.2 = * Some filters have been prepended with woothemes_our_. If you're customising Our Team with filters please check these customisations before updating. = 1.0.0 = * Initial release. Woo! == Changelog == = 1.1.0 = * New - Team members can be assigned to a WordPress user pulling a link to their posts into the team page and replacing their description with the bio according to their profile. * 3.8 UI compatibility. = 1.0.2 = * Fixed typo in the team members archive slug. Kudos digitales. * title, before_title and after_title params are now passed to shortcode. * Team member css class is now filterable allowing custom unique clases. * Prepended all filters woothemes_our_team_ = 1.0.1 = * Added role & twitter args to shortcode. * Added role option to widget. * Display 12 team members by default (previously 5). * Typos and other minor fixes. = 1.0.0 = * Initial release. Woo!