Extension:SportsTeams

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
Crystal Clear app error.svg
SportsTeams
Release status: unstable
Implementation Special page
Description Provides networking functionality
Author(s) Aaron Wright
Ashish Datta
David Pean
Jack Phoenix
Latest version 3.3.3 (2016-09-02)
MediaWiki 1.27+
Database changes Yes
License GNU General Public License 2.0 or later
Download
Parameters
$wgSportsTeamsGoogleAPIKey
Added rights
sportsteamsmanager
Hooks used
AddNewAccount
BeforePageDisplay
LoadExtensionSchemaUpdates
RenameUserSQL
UserProfileBeginLeft
Translate the SportsTeams extension if it is available at translatewiki.net
Check usage and version matrix.
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 place the file(s) in a directory called SportsTeams in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    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.

To users running MediaWiki 1.24 or earlier:

The instructions above describe the new way of installing this extension using wfLoadExtension() If you need to install this extension on these earlier versions (MediaWiki 1.24 and earlier), instead of wfLoadExtension( 'SportsTeams' );, you need to use:

require_once "$IP/extensions/SportsTeams/SportsTeams.php";

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/).

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.