The Arcive of Official vBulletin Modifications Site.

About Developer · **Released**: 01-07-2009

Easily create forms with no HTML or PHP knowledge. Questions can be made compulsory and are checked before the form is submitted. Forms can be previewed. (You can create multiple forms)

Backwards compatible with vb v3.7.x and 3.6.8

Example Form | Help File | Version History

Question Types:

Single line text
Multi-line text
Multi-select checkboxes
Single-select radio buttons
Single Select Dropdown
Yes/No
Multi-line text field using vbeditor (max one per form - limited by vB)
Human verification question
Custom Question (can query database or do whatever you want)
Date (month/ day/ year fields)

Form can Submit to:

new thread in forum
new post in thread
new pm to user
email address
save to database

Installation:

Just Import the Product File
Set usergroups options
admincp -> vboptions -> Easy Form Options
View/Create forms at
http://your-forum.com/forums/misc.php?do=forms
Click installed to get latest updates

More Features:

Form list categories (optional)
Preview form (can disable for individual forms)
Optional questions
Form Sections
Prefix support - you can choose which prefix you want thread to have
Different thread/pm title to form title with variables {username} {userid} and {q_1} (replacing 1 with appropriate question number)
Poll Options: Multiple choice, public vote, poll question, poll options, poll timeout
Regular expression match for single line text input field
Usergroup permissions per form
Forumid/threadid/username can be specified by input via {value=X} in dropdown, single line input or radio buttons
Multiple dropdown select for form usergroup permissions (still optional - leave blank to not use)
Option to show link to form list in navbar and quick links (separate options)
Import/ Export your forms as XML files - great for transferring forms across forums or creating backups
Specify bbcode for questions/ answers/ sections for the form's output
Form Hooks: (uses php code)
1. Before form submitted
  Useful for: your own form validation, multiple form outputs, etc.
2. At form start
  Useful for: banning userids/usergroups from form, setting minimum post count,etc.
Attachments allowed for posting new thread
Mass Copy Forms & their questions

Coming soon:

Allow attachments for posting in thread

Translations:

French/ Fran?aise http://www.vbulletin-ressources.com/...apides-t14717/

Vitaly · #**632** 03-09-2009, 04:59 PM

For some form, i need to implement such functionality:

1. Add 1 UINT parameter to form URL, when form is addressed
2. Disable form, if no parameter given
3. Send whis parameter in custom template via email (it will bу used to compose URL, such as "baselink/xxx/"."parameter")

That should be hidden from user interface.

What's the proper way to do that?

Vitaly · #**633** 03-09-2009, 06:32 PM

Almost finished testing Easy-Forms as "feedback system". Here is list of comments, applyed to such use-case.

1. No option to "disable preview button".

Preview is good for forum posts, but very bad for feedback emails. User should not see, if additional information generated.

Possible solution - one more form option.

2. "Add field" has only basic fields set.

Almost any field have to be edited twice. Once - created. Second - to edit additional parameters.

Not critical. Just unconvenient.

3. Date separator is sent as HTML code in text emails

And date format is hardcoded. It's better to use format string from VB options (not from language preferences).

4. Form description is not "templateable" (no conditions, no variables)

Not convenient, when you wish to automatically generate helper lins, for example, based on user id, and so on.

It would be good to have the same power there, as in form template. With the same variables, just without questions.

(*) Don't know, if the same needed for field descriptions. For now - not, in my case.

5. Additional Notice would be sweet for page with forms list.

(shown as standard VB notice at the top)

Possible solution - one more product setting.

6. When form is hidden from list, it's good to hide "Forms" link from navbar path.

Imagine, that you have multiple forms, used for contacts, forum posts and so on. When user fill "hidden" form for forum post, he will see link to contacts page (forms list) in navbar. That's confusing.

Dont's know, what is better:

- separate option
- hide if form is not listed
- hide if preview button disabled

7. When user fill form, navbar shows text "Viewing form: FormName"

"Viewing form:" - absulutely unnecesary and confusing. Looks like strange debug message.

8. I'd show asterisks (*) for compulsory question with red color.

Can do so with template edit, but think, that would be useful for all as general template.

9. Email has wrong return-path.

If someone write me email via contacts (forms list) page, I expect reply back, but not to forum administrator's email

Possible solution:

- add "email" field and use it automatically in return-path, if filled. Also automatic check can be done, that email conforms to standard.
- if no such field used (or empty) - try to take from member profile

- can be done by hooks, but not convenient (and i don't know how now

)

10. Captcha takes the whole row and have unnecessary border (group separator with name)

Is is possible to

- move captcha to right column, as other fields
- remove border
?

=================================================

More general things:

1. Form IDs and fields IDs are absolute and fixed.

That can cause huge problems, if you wish to export form to another site. If those IDs are already reserver to another form, information can be destroyed.

Possible solution:
- address form by text tag.
- numerate field in form namespace and allow duplicated field IDs, if those used for different forms.
- It would be also good to call form not by id, but by tag (as option). For example: misc.php?do=form&ftag=myformname

2. Mass import/export

It's normal practice to develop forms on debug site and then setup those on production. Function "export all" and "import all" would be convenient. At least for backups.

====================================

That's all for interface. Will review code a bit later.

alduren · #**634** 03-10-2009, 04:30 PM

I have various post icons in my forum.

It´s possible to select the post icon that you want to show in your new thread before form submitted??

bananalive · #**635** 03-10-2009, 04:48 PM

Quote:

Originally Posted by alduren

I have various post icons in my forum.

It?s possible to select the post icon that you want to show in your new thread before form submitted??

Import attached file
add following to Form Hook: Before Submit

PHP Code:

$iconid = 3;

where 3 is the post icon id

bananalive · #**636** 03-10-2009, 05:13 PM

Quote:

Originally Posted by Vitaly

For some form, i need to implement such functionality:

1. Add 1 UINT parameter to form URL, when form is addressed
2. Disable form, if no parameter given
3. Send whis parameter in custom template via email (it will bу used to compose URL, such as "baselink/xxx/"."parameter")

That should be hidden from user interface.

What's the proper way to do that?

Import attached file.

form Hook: Form start

PHP Code:


			
$hiddenfield1 = $vbulletin->input->clean_gpc('g', 'param', TYPE_UINT);
if (empty($hiddenfield1))
    {
        $errormessage = "Error, this form needs a parameter.";
           eval('print_output("' . fetch_template('STANDARD_ERROR') . '");');
    }

form Hook: Before Submit

PHP Code:


			
$hiddenfield1 = $vbulletin->input->clean_gpc('p', 'hiddenfield1', TYPE_UINT);
$formoutput = str_replace('{param}', "$hiddenfield1", $formoutput);

Then you can use {param} in custom output.

Vitaly · #**637** 03-10-2009, 06:36 PM

Quote:

Originally Posted by bananalive

...Then you can use {param} in custom output.

Thanks for details.

alduren · #**638** 03-10-2009, 10:22 PM

Quote:

Originally Posted by bananalive

Import attached file
add following to Form Hook: Before Submit

PHP Code:

$iconid = 3;

where 3 is the post icon id

Worked like a charm. Thanks again!!!

Trek · #**639** 03-10-2009, 10:29 PM

Ok, I'm finally redoing my old form and I have to say... this really is easy! Nice work!

I've found one bug though (no idea if it's been reported already or not, too much to sort through in this thread.)

Anyway, if you don't end your form question with a ? it will automatically add a : to the end of your sentence, even if you don't want it.

Not a big deal, but a little annoying to assume what I want.

Anyway, excellent work!

SnowBot · #**640** 03-11-2009, 04:21 AM

Hi

Great Mod

Have you got any example .xml form files so that people can see all the features?

lazyseller · #**641** 03-11-2009, 05:01 AM

It be nice if someone could come up with some a form pack. Im not volunteering!

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.05092 seconds Memory Usage 2,381KB Queries Executed 26 (?)
More Information
Template Usage: (1)SHOWTHREAD (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (1)ad_showthread_beforeqr (4)bbcode_php (4)bbcode_quote (1)footer (1)forumjump (1)forumrules (1)gobutton (1)header (1)headinclude (1)modsystem_post (1)navbar (4)navbar_link (120)option (1)pagenav (1)pagenav_curpage (4)pagenav_pagelink (5)pagenav_pagelinkrel (11)post_thanks_box (2)post_thanks_box_bit (11)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (1)post_thanks_postbit (11)post_thanks_postbit_info (10)postbit (12)postbit_attachment (11)postbit_onlinestatus (11)postbit_wrapper (1)spacer_close (1)spacer_open (1)tagbit_wrapper Phrase Groups Available: global inlinemod postbit posting reputationlevel showthread	Included Files: ./showthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/functions_bigthree.php ./includes/class_postbit.php ./includes/class_bbcode.php ./includes/functions_reputation.php ./includes/functions_post_thanks.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete showthread_start showthread_getinfo forumjump showthread_post_start showthread_query_postids showthread_query bbcode_fetch_tags bbcode_create showthread_postbit_create postbit_factory postbit_display_start post_thanks_function_post_thanks_off_start post_thanks_function_post_thanks_off_end post_thanks_function_fetch_thanks_start fetch_musername post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end post_thanks_function_fetch_thanks_bit_start post_thanks_function_show_thanks_date_start post_thanks_function_show_thanks_date_end post_thanks_function_fetch_thanks_bit_end post_thanks_function_fetch_post_thanks_template_start post_thanks_function_fetch_post_thanks_template_end postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete postbit_attachment postbit_display_complete post_thanks_function_can_thank_this_post_start pagenav_page pagenav_complete tag_fetchbit_complete forumrules navbits navbits_complete showthread_complete
Messages:

2 благодарности(ей) от:
hpidriver, vbresults

The Arcive of Official vBulletin Modifications Site.

It is not a VB3 engine, just a parsed copy!