Differences

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

--- mcalphabetize [2022/11/01 17:10] – admin
+++ mcalphabetize [2024/02/07 17:52] (current) – [langs] admin
@@ Line 10: / Line 10: @@
 mcAlphabetize currently does **not** support choice groups.
-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/inbox/conversation?with=373|TomG]]** on the Qualtrics Community to learn more.
-To alphabetize options in side-by-side dropdowns on-the-fly, see **[[sbsSelectAlphabetize|sbsSelectAlphabetize]]**.
+To alphabetize options in side-by-side dropdowns on-the-fly, see **[[sbsSelectAlphabetize|sbsSelectAlphabetize]]**. To alphabetize drill-down dropdowns on-the-fly, see **[[ddAlphabetize|ddAlphabetize]]**.
 ===== Set-up Instructions =====
 ==== Survey Header ====
-To make the function available to all questions in the survey, copy the function to the Survey Header inside a script tag:
 Add the mcAlphabetize function to the survey header to make it available to any question in the survey.   Go to Look & Feel -> General -> Header edit -> {{::icon_source.jpg?20|}} and paste the provided mcAlphabetize function JS:
 <code>
@@ Line 50: / Line 49: @@
 Default: [] (nothing anchored)
+==== langs ====
+**langs** is an object for mapping Qualtrics language codes to valid JavaScript locale languages for correct sorting. It is only needed if the Qualtrics language code doesn't resolve to a valid JavaScript locale language code. Of the built-in Qualtrics language only ZH-S (Simplified Chinese) and ZH-T (Traditional Chinese) don't resolve, but they are included in the **langs** object by default.
+If you have created your own language code, you made need to add your language to the langs object if it doesn't automatically resolve. A new language specification would look like %%langs:{"XX":"yy"}%%.
+==== qlang ====
+**qlang** is the Qualtrics language code string that should be used to do the alphabetization. By default, this is the current language of the survey.
+Default: %%"${e://Field/Q_Language}"%%
 ====== Qualtrics Wiki ======
 [[start|Qualtrics Wiki]]