Advanced Forms Documentation

Status
Not open for further replies.

sbj

Active Member
Validated XF Owner
XF2 Forms Owner
XF2 Ticker Owner
  1. Introduction
    1. What is a form
    2. Front-End example of this addon
  2. Where to find all the options of Advanced Forms
    1. Settings
    2. User group permissions
    3. Widget
  3. Understanding the architecture
    1. Types, Forms, Questions
    2. Description texts for types, forms and question settings
    3. How this documentation works
  4. Types
    1. Types all blank settings
    2. Main settings
      1. Type name
      2. Display order
      3. This type is active
      4. Show in widget
      5. Show in navigation tab
    3. User criteria
      1. User groups
  5. Forms
    1. Form
      1. Form name
      2. Display order
      3. This form is active
      4. Start date / End date
      5. End date error
      6. Form type
      7. PC sender name
      8. Delete PCs
      9. Success message
      10. Override user style choice
      11. Save answers to database
    2. User criteria
      1. Must meet criteria
      2. Form use limit
    3. Report type
      1. Main settings
        1. Report title
        2. Parse URLs
        3. Include member name/IP address
      2. Email report options
      3. Thread report options
        1. Poster user name
        2. Report in existing thread
        3. Use form as thread quick reply
        4. Quick reply option button
        5. Report in new thread
      4. PC report options
      5. User PC options
    4. Redirect options
    5. Promotion options
      1. Instant promote
      2. Decision or poll promote
        1. Include decision links
        2. Create promotion voting poll
    6. Normal poll
    7. Misc. options
      1. Show above form
      2. Show below form
      3. Report color
  6. Questions
    1. Main base settings
      1. Question or Header phrase
      2. Description
      3. Question error
      4. Show question in report
      5. Show question if not answered
      6. Report format
      7. Question position in report Post/PC
    2. Question answer types
      1. Agreement (Displays question text with optional checkbox below text)
      2. Date picker
      3. File upload (No more than 1 per form)
      4. Multi-line text
      5. Multiple choice (Checkboxes)*
      6. Multiple Choice w/ all of the above option (Checkboxes)*
      7. None - This is a header phrase
      8. Single line text
      9. Single selection dropdown*
      10. Single selection forum list
      11. Single selection radio button*
      12. Spinbox (number input)
      13. Thread prefixes (No more than 1 per form)
      14. Yes/No*
      15. WYSIWYG editor
    3. Conditional questions
    4. Default questions
  7. Export
  8. Import
  9. User group permissions
  10. Widget
  11. Quick example
 


1. Introduction

The Advanced Forms add-on is a very popular add-on in the XenForo community with a lot of settings. This documentation will try to assist you in setting up forms.



1.1 What is a form?

According to Merriam-Webster's Online Dictionary:
You must validate your XenForo license to see quoted content

As an example the registration on every XF site is done by using the registration form. It asks us for our user name, email and password. We enter those details and send it.

1608244957113.png

In our case as XF owners we might be in a situation where we want to create custom online forms for our guests and members. Maybe you are looking for new moderators and you want them to apply for this position. And for that you set up a form with questions you want to be answered. Or maybe before people post "I need help" threads, you want them to answer some questions to have a better communication as the answers would provide useful information.




1.2 Front-End example of this addon

1608245039933.png

1608245050333.png

1608245059137.png
 


2. Where to find all the options of Advanced Forms?

This only tells you where to find all the options of this addon. So you can quickly check all places. This does not explain the settings yet.

Like all add-ons you find the essential settings in the Admin Control Panel (ACP). To enter the ACP you need to be an admin of the site. You will find on top left the access to the ACP by clicking on Admin:

1608245148826.png

Alternatively you can access the ACP by entering this url https://YOURSITE.com/admin.php. Replace YOURSITE.com with your own domain name.




2.1 Settings (ACP->Advanced Forms)

Once you are in the ACP and you have already installed the add-on:

1608245171116.png

A new segment will appear. You can find the majority of the settings in the left sidebar under "Advanced Forms" segment:

1608245181651.png




2.2 User group permissions (ACP -> Groups & permissions -> User groups -> x user group)

1608245195378.png

If you click on any of the user groups and scroll down, you will find the Advanced Forms permissions.

1608245205506.png




2.3 Widget (ACP ->Appearance -> Widgets -> Add widget)

If you add a widget

1608245233387.png

You will see the "Form list" widget.

1608245244652.png
 


3. Understanding the architecture of Advanced Forms


3.1 Types, Forms, Questions

There are basically 3 kind of entities to configure in order to have a form ready to be used.

1608245347603.png

We will dive into those 3 things with more depth after this when we dissect each thing. Right now what you need to understand is how the addon works.

1608245361835.png

1) You don't need to create a type. The type entity is optional and it is mostly there to categorize your forms. I prefer to use them to group my forms.

2) Basically you just create a form first and configure the options around it. Each single form will have its own options. So different forms might have different options. It depends on your unique requirements. In most cases check out all the options of the forms entity and have vaguely an idea what you want to do. Create a form and later you can come back to this after you created your questions to tweak some settings.

3) Create questions for your forms. Each form can have different questions and outcome. Your questions will influence the options of the forms.

4) You set up usergroup permissions.

5) You set up the widget if you want it.




3.2 Description texts for types, forms and question settings

The next paragraphs are about types, forms and questions.
Pretty much every setting for types, forms and questions has a description text under the setting.

They explain already what the setting is meant to be. When you are looking at these options, please read them to understand them . I will add additional explanations to them but most are obviously easy to understand.

Example:

1608245376601.png




3.3 How this documentation works

1)
In most cases you will first see the full page of a settings page without commentary.

2) All settings are found in the ACP (Admin Control Panel).

3) We dissect each setting and explain each setting.

4) A screenshot of that setting is provided.

5) Then followed by a screenshot which shows what effect that setting has on the front-side inside the forum.

6) Often commentary is added to the screenshots when it is not obvious what the setting does.

7) In some cases no screenshot is provided because it is superfluous.

8) But remember, always read the descriptions you will find under each setting provided by the addon already.
 


4. Types

In this example I already created 3 types as you see.

1608245485278.png

To create a type click on "Add Form Type":

1608245494130.png


You can order the created types, copy or delete them using the available buttons.

1608245555874.png




4.1 Types all blank settings

If you want to create a type, these following settings will be displayed.

1608245573317.png
 


4.2 Main settings

Showing the setting in the ACP and then followed by its outcome on front-end.




4.2.1 Type name

1608255338685.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608255347185.png




4.2.2 Display order

1608255369332.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608255373161.png




4.2.3 This type is active

1608255388719.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608255392423.png




4.2.4 Show in widget

1608255400109.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608255408710.png




4.2.5 Show in navigation tab

1608255426598.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608255432393.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608255437508.png
 


4.3 User criteria

User criteria in XenForo are part of the core. The core software utilises it in different places and many add-ons include user criteria in the add-on options. The Advanced Forms addon does it, too. It works the same way it does everywhere.

Important to note is that if you want to display a type to your users, you must pick at least one criteria so it "knows" under which circumstance it is displayed and used. If you do not select at least one criteria, you will not be able to save a type.

I will not attempt to explain every criteria as everyone has individual cases and needs. But I will shortly talk about the most important criteria which will be used primarily all the time in most cases.




4.3.1 User groups

1608245953112.png

Every registered user's primary usergroup including admins and moderators should be the registered usergroup.
Which means by selecting the registered usergroup, the criteria targets every registered user. This is the "default" way of allowing registered users to use a form or a type.

1608245963506.png

Same target can be achieved by the negation:

1608245974858.png

If you want to target ALL people, registered and unregistered, then you do like this:

1608245989196.png

(Note: by holding down the CTRL button you can pick more than one choice).


You can combine every criteria and make the target group smaller. It depends on what you want to do and your case. As example I set this criteria additionally:

1608246001230.png

Then, I must be in the relevant usergroup AND have posted at least 10 messages. It is not enough to meet one criteria, all must be met.


Warning:
As the description for user groups says: if a user is a member of any of the selected user groups, the criteria is met. So say, if you picked "administrative and moderating" as criteria, it is enough for me to be a moderator to meet the criteria. I don't need to be in both usergroups, one is enough. This only applies to the usergroup criteria. Outside you must meet all of them.

Note:
There can be cases where you want a user to be in usergroup A and B.
By default in XF it is not possible to target that.
But there is a trick you can do in the Advanced Forms addon, which only works in this addon. If you create a type and a form, you can set for both a user group criteria. Which means in order to see the type, you can select user group A. In order to see the form which is inside the type, you can select user group B. That means the user must be in both user groups in order to see that form. He needs to be in usergroup A to see the type, and in usergroup B to see the form which belongs to that type.
 


5. Forms

In this example I already created several forms as you see.

1608246662103.png

To create a form click on "Add New Form":

1608246672750.png


You can order the created forms, copy or delete them using the available buttons.

1608246681369.png

If you want to create a form, these following tabs will be displayed. There are in total 7 tabs and each tab has a lot of settings.

1608246687107.png
 


5.1 Form

1608246738160.png




5.1.1 Form name

1608246798879.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608246803550.png




5.1.2 Display order

1608246813167.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608246819246.png




5.1.3 This form is active

1608246828320.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608246833326.png




5.1.4 Start date / End date

1608246844649.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608246863334.png

1608246867301.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608246874973.png




5.1.5 End date error

1608246882078.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608246886546.png




5.1.6 Form type

1608246892534.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608246897812.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608246903224.png




5.1.7 PC sender name

PC stands for Private Conversation.
This is required even though you may not send any private conversations to anyone. Just in case you have to enter a valid username.
As example I created an account named "User account for forms".

1608246914267.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
In case you use it in the report options (we will see later), that entered username is used:

1608246925192.png



5.1.8 Delete PCs

1608246970359.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
It means the user who submitted the form will receive the PC, but it will be locked. And the user account who sent it will not have this conversation saved at all.

1608246981321.png




5.1.9 Success message

1608246996377.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608247006353.png




5.1.10 Override user style choice

1608247017944.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608247027296.png




5.1.11 Save answers to database

1608247042410.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608247047343.png
 


5.2 User criteria

1608247329985.png




5.2.1 Must meet criteria

1608247344800.png

One must choose at least one criteria and it has to be met in order to use it.

As explained in the types chapter, the user criteria can be found in many areas and it works everywhere the same way. Recommended are the user group criteria for general purposes. Every case is different, so there is no right or wrong. Experiment with the criteria and choose what fits you the best. If you set more than one criteria, then each single one must be met, not just one of them.

Read 4.3.1 where additional stuff is explained as we already discussed user criteria for types and it works the same way for forms.




5.2.2 Form use limit

1608247358181.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
After the limit is reached the form disappears from the list for the user.

And in ACP you get these buttons and you can reset the counter.
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608247365122.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608247375269.png


1608247393129.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608247399694.png
 


5.3 Report type

This is the place where you configure the outcome of the submitted forms. What should happen when submitted? How should it be processed?

1608247490498.png




5.3.1 Main Settings


5.3.1.1 Report title

This option is very important to configure. If someone submits a form, then that can trigger several things, such as creating a new thread, a new personal conversation or sending an e-mail. And here you can determine what the thread title will be as an example. I opted to have threads created when a form is submitted and chose to have the thread titles to be the username of the person who submitted. But you can also have answers of forms to be the title. So whatever the user submits as an answe to the question nr. X, that answer will be the thread title. You can also have multipe answers to be the title, for example {A1} - {A2} - {A4}. So the answers to the questions 1, 2 and 4 will be used as a title with a separating - between as that is what I used as example. But in our example screemshot I used {1}, which is different than to {A1}, as that stands for the username of the member who submitted it.

1608247523951.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608247535463.png




5.3.1.2 Parse URLs

1608247550172.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608248040895.png

1608248059071.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608248063582.png




5.3.1.3 Include member name/IP address

1608248124605.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608248130571.png


1608248142237.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608248158644.png




5.3.2 Email report options

1608248170335.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
The king of the world would receive an e-mail after someone submits the form.




5.3.3 Thread report options


5.3.3.1 Poster user name

1608248182284.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608248186166.png


1608248191300.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608248201152.png




5.3.3.2 Report in existing thread

1608248211774.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608248215876.png




5.3.3.3 Use form as thread quick reply

1608248224328.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608248237034.png


1608248245091.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608248256937.png



5.3.3.4 Quick reply option button

1608248270476.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608248279449.png




5.3.3.5 Report in new thread

If you wish that each submitted form has its own thread, you tick this box Pick a destination forum node. And then you can configure additional stuff, like if the created should be automatically watched by the creator or if the created thread should require approval. One nice touch is the "Post thread button to form" option. And you can choose a thread prefix which will be applied automatically to all created threads by this form.

1608248289074.png


1608248296117.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608248319491.png




5.3.4 PC report options

1608248331478.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608248338609.png




5.3.5 User PC options

1608248348872.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608248354940.png
 


5.5 Promotion options

1608251432512.png




5.5.1 Instant promote

After submission the user is promoted to primary/secondary usergroup. I would never suggest you to change the primary usergroup of any user. If you want to use this feature, add a secondary usergroup to the user.



5.5.2 Decision or poll promote

Most options are self-explanatory here, so I will highlight only both important settings here.


5.5.2.1 Include decision links

1608251452029.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608251463707.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608251467937.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608251475181.png




5.5.2.2 Create promotion voting poll

1608251484827.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608251493018.png
 


5.6 Normal poll

Creates a standard XF poll after the submission of the form. Has nothing to do with promotion options.

1608251705673.png
 


5.7 Misc. options

1608251816530.png




5.7.1 Show above form

1608251825291.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608251831976.png




5.7.2 Show below form

1608251847933.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608251855431.png



5.7.3 Report color

1608251866998.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608251872257.png
 


6 Questions

After you have created forms, you want to create the questions you want each form have. Each created form has a Questions button. Pick a form and create questions for it by clicking that button.

1608251926582.png

As example clicking on the "Questions" button of my form called "Administrator" forwards me to this section. I already have 3 questions created for this form, so you see them.

1608251935164.png

If you want to add a question, click on the button Add new question

1608251951432.png




6.1 Main base settings

Each question you want to create has some base settings.
2 base settings before you choose a question answer type and 5 at the end (after).
Only Question or Header phrase and Report format settings are mandatory out of those 7 base settings. They are required to be filled in if you want to create a question.

(For the None - This is a header phrase question answer type the latter 5 base settings are not available fyi.)

But based on which question answer type you pick, some extra settings inbetween the base settings will appear additionally as well. Those I will explain individually when each question answer type is explained. Right now I will explain all common 7 base settings among all of them (except for 1).

Very important thing is to read the explanation texts below each setting to understand how to use them as always.

1608251994145.png




6.1.1 Question or Header phrase (required)

1608252009868.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252016782.png




6.1.2 Description

1608252029934.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252037135.png




6.1.3 Question error

1608252059957.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252072084.png




6.1.4 Show question in report

1608252092761.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252096747.png


1608252101875.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252106819.png




6.1.5 Show question if not answered

1608252133766.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252138173.png




6.1.6 Report format

1608252147113.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252154874.png




6.1.7 Question position in report Post/PC

1608252173531.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252178287.png
 


6.2 Question answer types

We've talked about the main base settings for all of them. Now let's look into the additional settings each answer type has (if any). These are the available answer types and below you will find the additional settings:

1608252430835.png




6.2.1 Agreement (Displays question text with optional checkbox below text)

Expected answers

1608252440298.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252447785.png




6.2.2 Date picker

No additional settings to those 7 main base settings.




6.2.3 File upload (No more than 1 per form)

File display

1608252464393.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252473635.png




6.2.4 Multi-line text

Placeholder

1608252535493.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252542798.png


Default answer

1608252557061.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252563508.png


Match regular expression & Regular expression validation error

You may use regex if you want to limit the answers to specific patterns and give it an error, if that pattern is not matched. Such as you might disallow numbers in the answer or only allow capitalized letters, etc. There are many websites which provide regex for specific needs.

1608252570198.png




6.2.5 Multiple choice (Checkboxes)*

Checkbox answer limit & Checkbox limit error

1608252580548.png


Expected answers

1608252585475.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252595661.png


Default answer

1608252623050.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252628548.png





6.2.6 Multiple Choice w/ all of the above option (Checkboxes)*

Expected answers and default answer is the same as above, just with "all of the above option" automatcally included to the form if you decide to use this answer type.


1608252638833.png




6.2.7 None - This is a header phrase

No additional settings to those 7 main base settings, in fact this is the only answer type which doesn't have the latter 5 base settings at all, which leaves this type with 2 settings only.




6.2.8 Single line text

Same as the 6.2.4 Multi-line text where the only difference is that it accepts only a single line as an answer compared to multiple lines. Has the same 4 additional settings. It has one special setting:

1608252651135.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252654900.png




6.2.9 Single selection dropdown*

It's a dropdown where you define the choices and can choose a default answer if you wish.

1608252662506.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252670276.png




6.2.10 Single selection forum list

It gives you a dropdown list of the forum nodes of your existing forum.

1608252681584.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252689484.png




6.2.11 Single selection radio button*

Same thing as many above. You pick choosable answers and if you wish you can pick a default answer and it looks like as radio buttons.

1608252701362.png




6.2.12 Spinbox (number input)

Same Expected answers, Default answer, Match regular expression, Regular expression validation error settings as many of the answer types.

My default is 99 and it increases/decreases in 0.0001 steps

1608252711628.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252717418.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252720987.png




6.2.13 Thread prefixes (No more than 1 per form)

No additional settings to those 7 main base settings.

1608252729721.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252735533.png




6.2.14 Yes/No*

Default answer

1608252748571.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252752828.png




6.2.15 WYSIWYG editor

Placeholder

1608252760147.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252766609.png
 


6.3 Conditional questions

This addon also lets you to create conditional questions. So you create a question, one answers it, and based on the answer of that, another question appears. This is called conditional questions. Conditional questions are limited to only specific answer types which are marked with a red asteristk (in total 5 different). Also please read the warning text.

1608252880577.png

To create a conditional question, you create a normal question and you pick one of the above answer types. Then a button appears in the questions section:

1608252887025.png

By clicking it we can now add a conditional question. The conditional question works the same as normal question. You can pick different question answer types and configure it like you want it. Only difference is you can now pick an existing question whose answer will now make this conditional question appear.

1608252893081.png


In my example below I can choose my existing question "Question 1" and then I can pick what answer to that question will make this conditional question appear. Let's pick "Yes". So if the user picks yes, my conditional question will appear.

1608252898752.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252903099.png

When answer is no:

1608252907628.png


When answer is yes the conditional question appears:

1608252918466.png

My example above is based on a "Yes/No" question answer type.




6.4 Default questions

Default questions are just regular questions jsut like explained above. Now if you don't want to create over and over the same questions but just with a different title, you can create a default question and include them in any form you have. This saves a lot of time.

I created one default question already.

1608252927506.png

Now I can go into any form and include this default question with 1 click.

1608252938238.png
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
1608252950234.png
 


7. Export

Now much to say here. If you click on the export button, you get a prompt on your Windows/Linux/MacOS asking you if you want to download a XML file. This file exports your created forms and you can import them whenever you need it.

1608252976335.png




8. Import

Here you can import the exported XML file. Not much to say here.

1608252990686.png
 

9. User group permissions

1608253018827.png

There are 3 permission for user groups. The first one is the basic permission about if one can view forms on the frontend. It only activates/deactivates the entry on the navigation bar. The real permission is set for each form in the user criteria section as explained in 4.2 and 5.3. Those define if you have the access to a form on the front-end.

The 2nd permission is needed for promotion options explained in 5.2.1 when you want to include decision links. This is a very powerful tool. You can create forms, people can use those forms as in answer the questions you set up. And then you can approve or deny them based on whoever has this permission. Let's say I have this permission and I approve one submitted form. Then that user will be promoted directly to a user group I selected in the options. So you can let people access specific areas of your forum by using this.

The 3rd permission is tied to 5.2.2. Not only we can include decision links but also can use polls to determine if we want to promote a user. And this permissions allows one to extend the end date of a poll.




10. Widget

Like many addons and the XF core, this addon makes use of the widget system of XF. Widgets are gadgets you can place on the front-end of your forum. You have several options around them like on which places you want to place them. Most notably the sidebar on the front-page is the most used place for widgets. The XF default has severals widgets placed there already. Like "Staff online, Members online, Latest replies" widgets.
1608253030407.png

To achieve this I created a widget like this:

1608253038784.png




11. Quick Example

https://streamable.com/8gpkti
 
Status
Not open for further replies.
Back
Top