Poll Management

npm  install  fansunited-widget-poll

yarn  add  fansunited-widget-poll

import  'fansunited-widget-poll/style.css';
import { PollManager } from  'fansunited-widget-poll';

const  App = () => {
return (
<PollManager
	fansUnitedApiKey={'your-api-key'}
	fansUnitedClientId={'your-client-id'} />
);
}

type  PollManagerProps = {
	fansUnitedApiKey: string;
	fansUnitedClientId: string;
	fansUnitedLanguage?: string;
	fansUnitedEnvironment?: string;
	sportal365Project?: string;
	sportal365Infrastructure?: 'shared' | 'betway';
	labels?: LabelsModel;
	hideSignOutButton?: boolean;
};

import  'fansunited-widget-poll/style.css';
import { PollManager } from  'fansunited-widget-poll';

const  labels = {
	userNotFound:  'User not found. Please try again',
	clientFeaturesNotFoundMessage:  "There was a problem fetching client's configuration. Please check again your API key and client ID. For more information contact Fans United staff.",
	featureDisabled:  'Feature disabled!',
	noPermissionMessage:  'You have no permission for this feature!',
	tryAgainButton:  'Try again',
	noPollsFound: "No polls games were found. You can create one by clicking the button 'Create'",
	signOut:  'Sign out',
	timeFormat:  'DD.MM.YYYY, HH:mm',
	getPollsErrorMessage: 'There was a problem with fetching list of polls',
	title:  'Title',
	status:  'Status',
	votes:  'Votes',
	creationDate:  'Created at',
	actions:  'Actions',
	pageNo: 'Page No',
	createFromTemplate: 'Create from template',
	browsePolls: 'Browse Polls',
	noTemplatePollsFound: 'No polls found',
	expand: 'Expand',
	import: 'Import',
	translateAndImport: 'Translate to _language_ and Import',
	back: 'Back',
	create: 'Create',
	edit: 'Edit',
	save: 'Save',
	preview: 'Preview',
	close: 'Close',
	sortBy: 'Sort by:',
	sortByAscending: 'Sort by created at field in ascending order',
	sortByDescending: 'Sort by created at field in descending order',
	language: 'Language',
	languageDescription: 'Select the language for your Poll. You can manage language selection by configuring available languages in language configuration. It cannot be changed if multilingual feature is in use.',
	contextEntityTag: 'Context entity tag',
	typeContextTagNamePlaceholder: 'Type context tag name...',
	itemsPerPage:  'Items per page',
	showMoreImages: 'Show more images',
	hideMoreImages: 'Hide more images',
	uploadImage: 'Upload image',
	copyUrl: 'Copy URL',
	add: 'Add',
	configuration: 'Configuration',
	minimumVotes: 'Minimum votes',
	alternativeTitle: 'Alternative title',
	description: 'Description',
	images: 'Images',
	rules: 'Rules',
	adContent: 'Ad content',
	adContentPlaceholder: 'Place your ad content',
	mainImage: 'Main',
	coverImage: 'Cover',
	mobileImage: 'Mobile',
	clearImage: 'Clear image',
	viewImage: 'View image',
	cropImage: 'Crop image',
	aspectRatio: 'Aspect ratio',
	crop: 'Crop',
	reset: 'Reset',
	sportal365Images: 'Sportal365 Images',
	search: 'Search',
	delete: 'Delete',
	fromDate: 'From Date',
	toDate: 'To Date',
	active: 'Active',
	inactive: 'Inactive',
	expired: 'Expired',
	optionsDescription: 'Describe the options that users will select from the poll. Ensure to provide a minimum of 2 options. Title for each is required',
	repeatedValueMessage: 'You have entered a repeated value. Please enter a different one',
	flags: 'Flags',
	flagsPlaceholder: 'Type your flag and hit enter',
	labels: 'Labels',
	customFields: 'Custom fields',
	keyDynamicFields: 'Key',
	valueDynamicFields: 'Value',
	options: 'Options',
	optionNumber: 'Option number',
	context: 'Context',
	content: 'Content',
	tags: 'Tags',
	campaign: 'Campaign',
	id: 'ID',
	label: 'Label',
	type: 'Type',
	typeDescription: 'Select the poll type. You can set the types in our Management Portal by going to Features, then clicking on the Poll page',
	deleteLabel: 'Delete',
	deletePollTitle: 'Delete Poll',
	deletePollDescription: 'Are you sure you want to delete',
	previewPoll: 'Preview poll',
	getFootballEntitiesErrorMessage: "There was a problem with fetching football's data",
	createPollMessage: 'You have successfully created poll',
	createPollErrorMessage: 'There was a problem creating poll. Please try again',
	titleRequiredFieldValidationMessage: 'Title field is required!',
	externalActivityRequiredFieldValidationMessage: 'External activity field in Configuration is required!',
	optionsFieldValidationMessage: "Options must have titles",
	tagsInvalidFieldValidationMessage: 'Tag entity is required!',
	getPollErrorMessage: 'There was a problem with fetching poll data. Please try again',
	deletePollMessage: 'You have successfully deleted poll',
	deletePollErrorMessage: 'There was a problem with deleting poll. Please try again',
	updatePollMessage: 'You have successfully updated the poll',
	updatePollErrorMessage: 'There was a problem updating the poll. Please try again',
	uploadingImageMessage: 'You have successfully uploaded image',
	generateSignedInUrlErrorMessage: 'There was a problem generating signed in URL to store the image in bucket. Please try again',
	uploadingImageErrorMessage: 'There was a problem with uploading image to bucket. Please try again',
	encryptingImageErrorMessage: 'There was a problem with encrypting image before uploading it to bucket. Please try again',
	clear: 'Clear',
	searchSportal365ImagesErrorMessage: 'There was a problem with searching images from Sportal 365 API. Please try again',
	hideFilters: 'Hide filters',
	showFilters: 'Show filters',
	branding: 'Branding',
	urls: 'URLs',
	primaryUrl: 'Primary URL',
	secondaryUrl: 'Secondary URL',
	privacyPolicyUrl: 'Privacy Policy URL',
	termsAndConditionsUrl: 'Terms and Conditions URL',
	additionalUrl: 'Additional URL',
	colors: 'Colors',
	primaryColor: 'Primary Color',
	secondaryColor: 'Secondary Color',
	contentColor: 'Content Color',
	backgroundColor: 'Background Color',
	borderColor: 'Border Color',
	additionalColor: 'Additional Color',
	mainLogo: 'Main Logo',
	mobileLogo: 'Mobile Logo',
	backgroundImage: 'Background Image',
	mobileBackgroundImage: 'Mobile Background Image',
	additionalImage: 'Additional Image',
	embedCode: 'Embed Code',
	embedCodePlaceholder: 'Place your embed code here',
	usersExportMessage: "Users have been exported successfully",
	usersExportErrorMessage: "There was a problem with exporting users. Please try again",
	managePollTitle: "Manage Poll",
	managePollDescription: "Manage your Poll here",
	addOption: "Add option",
	removeOption: "Remove option",
	urlCopiedToClipboardMessage: "URL copied to clipboard",
	imageDeletedMessage: "Image deleted",
	imageResetMessage: "The initial size of the image has been restored",
	authRequirement: "Auth Requirement",
	authRequirementDescription: "Choose the type of authentication to be used.",
	free: "Free",
	lead: "Lead",
	registered: "Registered",
	paid: "Paid",
	optionDescriptionExplanation: "This optional field allows you to provide users with more information about the option",
	additionalFields: "Additional fields",
	addDescription: "Add description",
	addImages: "Add images",
	addEmbedCode: "Add embed code",
	schedule: "Schedule",
	scheduledTaskNotAvailable: "To configure scheduled tasks you need to first create your poll",
	createScheduledTaskMessage: "You have successfully created scheduled task",
	createScheduledTaskErrorMessage: "An error occurred while creating scheduled task. Please try again later",
	updateScheduledTaskMessage: "You have successfully updated scheduled task",
	updateScheduledTaskErrorMessage: "An error occurred while updating scheduled task. Please try again later",
	deleteScheduledTaskMessage: "You have successfully deleted scheduled task",
	deleteScheduledTaskErrorMessage: "An error occurred while deleting scheduled task. Please try again later",
	name: "Name",
	changeStatusTo: "Change status to:",
	at: "At:",
	deleteScheduledTaskModalTitle: "Delete scheduled task",
	deleteScheduledTaskModalParagraph: "Are you sure you want to delete the following scheduled task: ",
	languagesModalTitle: "Select Languages",
	languagesModalDescription: "Select the languages this poll is going to be translated in.",
	languagesModalSave: "Save language preference",
	languageParentText: "This poll is a translated version of",
	pollTranslationErrorMessage: "An error occurred while translating the poll.",
	translateTo: "Translate to _language_",
	additionalInformation: "Additional information",
	voting: 'Voting',
	reports: 'Reports',
	exports: 'Exports',
	option: 'Option',
	exportUsersData: 'Export users data',
	category: 'Category',
	action: 'Action',
	exportAllUsers: 'Export all users',
	exportAllUsersDescription: 'Export all users who voted in the poll.',
	participations: 'Participations',
	performanceByDay: 'Performance by day',
	pollChartErrorMessage: 'There was a problem with fetching information about poll participation. Please try again',
	exportUsersForOption: 'Export users voted for option',
	exportAllUsersForOption: 'Export all users who voted for option',
	exportForOption: 'Export for option',
	exportUsersLeads: 'Export users leads',
	exportAllUsersLeads: 'Export all users leads',
	exportAllUsersLeadsDescription: 'Export all users collected leads in the poll.',
	usersLeadsExportMessage: 'All users leads have been exported successfully',
	usersLeadsExportErrorMessage: 'There was a problem with exporting all users leads. Please try again',
	related: 'Related',
	entity: 'Entity',
	relationship: 'Relationship',
	relatedEntitiesErrorMessage: 'There was a problem with fetching entities for related. Please try again',
	widgetEmbedCodeTitle: 'Widget embed code',
	configureLeads: 'Configure leads',
	configureLeadsDisabledMessage: 'Configure leads is enabled only when the authentication requirement is set to “Lead”.',
	leadPosition: 'Lead position',
	addCampaignInfo: 'Add campaign info',
	campaignIdInfoMessage: 'Group multiple content items by a campaign ID. This field will be used for filtering later on, so make sure you have excatly the same ID across your multiple quizzes, polls and other games in general. We recommend using lowercase and -. Example: "adidas-december-2025"',
	campaignNameInfoMessage: 'A label for your campaign that will appear in the reports. You can use anything here. Example: "Adidas (December 2025)"',
	copyToClipboard: 'Copy to clipboard',
	divElementTextInfo: "The generated embed code can be copied directly into your website's HTML. For comprehensive implementation details, visit our documentation: ",
	widgetEmbedCodeNotAvailable: 'To configure embed code you need to first create your poll.',
	layoutTemplate: 'Layout template',
	layoutTemplateDescription: `Standard: image takes 30% width with configurable position. Split: image takes 50% width on the left. Overlay: image as background with content overlay.`,
	imagePosition: 'Image position',
	imagePositionDescription: 'Position of the image relative to the main content (only available for Standard layout).',
	signInLabel: 'Label',
	signInLabelInfoMessage: `Custom text displayed on the sign-in button. If empty, defaults to "Sign in to vote".`,
	authenticationHandler: 'Authentication handler',
	authenticationHandlerInfoMessage: 'JavaScript function code that executes when users click the sign-in button. To evaluate the function, provide only the function name. Example: showLoginModal() or window.openAuth(). The function is required otherwise the sign-in button will just log dummy message in the console.',
	configureSignIn: 'Configure sign-in options',
	configureSignInDisabledMessage: `Configure sign-in options is enabled only when the authentication requirement is set to “Registered”.`,
	enableMultipleChoice: 'Enable multiple choice',
	enableMultipleChoiceDescription: 'When enabled, users can select multiple options in the poll.',
	maximumOptions: 'Maximum options',
	maximumOptionsDescription: 'Set the maximum number of options a user can select in a multiple choice poll.',
	votesTooltipContent: 'Total number of votes received in poll',
	participationsTooltipContent: 'Number of unique users who have participated in poll',
	profilePreferencesMapping: 'Profile preferences mapping',
	profilePreferencesMappingEnabledDescription: 'Allows to create polls that collect user preference data. Users answer polls while you gather insights about their brand, product, and lifestyle preferences.',
	profilePreferencesMappingDisabledDescription: 'The "profile preferences" feature is disabled! To enabled it, contact the Fans United team.',
	preferenceMapping: 'Preference mapping',
	uncategorized: 'Uncategorized',
	maxAttempts: 'Maximum attempts',
	maxAttemptsDescription: `Set the maximum number of attempts a user can make in the poll. When set to -1, there is no limit. When it's different from 1, the poll CAN'T be set with multiple choice`,
	externalActivity: "External activity",
	externalActivityDescription: "SKU identifier required for users to vote in paid poll. Must not contain special characters. Cannot be changed once poll has votes.",
	noPreviewAvailable: "No preview available. Click Regenerate or select a different match.",
	createWithAi: 'Create with AI',
	generateFootballPostMatchLabel: '⚽ Football Post-Match',
	generateFootballPostMatchModalTitle: 'Football Post-Match Poll',
	teamsSelectionPlaceholder: 'Search teams by name...',
	searchTeamsErrorMessage: 'There was a problem searching teams.',
	targetLanguageDescription: 'Select the language in which the AI will create the entity.',
	searchMatch: 'Search match',
	searchMatchTooltip: 'Click to go back and change match selection',
	useFramingGuidelinesLabel: 'Use "Framing guidelines". This way, the last selected team\'s name will be replaced with "we/us/our" in questions and by first-person pronouns in options.',
	onEntityGenerateErrorMessage: 'Failed to generate AI content. Please try again',
	noPreviewAvailable: 'No preview available. Click Regenerate or select a different match.',
	engagementScore: 'Engagement score',
	noMatchesFound: 'No matches found for the selected filters.',
	page: 'Page',
	of: 'of',
	total: 'total',
	generate: 'Generate',
	regenerate: 'Regenerate',
	createAndContinue: 'Create and Continue',
	createAndGoTo: 'Create and Go To Poll',
	clonePollMessage: 'You have successfully cloned Poll',
	clonePollErrorMessage: 'There was a problem cloning Poll. Please try again',
	translationErrorMessage: 'An error occurred while translating.',
	clonePollTitle: 'Clone Poll',
	clone: 'Clone',
	translationOptions: 'Translate to:'
};

const  App = () => {
return (
<PollManager
	fansUnitedApiKey={'your-api-key'}
	fansUnitedClientId={'your-client-id'}
	labels={labels}/>
);
}