Gift widget

The Gift Widget allows users to give each other gifts in the form of badges and/or points. Using this widget, one user can give another any of the Gifts or Giftable Points configured in the Administration Panel.

The Gift Widget interface allowing users to select recipients, gift types, and add personalized messages

Implementation

To render the Gift Widget, add a call to the Mambo gift() function in the mamboCallbacks() array. The example below shows the function call with all available options. None of these options are required, so you could simply use: Mambo('.selector').gift().

JavaScript

// Initialise the Mambo Callbacks array
var mamboCallbacks = window.mamboCallbacks || [];
mamboCallbacks.push(function() {

  // Render the Gift Widget in the DOM Element with an ID of 'gift'
  Mambo('#gift').gift({
    popup: false,
    title: null,
    prize: null,
    triggerActivity: null,
    withPoints: true,
    withGifts: true,
    requireReason: true,
    tags: null,
    tagsJoin: 'hasAnyOf'
  });
});

Configuration options

Each option found in the code above is explained in detail below. None of these options are required.

Display options

Option	Description	Default Value	Sample Value
popup	When enabled, displays the widget in a popup in the middle of the screen. When using this option, a class selector is not required.	false	true
title	Allows you to override the default title displayed in the widget.	null	Send a Gift
prize	Adds a prize message under the widget title. This can be used to describe an activity triggered by the triggerActivity option, providing users with additional incentive to give gifts.	null	Win 600 points

Gift content options

Option	Description	Default Value	Sample Value
withPoints	Enables or disables the option to give points through the widget.	true	false
withGifts	Enables or disables the option to give Gift rewards through the widget.	true	false
requireReason	Determines whether the reason field ("Tell them why") is mandatory when sending a gift.	true	false

User filtering options

Option	Description	Default Value	Sample Value
tags	Specifies tags that users must have in order to appear in the search results. This allows you to focus gifting on particular subsets of users, such as members of a specific department or office location.	null	['finance_dept','hr_dept']
tagsJoin	Determines whether users must have all specified tags (hasAllOf) or any of the specified tags (hasAnyOf) to appear in search results.	hasAnyOf	hasAllOf

Activity triggers

Option	Description	Default Value	Sample Value
triggerActivity	Defines an activity that will be triggered for the user who performs the gifting. This allows you to reward the sender with any type of activity (behaviour, point, coupon, etc). See Create activities for sample data objects.	null	See activities documentation