Kindly EditDocumentationTry the editor

Quizzes, surveys, form pages and posts

Score answers as a quiz, show survey results, give a form its own page, and create posts and user accounts from entries.

A form can score its answers as a quiz, show survey results, live on a page of its own, and turn each entry into a WordPress post or user account. All of these are settings of an ordinary form: the quiz, survey and form page settings are in the builder's Settings tab, and posts and accounts are connections in the Connections tab.

Quizzes#

Settings > Quiz scores the answers on the server when the form is sent. Visitors can't change their score from the browser.

Setting What it does
Score answers as a quiz Turns it on.
Result A score (points for right answers) or A personality (the answers point to one of several results).
Show the result after sending Adds the result under the confirmation message.
Shuffle the questions Scored questions trade places at random, each time the form is shown. Other fields stay where they are, and questions stay within their own step.
Shuffle the choices The choices of scored questions appear in a random order.

Quiz questions can be Choose one, Choose several, Drop-down, Text, Number and Rating fields. "Add choice questions in Build to score them."

A score#

Under Right answers, each question gets:

  • its right answers: chosen from the choices with Add a right answer, or typed for text and number questions (Right answers, separated by commas)
  • Points, 1 by default; decimals and negative numbers work
  • for Choose several, how it scores: Any right answer scores (at least one right choice and no wrong ones) or All right answers, nothing else

Typed answers are compared without regard to capital letters or spaces at either end. Questions without right answers aren't scored.

Grades turn the percent into a word: each grade has a name, From % and To %, and the first grade whose range holds the percent is used. Use Add a grade for each.

A personality#

Under Personalities, add each result with Add a personality: a name and What the result says. Then, for each choice question, choose which personality each choice points to (or No personality). The personality chosen most wins. A tie goes to the one listed first.

Showing the result#

With Show the result after sending, the confirmation message gets the result line:

  • a score: for example "Merit: 8 of 10 points (80%)", followed by a table of each question with Your answer, Right answer, and Right or Not right
  • a personality: its name and its text

This applies to message confirmations, not to ones that go to a page or address.

The Quiz result field (Advanced fields) keeps part of the result in the entry, so it shows in Entries, exports and connections. Its Keep setting is Points, Percent, Right answers of total, Grade or Personality. Visitors don't fill it in.

Smartcodes for confirmations, emails and the answers page: "Use {quiz.score}, {quiz.percent} and {quiz.grade} in confirmations and emails."

Smartcode Gives
{quiz_result} The full result line (or the personality and its text)
{quiz.score}, {quiz.possible} Points scored and points possible
{quiz.percent} The percent, with %
{quiz.right}, {quiz.questions} Right answers and scored questions
{quiz.grade} The grade
{quiz.personality}, {quiz.personality_text} The personality's name and text
{quiz.answers} The table of every question

See the Smartcode reference for the rest.

Surveys#

Settings > Survey results shows everyone's answers so far as bars after sending.

Setting What it does
Show everyone's results after sending Adds results for every choice question under the confirmation message.
With counts Shows the number beside each percent.
With the question Shows each question above its bars.

Results cover Drop-down, Choose one, Choose several, Country, Rating, Net Promoter Score and Opinion scale questions. Each choice shows its percent of the people who answered that question. Entries in Spam, in Trash and those waiting for an email confirmation don't count.

To show results anywhere on the site, use the shortcode:

[kindly_forms_results form="12"]
[kindly_forms_results form="12" field="favorite_activity" counts="no" labels="no"]

form is the form's ID. field limits it to one question (its field name). counts="no" hides counts and labels="no" hides the questions. Only published forms show results.

Form pages (landing pages)#

Settings > Form page gives a form "a page of its own at its own address, without the site's menus." The page uses the theme's styles and fonts, so the form looks as it does elsewhere on the site.

Setting What it does
Give this form its own page Turns it on.
Address The last part of the address, such as contact-us. Empty uses the form's ID.
Password to open it Visitors type it once, then it is remembered in their browser for a day. Empty means no password.
Heading Empty uses the form's title.
Text Words under the heading.
Layout Boxed (the form on a white card), With a picture (two columns) or Plain.
Picture, Picture side For With a picture: the image and Left or Right. On phones the picture goes on top.
Logo Shown above the heading.
Background, Background picture A color and an image behind the page.

The page lives at /form/your-address/. The word form can be changed for the whole site in Kindly Edit > Forms > Settings > Maps and location > Address word for form pages. On sites without pretty permalinks the address is ?kindly_form=your-address.

The address starts working once the form is published with its page turned on. {form_page} gives the address in emails and confirmations. Form pages can be found by search engines; the answers page and Preview can't.

The builder's Preview in a new tab shows the draft on a similar page for people who may edit the form. Its note says whether visitors still see the published version. Answers sent from Preview are kept like any others.

Posts and user accounts#

Three connections in the Connections tab, under Posts and accounts, act on the site itself. They run at once, in the same request, not in the background queue. Each has a Run event, conditions, and lines in the form's API log like other connections. See Connections.

Fields marked as accepting smartcodes take answers such as {inputs.title}.

Create a post#

"Make a post, page or custom post type from each entry, or update one from the front end."

Setting What it does
Action Create a post or Update a post.
Post to update For updates: the post's ID, for example {get.post_id} or {embed_post.ID}. "Only people who may edit that post can update it."
Post type Any post type with an admin screen.
Status Pending review (default), Draft, Published or Private.
Author A site author, or The person filling it in (when signed in).
Title, Content, Excerpt From answers. An empty title becomes the form's title and the entry number.
Featured image from An image or file upload field.
Categories, tags and terms Pairs of a taxonomy (category, post_tag and others) and term names or IDs, separated by commas. Missing tags are created; missing categories in hierarchical taxonomies are not.
Allow comments Opens comments on the new post.
Custom fields Meta key and what to save. JetEngine fields use these too.
ACF fields, Meta Box fields Shown when those plugins are active.

When updating, empty title, content and excerpt leave the post's own unchanged. The post's ID is saved on the entry.

Register a user#

"Make a WordPress account from each entry, with a role, profile and custom fields."

Setting What it does
Fields Map answers to Email (required), Username ("Empty: made from the email."), First name, Last name, Display name, Nickname, Website and Biography.
Password field A password field. "Empty: WordPress emails a link to set one."
Role Only roles that can't manage the site or other users are offered. Others are never given.
Sign them in Signs the new user in right after sending, when they chose a password and don't need to confirm their email.
Send the WordPress welcome email Sends WordPress's own new-user email.
Confirm their email before they can sign in Emails them a link; until they use it, signing in is refused with "Confirm your email address first: use the link we emailed you."
Turn the form away if the account exists Checks while validating, so the visitor sees "An account with this email already exists. Sign in instead." or "That username is taken." on the field.
Custom fields, ACF fields, Meta Box fields User meta to save.
Profile fields, Profile type BuddyPress or BuddyBoss profile fields and member type, when active.

Passwords:

  • Kindly never stores a password answer. When the registration runs When sent, the password is used in that same request and dropped.
  • A registration set to run later (after approval, email confirmation or payment) has no password, so WordPress emails the new user a link to set one.
  • Someone already signed in doesn't get a second account.
  • The entry is linked to the new account, and the account records which form and entry made it.

Update the user profile#

"Save the answers to the signed-in person's own profile." It maps the same profile fields as registration (email optional), plus New password field, custom fields and profile fields. An email that belongs to another account is refused. When the person isn't signed in, nothing is changed.

Custom field keys that start with an underscore, and WordPress's own keys for roles, capabilities and sessions, are never written. Developers can adjust this with kindly_forms_meta_key_allowed, and the offered roles with kindly_forms_registration_roles.

About this page

Documents Kindly Edit 0.9.16. Source: includes/forms/quiz.php, includes/forms/pages.php, includes/forms/posts.php, assets/forms/builder-panels.js. Theme choices and account permissions can change which controls appear.

Type a word or phrase to search the full documentation.