@openculinary/jquery-feedback - Feedback form with screenshot

This jQuery-based component is derived from the feedback.js project, and subsequent contributors.

Original preview available at http://experiments.hertzen.com/jsfeedback/

This script allows you to create feedback forms which include:

• a screenshot, created on the clients browser

• the user-supplied information

• all sorts of info gathered about the client.

The screenshot is based on the DOM and as such may not be 100% accurate to the real representation as it does not make an actual screenshot, but builds the screenshot based on the information available on the page.

How does it work?

The script is based on the html2canvas library, which renders the current page as a canvas image, by reading the DOM and the different styles applied to the elements. This script adds the options for the user to draw elements on top of that image, such as mark points of interest on the image along with the feedback they send.

No plugins, no flash, no interaction needed from the server, just pure JavaScript!

Try it out locally (frontend + backend)

• start a webserver in the root of feedback.js:

    python -m http.server --bind 127.0.0.1

• start the supplied sample backend:

    ./sample_backend.py

• open the http://localhost:8000/examples/ URL in the browser

• submit a feedback, and ignore the error (it's caused by CORS)

• watch the information gathered at the client side as logged by the sample backend

• examine the screenshot which the backend saves in the screenshot.png file

Options

Pass to constructor, e.g.

Feedback({
    h2cPath:'//cdnjs.cloudflare.com/ajax/libs/html2canvas/0.4.1/html2canvas.min.js',
    url: '/rest/feedback'});

Available options:

• adapter - sends the data overriding the default adapter in src/send/xhr.js
• appendTo - DOM element where to add the feedback button, defaults to document.body
• highlightClass - CSS class to use for elements that have been highlighted by the user during the screenshot review, defaults to feedback-highlighted
• redactClass - CSS class to use for elements that have been redacted by the user during the screenshot review, defaults to feedback-redacted
• elements - prompts and input fields to display during the form entry phase, defaults to a single text entry field
• h2cPath - url to html2canvas
• lang - auto for autodetect from browser or language code like ru_RU
• pages - dialogs with user. defaults to [Form, Screenshot, Review]
• url - url to post form data
• redactions - whether to offer the user the ability to redact elements during the screenshot review phase, defaults to true

html2canvas options (see http://html2canvas.hertzen.com/documentation.html#available-options):

• allowTaint
• background
• height
• letterRendering
• logging
• proxy
• taintTest
• timeout
• width
• useCORS

Building feedback.js

• Install gulp and uglifier at the command line if you don't already have it (uglifier is only needed if you are going to compile the minified version)

    npm install gulp gulp-concat
    npm install gulp-uglify

• Navigate to the feedback.js directory in the terminal and run one of the following

    gulp build
    gulp build:min

or both:

    gulp build build:min

Licensing

feedback.js is released under the MIT license:

• http://www.opensource.org/licenses/MIT

The webpages in the examples directory are adapted from example HTML provided by Twitter's Bootstrap project under an Apache-2.0 license, notably the hero example.