Kentico CMS 7.0 Developer's Guide

Requesting friendships

Requesting friendships

Previous topic Next topic Mail us feedback on this topic!  

Requesting friendships

Previous topic Next topic JavaScript is required for the print function 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 -> Friends

 

Users with access to CMS Desk can request friendships from within My desk -> Friends. Here again, they can find the Add a friend button, 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. In the dialog, you can specify the following:

 

User - the user whose friendship you are requesting. This options is not available when requesting a friendship from the context menu as friendship of the user whose context menu was displayed is requested in this case.

Comment - comment sent to the user along with the friendship 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 case that the Send e-mail or Send message options are enabled, the Friends - Friend request e-mail template mentioned in the section below is used for the notification e-mail or Messaging module message. When the Automatically approve option is enabled along with the previously mentioned ones, the Friends - Friend approval template is used.

 

devguide_clip0434