I’ve been modifying phpBB for ages now. So, a while ago I thought of making a kick-ass phpBB plugin that will make its users feel a bit more comfy… Anyways, the project turned black. Why? I found out that, to make a plugin, you have to do a whole lots of things, not just open up your notepad.exe and give out some intl. It turned out that you will probably need to make an MODX version and a .txt version of the mod for a start. Then, you’ll have to add the template modifications to at-least one template, where subSilver was that one…

Anyways, the idea passed, like most of my ideas :D . But a couple of days ago, when I was alone @ home with nothing to do, I cracked up a small phpBB plugin. “The Official phpBB Contact Us Form”, I called it :D . Its basically to put in a damn contact form to integrate with your phpBB. It turned out kinda good considering how much reading I made about how to submit a phpBB MOD :D.

Enuf talk.. :) Here is the part which is supposedly showed to public to reference the MOD, or in other words, that B.S before the MOD installation instructions :D . 

##############################################################
## MOD Title: Simple Contact Form
## MOD Author: Damnz! damnz.ramnz@gmail.com http://damnz.wordpress.com
## MOD Description: I already explained :p
## MOD Version: 0.0.1
##
## Installation Level: Easy
## Installation Time: 3 Minutes
## Files To Edit:
##  language/lang_english/lang_admin.php,
##  templates/subSilver/overall_header.tpl
## 
##
## Included Files: contact_form.php,
##     contact_form_body.tpl
## License: http://opensource.org/licenses/gpl-license.php GNU General Public License v2
##############################################################
## For security purposes, please check: http://www.phpbb.com/mods/
## for the latest version of this MOD. Although MODs are checked
## before being allowed in the MODs Database there is no guarantee
## that there are no security problems within the MOD. No support
## will be given for MODs not found within the MODs Database which
## can be found at http://www.phpbb.com/mods/
##############################################################
## Author Notes:
## Hope you like it ;) . I’d really appreciate a backlink too :) to http://damnz.wordpress.com .
##############################################################
## MOD History:
##
##   2006-09-07 – Version 0.0.1
##      
##
##############################################################
## Before Adding This MOD To Your Forum, You Should Back Up All Files Related To This MOD
##############################################################

 As for the MOD’s code, I’m gonna have to put it up right here, cuz there is something wrong with the upload engine, or so I think :D .

The instructions are,

#
#—–[ COPY ]——————————————
#
*.* to *.* #
#—–[ OPEN ]——————————————
#
language/lang_english/lang_main.php
#
#—–[ FIND ]——————————————
#
//
// That’s all, Folks!
// ————————————————-
#
#—–[ BEFORE, ADD ]——————————————
#
$lang['Contact_Form_Title'] = “Contact Form”;
$lang['Contact_Form_Subject'] = ‘Subject’;
$lang['Contact_Form_Name'] = ‘Name’;
$lang['Contact_Form_Email'] = ‘E-Mail’;
$lang['Contact_Form_Message'] = ‘Message Body’;
$lang['Contact_Form_Notice'] = ‘Please fill in the WHOLE form’;
$lang['Contact_Form_Success'] = ‘Your e-mail has been sent!’;
$lang['Contact_Form_Failure'] = ‘Your e-mail delivery failed!’;
#
#—–[ SAVE/CLOSE ALL FILES ]——————————————
#
# EoM

Now, to the real PHP code then the subSilver template :D :

phpbb_root/contact_form.php

<?php/***************************************************************************
 *                                contact_form.php
 *                            -------------------
 *   begin                : Saturday, Feb 13, 2001
 *   copyright            : (C) 2001 The phpBB Group
 *   email                : support@phpbb.com
 *
 *   $Id: contact_form.php,v 0.0.1 2006/09/07 16:17:27 damnz Exp $
 *
 *
 ***************************************************************************/

/***************************************************************************
 *
 *   This program is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU General Public License as published by
 *   the Free Software Foundation; either version 2 of the License, or
 *   (at your option) any later version.
 *
 ***************************************************************************/
define('IN_PHPBB', true);
$phpbb_root_path = './';
include($phpbb_root_path . 'extension.inc');
include($phpbb_root_path . 'common.'.$phpEx);
//
// Start session management
//
$userdata = session_pagestart($user_ip, PAGE_PROFILE);
init_userprefs($userdata);
//
// End session management
//
$page_title = $lang['Contact_Form_Title'];
include($phpbb_root_path . 'includes/page_header.'.$phpEx);
$template->set_filenames(array(
 'body' => 'contact_form_body.tpl')
 );
 if(! $_POST['submitted']=="1")
{
$template->assign_vars(array(
 'L_SUBJECT' => $lang['Contact_Form_Subject'],
 'L_EMAIL' => $lang['Contact_Form_Email'],
 'L_MESSAGE' => $lang['Contact_Form_Message'],
 'L_CONTACT_NOTICE' => $lang['Contact_Form_Notice'],
 'L_NAME'=> $lang['Contact_Form_Name'],
 'VALIDATION'=>'')
);
}
else
{
$this[email]=$_POST['email'];
$this[subject]=$_POST['subject'];
$this[message]=$_POST['message'];
$this[name]=$_POST['name'];

foreach ($this as $key => $value)
{
if(empty($value))
 {
$validation .='<span class="gen"><center><font color="red"> |You\'re '.$key.' box was empty| </font></center></span>';
 }
 }
if(empty($validation))
{
// subject
$subject = $this[subject];

// message
$message = '

This message was sent to you by '.$this[email].':'.$this[message];
$headers = 'From: '.$this[name].' <'.$this[email].'>' . "\r\n";
// Mail it
mail($board_config['board_email'], $subject, $message, $headers);
$template->assign_vars(array(
 'L_SUBJECT' => $lang['Contact_Form_Subject'],
 'L_EMAIL' => $lang['Contact_Form_Email'],
 'L_MESSAGE' => $lang['Contact_Form_Message'],
 'L_CONTACT_NOTICE' => '',
 'L_NAME'=> $lang['Contact_Form_Name'],
 'VALIDATION' => ''
)
);
}
{
//Handle the reprinting
$template->assign_vars(array(
 'L_SUBJECT' => $lang['Contact_Form_Subject'],
 'L_EMAIL' => $lang['Contact_Form_Email'],
 'L_MESSAGE' => $lang['Contact_Form_Message'],
 'L_CONTACT_NOTICE' => $lang['Contact_Form_Notice'],
 'L_NAME'=> $lang['Contact_Form_Name'],
 'VALIDATION' => $validation)
);
}
}
$template->pparse('body');
include($phpbb_root_path . 'includes/page_tail.'.$phpEx);
?>
templates/subSilver/contact_form_body.tpl

<form action="contact_form.php" method="post"><table width="100%" cellpadding="4" cellspacing="1" border="0" class="forumline" align="center">
  <tr>
 <th height="25" class="thHead" nowrap="nowrap">{L_CONTACT_NOTICE}</th>
  </tr>
  <tr>
 <td class="row1"><table border="0" cellpadding="3" cellspacing="1" width="100%">
    <tr>
   <td colspan="2" align="center">&nbsp;</td>
    </tr>
    {VALIDATION}
    <tr>
   <td width="45%" align="right"><span class="gen">{L_SUBJECT}:</span></td>
   <td>
     <input type="text" class="post" name="subject" size="25" maxlength="40" />
   </td>
    </tr>
    <tr>
   <td align="right"><span class="gen">{L_EMAIL}:</span></td>
   <td>
     <input type="text" class="post" name="email" size="25" maxlength="32" />
    
   </td>
    </tr>
     <tr>
   <td align="right"><span class="gen">{L_NAME}:</span></td>
   <td>
     <input type="text" class="post" name="name" size="25" maxlength="32" />
    
   </td>
    </tr>

   
    <tr>
   <td align="right"><span class="gen">{L_MESSAGE}:</span></td>
   <td>
     <textarea name="message" rows="15" cols="35" wrap="virtual" style="width:450px" tabindex="3" class="post"/></textarea>
    
   </td>
    </tr>
    <tr align="center">
   <td colspan="2"><input type="hidden" name="submitted" value="1" />
   <input type="submit" value="Email!" /></td>
    </tr>
      </table></form>

Yes, I know it’s lame, but I like it for a first MOD :D . If you like it, don’t be shy and tell me :D .

Possibly related posts: (automatically generated)