Widget Installation

Overview

The FeedbackNexus widget allows you to:

Embed feedback collection directly on your website
Maintain your site's look and feel
Collect feedback without redirecting users
Display existing feedback and voting
Customize appearance and behavior

Widget Files

Production URLs

Minified (Recommended): https://api.feedbacknexus.com/widget.min.js

Basic Installation

HTML Integration

The simplest way to add the widget to your website:

<!DOCTYPE html>
<html>
<head>
    <title>My Website</title>
</head>
<body>
    <!-- Your existing content -->
    <h1>Welcome to My App</h1>
    
    <!-- FeedbackNexus Widget -->
    <script src="https://api.feedbacknexus.com/widget.min.js"></script>
    <div id="feedback-widget"></div>
    <script>
    FeedbackNexus.init({
    portal: 'portal-name',
    container: '#feedback-widget',
    maxItems: 0 // 0 = show all
    });
    </script>
</body>
</html>

Configuration Options

Required Parameters

Parameter	Type	Description
`portal`	string	Your portal name (without portals.feedbacknexus.com)
`container`	string	CSS selector for the container element

Optional Parameters

Parameter	Type	Default	Description
`maxItems`	number	0	Maximum feedback items to display (0 = unlimited)

Example with All Options

FeedbackNexus.init({
    portal: 'portal-name',
    container: '#feedback-widget',
    maxItems: 20,
});

Styling & Customization

CSS Classes

The widget uses scoped CSS classes prefixed with fn-:

/* Customize widget container */
.fn-widget-container {
    border-radius: 8px;
    box-shadow: 0 2px 10px rgba(0,0,0,0.1);
}

/* Customize feedback items */
.fn-feedback-item {
    padding: 16px;
    margin-bottom: 12px;
}

/* Customize vote buttons */
.fn-vote-button {
    background-color: #your-color;
    border-radius: 4px;
}

Security Considerations

Domain Restrictions

Configure allowed domains in your portal settings:

Go to Settings → Widget Settings
Add your domains to the Allowed Domains list
Widget will only work on specified domains

Troubleshooting

Common Issues

Widget not loading:

Check that the portal name is correct
Verify the container element exists
Check browser console for errors
Ensure domain is in allowed domains list

Styling conflicts:

Widget uses scoped CSS classes (fn-*)
Check for CSS conflicts with your site
Use browser dev tools to inspect styles