Thomas Gibbons Consulting Qualtrics Wiki

User Tools

Site Tools

Trace:
mcpointallocation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
mcpointallocation [2023/03/12 14:01] – created adminmcpointallocation [2024/02/14 13:55] (current) – admin
Line 1: Line 1:
 ====== mcPointAllocation - Assign points or cost to each choice and calculate a total ====== ====== mcPointAllocation - Assign points or cost to each choice and calculate a total ======
-The **mcPointAllocation** function enables points or cost to be assigned to each choice in a multiple choice question and calculates, displays and saves the total for the choices selected. It supports setting a maximum total and can be used to do an allocation or build a product with specific features.+The **mcPointAllocation** function enables points or cost to be assigned to each choice in a multiple choice question and calculates, displays and saves the total for the choices selected. It supports setting a maximum total and can be used to do a weighted allocation or build a product with specific features.
  
 Features include: Features include:
Line 6: Line 6:
   * Easy to configure   * Easy to configure
   * Supports a maximum total   * Supports a maximum total
-  * Supports a base point allocation (e.g., price)+  * Supports a base point allocation (e.g., base price)
   * Total displayed based on locale (e.g., thousands separator, decimal point, etc.)   * Total displayed based on locale (e.g., thousands separator, decimal point, etc.)
   * Customizable total formatting   * Customizable total formatting
Line 12: Line 12:
  
 Here is a quick video demonstration:\\ Here is a quick video demonstration:\\
-Coming soon+{{ ::mcpointallocation.mp4?650 |mcPointAllocation Demonstration}}
  
 This function is available for a reasonable fee. Contact **[[https://community.qualtrics.com/XMcommunity/messages/add/TomG|TomG]]** on the Qualtrics Community to learn more. This function is available for a reasonable fee. Contact **[[https://community.qualtrics.com/XMcommunity/messages/add/TomG|TomG]]** on the Qualtrics Community to learn more.
Line 23: Line 23:
 Alternatively, paste the mcPointAllocation function JS into a question's JS outside the existing Qualtrics functions to make it available to questions on the page. Alternatively, paste the mcPointAllocation function JS into a question's JS outside the existing Qualtrics functions to make it available to questions on the page.
 ===== Question Setup ===== ===== Question Setup =====
-The mcPointsAllocation function uses two questions: the multiple choice question itself and a text entry question immediately following the multiple choice question to capture the total.  The text entry question is not visible to the respondent.+The mcPointAllocation function uses two questions: the multiple choice question itself and a text entry question immediately following the multiple choice question to capture the total.  The text entry question is not visible to the respondent.
 ==== MC Choices ==== ==== MC Choices ====
-Add the points or cost of each choice to the choice label inside a %%<span>%% with the class %%"pts"%%:+Add the points or cost of each choice to the choice label inside a %%<span>%% with the class %%"pts"%%. ONLY numbers  should be inside the %%<span>%%. All other text, such as currency symbols, should be outside the %%<span>%%. 
 <code> <code>
 <span class="pts">5</span> <span class="pts">5</span>
Line 32: Line 32:
 If there is a maximum point allocation or price, add custom validation to the multiple choice question to pass validation if the hidden text entry question is less than or equal to the maximum. If there is a maximum point allocation or price, add custom validation to the multiple choice question to pass validation if the hidden text entry question is less than or equal to the maximum.
 ==== MC Question JavaScript ==== ==== MC Question JavaScript ====
-Add JS to call the mcPointsAllocation function to apply it to the multiple choice question as follows:+Add JS to call the mcPointAllocation function to apply it to the multiple choice question as follows:
 <code> <code>
 Qualtrics.SurveyEngine.addOnload(function() { Qualtrics.SurveyEngine.addOnload(function() {
- mcPointsAllocation(this);+ mcPointAllocation(this);
 }); });
 </code> </code>
Line 41: Line 41:
 <code> <code>
 Qualtrics.SurveyEngine.addOnload(function() { Qualtrics.SurveyEngine.addOnload(function() {
- mcSubChoices(this,{max:1000,prefix:"$"});+ mcPointAllocation(this,{max:1000,prefix:"$"});
 }); });
 </code> </code>
Line 60: Line 60:
 Default: 0 Default: 0
 ==== label ==== ==== label ====
-**label** is a string that specifies text label of the total. +**label** is a string that specifies the text label of the total. 
  
 Default: %%"Total: "%% Default: %%"Total: "%%
Line 68: Line 68:
 Default: %%"text-align:right;font-weight:bold;"%% Default: %%"text-align:right;font-weight:bold;"%%
 ==== max ==== ==== max ====
-**max** is a numeric field containing the maximum total. When max=0 there is no maximum. When the total exceeds max, the total (including prefix and suffix) will be displayed in overMaxColor. +**max** is a numeric field containing the maximum total. When max=0 there is no maximum. When the total exceeds max, the total (including **[[mcpointallocation#prefix|prefix]]** and **[[mcpointallocation#prefix|suffix]]**) will be displayed in **[[mcpointallocation#overmaxcolor|overMaxColor]]**. 
  
 Default: 0 Default: 0
Line 79: Line 79:
  
 Default: %%""%% Default: %%""%%
-==== prefix ====+==== suffix ====
 **suffix** is a string that specifies the text to be shown after the total (e.g., %%"€"%%).  **suffix** is a string that specifies the text to be shown after the total (e.g., %%"€"%%). 
  
mcpointallocation.1678644086.txt.gz · Last modified: by admin
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki