Friday, June 27, 2014

Feedback Collection Form Integration API

One of the very first things customers have asked for is the ability for our embedded form to detect who the users are. If your users have to login to your application, then you already know who they are. It's incredibly redundant to ask these users to once again login to yet another system, just to leave valuable feedback.

We noticed Get Satisfaction requires users to login to their application -- not the application the user is leaving feedback for -- before that person can leave feedback or ask a question.

If your users have already logged into your application, then that person shouldn't need to login to yet another system within your application.

Through the embed code, your developers can pass in user data and control some aspects of the form. Here are the 7 available options to control and customize the form:


  • name:  This property takes as an argument the name of the currently logged in user. Pass this value into the looptodo_feedback_btn_init function, and the embedded form will prepopulate the form with this information.
  • email:  In order to reply or respond to feedback, questions, suggestions, and other submitted requests, you need an email address. Since your user is logged into your application, use their email address as an argument passed into the email parameter, and your support staff can easily reply.
  • allowAnonymous:  By default, users can choose to leave anonymous feedback. Set this to false to hide and disable the anonymous option.
  • hideNameEmail:  If you are prepopulating the form with a name and email address, it might make sense to just go ahead and hide those fields. Set this property to true to hide the name and email address fields. Just make sure you're also passing in the contact information!
  • hideCopyOfFeedback : This property lets users (who submit the feedback) can get a copy of the feedback they submitted as an email for their reference, if they check this option's check box. Set this to true to hide and disable copy of feedback option.
  • allowScreenshot : Getting the screenshot of the page from where people submit the feedback, helps better to understand the problem what they are trying to convey. If you set this option to false, then this option will be hidden from the feedback form.
  • hideAttachFile : People who submit the feedbacks can also attach the files along with their text feedbacks. Setting this option to true will hide the Attach File option from Feedback form

Example Usage:

looptodo_feedback_btn_init(
    { 
        name: nameVar,
        email: emailVar,
        allowAnonymous: false,
        hideNameEmail: true,
        hideCopyOfFeedback : true, 
        allowScreenshot : false, 
        hideAttachFile : true 
    }); 

The example above configures the form to pass in the value stored in the JavaScript variable called "nameVar", and the value stored in "emailVar" into the name and email properties respectively. Additionally, the anonymous field is disabled and hidden, and the name and email fields are hidden. This is the same configuration we use in the LoopToDo application, and it looks like this:




The embed code is easy to obtain. In your Loop, click "Settings". In the "Collecting" section, copy the embed code and place it on your website, before the closing </body> tag:



If you have any questions or need more help, please let us know! 

0 Comments:

Post a Comment

Subscribe to Post Comments [Atom]

<< Home

Ready to get a FREE Loopround account?
All you need is a Google account and 30 seconds!

Create a Free Account

Sign up with your Google login!

Terms of Use

Privacy Policy