Forms Hack

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.

[Ohiosweetheart]

Ok this is what I'm actually trying to do.............

I need a form for users to submit a story to me.
It will have a box for name/username, one for their email addres, and a small box for additional notes.
Then a LARGE box to type their story into, then will submit and it will be emailed to me. No new post, no new thread, no poll... a simple form to email a story to me.

This is what I have in the hook. Please tell me what I'm doing wrong?

// To add more then one form, copy this whole text, and creat a new plug-in with the hook location 'newthread_start'.
// After, change the form name. You can't have 2 forms with the same name.

// Name of this form
$formname = "form";

if ($_REQUEST['do'] == $formname)
{

// ################################################## #####################
// ######################## CUSTOMIZE VARIABLES ##########################
// ################################################## #####################

////////////////////////////////////////////////////////////////////////////////////////////////////
////// BEGIN CUSTOMIZATION BELOW////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////

////////////////////////////////////////////////////////////////////////////////////////////////////
//VARIABLES
//Study how variables are add here to add or remove any. If you add a variable to your form, you must add it to part one and part two.
////////////////////////////////////////////////////////////////////////////////////////////////////

// Part 1
$vbulletin->input->clean_array_gpc('p', array(
'answer1' => TYPE_STR,
'answer2' => TYPE_STR,
'answer3' => TYPE_STR,
'longanswer1' => TYPE_STR
));

// Part 2
$answer1 = $vbulletin->GPC['answer1'];
$answer2 = $vbulletin->GPC['answer2'];
$answer3 = $vbulletin->GPC['answer3'];
$longanswer1 = $vbulletin->GPC['longanswer1'];

////////////////////////////////////////////////////////////////////////////////////////////////////
//USERGROUPS ALLOWED
//You can add or remove usegroups that are ALLOWED to use this form by changing the numbers below in the array.
//To enable this feature, remove the '//' before the 'if'.
////////////////////////////////////////////////////////////////////////////////////////////////////

if (!in_array($vbulletin->userinfo['usergroupid'], array(2,5,6,7,23,24,25,27,28))) print_no_permission();

////////////////////////////////////////////////////////////////////////////////////////////////////

////////////////////////////////////////////////////////////////////////////////////////////////////
//NAME OF TEMPLATES - DO THIS BIT IF YOU ARE MAKING MORE FORMS AND WANT TO USE A DIFFERENT LOOKING TEMPLATE
////////////////////////////////////////////////////////////////////////////////////////////////////

// Name of the main template
$maintemplate = "form";
// Name of the answer template
$answertemplate = "formanswers";

////////////////////////////////////////////////////////////////////////////////////////////////////

////////////////////////////////////////////////////////////////////////////////////////////////////
//CHOOSE WHETHER YOU WANT FORM TO BE POSTED IN A NEW THREAD, NEW POLL, REPLY TO EXISITING THREAD, PMed OR EMAILED
///////////////////////////////////////////////////////////////////////////////////////////////////

//ENABLE FORM TO BE POSTED - 1 = yes, 0 = no
$formforum = "0";

//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.
$formforumid = "2";

//ENABLE POLL TO BE CREATED - 1 = yes, 0 = no
$formpoll = "0";
$polloption[1] = "Yes";
$polloption[2] = "No";
$polloption[3] = "Maybe";

//Make poll public - 1 = yes, 0 = no
$pollpublic = "0";

////////////////////////////////////////////////////////////////////////////////////////////////////

//ENABLE FORM TO REPLY TO EXISTING THREAD - 1 = yes, 0 = no
$formreply = "0";

//EXISTING THREAD ID FOR FORM TO REPLY IN
$formreplythreadid = "12345";

////////////////////////////////////////////////////////////////////////////////////////////////////

//ENABLE FORM TO BE PMED (guests CANNOT use this option) - 1 = yes, 0 = no
$formpm = "0";

//USERNAME TO PM TO
$formpmname = "Abe";

////////////////////////////////////////////////////////////////////////////////////////////////////

//ENABLE FORM TO BE EMAILED - 1 = yes, 0 = no
$formemail = "1";

//EMAIL ADDRESS TO EMAIL TO
$formemailaddress = "stories@exquisitelyerotic.net";

////////////////////////////////////////////////////////////////////////////////////////////////////

////////////////////////////////////////////////////////////////////////////////////////////////////
//REDIRECT OPTIONS:
// 0 - thank you message (thread, reply, pm, or email)
// 1 - redirect to post (thread or reply)
// 2 - redirect to thread (thread only)
// 3 - redirect to forum (thread only)
// 4 - redirect to editpost to upload attachments (thread or reply)
//
// Feel free to change the thank you message if you choose option 0
////////////////////////////////////////////////////////////////////////////////////////////////////

$redirectoption = "0";

$errormessage = "Thank you for submitting your story. You will hear from us soon if any editing is needed. Otherwise, look for it to be posted within the next couple of days!

The Writers Corner Editorial Staff"; //This is the thank you message

////////////////////////////////////////////////////////////////////////////////////////////////////

////////////////////////////////////////////////////////////////////////////////////////////////////
//FORCE USER TO ANSWER ALL QUESTIONS - 1 = yes, 0 = no
//If you added or deleted variables, you must edit what it checked for. Search for "$answerall ==" and edit 2 lines under it.
////////////////////////////////////////////////////////////////////////////////////////////////////

$answerall = "1";

////////////////////////////////////////////////////////////////////////////////////////////////////
//TITLE OF FORM (do not use quotation marks or you will get a parse error, besides the quotes around the whole title)
////////////////////////////////////////////////////////////////////////////////////////////////////

$formtitle = "Submit Your Story";

////////////////////////////////////////////////////////////////////////////////////////////////////
//TITLE OF THREAD/POST/PM/EMAIL (do not use quotation marks in the title or you will get a parse error)
//You may use variables from the form for this.
////////////////////////////////////////////////////////////////////////////////////////////////////

$posttitle = "$formtitle";

////////////////////////////////////////////////////////////////////////////////////////////////////
//PURPOSE OF FORM (do not use quotation marks or you will get a parse error, besides the quotes around the whole text)
////////////////////////////////////////////////////////////////////////////////////////////////////

$formpurpose = "Use this form to submit your story. It will be sent to our editorial staff.";

////////////////////////////////////////////////////////////////////////////////////////////////////

////////////////////////////////////////////////////////////////////////////////////////////////////
//QUESTION 1 (do not use quotation marks or you will get a parse error, besides the quotes around the whole text)
$question1 = "Your Name or EE Username";
$explain1 = "Please enter your real name here.";

//QUESTION 2 (do not use quotation marks or you will get a parse error, besides the quotes around the whole text)
$question2 = "Email Address";
$explain2 = "Please enter your real email here.";

//QUESTION 3 (do not use quotation marks or you will get a parse error, besides the quotes around the whole text)
$question3 = "Copyright Information";
$explain3 = "written by (name or ee username)
? date written, all rights reserved";

////////////////////////////////////////////////////////////////////////////////////////////////////


////////////////////////////////////////////////////////////////////////////////////////////////////
//LONG TEXT AREA INPUT: QUESTION 1 (do not use quotation marks or you will get a parse error, besides the quotes around the whole text)
////////////////////////////////////////////////////////////////////////////////////////////////////

$longquestion1 = "Please type or paste your story here":
$longexplain1 = "story";

////////////////////////////////////////////////////////////////////////////////////////////////////

////// END OF CUSTOMIZATION ////////////////////////////////////////////////////////////////////
///// DO NOT CHANGE BELOW UNLESS YOU KNOW WHAT YOU ARE DOING!!! ////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////

// ################################################## #####################
// ######################## START MAIN SCRIPT ############################
// ################################################## #####################
if ($_REQUEST['action'] == '')
{
$_REQUEST['action'] = "form";
}


$bbuserinfo = $vbulletin->userinfo;

// start navbar
$navbits = array();
$navbits['newthread.php?' . $vbulletin->session->vars['sessionurl'] . "do=$formname"] = $formtitle;

$navbits = construct_navbits($navbits);
eval('$navbar = "' . fetch_template('navbar') . '";');

if ($_REQUEST['action'] == "submit")
{

if ($answerall == "1")
{
if ($normalanswer1 == '' OR $radioanswer1 == '' OR $radioanswer2 == '' OR $radioanswer3 == '' OR $answer1 == '' OR $answer2 == '' OR $answer3 == '' OR $longanswer1 == '')
{
$errormessage = "$bbuserinfo[username], you need to answer every question!";
eval('print_output("' . fetch_template('STANDARD_ERROR') . '");');
exit();
}
}

$vbulletin->input->clean_array_gpc('p', array(
'wysiwyg' => TYPE_BOOL,
'message' => TYPE_STR
));

if ($vbulletin->GPC['wysiwyg'])
{
require_once(DIR . '/includes/functions_wysiwyg.php');
$vbtextanswer = convert_wysiwyg_html_to_bbcode($vbulletin->GPC['message'], $foruminfo['allowhtml']);
}
else
{
$vbtextanswer =& $vbulletin->GPC['message'];
}

eval('$formsend = "' . fetch_template("$answertemplate") . '";');

if ($_POST['submit'] == 'Submit')
{
if ($formforum == "1")
{
$foruminfo = verify_id('forum', $formforumid, 0, 1);
$forumperms = fetch_permissions($foruminfo[forumid]);
$newpost['username'] =& $vbulletin->userinfo['username'];
$newpost['message'] =& $formsend;
$newpost['title'] =& $posttitle;
$newpost['parseurl'] = '1';

if ($vbulletin->userinfo['autosubscribe'] != -1)
{
$newpost['emailupdate'] = $vbulletin->userinfo['autosubscribe'];
}
else
{
$newpost['emailupdate'] = 9999;
}

if ($vbulletin->userinfo['signature'] != '')
{
$newpost['signature'] = '1';
}
else
{
$newpost['signature'] = '0';
}

build_new_post('thread', $foruminfo, array(), array(), $newpost, $errors);

if ($formpoll == "1")
{
$threadinfo = verify_id('thread', $newpost[threadid], 0, 1);
$polloptions = count($polloption);
$question = $posttitle;
$vbulletin->GPC['options'] = $polloption;

$counter = 0;
$optioncount = 0;
$badoption = '';
while ($counter++ < $polloptions)
{ // 0..Pollnum-1 we want, as arrays start with 0
if ($vbulletin->options['maxpolllength'] AND vbstrlen($vbulletin->GPC['options']["$counter"]) > $vbulletin->options['maxpolllength'])
{
$badoption .= iif($badoption, ', ') . $counter;
}
if (!empty($vbulletin->GPC['options']["$counter"]))
{
$optioncount++;
}
}

// Add the poll
$poll =& datamanager_init('Poll', $vbulletin, ERRTYPE_STANDARD);

$counter = 0;
while ($counter++ < $polloptions)
{
if ($vbulletin->GPC['options']["$counter"] != '')
{
$poll->set_option($vbulletin->GPC['options']["$counter"]);
}
}

$poll->set('question', $question);
$poll->set('dateline', TIMENOW);
$poll->set('active', '1');
$poll->set('public', $pollpublic);

$pollid = $poll->save();
//end create new poll

// update thread
$threadman =& datamanager_init('Thread', $vbulletin, ERRTYPE_STANDARD, 'threadpost');
$threadman->set_existing($threadinfo);
$threadman->set('pollid', $pollid);
$threadman->save();
}
}

if ($formreply == "1")
{
$threadinfo = verify_id('thread', $formreplythreadid, 0, 1);
$forumperms = fetch_permissions($threadinfo[forumid]);
$newpost['username'] =& $vbulletin->userinfo['username'];
$newpost['message'] =& $formsend;
$newpost['title'] =& $posttitle;
$newpost['parseurl'] = "1";

if ($vbulletin->userinfo['autosubscribe'] != -1)
{
$newpost['emailupdate'] = $vbulletin->userinfo['autosubscribe'];
}
else
{
$newpost['emailupdate'] = 9999;
}

if ($vbulletin->userinfo['signature'] != '')
{
$newpost['signature'] = '1';
}
else
{
$newpost['signature'] = '0';
}

build_new_post('reply', $foruminfo, $threadinfo, $postinfo, $newpost, $errors);
}

if ($formpm == "1")
{
$vbulletin->GPC['message'] =& $formsend;
$vbulletin->GPC['title'] =& $posttitle;
$vbulletin->GPC['recipients'] =& $formpmname;

$pm['message'] =& $vbulletin->GPC['message'];
$pm['title'] =& $vbulletin->GPC['title'];
$pm['recipients'] =& $vbulletin->GPC['recipients'];

// create the DM to do error checking and insert the new PM
$pmdm =& datamanager_init('PM', $vbulletin, ERRTYPE_ARRAY);

$pmdm->set('fromuserid', $vbulletin->userinfo['userid']);
$pmdm->set('fromusername', $vbulletin->userinfo['username']);
$pmdm->setr('title', $pm['title']);
$pmdm->setr('message', $pm['message']);
$pmdm->set_recipients($pm['recipients'], $permissions);
$pmdm->set('dateline', TIMENOW);

// everything's good!
$pmdm->save();
}

if ($formemail == "1")
{
vbmail($formemailaddress, $posttitle, $formsend);
}

if ($redirectoption == "1")
{
$vbulletin->url = 'showthread.php?' . $vbulletin->session->vars['sessionurl'] . "p=$newpost[postid]";
eval(print_standard_redirect('redirect_postthanks' ));
exit();
}
if ($redirectoption == "2")
{
$vbulletin->url = 'showthread.php?' . $vbulletin->session->vars['sessionurl'] . "t=$newpost[threadid]";
eval(print_standard_redirect('redirect_postthanks' ));
exit();
}
if ($redirectoption == "3")
{
$vbulletin->url = 'forumdisplay.php?' . $vbulletin->session->vars['sessionurl'] . "f=$foruminfo[forumid]";
eval(print_standard_redirect('redirect_postthanks' ));
exit();
}
if ($redirectoption == "4")
{
$vbulletin->url = 'editpost.php?do=editpost&' . $vbulletin->session->vars['sessionurl'] . "p=$newpost[postid]";
eval(print_standard_redirect('redirect_postthanks' ));
exit();
}
eval('print_output("' . fetch_template('STANDARD_ERROR') . '");');
exit();
}
else
{
require_once('./includes/class_bbcode.php');
$parser =& new vB_BbCodeParser($vbulletin, fetch_tag_list());
$preview = $parser->do_parse($formsend);

$_REQUEST['action'] = 'form';
}
}

if ($_REQUEST['action'] == 'form')
{
// set message box width to usercp size
$stylevar['messagewidth'] = $stylevar['messagewidth_usercp'];
$editorid = construct_edit_toolbar($vbtextanswer);

eval('print_output("' . fetch_template("$maintemplate") . '");');
}
}

and now I find that I'm getting that parse error on EVERY new thread started. grrrrrrrrrrrrrrrrrr...

[aceofspades]

Sorry to be a noob, but i have installed it and its working, but i dont understand your instructions about how to edit it. Usually when i install products there is now an option menu in the settings section of the adminCP. However this time there isnt and i dont understand what you mean by edit the hook.

Can you please explain a little further for a VB noob?

James

[Ohiosweetheart]

*bump*

[RMS-Chef]

Hi Abe, I was wondering if there was anything that could be done to get your forms hack working with this new "Thread Notification Alert" hack here. I realize it is not either one of you guy's responsibility to get your respective hacks working with each other but the Notification does not seem to be working with threads submitted via your forms. I have mentioned this in his thread as well. Hopefully one of you will be able to figure this out because both hacks are fantastic. I can't function without yours but I would love to have his as well. Thank you.

[Abe1]

I'll try to check it out when I have time. I'm working now on a way to generate a form with someone just giving me what questions that want. It will help thoughs user who dont have time or dont know how to make a custom form using this hack.

[RMS-Chef]

Thanks for the response Abe.
Does this make sense?
https://vborg.vbsupport.ru/showpost....0&postcount=18

[Abe1]

Originally Posted by RMS-Chef

Thanks for the response Abe.
Does this make sense?
https://vborg.vbsupport.ru/showpost....0&postcount=18

No, it does not make any sense. I use that function right now. I dont use my own way to add a thread. I use the regular vb function.

[RMS-Chef]

Originally Posted by Abe1

No, it does not make any sense. I use that function right now. I dont use my own way to add a thread. I use the regular vb function.

Not sure if it matters but none of my forums that I tested this with are using the vB style editor boxes, just several $longanswer boxes and a few shorts. Not sure if that makes a difference or not. I will test things out on a board that uses the vB editor to see if it makes any difference.

[Abe1]

Originally Posted by RMS-Chef

Not sure if it matters but none of my forums that I tested this with are using the vB style editor boxes, just several $longanswer boxes and a few shorts. Not sure if that makes a difference or not. I will test things out on a board that uses the vB editor to see if it makes any difference.

There is no diff if you use them or not. This fuction that he said to use, gets used already.

[Crazy Serb]

is "emailing the form results" feature working for everyone else? is that just me having a problem with that feature of the script?!!!

[Michael_Tree]

how do i edit the main hook?

[Sarcoth]

I made my own redirect option. It is working just fine and redirects to the proper page. I need it to do a little more though and not quite sure how to do it yet.

if ($redirectoption == "5")
     {
     $vbulletin->url = '../index.php?' . $vbulletin->session->vars['sessionurl'] . "page=HOME";
     eval(print_standard_redirect('redirect_postthanks'));
     exit();
     }

I tried to play around with the code by adding another "IF...ELSE" statement and that gave me an error. Abe, can you or someone else assist me.

I'm trying to have this do one of two things. If someone provides the correct answer to $answer1, the user will be added to a usergroup with the ID = 14 and then they'll be redirected to the congrats page. If someone provides an incorrect answer, they will be redirected to a "Sorry, try again" page instead.

Thanks for keeping this hack updated. It is definitely one of my favorites.

-Sarcoth

[upnorth]

Does this work with version 3.5.4?

[Abe1]

Originally Posted by upnorth

Does this work with version 3.5.4?

Yes.

[grecostimpy]

For some reason my users are receiving subscription emails from the form results thread even though it is in a private forum. How can I prevent this?

I noticed this in the plugin:

if ($vbulletin->userinfo['autosubscribe'] != -1)
            {
                $newpost['emailupdate'] = $vbulletin->userinfo['autosubscribe'];
            }
            else
            {
                $newpost['emailupdate'] = 9999;
            }

Can I get rid of this? Any thoughts? They really should not be subscribed/notified of these posts.

Thanks