Player Performance
Player Performance items are the per-event statistics tracked for individual players. Examples include Goals Scored, Assists, Yellow Cards, Minutes Played, and Saves. Each performance item is a WordPress post of type sp_performance.
When you edit an event, the box score section shows a row for each player and a column for each performance item. Coaches or administrators fill in these values when recording event results.
Navigate to SportsPress > Configure to see the list, or use the View All link in the Player Performance section.
Fields
Each performance item has the following fields:
Primary — A radio button selecting which performance item is the primary one. The primary performance item is the default reference for the first result in the Event Results section when no custom equation is specified for that result.
Icon — An optional thumbnail image displayed as a small icon in the box score column header.
Label — The display name shown in the box score column header (for example: Goals, Assists, Cards).
Variable — The slug used to reference this item in equations, prefixed with
$(for example:$goals). Set when first published; read-only after publishing.Singular — An optional singular form of the label. Used in some display contexts.
Category — Groups this performance item within the box score. The available options are:
All — Shown in all views.
Offense — Shown in the offense grouping.
Defense — Shown in the defense grouping.
Format — Controls how the value is entered and displayed. The available formats are:
Number — A plain numeric value (default).
Time — A time value. When selected, the Timed option appears.
Text — A free-text string.
Equation — The value is calculated from an equation rather than entered manually.
Checkbox — A binary yes/no value.
Decimal Places — Number of decimal places shown when rendering this value. Visible when Format is Number.
Timed — Whether to record the minute at which the stat occurred. Appears when Format is Time. Options are Yes and No.
Send Off — Whether this performance item ends the player's participation (stops counting minutes after this event). Appears when Format is Time. Options are Yes and No. Used for red cards.
Visible — Whether this column appears in the player profile by default. Shown only when the Player Columns setting in SportsPress > Settings > Players is set to Automatic. Options are Yes and No.
Description — Internal notes displayed only in the admin dashboard.
The Equation Format
When Format is set to Equation, the performance item's value is calculated from other performance items rather than entered manually. An Equation meta box appears below the Details meta box. Use the drag-and-drop builder to create the formula by combining other Performance items and operators.
This is useful for derived stats. For example, a "Shot Accuracy" performance item could calculate from "Shots on Target" divided by "Total Shots."
How Performance Items Appear in the Box Score
The box score on an event page displays one column per performance item. Items are ordered by their Order value (set in the Attributes box). The Category field determines which section header the column falls under when the box score is grouped by offense and defense.
The Visible field controls whether a given performance item appears in the player statistics columns on player list pages. Items set to Visible: No still appear in the event box score; they are only hidden from the player list column selector.
Adding a Performance Item
Go to SportsPress > Configure.
In the Player Performance section, click Add New.
Enter the Label (title) in the post title field.
Optionally set a featured image to serve as the Icon.
In the Details meta box, configure Variable, Singular, Category, Format, and other format-specific options.
If Format is Equation, use the Equation meta box to build the calculation.
Optionally add a description in the Excerpt field.
Set the display Order in the Attributes box.
Click Publish.