https://nodevision.com.au/component---src-pages-user-poll-configuration-index-js-4d949852ea38170c55cb.js

1"use strict";(self.webpackChunkgatsby_starter_default=self.webpackChunkgatsby_starter_default||[]).push([[572],{7528:function(e,t,l){l.d(t,{d:function(){return o}});var n=l(6540),a=l(5556),r=l.n(a),c=l(4810);const o=e=>{let{description:t,lang:l="en",meta:a=[],keywords:r,title:o,ogImage:u,siteUrl:m}=e;const{site:s}=(0,c.useStaticQuery)("3492837776"),d=t||s.siteMetadata.description,i=r||s.siteMetadata.keywords,E=o||s.siteMetadata.title,h=u||s.siteMetadata.ogImage,p=m||s.siteMetadata.siteUrl,g=[{name:"google-site-verification",content:s.siteMetadata.googleSiteVerification},{name:"description",content:d},{property:"og:title",content:E},{property:"og:description",content:d},{property:"og:type",content:"website"},{name:"twitter:card",content:"summary"},{name:"twitter:creator",content:"Node Vision"},{name:"twitter:title",content:E},{name:"twitter:description",content:d},{name:"keywords",content:i},{name:"og:image",content:p+h}].concat(a);return n.createElement(n.Fragment,null,n.createElement("html",{lang:l}),n.createElement("title",null,E),g.map((e,t)=>e.name?n.createElement("meta",{key:t,name:e.name,content:e.content}):e.property?n.createElement("meta",{key:t,property:e.property,content:e.content}):null))};function u(e){return"undefined"!=typeof window&&console.warn("SEO component is deprecated. Please update your page to export a Head function using SEOTags component."),null}u.defaultProps={lang:"en",meta:[]},u.propTypes={description:r().string,lang:r().string,meta:r().array,keywords:r().arrayOf(r().string),title:r().string},t.A=u},9076:function(e,t,l){l.r(t),l.d(t,{Head:function(){return c}});var n=l(6540),a=l(4728),r=l(7528);t.default=()=>n.createElement(a.A,{pageType:"blog"},n.createElement("div",{className:"pdp-docs"},n.createElement("section",{className:"heading"},n.createElement("h1",null,"User Poll - Configuration Reference")),n.createElement("section",{className:"content"},n.createElement("div",{className:"container"},n.createElement("p",null,"All User Poll settings are managed through the built-in configuration panel. Click"," ",n.createElement("strong",null,"Open configuration")," in the web part toolbar to access it. The panel is organized into tabs:"),n.createElement("table",{className:"doc-table"},n.createElement("thead",null,n.createElement("tr",null,n.createElement("th",

1null,"Tab"),n.createElement("th",null,"What it controls"))),n.createElement("tbody",null,n.createElement("tr",null,n.createElement("td",null,"General"),n.createElement("td",null,"Poll question, answers, voting mode, scheduling, and results display")),n.createElement("tr",null,n.createElement("td",null,"Advanced"),n.createElement("td",null,"JSON5 configuration editor for theme, chart, and translation settings")),n.createElement("tr",null,n.createElement("td",null,"Custom CSS"),n.createElement("td",null,"CSS stylesheet editor for visual customizations")),n.createElement("tr",null,n.createElement("td",null,"Licensing"),n.createElement("td",null,"License key input and validation")),n.createElement("tr",null,n.createElement("td",null,"About"),n.createElement("td",null,"Version and product information")))),n.createElement("h2",null,"General settings"),n.createElement("h3",null,"Poll setup"),n.createElement("table",{className:"doc-table"},n.createElement("thead",null,n.createElement("tr",null,n.createElement("th",null,"Setting"),n.createElement("th",

1null,"Type"),n.createElement("th",null,"Default"),n.createElement("th",null,"Description"))),n.createElement("tbody",null,n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"enable")),n.createElement("td",null,"boolean"),n.createElement("td",null,n.createElement("code",null,"true")),n.createElement("td",null,"Enable or disable voting. When disabled, users cannot submit votes.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"question")),n.createElement("td",null,"string"),n.createElement("td",null,"—"),n.createElement("td",null,"The poll question displayed to users. Required.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"description")),n.createElement("td",null,"string"),n.createElement("td",null,"—"),n.createElement("td",null,"Optional description shown below the question for additional context.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"allowMultiple")),n.createElement("td",null,"boolean"),n.createElement("td",null,n.createElement("code",null,"false")),n.createElement("td",null,"If ",n.createElement("code",null,"true"),", users can select multiple answers (checkboxes). If ",n.createElement("code",null,"false"),", only one answer (radio buttons).")))),n.createElement("h3",null,"Answers"),n.createElement("p",null,"Each answer option has the following properties:"),n.createElement("table",{className:"doc-table"},n.createElement("thead",null,n.createElement("tr",null,n.createElement("th",

1null,"Property"),n.createElement("th",null,"Type"),n.createElement("th",null,"Description"))),n.createElement("tbody",null,n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"title")),n.createElement("td",null,"string"),n.createElement("td",null,"The answer text displayed to voters. Required.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"note")),n.createElement("td",null,"string"),n.createElement("td",null,"Optional note shown below the answer title for additional context.")))),n.createElement("p",null,"Answers can be reordered using the up/down buttons in the configuration panel. Each answer also displays its current vote count."),n.createElement("h3",null,"Scheduling"),n.createElement("table",{className:"doc-table"},n.createElement("thead",null,n.createElement("tr",null,n.createElement("th",null,"Setting"),n.createElement("th",null,"Type"),n.createElement("th",null,"Default"),n.createElement("th",null,"Description"))),n.createElement("tbody",null,n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"openingTime")),n.createElement("td",null,"datetime"),n.createElement("td",null,"—"),n.createElement("td",null,"When the poll opens for voting. Leave empty for immediately available. Before this time, the poll questions are hidden.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"closingTime")),n.createElement("td",null,"datetime"),n.createElement("td",null,"—"),n.createElement("td",null,"When voting ends. After this time, no new votes are accepted.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"displayResultsAfterPollClosingTime")),n.createElement("td",null,"boolean"),n.createElement("td",null,n.createElement("code",null,"true")),n.createElement("td",null,"Automatically show results after the closing time passes.")))),n.createElement("h3",null,"Results display"),n.createElement("table",{className:"doc-table"},n.createElement("thead",null,n.createElement("tr",null,n.createElement("th",

1null,"Setting"),n.createElement("th",null,"Type"),n.createElement("th",null,"Default"),n.createElement("th",null,"Description"))),n.createElement("tbody",null,n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"displayResultsAfterSubmitting")),n.createElement("td",null,"boolean"),n.createElement("td",null,n.createElement("code",null,"true")),n.createElement("td",null,"Show results immediately after a user submits their vote.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"resultChart")),n.createElement("td",null,"string"),n.createElement("td",null,n.createElement("code",null,'"PIE"')),n.createElement("td",null,"Chart type for results. Values:"," ",n.createElement("code",null,'"PIE"')," (pie chart) or"," ",n.createElement("code",null,'"BAR"')," (bar chart).")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"displayCountInResult")),n.createElement("td",null,"boolean"),n.createElement("td",null,n.createElement("code",null,"true")),n.createElement("td",null,"Show vote counts next to each answer in results.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"displayAnswerNoteInResult")),n.createElement("td",null,"boolean"),n.createElement("td",null,n.createElement("code",null,"true")),n.createElement("td",null,"Show answer notes in the results view.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"displayPollQuestionNoteInResult")),n.createElement("td",null,"boolean"),n.createElement("td",null,n.createElement("code",null,"true")),n.createElement("td",null,"Show the poll description in the results view.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"displayTotalVotes")),n.createElement("td",null,"boolean"),n.createElement("td",null,n.createElement("code",null,"true")),n.createElement("td",null,"Show the total number of votes at the bottom of results.")))),n.createElement("h2",null,"Advanced configuration (JSON5)"),n.createElement("p",null,"The ",n.createElement("strong",null,"Advanced")," tab provides a JSON5 editor for settings that don't have dedicated form controls. The following sections are available:"),n.createElement("h3",null,"Theme"),n.createElement("table",{className:"doc-table"},n.createElement("thead",null,n.createElement("tr",null,n.createElement("th",

1null,"Setting"),n.createElement("th",null,"Type"),n.createElement("th",null,"Default"),n.createElement("th",null,"Description"))),n.createElement("tbody",null,n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"primaryColor")),n.createElement("td",null,"string"),n.createElement("td",null,n.createElement("code",null,'"#0078d4"')),n.createElement("td",null,"Main UI accent color (buttons, selected states).")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"secondaryColor")),n.createElement("td",null,"string"),n.createElement("td",null,n.createElement("code",null,'"#F50057"')),n.createElement("td",null,"Secondary accent color.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"chartColors")),n.createElement("td",null,"string[]"),n.createElement("td",null,n.createElement("code",null,'["#43A19E", "#7B43A1", "#F2317A", "#FF9824", "#58CF6C"]')),n.createElement("td",null,"Array of colors for chart segments/bars. Each answer uses the next color in the array.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"fontFamily")),n.createElement("td",null,"string"),n.createElement("td",null,"Segoe UI"),n.createElement("td",null,"Font family for all poll text.")))),n.createElement("h3",null,"Layout"),n.createElement("table",{className:"doc-table"},n.createElement("thead",null,n.createElement("tr",null,n.createElement("th",

1null,"Setting"),n.createElement("th",null,"Type"),n.createElement("th",null,"Default"),n.createElement("th",null,"Description"))),n.createElement("tbody",null,n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"maxWidth")),n.createElement("td",null,"string"),n.createElement("td",null,n.createElement("code",null,'"auto"')),n.createElement("td",null,"Maximum width of the poll container. Values:"," ",n.createElement("code",null,'"auto"'),", pixels (e.g."," ",n.createElement("code",null,'"600px"'),"), or percentage (e.g."," ",n.createElement("code",null,'"80%"'),").")))),n.createElement("h3",null,"Pie chart settings"),n.createElement("p",null,"Fine-tune the pie chart appearance:"),n.createElement("table",{className:"doc-table"},n.createElement("thead",null,n.createElement("tr",null,n.createElement("th",null,"Setting"),n.createElement("th",null,"Type"),n.createElement("th",null,"Default"),n.createElement("th",null,"Description"))),n.createElement("tbody",null,n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"pieChart.radiu

1s")),n.createElement("td",null,"number"),n.createElement("td",null,n.createElement("code",null,"40")),n.createElement("td",null,"Radius of the pie chart.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"pieChart.lineWidth")),n.createElement("td",null,"number"),n.createElement("td",null,n.createElement("code",null,"93")),n.createElement("td",null,"Width of pie segments as a percentage (0–100). Lower values create a donut chart.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"pieChart.segmentsShift")),n.createElement("td",null,"number"),n.createElement("td",null,n.createElement("code",null,"0.5")),n.createElement("td",null,"Gap between pie segments in pixels.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"pieChart.labelPosition")),n.createElement("td",null,"number"),n.createElement("td",null,n.createElement("code",null,"65")),n.createElement("td",null,"Position of percentage labels within segments (0 = center, 100 = edge).")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"pieChart.labelStyle")),n.createElement("td",null,"object"),n.createElement("td",null,"—"),n.createElement("td",null,"CSS-like style object for labels:"," ",n.createElement("code",null,"fill"),", ",n.createElement("code",null,"fontSize"),","," ",n.createElement("code",null,"fontWeight"),".")))),n.createElement("h3",null,"Translations"),n.createElement("p",null,"Override any UI label in the ",n.createElement("code",null,"translations")," ","section:"),n.createElement("table",{className:"doc-table"},n.createElement("thead",null,n.createElement("tr",null,n.createElement("th",

1null,"Key"),n.createElement("th",null,"Default (English)"),n.createElement("th",null,"Description"))),n.createElement("tbody",null,n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"poll")),n.createElement("td",null,"Poll"),n.createElement("td",null,"Label shown above the poll question.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"pollResult")),n.createElement("td",null,"Poll result"),n.createElement("td",null,"Label shown above the results section.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"noResults")),n.createElement("td",null,"We are sorry. No one participated in the poll."),n.createElement("td",null,"Message shown when there are no votes.")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,"total")),n.createElement("td",null,"Total"),n.createElement("td",null,"Label for the total votes count.")))),n.createElement("h3",null,"Example advanced configuration"),n.createElement("pre",{className:"code-block"},n.createElement("code",null,"{\n  displayCountInResult: true,\n  displayPollQuestionNoteInResult: true,\n  displayAnswerNoteInResult: true,\n  displayTotalVotes: true,\n  maxWidth: '600px',\n\n  theme: {\n    primaryColor: '#0078d4',\n    secondaryColor: '#F50057',\n    chartColors: ['#43A19E', '#7B43A1', '#F2317A', '#FF9824', '#58CF6C'],\n    fontFamily: '\"Segoe UI\", Tahoma, Helvetica, Arial, sans-serif',\n  },\n\n  pieChart: {\n    radius: 40,\n    lineWidth: 93,\n    segmentsShift: 0.5,\n    labelPosition: 65,\n    labelStyle: {\n      fill: '#fff',\n      fontSize: '5px',\n      fontWeight: 'bold',\n    },\n  },\n\n  translations: {\n    poll: 'Poll',\n    pollResult: 'Poll result',\n    noResults: 'No votes have been submitted yet.',\n    total: 'Total',\n  },\n}")),n.createElement("h2",null,"Custom CSS"),n.createElement("p",null,"The ",n.createElement("strong",null,"Custom CSS")," tab provides a code editor where you can add CSS rules to style the poll. The following CSS class names are available as styling hooks:"),n.createElement("table",{className:"doc-table"},n.createElement("thead",null,n.createElement("tr",null,n.createElement("th",

1null,"Class"),n.createElement("th",null,"Element"))),n.createElement("tbody",null,n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,".nv-poll")),n.createElement("td",null,"Top-level poll container")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,".nv-poll-question-wrapper")),n.createElement("td",null,"Container for the question and answers")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,".nv-poll-question-text")),n.createElement("td",null,"The poll question text")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,".nv-poll-result-question")),n.createElement("td",null,"Question text in the results view")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,".nv-poll-result-legend-wrapper")),n.createElement("td",null,"Legend container in results (pie chart mode)")),n.createElement("tr",null,n.createElement("td",null,n.createElement("code",null,".nv-poll-result-bar-wrapper")),n.createElement("td",null,"Bar container in results (bar chart mode)")))),n.createElement("h3",null,"Example: Custom styling"),n.createElement("pre",{className:"code-block"},n.createElement("code",null,"/* Center the poll and limit width */\n.nv-poll {\n  max-width: 500px;\n  margin: 0 auto;\n}\n\n/* Style the question text */\n.nv-poll-question-text {\n  font-size: 1.4rem;\n  font-weight: bold;\n  color: #333;\n}\n\n/* Add a border to the results legend */\n.nv-poll-result-legend-wrapper {\n  border: 1px solid #eee;\n  border-radius: 8px;\n  padding: 16px;\n}")),n.createElement("h2",null,"Data management"),n.createElement("h3",null,"CSV export"),n.createElement("p",null,"Export poll results from the configuration panel. The CSV file includes the following columns:"),n.createElement("table",{className:"doc-table"},n.createElement("thead",null,n.createElement("tr",null,n.createElement("th",

1null,"Column"),n.createElement("th",null,"Description"))),n.createElement("tbody",null,n.createElement("tr",null,n.createElement("td",null,"User ID"),n.createElement("td",null,"SharePoint user identifier")),n.createElement("tr",null,n.createElement("td",null,"User Name"),n.createElement("td",null,"Display name of the voter")),n.createElement("tr",null,n.createElement("td",null,"User Email"),n.createElement("td",null,"Email address of the voter")),n.createElement("tr",null,n.createElement("td",null,"Selected Answers"),n.createElement("td",null,"The answer(s) the user selected")))),n.createElement("h3",null,"Reset votes"),n.createElement("p",null,"To clear all votes and start fresh, use the"," ",n.createElement("strong",null,"Reset votes")," button in the configuration panel. This permanently deletes all vote data for the poll instance."),n.createElement("div",{className:"warning-note"},n.createElement("strong",null,"Warning:")," Resetting votes cannot be undone. Consider exporting to CSV first if you need a record of the results."),n.createElement("div",{className:"help-note"},n.createElement("strong",null,"Need help configuring?")," See the"," ",n.createElement("a",{href:"/user-poll-docs"},"documentation overview")," or contact us at"," ",n.createElement("a",{href:"mailto:[email protected]"},"[email protected]"),".")))));const c=()=>n.createElement(r.d,{keywords:["user poll configuration","sharepoint poll settings","spfx poll web part setup","sharepoint poll customization"],description:"Complete configuration reference for User Poll - all settings for poll behavior, results display, pie and bar charts, theme, scheduling, translations, and custom CSS.",title:"Node Vision | User Poll - Configuration Reference"})}}]);
2//# sourceMappingURL=component---src-pages-user-poll-configuration-index-js-4d949852ea38170c55cb.js.map