How to Use One Widget for Different Users, Multiple Users, Locations and Teams

How to Use One Widget for Different Users, Multiple Users, Locations and Teams

 Widget Template Documentation

This article is for companies that want to use the same testimonial display widget (widget) on their users' pages. For example, a real estate office might have many agents in the company, all with their own profile pages. One widget can be used for each of the agents' pages and will be populated dynamically with only that one agent's testimonials by incorporating that one agent's email address in the widget code. The benefit of this is that one widget can be used on multiple pages. Please, bear in mind that one widget, which controls the appearance of the testimonials, can be used on multiple pages with the same branding colors, like on each of the agent pages hosted on the same corporate website.

Regular Widget Format (without filtering by sub-user, team or location)

This will display all the testimonials for the whole company:

<div id='TestimonialTree_Widget_{widgetid}'></div>
<script src='https://www.testimonialtree.com/widgets/?widgetid=
{widgetid}' type='text/javascript'></script>


Used as a Template (passing "username" or "email" or "externalid")

This will filter the testimonials so the the widget only shows the testimonials for the user that correlates to the email address used, as in the first example, or the username being used, as in the second example or the externalID, as in the third example.
  • This shows the widget with the added email address variable that will only show testimonials for the user related to the email passed in
<div id='TestimonialTree_Widget_{widgetid}'></div>
<script src='https://www.testimonialtree.com/widgets/?widgetid=
{widgetid}&email={email address}' type='text/javascript'></script>
or
  • This shows the widget with the added username variable that will only show testimonials for the user related to the username passed in
<div id='TestimonialTree_Widget_{widgetid}'></div>
<script src='https://www.testimonialtree.com/widgets/?widgetid=
{widgetid}&username={username}'type='text/javascript'></script>
 

  • This shows the widget with the added externalid variable that will only show testimonials for the user related to the externalid passed in
<div id='TestimonialTree_Widget_{widgetid}'></div>
<script src='https://www.testimonialtree.com/widgets/?widgetid={widgetid}& externalid={externalid}'type='text/javascript'></script> 


Templates that only show testimonials for: *

...the whole company (this is the default output for the widget code).

<div id='TestimonialTree_Widget_123'></div>
<script src='https://www.testimonialtree.com/widgets/?widgetid=123' type='text/javascript'></script>

...one user using that user's email address:

<div id='TestimonialTree_Widget_123'></div>
<script src='https://www.testimonialtree.com/widgets/widgetid=123
&email=johndoe@domain.com'
type='text/javascript'></script>

...multiple users using those users' email addresses:

<div id='TestimonialTree_Widget_123'></div>
<script src='https://www.testimonialtree.com/widgets/widgetid=123
&email=johndoe@domain.com,wilmajones@electronicaddress.com'
type='text/javascript'></script>

...one user using that users' external id:

<div id='TestimonialTree_Widget_123'></div>
<script src='https://www.testimonialtree.com/widgets/widgetid=123
&externalid=1234'
type='text/javascript'></script>

...a Team. 

<div id='TestimonialTree_Widget_123'></div>
<script src='https://www.testimonialtree.com/widgets/?widgetid=123
&teamID=Team Wins-A-Lot'
type='text/javascript'></script>

OR

<div id='TestimonialTree_Widget_123'></div>
<script src='https://www.testimonialtree.com/widgets/?widgetid=123
&teamLead=teammanageremailaddress'
type='text/javascript'></script>


...a Location. 

<div id='TestimonialTree_Widget_123'></div>
<script src='https://www.testimonialtree.com/widgets/?widgetid=123
&locationID=Downtown Office'
type='text/javascript'></script>

* Remember, there are settings that disclude displaying testimonials with a star rating of 1, 2 or 3. This is our default setting. Click here for instructions on how to check these settings in your account.

  


    • Related Articles

    • Edit a Widget

      Once you've created a widget, you will have the option of changing a number of different settings particular to that widget.  Note: Depending on your parent account’s permission settings, you may not have access to this feature.  Step 1: From your ...
    • How to Add Locations

      As an Admin of an account you can create Locations if you have more than one office location. Step 1: Select Management from the left-hand side Navigation Bar and then Teams Step 2: On the Location page, click Add Location Step 3: Here you will add ...
    • Modify, Add, or Delete Users

      With an enterprise account, you're able to manage all the users in your account. Step 1: To access your users, from the Dashboard go to Management in the left-hand side Navigation Bar and then Users Step 2: The User Administration page will open and ...
    • FAQ: Teams

      In a Testimonial Tree Enterprise Account, Teams can be set up in two different ways. This article will describe each and help you determine the best setup for you. Option 1: Individual Users in an account are assigned to a Team: Testimonial Tree can ...
    • How to Add Teams

      As an Admin of an account you can create Teams so that more than one agent can request and receive survey and testimonial feedback. Step 1: Select Management from the left-hand side Navigation Bar and then Teams Step 2: On the Teams page, click Add ...