Requesting friendships

  Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic! Mail us feedback on this topic!  

How to make the request?

 

There are several ways how users can request other users' friendship:

 

Context menus

 

As described in Development -> Document types and transformations -> Context menus in transformations, the Users viewer web part may be equipped with a context menu when an appropriately written transformation is used. This context menu contains the Add as friend option, enabling registered website users to request this user's friendship.

 

devguide_clip1247

 

Request friendship and My friends web parts

 

The Request friendship web part is just a tiny link with customizable text. Clicking it opens the Add a new friend pop-up dialog.

 

devguide_clip0949

 

Requesting friendships on the live site is also possible via the My friends web part. It contains the Add a friend link, which opens the same Add a new friend dialog mentioned above.

 

devguide_clip1249

 

CMS Desk -> My Desk -> My friends

 

Users with access to CMS Desk can request friendships from within My desk -> My friends. Here again, they can find the Add a friend link, which opens the Add a new friend dialog.

 

devguide_clip1250

 

Add a new friend dialog

 

After clicking one of the options mentioned above, the Add a new friend dialog appears. After selecting a user (not possible in case of request from context menu) and filling in a comment explaining your request, there are two important options defining how the user will be notified about the request:

 

Send e-mail - the user will be notified by a standard e-mail message
Send message - the user will be notified by a Messaging module message
Automatically approve - global administrators and users with the Manage permission for the Friends module can use this check-box, which creates the requested friendship without the other user's approval; not available on the live site

 

In both cases, the Friend request e-mail template mentioned in the section below is used as the body of the message.

 

devguide_clip0434

 

Related e-mail templates

 

In Site manager -> Development -> E-mail templates, you can find the following e-mail templates related to the Friends module:

 

Friend approval - template for e-mail or message confirming that a user approved your friendship request
Friend rejection - template for e-mail or message confirming that a user rejected your friendship request
Friend request - template for e-mail or message notifying you about the fact that some user requested your friendship

 

If you choose to Edit (Edit) some of the templates, you will see two large text fields:

 

Text - text of the template used for e-mails
Plain text - text of the template used for Messaging module messages

 

Links in these e-mails need to be handled by a special page containing the Friendship management web part, which is a special web part that ensures handling of these requests.

 

devguide_clip1254

 

Page url: http://devnet.kentico.com/docs/5_5r2/devguide/index.html?friends_requesting_friendships.htm