Name: Donation Page 1.0

Description: 
This modification will add a donation page with the ability to control message and paypal email in admin panel settings.

Author: John Briggs

Copyright: Copyright 2009, John Briggs

Compatability: XMB 1.9.11

License: This modification is released under the GNU GPL v3 license. A copy is provided with this software package.

Author Note: Paypal account is required to use this modification. Visit http://www.paypal.com

===================================================================================================================================
=======
Step 1:
=======
=========================================================================
Go To Admin Panel -> Insert Raw SQL -> Copy & Paste Code Below & click "Submit Changes" button
=========================================================================

ALTER TABLE `$table_settings` ADD `donatemessage` text;
ALTER TABLE `$table_settings` ADD `donatestatus` SET('on','off') NOT NULL default 'on';
ALTER TABLE `$table_settings` ADD `donateemail` varchar(60) NOT NULL default 'donate@domain.ext';

===================================================================================================================================
=======
Step 2:
=======
==============================================
Go To Admin Panel -> Translations & Download Language File
==============================================

===============
Edit Language File:
===============
==================================
Add Code At Very Bottom Of File Above ?>
==================================

// Donation Page Mod Begin
$lang['textdonate'] = "Donate";
$lang['textdonateoff'] = "The donation page is currently disabled. Please contact the administrator for assistance.";
$lang['textdonatestatus'] = "Donation Page Status:";
$lang['textdonateemail'] = "Donation PayPal E-mail Address:";
$lang['textdonatemessage'] = "Donation Message:<br /><small>This message will be displayed on the donation page.</small>";
$lang['textdonatemessage2'] = "Please select the amount you would like to donate and hit donate. USD";
$lang['onlinedonate'] = "Making a donation";
// Donation Page Mod End


============================================
Go To Admin Panel -> Translations & Upload Language File
============================================

===================================================================================================================================
=======
Step 3:
=======
==============
Edit File: cp.php
==============
==========
Find Code:
==========

        $remoteimageson = $remoteimagesoff = '';
        settingHTML('attach_remote_images', $remoteimageson, $remoteimagesoff);

===============
Add Code Below:
===============

        // Donation Page Mod Begin
        $donateon = $donateoff = '';
        settingHTML('donatestatus', $donateon, $donateoff);
        // Donation Page Mod End

==========
Find Code:
==========

        printsetting4($lang['textbboffreason'], 'bboffreasonnew', $SETTINGS['bboffreason'], 5, 50);

===============
Add Code Below:
===============

        // Donation Page Mod Begin
        printsetting1($lang['textdonatestatus'], 'donatestatusnew', $donateon, $donateoff);
        printsetting2($lang['textdonateemail'], 'donateemailnew', $SETTINGS['donateemail'], 50);
        printsetting4($lang['textdonatemessage'], 'donatemessagenew', $SETTINGS['donatemessage'], 5, 50);
        // Donation Page Mod End

==========
Find Code:
==========

        $remoteimages = formOnOff('remoteimages');
    
===============
Add Code Below:
===============

        // Donation Page Mod Begin
        $donatestatusnew = formOnOff('donatestatusnew');
        $donateemailnew = postedVar('donateemailnew');
        $donatemessagenew = postedVar('donatemessagenew');
        // Donation Page Mod End

==========
Find Code:
==========

        $sql = "UPDATE ".X_PREFIX."settings SET
    
================
Replace Code With:
================

        $sql = "UPDATE ".X_PREFIX."settings SET
            donatestatus='$donatestatusnew',
            donateemail='$donateemailnew',
            donatemessage='$donatemessagenew',

===================================================================================================================================
=======
Step 4:
=======
=================
Edit File: header.php
=================
==========
Find Code:
==========

    // Stats-link
    if ($SETTINGS['stats'] == 'on') {
        $links[] = '<img src="'.$imgdir.'/top_stats.gif" alt="'.$lang['altstats'].'" border="0" /> <a href="stats.php"><font class="navtd">'.$lang['navstats'].'</font></a>';
    }

===============
Add Code Below:
===============

    // Donate-link
    if ($SETTINGS['donatestatus'] == 'on') {
        $links[] = '<img src="'.$imgdir.'/top_donate.gif" alt="'.$lang['textdonate'].'" border="0" /> <a href="donate.php"><font class="navtd">'.$lang['textdonate'].'</font></a>';
    }

===================================================================================================================================
=======
Step 5:
=======
==================
Edit File: online.inc.php
==================
==========
Find Code:
==========

    } else if (false !== strpos($url, '/topicadmin.php')) {
        $location = $lang['onlinetopicadmin'];

===============
Add Code Below:
===============

    // Donation Page Mod Begin
    } else if (false !== strpos($url, '/donate.php')) {
        $location = $lang['onlinedonate'];
    // Donation Page Mod End

===================================================================================================================================
=======
Step 6:
=======
==========================
Go To Admin Panel -> Templates
==========================
===================
Create Template: donate
===================
=======================
Add Code & Click Submit
=======================

<form method="POST" action="https://www.paypal.com/cgi-bin/webscr" target="_blank">
<table cellspacing="0" cellpadding="0" border="0" width="$THEME[tablewidth]" align="center">
<tr>
<td bgcolor="$bordercolor">
<table border="0" cellspacing="$THEME[borderwidth]" cellpadding="$THEME[tablespace]" width="100%">
<tr>
<td class="category"><font color="$THEME[cattext]"><strong>$lang[textdonate]</strong></font></td>
</tr>
<tr>
<td class="tablerow" bgcolor="$THEME[altbg1]">{$SETTINGS['donatemessage']}</td>
</tr>
<tr>
<td class="ctrtablerow" bgcolor="$THEME[altbg2]">
$lang[textdonatemessage2]&nbsp;
<input type="hidden" name="cmd" value="_donations" />
<input type="hidden" name="business" value="{$SETTINGS['donateemail']}" />
<input type="hidden" name="item_name" value="Donation" />
<input type="hidden" name="item_number" value="$self[username]|$self[uid]" />
<select name="amount">
<option value="" selected="selected">$lang[textnone]</option>
<option value="5">$5</option>
<option value="10">$10</option>
<option value="15">$15</option>
<option value="20">$20</option>
<option value="25">$25</option>
<option value="30">$30</option>
<option value="35">$35</option>
<option value="40">$40</option>
<option value="45">$45</option>
<option value="50">$50</option>
<option value="75">$75</option>
<option value="80">$80</option>
<option value="85">$85</option>
<option value="90">$90</option>
<option value="95">$95</option>
<option value="100">$100</option>
<option value="125">$125</option>
<option value="150">$150</option>
<option value="175">$175</option>
<option value="200">$200</option>
</select>
<input type="hidden" name="no_note" value="1" />
<input type="hidden" name="currency_code" value="USD" />
<input type="hidden" name="tax" value="0" />
<input type="hidden" name="bn" value="PP-DonationsBF" />
<input type="submit" name="submit" class="submit" value="$lang[textdonate]" />
</td>
</tr>
</table>
</td>
</tr>
</table>
</form>

===================================================================================================================================
=======
Step 7:
=======

Upload provided file named "donate.php" to your forum path.

Now go to your admin panel -> settings and fill in the applicable information for the mod.

===================================================================================================================================
Enjoy!