Extension:SportsTeams

MediaWiki extensions manual - list

SportsTeams Release status: unstable
Implementation	Special page
Description	Provides networking functionality
Author(s)	Aaron Wright Ashish Datta David Pean Jack Phoenix
Last version	2.0
MediaWiki	1.16+
License	GNU General Public License 2.0 or later
Download	Download snapshot (Git master) Git [?]: repo summary • tree • code changes SVN [?]: checkout-url • tree • code changes
Parameters $wgSportsTeamsGoogleAPIKey
Added rights sportsteamsmanager
Hooks used AddNewAccount UserProfileBeginLeft
Check usage (experimental)

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

Note: This extension requires the SocialProfile extension to be installed and properly configured.

Warning:

This extension is under development and is not suited for any production environment yet. No release date has been set. See also the development notes and leave Jack Phoenix a message if you want to help out with the development of this extension.

Installation

1. Get the source code, either SVN or via ExtensionDistributor
   1. You will also need the UserStatus extension (ArmchairGM version, which is in trunk/extensions/UserStatus); install it like how you'd install any other extension and don't forget to create its database tables
2. Create two new writable directories, sport_logos and team_logos, under $wgUploadPath
3. Create the new, required database tables — do note that running update.php doesn't do, you have to (more or less) manually source sportsteams.sql against your wiki's database
4. Add the following into the wiki's LocalSettings.php:
   require_once("$IP/extensions/SportsTeams/SportsTeams.php");
5. Get a Google Maps API key and set $wgSportsTeamsGoogleAPIKey in your LocalSettings.php, after requiring the extension's setup file
6. Installation can now be verified through the wiki's Special:Version

Configuration and usage

Right now there is no Graphical User Interface (GUI) for creating a new sport. This sucks and needs to be fixed. For now, for testing, you can run something like INSERT INTO sport (sport_name, sport_order) VALUES ('Golf',1); against your database.

Once you have at least one sport, you can add teams under it via Special:SportsTeamsManager; accessing this special page requires that you have the sportsteamsmanager user right, which sysop and staff groups have by default. 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/).

User rights

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