Extension:SportsTeams

From mediawiki.org
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
  • $wgSportsTeamsGoogleAPIKey
  • sportsteamsmanager
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[edit]

Installation[edit]

  • 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
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration and usage[edit]

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[edit]

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[edit]

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