Team Rosters Plugin Users Manual

Team Rosters Plugin Overview

The MSTW Team Rosters plugin manages team rosters and provides shortcodes to display rosters as simple html tables and as “player galleries”. Page templates are provided to offer a single player view and a team “player gallery” view of the roster. The plugin supports as many players and team rosters as needed. The plugin supports three ‘views’ of team rosters: … Continue reading

Change Log

4.0 Access controls for MSTW Admin, MSTW Team Rosters Admin, and Team Admins. New data fields for the team taxonomy to integrate with MSTW Schedules & Scoreboards Teams database Completely re-wrote the settings screen – organized with tabs and added help screens Re-organized Edit Player screen Added field to link Team taxonomy to MSTW Schedules & Scoreboards Teams DB Corrected … Continue reading

CSV File Format

The CSV file format is very simple, but formatting errors are the source of most import problems. I suggest you start with the sample files in the plugin’s /csv-examples directory. Import the one that appears closest to your needs first; then modify it to suit your needs. The CSV file format starts with a “header row” (the first row of … Continue reading

CSV File Import

Thanks to ‘dvkob’ for the great CSVImporter plugin, which I simplified for this specific use. I also include and use the File_CSV_Datasource class by Kazuyoshi Tlacaelel exactly as it was found in the CSV Importer plugin. All their GNU/MIT copyrights are passed through. Since version 2.0 team rosters can be loaded from files in CSV format. This allows admins to … Continue reading

CSV Sample Files

I use the following CSV files to test the CSV function. Almost all CSV issues in the support forums have turned out to be file format issues*. Rather than starting from scratch, I highly recommend that you first test that you can import one or more of these files into your site, then modify one that works for your use. … Continue reading

Customizing the Team Rosters Plugin

In version 4.0 the ability to customize the plugin’s displays – roster tables, player galleries, and player profiles – has been greatly expanded. The four ways to customize the plugin are described below. Examples of their use are available on the MSTW Development site. A video tutorial is available to Gold Support members on the Tutorials page. Admin Settings Screen. … Continue reading

Data Entry – Players

Two admin screens support player data entry: (All) Players and Add/Add Player. Each screen is described below. Players Screen The Players screen provides a list of all players as shown below. You can filter the list by team, just like you might filter regular posts by category or tag. You can also sort the list by name (title), first name, … Continue reading

Data Entry – Teams

Two admin screens support player data entry: MSTW Teams and Edit Team. Each screen is described below. MSTW Teams Screen As shown in the screenshot below, the MSTW Teams screen serves two purposes: it lists all the teams in the custom taxonomy, and it allows new teams to be added to the taxonomy. [Think of this custom teams taxonomy like … Continue reading

Frequently Asked Questions

I installed version 4.0 (without reading the fine manual) and all my data is gone! @*?*$^&#!! Please tell me I did not lose 3 years of data! No, you did not lose your data, you just can’t see it via version 4.0 of the plugin. Deactivate version 4.0 (I don’t believe you have to uninstall it.) and reinstall version 3.1.2, … Continue reading


INSTALLATION NOTES When upgrading the existing Team Rosters data must be updated by exporting it to CSV files, then importing it. SEE THE MIGRATING THE DATA MAN PAGE FOR DETAILS. The plugin’s mstw_tr_styles.css stylesheet WILL be overwritten, so if you have modified that file, you may want to move it to a safe place before updating the plugin. You will … Continue reading

MSTW Roles & Capabilities

The MSTW Schedules & Scoreboards and Team Rosters plugins create a number of custom WordPress capabilities, and assign them across three custom WordPress user roles – MSTW Admin, MSTW Schedules & Scoreboards Admin, and MSTW Team Rosters Admin. Users can then be assigned to any of these MSTW Roles on the Users admin screen shown below. So what does this … Continue reading

Player Gallery & Single Player Profile Pages

Historically, these pages have proven to be the hardest for plugin users to get working properly. Careful attention to this page, the Installation page, the Usage Notes page, and the WordPress Support Forums should help you out (hopefully a lot). For those who are more knowledgeable in some technical details of WordPress, player (actually mstw_tr_player, rewritten) is simply a custom … Continue reading


The default settings for the Team Rosters Tables [shortcode], Player Gallery [shortcode], Single Player (Bio) Pages, and Player Gallery (Taxonomy) Pages may be modified on the plugin’s Settings page. NOTE 1: IN ORDER FOR THESE SETTINGS TO TAKE EFFECT, THE SPECIFIED ROSTER SHORTCODE FORMAT MUST BE “CUSTOM” OR BLANK. If a specific format, such as “college”, “pro”, or “high-school” is … Continue reading

Settings – Data Fields & Columns

These controls allow customization of roster displays by displaying or hiding data fields (columns), and changing the labels of data fields (columns). This allows the re-purposing of data fields (columns) for very general uses, perhaps not even sports related. The purpose and use of these fields is self-evident. Note that the Name field cannot be hidden, but it can be … Continue reading

Settings – Player Profiles & Galleries

More settings unique to the Single Player Bio pages and Player Gallery pages are provided here. Generally speaking, these pages share the same color scheme. Two important settings in this section are: Add Links to Player Bios. Adds links from the Player Gallery pages to the Single Player Bio pages. By default these links are NOT enabled. Player Photo Size. … Continue reading

Settings – Roster Table Colors

Roster Table Color Settings These settings control of colors in the roster tables, single player profiles, and player galleries. They will override the default/generic settings in the plugin’s stylesheet (/css/mstw-tr-styles.css). However, each team’s displays may be styled individually using the plugin’s stylesheet. See the examples on the MSTW plugin development page or read more about how to use the stylesheet. … Continue reading

Settings – Roster Tables

The Roster Table tab provides a collection of settings not covered by the Data Fields & Columns tab and the Roster Table Colors tab. Two settings are worthy of some discussion: Roster Table Format. This setting MUST be set to custom (the default), if you want the Data Fields & Columns settings to take affect. Other settings will provide custom … Continue reading


The following shortcodes for front end displays are described below. Roster Tables [mstw-tr-roster team=team-slug] Roster Galleries [mstw-tr-gallery team=team-slug] Roster Tables The Team Rosters roster table shortcode is: [mstw-tr-roster team=team-slug] The team argument is REQUIRED. Nothing will display without it. Many other arguments are available to control the table as discussed below. The Team Rosters Table layout is controlled by three … Continue reading

Styling the Plugin’s Displays (v 3.1.2)

More or less complete control of the graphic design of the roster tables, the single player pages, and the player gallery pages may be obtained by editing the plugin’s style sheet /css/mstw-tr-style.css. Depending on your theme, it may also be necessary to edit the single-player.php and taxonomy-team.php templates to get everything to ‘fit’ just right. Out of the box, the … Continue reading

Upgrading to Version 4.0

Upgrading MSTW Team Rosters to version 4.0 is not as simple as pushing the WordPress upgrade plugin button, but it’s not hard if you follow the steps listed below. NOTE these steps are not necessary for a new installation, use them only if you want to move existing data from version 3.1.2 to version 4.0. BACKUP YOUR SITE. This is … Continue reading

Usage Notes

I recommend that you use the test pages on as guides to compare what works with what doesn’t. Many good shortcode examples are there. Help me seek out and destroy a dastardly bugs! It has been reported that the data for one or more players sometimes simply disappears!? I saw this problem on my development site once, when I … Continue reading