Extension:SocialProfile/Technical documentation

The SocialProfile extension integrates multiple social functionalities into MediaWiki software.

For installation instructions, see Extension:SocialProfile.

Configure
Some features won't work without additional changes, but if chosen by the site admin, may be left out.

Relationships
To enable friends/foes to display on the user page, the following additions need to be made to :

The following settings should be placed directly under the require_once line:

decides whether to enable friending or not. At the moment, however, it isn't really effective - don't rely on it.

Board
To enable the Board to display on the user page, allowing users to view messages posted, the following settings need to be added:

User-specific statistics
To enable per-user statistics that show up on the profile pages, add the following into your wiki's settings:

Points system
User Levels show on the users' profile pages and on various other places across the wiki. This feature is available from SocialProfile version 1.1 onwards (37590).

Note that this feature must be correctly configured, or it can interfere with other features, such as avatar upload and messaging. See the discussion on the talk page.

To enable user levels, add something like below into your wiki's settings:

You may also want to configure the actions for which points are being awarded. The default settings are:

Most of the above require separate social extensions to be installed and configured. However, there are actions for which you can give out points without installing separate extensions. These actions are:
 * editing
 * friending another user
 * foeing another user
 * uploading your first avatar
 * sending a gift
 * receiving a gift

Even if you didn't want to change the defaults, you might need to re-define one  after including EditCount.php and defining. You could just add the following default to your wiki's settings, assuming that you don't want to change it:

After UserLevels is configured, you might want to visit Special:UpdateEditCounts to initialize the points (requires you to have the updatepoints user right). You should also visit this page every time after changing.

The list of users with the most points can be seen at Special:TopUsers.

System gifts

 * — path to SystemGift files. Defaults to.
 * — Defaults to.

User gifts

 * — path to UserGifts files. Defaults to.
 * — similar to the above. Defaults to.
 * — maximum number of private custom gifts that a user may create. If not set (as per default), normal users cannot access Special:GiftManager, only those with giftadmin privileges can access it. Note that when this is set, users can create their own gifts but they cannot delete them.
 * — (description needed)

Restricted special pages
Certain special pages introduced by SocialProfile extension are restricted to the staff user group by default. To enable access to the special page Special:PopulateUserProfiles, create a user group called staff and add yourself into the group.

If you do not want to create such a user group however, you can manually edit the file.

Custom profile info
The titles of the custom text input boxes can be changed via the following system messages:
 * MediaWiki:Custom-info-field1
 * MediaWiki:Custom-info-field2
 * MediaWiki:Custom-info-field3
 * MediaWiki:Custom-info-field4

Logging
SocialProfile adds two logs: avatar log (Special:Log/avatar), which tracks avatar image uploads and user profile log (Special:Log/profile), which tracks changes to users' social profiles. Since 37590, both logs can be hidden from the recent changes as they tend to flood it quickly.


 * To turn off the display of avatar uploads, set:
 * To turn off the display of user profile changes, set:

Permissions

 * — allows access to Special:RemoveAvatar, it allows removal of others' avatars. Given to 'sysop' and 'staff' groups by default.
 * — allows access to Special:PopulateAwards and Special:SystemGiftManager. Given to 'awardsmanage', 'sysop' and 'staff' groups by default.
 * — allows access to Special:EditProfile, a special page to edit other users' social profiles. Given to the 'staff' group by default; since 84989.
 * — allows accessing Special:GenerateTopUsersReport, which can be used to generate the report of top users, and thus to give out points for having the most points for a week or for a month; available since r91854. By default no group has this right.
 * — allows access to Special:GiftManager. Given to 'giftadmin', 'sysop' and 'staff' groups by default.
 * — available since r50604. Users with this right are allowed access to Special:UpdateEditCounts. By default no group has this right.
 * — available since r50565. Users with this right can delete other users' board messages. By default no group has this right.

Working against spam
To prevent spambots from creating a social profile page right after registering, you can use. For example, to require a user to have five edits before they're allowed to update their profile, set:

To require a user to have 10 edits and 3 friends before they're allowed to update their profile, set:

Special pages

 * System gifts
 * Special:TopAwards — lists the awards that have been given out the most times.
 * Special:ViewSystemGifts — a special page for viewing all of your own awards.
 * Special:ViewSystemGift — not meant to be accessed directly.
 * Special:SystemGiftManager — allows to add and remove awards. Restricted to users with the awardsmanage right.
 * Special:SystemGiftManagerLogo — allows to upload award images which will be stored in the  folder. Restricted to users with the awardsmanage right.
 * Special:PopulateAwards — a special page to give out awards. Restricted to users with awardsmanage right.


 * User gifts
 * Special:GiveGift — a special page that allows you to give a gift to another user.
 * Special:ViewGifts — a special page for viewing all your own gifts.
 * Special:ViewGift — not meant to be accessed directly.
 * Special:GiftManager — allows to add, remove and modify gifts. Restricted to users with the giftadmin right or all logged-in users if  is set.
 * Special:GiftManagerLogo — allows to upload new gift images, restricted to users with the giftadmin right.
 * Special:RemoveMasterGift — allows to remove a gift completely, restricted to users with giftadmin right.
 * Special:RemoveGift — allows an individual user to remove a gift given to them.


 * User profile
 * Special:EditProfile
 * Special:UpdateProfile
 * Special:ToggleUserPageType
 * Special:PopulateExistingUsersProfiles.php
 * Special:UploadAvatar
 * Special:RemoveAvatar


 * User board
 * Special:UserBoard
 * Special:SendBoardBlast


 * User relationship
 * Special:AddRelationship
 * Special:RemoveRelationship
 * Special:ViewRelationships
 * Special:ViewRelationshipRequests


 * User stats
 * Special:UpdateEditCounts