Team List

外掛說明

Team List is a plugin that helps you to create a simple team site using your WordPress users with various display options. Either use a block, a shortcode, a template tag or the built-in widget to display blog authors.

After creating similar functionality for a couple of clients, we decided to roll our knowledge into this simple plugin. It’s really straightforward to use:

First of all, the plugin adds a small checkbox to the user profile in WordPress to toggle its visibility in the team list. This means you can decide for every user whether he should show up in the team list or not.

You can then use one of these ways to display the list anywhere on your site.

Action

Use the wp_team_list hook to directly display the users in your theme or plugin.

For example, you can show users of any role ordered by their name:

<?php
echo do_action( 'wp_team_list', array( 'role' => 'all', 'orderby' => 'name' ) );
?>

Note: Team List supports many of the arguments WP_User_Query supports.

Block

Use the “Team List” block in the block-based editor to display one or more team lists in any post types. You can select one or more roles and change the order. If you want you can also provide a link to a full team page.

Shortcode

Use the [wp_team_list] shortcode to display a team list in your posts. Supported arguments:

  • role – Filter users by roles (comma-separated).
    Use all to show users with any role.
    Default: administrator
  • orderby
    Default: post_count
  • order – Either asc or desc.
    Default: desc.
  • include – Filter users with specific IDs (comma-separated).
  • has_published_posts – Filter users with published posts.
    Either a comma-separated list of post types or true to filter by all post types.

Example:

[wp_team_list role="author" orderby="last_name" order="desc"]

Pro tip: If you use the Shortcake WordPress plugin, you’ll get an inline preview of the shortcode right in the visual editor. You can also add the shortcode with the click of a button.

Widget

Want do display the team members in your sidebar? Use the built-in WordPress widget. You can set the role you want, the number of users to show and even link to a separate team page.

螢幕擷圖

  • This is how your team list can look like with some additional CSS.
  • The plugin only provides limited styling. It’s up to you to adjust it.
  • The block in the block editor with its settings and custom styling.
  • The configuration options of the built-in widget.

適用於區塊編輯器

這個外掛提供 1 個可供 Gutenberg/區塊編輯器使用的區塊。

  • Required Wp Team List

安裝方式

  1. Upload wp-team-list to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Use one of the supported methods (hook, shortcode, or widget) to display a team list.
  4. Optional: Set the visibility status of your users in their profiles.

常見問題集

How do I contribute to Team List?

Easy! You can report bugs, with reproduction steps, or post patches on GitHub.

What kind of filters / hooks are available?

  • wp_team_list_user_role – Filter the user role displayed in the team list.
  • wp_team_list_query_args – Filter the WP_User_Query arguments.
  • wp_team_list_template – Change the team list template.
    Note: You can also put a rplus-wp-team-list.php file in your theme folder.
  • wp_team_list_avatar_size – Filter the default avatar size.
  • wp_team_list_default_classes – Filter default CSS classes.

使用者評論

2019 年 1 月 28 日
This is a very helpful and well documented plugin! I was searching quite a time for a simple and functional solution like this. Very good work! Thank you very much for providing this.
2018 年 4 月 5 日 1 則留言
If you are an dev this plugin is an god send. Minimalistic and easily customizable. Thanks devs!
2017 年 11 月 29 日 1 則留言
Brillante solución y muy simple!!! He estado buscando un plugin que asocie directo el “equipo” (front) con el listado de usuarios de WP (back), sin tener que hacer un listado de equipo aparte. Y todos los plugins eran complicados y pesados o no cumplían. Este es una maravilla. Muchísimas gracias. Apenas pueda la traduzco al español.
2016 年 9 月 3 日 1 則留言
Searched days for a good member/team plugin. There are many free and paid plugins for this matter but almost all of them don’t use your wp users! This plugin uses your wp users, is simple and also free. Awesome job 🙂
閱讀全部 7 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈Team List〉的開發相關工作。

參與者

〈Team List〉外掛目前已有 5 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈Team List〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

4.0.0 – 2023-03-27

Changed

  • Add colors, spacing, and alignment support for team list block.
  • Require at least PHP 7.4 and WordPress 6.0.
  • Tested compatibility with WordPress 6.2.

Fixed

  • Fix incorrect type registration for block attributes.
  • Fix updating the number of users to display in block.
  • Fix misalignment of the show all link by providing a block wrapper.

3.0.4 – 2021-08-02

Changed

  • Tested compatibility with WordPress 5.8

Fixed

  • Fixed missing PHP functions when widget was used with legacy widget in the new WordPress 5.8 widget area.

Added

  • Allow transformation from legacy widget to block

For previous updates see CHANGELOG.md.