this is really a great mod, i'm currently adjusting it to submit different kinds of content but have already completed one form which allows you to submit news, thanks very much abe!
The code is quite well commented already but i just wanted to do something in return so here is a quick overview on how to create a news submit form. The extra thing i've added here is the ability to insert a link to the source of the news (via a question in the submit form) and then a 'link' url at the end of the created thread. bit hard to understand, just take a look at the screenshots and you'll see what i mean, so let's get started with the code!
1.First of all
install the mod, just follow the instructions.
2. then go to plugins> add plugin for the
PHP code part. i created a plugin and named it 'submit_news', the name doesn't really matter, as long as it's understandable for you. set the hook to
'newthread_start'. Then paste this code into the Plugin PHP Code field:
Code:
// 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 = "submit_news";
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(
'normalanswer1' => TYPE_STR,
//'radioanswer1' => TYPE_STR,
//'radioanswer2' => TYPE_STR,
//'radioanswer3' => TYPE_STR,
//'radioanswer3other' => TYPE_STR,
'answer1' => TYPE_STR,
//'answer2' => TYPE_STR,
//'answer3' => TYPE_STR,
//'dropdownanswer1' => TYPE_STR,
//'checkboxanswer1_1' => TYPE_STR,
//'checkboxanswer1_2' => TYPE_STR,
//'checkboxanswer1_3' => TYPE_STR,
//'longanswer1' => TYPE_STR
));
// Part 2
$normalanswer1 = $vbulletin->GPC['normalanswer1'];
//$radioanswer1 = $vbulletin->GPC['radioanswer1'];
//$radioanswer2 = $vbulletin->GPC['radioanswer2'];
//$radioanswer3 = $vbulletin->GPC['radioanswer3'];
//$radioanswer3other = $vbulletin->GPC['radioanswer3other'];
$answer1 = $vbulletin->GPC['answer1'];
//$answer2 = $vbulletin->GPC['answer2'];
//$answer3 = $vbulletin->GPC['answer3'];
//$dropdownanswer1 = $vbulletin->GPC['dropdownanswer1'];
//$checkboxanswer1_1 = $vbulletin->GPC['checkboxanswer1_1'];
//$checkboxanswer1_2 = $vbulletin->GPC['checkboxanswer1_2'];
//$checkboxanswer1_3 = $vbulletin->GPC['checkboxanswer1_3'];
//$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))) 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 = "newsform";
// Name of the answer template
$answertemplate = "newsformanswers";
////////////////////////////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////
//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 = "1";
//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 = "24";
//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 (separate multiple usernames with a ';')
$formpmname = "Abe";
////////////////////////////////////////////////////////////////////////////////////////////////////
//ENABLE FORM TO BE EMAILED - 1 = yes, 0 = no
$formemail = "0";
//EMAIL ADDRESS TO EMAIL TO (separate multiple usernames with a ';')
$formemailaddress = "youremail@yourforums.com";
////////////////////////////////////////////////////////////////////////////////////////////////////
//ENABLE ATTACHMENTS - 1 = yes, 0 = no
//attachments can only be used if the form is going to make a new thread or post
$allow_attachments = "1";
////////////////////////////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////
//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 (thread or reply)
//
// Feel free to change the thank you message if you choose option 0
////////////////////////////////////////////////////////////////////////////////////////////////////
$redirectoption = "0";
$errormessage = "Thank you for submitting news! you're content will be reviewed by our staff, so it might take a short time before it shows up."; //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 = "0";
////////////////////////////////////////////////////////////////////////////////////////////////////
//TITLE OF FORM (do not use quotation marks or you will get a parse error, besides the quotes around the whole title)
////////////////////////////////////////////////////////////////////////////////////////////////////
$formtitle = "Submit CG News";
////////////////////////////////////////////////////////////////////////////////////////////////////
//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 = "$normalanswer1";
////////////////////////////////////////////////////////////////////////////////////////////////////
//PURPOSE OF FORM (do not use quotation marks or you will get a parse error, besides the quotes around the whole text)
////////////////////////////////////////////////////////////////////////////////////////////////////
$formpurpose = "Use the form below to submit Computer Graphics related news on tutorials, software releases and new technology. Your content will be reviewed so it will take a short time to show up, be sure to attach a small image as well.";
////////////////////////////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////
//NORMAL INPUT BOX : QUESTION 1 (do not use quotation marks or you will get a parse error, besides the quotes around the whole text)
////////////////////////////////////////////////////////////////////////////////////////////////////
$normalquestion1 = "fill in a descriptive, short title/heading:";
////////////////////////////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////
//RADIO BOX CHOICES : QUESTION 1 (do not use quotation marks or you will get a parse error, besides the quotes around the whole text)
////////////////////////////////////////////////////////////////////////////////////////////////////
//$radioquestion1 = "Choose one of the following choices";
// The following choices must NOT have quotation marks
//$radiochoice1a = "yes";
//$radiochoice1b = "no";
////////////////////////////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////
//RADIO BOX CHOICES : QUESTION 2 (do not use quotation marks or you will get a parse error, besides the quotes around the whole text)
////////////////////////////////////////////////////////////////////////////////////////////////////
//$radioquestion2 = "Choose another one of the following choices";
// The following choices must NOT have quotation marks
//$radiochoice2a = "good";
//$radiochoice2b = "bad";
//$radiochoice2c = "both";
////////////////////////////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////
//RADIO BOX CHOICES : QUESTION 3 (do not use quotation marks or you will get a parse error, besides the quotes around the whole text)
////////////////////////////////////////////////////////////////////////////////////////////////////
//$radioquestion3 = "Is it yes or no? If yes, please elaborate";
// The following choices must NOT have quotation marks
//$radiochoice3a = "yes";
//$radiochoice3b = "no";
////////////////////////////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////
//QUESTION 1 (do not use quotation marks or you will get a parse error, besides the quotes around the whole text)
$question1 = "direct link to news ";
$explain1 = "for example: http://www.enjoycg.com/article";
//QUESTION 2 (do not use quotation marks or you will get a parse error, besides the quotes //around the whole text)
//$question2 = "What is your email?";
//$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 = "What is your website?";
//$explain3 = "Please enter your URL here.";
////////////////////////////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////
//DROP DOWN CHOICES : QUESTION 1 (do not use quotation marks or you will get a parse error, besides the quotes around the whole text)
////////////////////////////////////////////////////////////////////////////////////////////////////
//$dropdownquestion1 = "What filetype are you uploading?";
// The following choices must NOT have quotation marks
//$dropdownchoice1a = "image, .jpg, .gif, .png etc.";
//$dropdownchoice1b = ".3ds, .obj, .max";
//$dropdownchoice1c = "other";
////////////////////////////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////
//CHECK BOX CHOICES : QUESTION 1 (do not use quotation marks or you will get a parse error, besides the quotes around the whole text)
////////////////////////////////////////////////////////////////////////////////////////////////////
//$checkboxquestion1 = "This shows how to use checkboxes.";
// The following choices must NOT have quotation marks
//$checkboxchoice1_1 = "good";
//$checkboxchoice1_2 = "bad";
//$checkboxchoice1_3 = "both";
////////////////////////////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////
//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 write down a paragraph about yourself.";
//$longexplain1 = "For example, a bit about your experience in this area.";
////////////////////////////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////////////////////
//VB TEXT AREA INPUT: You can only have ONE vb text question. (do not use quotation marks or you will get a parse error, besides the quotes around the whole text)
////////////////////////////////////////////////////////////////////////////////////////////////////
$vbtextquestion = "Please describe your news in short, one or two sentences.";
$vbtextexplain = "a link to the news is not neccessary, it will be added automatically.";
}
IMPORTANT: i didn't change the main script, you should insert it after this code, you can find the code in the original 'form hack' plugin.
i'm not going to explain all of the changes but they are actually fairly simple, many questions were just taken out because i didn't need them, it's important to use this name though, so it matches when you want to load the form later: $formname = "submit_news";
More Information