Extension:SocialProfile

MediaWiki extensions manual

Social Profile Release status: stable
Implementation	Special page , Database , Ajax
Description	Incorporates multiple social features into MediaWiki for communities
Author(s)	Aaron Wright Adam Carter David Pean Jack Phoenix
Latest version	1.14 (Continuous updates (see social tools/MediaWiki compatibility)
MediaWiki	1.35+
Database changes	Yes
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Download Git master browse repository (GitHub) commit history repository contributors (GitHub) code review Template:WikimediaDownload/gerritonly
Help	Help:Extension:SocialProfile
Example	Brickipedia, the LEGO Wiki
Parameters $wgUserPageChoice $wgUpdateProfileInRecentChanges $wgUploadAvatarInRecentChanges $wgUserProfileDisplay $wgUserProfileThresholds $wgUserLevels $wgNamespacesForEditPoints $wgUserStatsPointValues
Added rights avatarremove awardsmanage editothersprofiles giftadmin updatepoints userboard-delete
Hooks used BeforePageDisplay CanonicalNamespaces LoadExtensionSchemaUpdates BeforeCreateEchoEvent EchoGetDefaultNotifiedUsers EchoGetBundleRules ParserFirstCallInit DifferenceEngineShowDiff DifferenceEngineShowDiffPage DifferenceEngineOldHeader DifferenceEngineNewHeader OutputPageBodyAttributes
Hooks provided UserProfileBeginLeft UserProfileEndLeft UserProfileBeginRight UserProfileRightSideAfterActivity UserProfileEndRight UserProfileGetProfileHeaderLinks SpecialUpdateProfile::saveSettings_pref BasicProfileChanged PersonalInterestsChanged SpecialUpdateProfile::displayPreferencesForm NewAvatarUploaded NewFriendAccepted NewFoeAccepted RelationshipRemovedByUserID
Translate the SocialProfile extension if it is available at translatewiki.net
Check usage and version matrix.
Issues	Open tasks · Report a bug

The SocialProfile extension incorporates a social profile, user board, and basic profile info into MediaWiki, specifically avatars, befriending, foeing, user board, board blast, user levels rank system, awards and gifts. The package also notifies users via email when other users request them as a friend or foe and/or sends them a message.

• For technical documentation (if you are a system administrator), see Extension:SocialProfile/Technical documentation .
• For developer information, see Extension:SocialProfile/Developer information .
• For help on using SocialProfile, see Help:Extension:SocialProfile (currently a draft).

Install

• If you use the ExtensionDistributor to download SocialProfile, make sure that you select "master (latest development version)"; older versions are guaranteed to have lots of bugs and they are unmaintained, while trunk is always up-to-date and contains the newest features and bugfixes! See social tools' MediaWiki compatibility policy for more info.
• You can also use git, like so:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/SocialProfile

• Download the master branch and place the file(s) in a directory called SocialProfile in your extensions/ folder.
• Add the following code at the bottom of your LocalSettings.php:

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

• Run the update script which will automatically create the necessary database tables that this extension needs.
• The following directories should exist under the wiki's $wgUploadDirectory :
  • avatars/ — the directory where all user-uploaded avatar images are stored
  • awards/ — system gift (award) and normal gift images will be stored here
  • Move the directory awards/ from extensions/SocialProfile into the images directory that is used in your MediaWiki installation. This directory should be writable. The images included in this folder by default can be used for awards if you upload them through Special:SystemGiftManagerLogo, but they won't show up as "defaults" the same way avatar default images do show up.
  • Move the directory avatars from extensions/SocialProfile into the images directory used in your MediaWiki installation. This directory should be writable. Using sudo chown -R apache:apache ./avatars/ && sudo chown -R apache:apache ./awards/
•  Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Parser functions

• {{#avatar:Username}} - retrieves the avatar picture for the specified user.
• {{#randomuserswithavatars}}
• {{#newusers}}

User Options

• echo-subscriptions-web-social-rel (requires Echo extension installed)
• echo-subscriptions-email-social-rel (requires Echo extension installed)

Configuration variables

$wgUserProfileDisplay['board'] = true;
$wgUserProfileDisplay['foes'] = true;
$wgUserProfileDisplay['friends'] = true;
$wgUserProfileDisplay['avatar'] = true; // If set to false, disables both avatar display and upload
$wgUserBoard = true;
$wgFriendingEnabled = true;
$wgAvatarKey = $wgDBname;

$wgUserPageChoice = true;
$wgUserProfileAvatarsInDiffs = true;

Special Pages

• SpecialEditProfile
• SpecialPopulateUserProfiles
• RemoveAvatar
• SpecialToggleUserPage
• SpecialUpdateProfile
• SpecialUploadAvatar

Notes

• Upgrading - If you are upgrading from SocialProfile version 1.2 or older, you'll need to create four new database tables manually: gift, system_gift, user_gift, user_system_gift. If you're upgrading from 1.3, you'll need to create user_system_messages database table.
• Since r93317, SocialProfile's namespaces are automagically registered, so you do not need to add them to $wgExtraNamespaces .
• SocialProfile uses either ImageMagick or PHP's built-in GD library (since r93067), depending on which one is available, for creating the resized avatar, award and gift image files.

Known Limitations

• Avatars do not work on private wikis using image_auth.php (ref: T163529)

Reporting bugs

• Social tools/Contributing and reporting bugs

Screenshots

• Extension:SocialProfile/Screenshots - For screenshots of the extension and some very brief descriptions of the features.