The Arcive of Official vBulletin Modifications Site.

Forms Hack · **Released**: 08-09-2005

Forms Hack 3.5

Features:

Ever wanted an online form that a user can fill out, which when submitted gets:

Posted into a new thread in a forum of your choice
Create a new poll in the new thread with options of your choice
Posted as a reply in an existing thread of your choice
PMed to you or someone else
Emailed to an email address you specify
Choose to redirect to the post, thread or forum, or a custom thank you message
Choose to redirect to edit post to upload attachments
See a preview before they submit

Or any combination or all of the above?

Well, this is the hack for you!

You can use this for:

Moderator Applications
Quiz Submit Form which gets PMed to a moderator
Contact Form that goes to PM, email or thread
Guests to apply to be members
Report a Moderator form that goes as a PM to you
Guests can PM you for whatever reason
Order form to buy things
Donation form
News or Articles submissions that can go straight to a thread

Or anything you like - this hack is totally customizable via the AdminCP.

The beauty of this hack is that once you install this hack, to make a new form all you need to do is copy the main hook, rename it to whatever you want, edit the variables in the hook, and you have a totally new form!!! You do not need to touch the templates again, but can always create new ones and use different templates for different forms.

Format of the form:

One main input question
3 Radio buttons Choice questions
3 Normal text input questions
1 Drop down menu
3 Check boxes
1 Long answer question
1 VB message editor text box question

This is customizable via the hook.

Also:

You can set the usergroups you want access to this form.
Depending on your forum permissions, if the new thread is in a public forum, members can reply to it. This hack allows a form to submit the new thread or post wherever you want it to go.
Force the user to answer all questions.

INSTALLATION
Easy - takes only a few minutes:

Import the XML into products. (admin cp -> Plug-in System -> Manage Products -> Add/Import Product)
Edit the main plug-in - the instructions are all inside the hook itself, in the top half. Follow the instructions carefully!
To get to the form, go to: /newthread.php?do=form (change "form" to the name of your form if you have few)

Done!

Use this hack to make as many forms as you like!

Enjoy!

Updates:

Version 2.0: (08/10/2005)

Ported over for vb3.5

Version 2.1: (08/10/2005)

bug fix with answers not showing

Version 2.5: (08/13/2005)

Major update:
Templates have a few lines changed here and there.
You can now have more then 2 poll options very easily
Polls can't be created if your not creating a new thread
New Thread now uses VB function to add the thread
New Poll now uses VB function to add the poll
New Reply now uses VB function to add the reply
PM now uses VB function to send the PM

Version 2.6: (08/21/2005)

fixed bug with posts having to be moderated

Version 2.7: (08/23/2005)

Minor update:
Fixed some issues with signatures, URL parsing, and subscriptions
Option to name the post titles
Made template XHTML 1.0 Transitional

Version 3.0: (11/29/2005)

Major update:
Added drop down menu
Made the long answer show up in a the vb message box
Re-wrote some instructions
Pressing back should save work
Both templates and plug-in were edited
Some more minor things

Version 3.1: (12/07/2005)

Brought back the standard text box (longanswer)

Version 3.2: (12/09/2005)

[ADDED] Option to make polls public.

Version 3.3: (12/19/2005)

[FIXED] Guests can now post using the forms to make a thread or post. They cannot send a PM though.
[ADDED] Paypal link so you can make a donation for this hack.

Version 3.4: (04/05/2006)

[FIXED] Removed extra line from template.
[ADDED] WYSIWYG editor now works besides the regular editor.
[ADDED] Preview.
[CHANGED] Subscriptions now take from user default setting.

Version 3.5: (05/31/2006)

[ADDED] Check boxes.

Abe1 with rights from Dr Erwin Loh

This hack is created for your use free of charge. No payment is requested. However, if you would like to donate money for the work I put in to this hack, a donation would show your appreciation.

Abe1 · #**362** 12-16-2005, 11:54 AM

Quote:

Originally Posted by utw-Mephisto

Just a question for understanding, to change the actuall look of the created form I need to modify the template ?

Yes.

BiReL41r · #**363** 12-16-2005, 07:51 PM

Wow, yet another great hack. Best hack for applications to a website.

dsotmoon · #**364** 12-17-2005, 07:06 PM

wow, how have i missed this all this time, will install today, thanks

silurius · #**365** 12-17-2005, 07:48 PM

Abe did you post a PayPal link? I'd like to tip as this has been a great help to my project.

Abe1 · #**366** 12-17-2005, 09:44 PM

Quote:

Originally Posted by silurius

Abe did you post a PayPal link? I'd like to tip as this has been a great help to my project.

Thanx alot, it would be appreciated. I just posted a link in the main post.

cclaerhout · #**367** 12-18-2005, 12:51 PM

Quote:

Originally Posted by Abe1

Thanx alot, it would be appreciated. I just posted a link in the main post.

Thanks for this great hack.
I have just a little question

When i'm connected as a guest and try to submit the form :
email sending is working
pm sending is not working
opening a new thread in a specified forum is not working.

But all theses tree functions are working if i'm connected as a member.

I've given guests the ability to "open" new threads in the specified forum (but they still can't see the forum), but it still doesn't work.

And i don't know why PM sending by a guest don't work.

Where did i make a mistake ?

Abe1 · #**368** 12-18-2005, 03:09 PM

Quote:

Originally Posted by cclaerhout

Thanks for this great hack.
I have just a little question

When i'm connected as a guest and try to submit the form :
email sending is working
pm sending is not working
opening a new thread in a specified forum is not working.

But all theses tree functions are working if i'm connected as a member.

I've given guests the ability to "open" new threads in the specified forum (but they still can't see the forum), but it still doesn't work.

And i don't know why PM sending by a guest don't work.

Where did i make a mistake ?

I never realy did tests with Guests. I will soon try to by pass all the vb permissions but still use their functions so everything goes smoothly.

Guests can't send PM's as far as I know.

Spinball · #**369** 12-18-2005, 05:06 PM

Apologies, Abe (and others), but I need a bit of help, please.
I want to call the form with a passed forum number.
I have put the variable in thus:

PHP Code:


			
// Part 1

$vbulletin->input->clean_array_gpc('p', array(

'advert_type' => TYPE_STR,

'advert_title' => TYPE_STR,

'location' => TYPE_STR,

'confirmation' => TYPE_STR,

'f' => TYPE_STR

));



// Part 2

$advert_type = $vbulletin->GPC['advert_type'];

$advert_title = $vbulletin->GPC['advert_title'];

$location = $vbulletin->GPC['location'];

$confirmation = $vbulletin->GPC['confirmation'];

$f = $vbulletin->GPC['f'];

and

PHP Code:


			
$formforumid = $f;

if (strlen($formforumid) == 0) {

   $errormessage = $vbulletin->userinfo['username'] . ", Fatal Error - please contact admin and tell them the formforumid variable was blank when trying to create a new classified advert.  Thanks!";

   eval('print_output("' . fetch_template('STANDARD_ERROR') . '");');

   exit();

}

Yet when I call the script thus:
http://www.avforums.com/forums/newth...eds_form&f=115
I get the error message.
If I hard code the forum number in, it works perfectly.
Why is $f null?
Thanks in advance.

Abe1 · #**370** 12-18-2005, 05:51 PM

Quote:

Originally Posted by Spinball

Apologies, Abe (and others), but I need a bit of help, please.
I want to call the form with a passed forum number.
I have put the variable in thus:

PHP Code:


			
// Part 1

$vbulletin->input->clean_array_gpc('p', array(

'advert_type' => TYPE_STR,

'advert_title' => TYPE_STR,

'location' => TYPE_STR,

'confirmation' => TYPE_STR,

'f' => TYPE_STR

));



// Part 2

$advert_type = $vbulletin->GPC['advert_type'];

$advert_title = $vbulletin->GPC['advert_title'];

$location = $vbulletin->GPC['location'];

$confirmation = $vbulletin->GPC['confirmation'];

$f = $vbulletin->GPC['f'];

and

PHP Code:


			
$formforumid = $f;

if (strlen($formforumid) == 0) {

   $errormessage = $vbulletin->userinfo['username'] . ", Fatal Error - please contact admin and tell them the formforumid variable was blank when trying to create a new classified advert.  Thanks!";

   eval('print_output("' . fetch_template('STANDARD_ERROR') . '");');

   exit();

}

Yet when I call the script thus:
http://www.avforums.com/forums/newth...eds_form&f=115
I get the error message.
If I hard code the forum number in, it works perfectly.
Why is $f null?
Thanks in advance.

You can't use 'f'. It is reserved for a fourmid.

cclaerhout · #**371** 12-18-2005, 05:55 PM

Quote:

Originally Posted by Abe1

You can't use 'f'. It is reserved for a fourmid.

Thanks for your answer Abe1. I'm waiting after your tests

Spinball · #**372** 12-18-2005, 07:45 PM

Quote:

Originally Posted by Abe1

You can't use 'f'. It is reserved for a fourmid.

I'm trying to use it as the forumid as per your suggestion in the code

Quote:

//FORUM TO POST NEW THREAD IN
//You CAN make this number a variable. You can have a drop down menu or in the link like do=form&f=1. Make sure you add it the variables list.

and use 'f' to post the new thread in the forum with id 'f'.
And indeed if I change 'f' to 'post_to_forum' it still fails.

Abe1 · #**373** 12-18-2005, 08:56 PM

Quote:

Originally Posted by Spinball

I'm trying to use it as the forumid as per your suggestion in the code

and use 'f' to post the new thread in the forum with id 'f'.
And indeed if I change 'f' to 'post_to_forum' it still fails.

OK.

Skip the f part and automaticly if you do f= in the url, the varible $forumid will equal it. dont add it to the part on2 and part 2.

WNxWakko · #**374** 12-18-2005, 09:06 PM

There must be a way to get this form to allow people not registered on the board to submit it. PLEASE!!!

Spinball · #**375** 12-18-2005, 09:16 PM

Quote:

Originally Posted by Abe1

OK.

Skip the f part and automaticly if you do f= in the url, the varible $forumid will equal it. dont add it to the part on2 and part 2.

Thanks. That got the page up, but when I posted the form I got

Quote:

Warning: Cannot use a scalar value as an array in /includes/functions_newpost.php on line 331

Sorry to be a pain, but any ideas?

Abe1 · #**376** 12-18-2005, 09:18 PM

Quote:

Originally Posted by Spinball

Thanks. That got the page up, but when I posted the form I got

Sorry to be a pain, but any ideas?

Nope. Just make sure you dont have any where you are change what f or forumid equals to.

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.06239 seconds Memory Usage 2,403KB Queries Executed 30 (?)
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 (12)bbcode_quote (1)footer (1)forumjump (1)forumrules (1)gobutton (1)header (1)headinclude (1)modsystem_post (1)navbar (6)navbar_link (120)option (1)pagenav (1)pagenav_curpage (4)pagenav_pagelink (2)pagenav_pagelinkrel (16)post_thanks_box (16)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (16)post_thanks_postbit_info (15)postbit (16)postbit_onlinestatus (16)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 post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end fetch_musername postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete 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:

The Arcive of Official vBulletin Modifications Site.

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