Extension:SportsTeams

MediaWiki extensions manual

SportsTeams Release status: beta
Implementation	Special page
Description	Provides networking functionality
Author(s)	Aaron Wright Ashish Datta David Pean Jack Phoenix
Latest version	3.7.0
MediaWiki	1.39+
Database changes	Yes
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Download Git master browse repository (Phabricator · GitHub) commit history repository contributors (GitHub) code review
Parameters $wgSportsTeamsGoogleAPIKey
Added rights sportsteamsmanager
Hooks used BeforePageDisplay LoadExtensionSchemaUpdates LocalUserCreated UserProfileBeginLeft
Quarterly downloads	0
Translate the SportsTeams extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

SportsTeams is an extension that provides networking functionality. Users' networks will show up on their social profile pages and they can provide status updates related to each network, either directly on their profile or via the network page (i.e. "Go Mets!" if the user would be a fan of the New York Mets team, and so on).

Requirements

• Extension:SocialProfile
• Extension:UserStatus

Installation

• Download and move the extracted SportsTeams folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/SportsTeams
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'SportsTeams' );
  

• Run the update script which will automatically create the necessary database tables that this extension needs.
• Create two new writable directories, sport_logos and team_logos, under $wgUploadPath
• Get a Google Maps API key and set $wgSportsTeamsGoogleAPIKey in your LocalSettings.php, after requiring the extension's setup file
•  Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration and usage

Users with the sportsteamsmanager user right can use the Special:SportsTeamsManager special page to create a new sport. Once there is at least one sport, teams can be added under that sport. After creating a team, you can upload a logo for it.

Once there are some teams, you (and other users) can become fans of these teams by going either into your social profile page or directly to Special:UpdateFavoriteTeams.

Special:SimilarFans shows users who are interested in the same teams as you are.

Network pages are accessible via Special:FanHome, although going to that special page directly will give you an error. A proper URL looks something like Special:FanHome&sport_id=1&team_id=25. Via the team's network page, you can join the network or leave it, see other users' status updates related to the team, (blog) articles related to it, the location of other fans on a Google Maps map and how many fans the team has altogether.

Special:TopNetworks shows the most and least popular sports and teams.

Parameters

In order for a map (provided by Google Maps) to show up on each network page, you need to obtain a Google Maps API key from Google and set $wgSportsTeamsGoogleAPIKey to the key you obtained; the default key is for localhost (http://localhost/).

As of October 2023, the Google Maps integration is broken and thus commented out; see commit 30b1905062548c3363fa1f349379f905d087c127.

User rights

The new sportsteamsmanager user right, which sysop and staff groups have by default, is required to add new sports and teams via Special:SportsTeamsManager.