Help:Extension:SocialProfile/Gifts

From Linux Web Expert

File:Social user profile.png
Gifts, like awards and friends and foes, show up on social profile pages unless configured otherwise by the wiki's system administrators.

Users can send gifts to other users, as a way to thank them or just for fun, from a list of defined gifts. Each user profile page will list the gifts received by other users.

A gift contains:

  • A name.
  • A description.
  • An image.

Managing gifts

Gifts must be created before anyone can send gifts. Only users with the giftadmin right can create, edit or delete gifts unless the $wgMaxCustomUserGiftCount variable has been defined in the wiki's configuration and its value is greater than zero; in that case, users without the giftadmin right can create up to that many custom gifts that only they can send out. Gifts can be managed on the Special:GiftManager special page.

When creating the gift, you should provide a name and description. Neither name nor description accept wikitext, only plain text.

You should also select if the gift will be public or private:

  • Public: Any user can send that gift.
  • Private: Only the user that created the gift (you) can send and edit that gift.

Only after creating the gift, you'll be able to attach an image to the gift. Images should be square.

The Special:GiftManager special page will list all existing gifts, even private ones, but private gifts can only be edited by users that created them.

Editing the gift name, description or image, will replicate to the users that received it.

Removing a gift will also remove it from all users that received it. Even though private gifts can't be edited by other users, private gifts can be deleted by anyone with the giftadmin right.

Sending gifts

To send a gift to a user, open the user profile page of the user you want to give the gift. On the header there's a link to give the user a gift. You'll be presented with a list of available gifts (public, and private gifts created by you), which you should click to select which one to give, and a textarea where you can provide a message to the user for more information. The user will receive that message in a notification, and the message will also be visible by others in the list of gifts received. The message can contain wikitext.

You can also access the Special:GiveGift special page to give gifts, where you can type in the name of the user to send the gift, or select the name directly from the drop down of your current friends. Once you select a user, you can send the gift as explained before.

When sending a gift, a notification will be sent to the user that receives the gift. Also, the action will be logged in the user activity for both users (one entry for sending the gift, another for receiving it).

The same gift can be sent several times to the same user, even from the same user.