Beschrijving
De Personality Quiz add-on voor Gravity Forms laat je toe simpele, niet te verbeteren quizzen aan te maken (denk Buzzfeed-achtige quizzen).
Hoewel er een officiële quiz add-on is voor Gravity Forms, focust die zich op quizzen die je moet verbeteren, zoals je er zou krijgen op school. Deze add-on laat je gemakkelijk quizzen aanmaken die een resultaat teruggeven in plaats van een punt, zoals “Hoe Texaans ben jij?” of “Welk Disney karakter zou je zijn?”
Naast het opzetten van de logica voor deze quizzen implementeert deze add-on ook de WordPress media uploader om het ongelooflijk makkelijk te maken om afbeeldingen te gebruiken als label voor vragen en antwoorden. De add-on bevat enige vormgeving om je quizzen er standaard goed uit te laten zien, maar deze kan aan- of uitgezet worden voor elke quiz.
Over de plugin
Hou rekening met het volgende voor je een quiz maakt:
- Deze plugin is niet compatibel met de officiële Gravity Forms quiz add-on. Probeer beiden niet in hetzelfde formulier te gebruiken.
- Alleen keuzerondjes en selectievakjes ingaves worden ondersteund.
Je kan twee types quizzen bouwen: numerieke en multiple choice. Numerieke quizzen produceren een numeriek resultaat, of puntentelling, terwijl multiple choice quizzen een tekst als resultaat produceren.
Bij numerieke quizzen gebeurt de puntentelling door de waarden van de keuzerondjes of selectievakjes op te tellen. Een numerieke quiz kan vragen “Hoeveel hou je van WordPress?”, met vragen die puntwaarden bevatten gebaseerd op hoe vaak de gebruiker met WordPress werkt.
Bij multiple choice quizzen word gekeken welke ingevoerde waarde het meest geselecteerd werd door de gebruiker, en word die waarde teruggegeven als het quiz resultaat. Bij een gelijke stand wordt een willekeurige winnaar bepaald. Een multiple choice quiz kan vragen “Naar welk land moet je de volgende keer reizen?”, waarbij de antwoorden op elke vraag overeenkomen met een land.
Numeric quizzes with multiple categories will calculate point totals like a numeric quiz, but into different categories. There is no single winner as in a “multiple choice” quiz, but simply different totals for separate categories. A multiple choice quiz might also ask “Which country should you travel to next?”, but instead of returning a single result, it will return the number of “points” you scored for each country.
Je quiz instellen
- Activeer de quiz in het “Personality Quiz Instellingen” menu onder “Formulier Instellingen”. Hier selecteer je of je quiz numeriek of multiple choice zal zijn.
- Je formuliervelden instellen (zie details onderaan).
Formulier velden instellen
- Om een veld te gebruiken voor je quiz puntentelling moet je het activeren door het “Gebruik voor Personality Quiz Puntentelling” selectievakje aan te vinken.
- Indien je de volgorde van de invoeren van je formulier velden willekeurig wilt maken, vink het “Schud antwoorden” selectievakje aan.
- Je kan het label van een formulier veld vervangen door een afbeelding door op de upload knop te klikken onder de “Personality Quiz Afbeelding Label” instelling.
- Elk keuzerondje of selectievakje in een veld kan ook een afbeelding als label hebben. Klik op het afbeelding pictogram naast het veld label om een afbeelding in het label te plaatsen.
- De waarde van je veld instellen is de belangrijkste stap om je quiz aan het werk te krijgen. Zie hieronder voor meer details.
Numerieke Waarden
Numerieke quizzen tellen simpelweg nummers op om een totaal te produceren. Als het je niet uitmaakt of het resultaat van je quiz opgeslagen wordt kan je simpelweg getallen gebruiken als je invoerwaarden. Als het je wel uitmaakt of het resultaat van je quiz opgeslagen wordt, kan je de numerieke puntentelling in accolades aan het invoerveld toevoegen, op deze manier:
mijn-veld-waarde{1}
Numeric Values – Multiple Categories
For these results, each radio/checkbox answer must use the format category-name{score}
, where score
is a point value. A single checkbox or radio may add points to multiple categories. See examples:
Label: Apple
Waarde: apple{1}
Label: Banana
Waarde: banana{1}
Label: Fruitmand
Waarde: apple{1},banana{1},strawberry{1}
Multiple Choice Waarden
Multiple choice quizzen zijn bedoeld om te bepalen welke keuze een gebruiker het meest gemaakt heeft. Gewoonlijk zal elke vraag in een multiple choice quiz een invoer bevatten die gelinkt is aan elke keuze. Een quiz om te bepalen of je de voorkeur geeft aan appels of sinaasappelen, bijvoorbeeld, zou een invoer met de waarde “appel” in elke vraag en een invoer met de waarde “sinaasappel” in elke vraag hebben.
Quiz Vormgeving
De add-on beschikt over enige standaard, optionele vormgeving die je kan activeren in het “Personality Quiz Instellingen” menu onder “Formulier Instellingen”. Om kolommen te gebruiken voor je keuzerondjes- en selectievakjes-elementen maak je gebruik van de ingebouwde Ready Classes van Gravity Forms:
http://www.gravityhelp.com/css-ready-classes-for-gravity-forms/
Quiz resultaat weergeven
Het quiz resultaat is beschikbaar in je bevestigingen en berichten als een merge tag. Voor numerieke quizzen kan je ook het resultaat percentage insluiten (berekend aan de hand van het totale aantal beschikbaar punten in de quiz) of het resultaat gemiddelde (punten per vraag in de quiz).
For numeric quizzes with multiple categories, you will see multiple merge tags for each category; each one with a total, percentage of total, and average.
Om verschillende bevestigingen of berichten op te stellen die afhankelijk zijn van het quiz resultaat zal je gebruik moeten maken van de conditionele logica van Gravity Forms. Voor numerieke quizzen kan je gebruik maken van regels zoals ‘groter dan’ en ‘kleiner dan’ om bevestigingen te maken gebaseerd op het numerieke totaal in het quiz resultaat. Voor multiple choice quizzen maak je één bevestiging aan voor elk potentieel resultaat (bv. een bevestiging voor “appel” en een bevestiging voor “sinaasappel”).
Aan het bijdragen
Je kan bijdragen aan deze add-on met Github:
https://github.com/dabernathy89/gravity-forms-personality-quiz-add-on
Schermafdrukken
Installatie
Installeer via het WordPress dashboard, of upload de uitgepakte map naar je plugins folder.
Beoordelingen
Bijdragers & ontwikkelaars
“Gravity Forms Personality Quiz Add-On” is open source software. De volgende personen hebben bijgedragen aan deze plugin.
BijdragersVertaal “Gravity Forms Personality Quiz Add-On” naar jouw taal.
Interesse in ontwikkeling?
Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.
Changelog
1.1.2 – Add overall result for numeric quizzes with multiple categories
1.1.1 – Code cleanup
1.1.0 – Nieuwe functie: je kan nu de quiz merge tag in andere formulier velden gebruiken (zoals verborgen velden). Dit is handig in combinatie met andere add-ons die veld waarden gebruiken voor conditionele logica maar die geen merge tags ondersteunen.
1.0.0 – De plugin registreert nu correct met de laatste versie van WordPress en Gravity Forms. Omdat bestanden hernoemd zijn in deze release zal de plugin automatisch gedeactiveerd worden. Je zal deze opnieuw moeten activeren.
0.9 – Nieuwe feature: geef gemiddelde resultaten voor numerieke quizzen weer (bijgedragen door collinmanderson)
0.8 – Bug fix: sta toe quiz resultaten te exporteren met inzendingen; Bug fix: veld label afbeeldingen werken nu correct
0.7 – toegang tot $field als een object in plaats van een array; lost bug op bij het berekenen van het puntentelling percentage van het totaal
0.6 – verbeterde documentatie; nieuwe methode om punten te tellen om GF toe te laten quiz resultaten op te slaan
0.4 – vormgeving updates: laat gebruiker kolommen definiëren met GF ready classes
0.3 – vormgeving update
0.2 – sta toe quiz antwoord schudden aan en uit te zetten per vraag
0.1 – initiële plugin