Software Information:
    Document Software:  XMB Version 1.9.8 SP3/SP4
    Author: The XMBGroup
    Reference: http://xmbforum.com

Modification Information:
    Branch Title: Birthday Page
    Version: 4.0

Description:
This modification adds a birthday page on your forum listing all of your users' birthdays who have specified a birth date.
This modification includes an on/off switch in the admin panel under Settings.

Document Information
    Author: Darryl

    Lee Jian Yuan
    Updated: Wormhole - 1.9.0/3
    Chrno (Michael Fraker) - 1.9.3
    FunForum - 1.9.5   3.1
    Xian - 1.9.5   3.2
    Adam - 1.9.5   3.2
    Train (Michael Fraker) - 1.9.8   4.0
    Last Updated: April, 30 2009 at 8:45 AM EDT

====================
Step 1: Insert RAW SQL
====================

Go to your admin panel at this time, and click "Insert RAW SQL". You will
have an option to browse and upload SQL, please find the SQL.txt file which
was included with this zip folder, and select it.

You may also copy and paste the contents of the sql.txt file into the upgrade
field, whichever you prefer, click submit to continue.

===================
Step 2: Open header.php
===================
======
Find:
======

// 'Forum Rules'-link
if ($SETTINGS['bbrules'] == 'on') {
    $links[] = '<img src="'.$imgdir.'/top_bbrules.gif" alt="'.$lang['altrules'].'" border="0" /> <a href="faq.php?page=forumrules"><font class="navtd">'.$lang['textbbrules'].'</font></a>';
}

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

// Birthday Page-link
if ($SETTINGS['bday_status'] == 'on') {
    $links[] = '<img src="'.$THEME['imgdir'].'/birthday.gif" alt="'.$lang['bday_05'].'" border="0" /> <a href="bday.php"><font class="navtd">'.$lang['bday_01'].'</font></a>';
}

==========================
Step 3: Open include/online.inc.php
==========================
======
Find:
======

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

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

    // Birthday Page Mod Begin
    } else if (false !== strpos($url, "/bday.php")) {
        $location = $lang['bday_07'];
    // Birthday Page Mod End

==========================
Step 4: Open lang/English.lang.php
==========================
======
Find:
======

?>

===============
Add Code Above:
===============

// Birthday Page Mod Begin
$lang['bday_01'] = "Birthdays";
$lang['bday_02'] = "$bbname Member Birthdays";
$lang['bday_03'] = "Happy Birthday!";
$lang['bday_04'] = "HAPPY BIRTHDAY!";
$lang['bday_05'] = "Birthday List";
$lang['bday_06'] = "Birthday List Status:";
$lang['bday_07'] = "Viewing Birthdays";
$lang['bday_08'] = "$bbname would like to say Happy Birthday to the people who are celebrating their birthday today, they are:";
$lang['bday_09'] = "There are no registered birthdays today on $bbname.<br />";
$lang['bday_10'] = "This is the complete list of all $bbname members birthdays.<br />If you're not in here, remember to add your birthday info in your profile. Thank you!<br /><br />";
$lang['bday_11'] = "Birthday Listing";
// Birthday Page Mod End

=================
Step 5: Open cp.php
=================
======
Find:
======

        $onlinetoday_statuson = $onlinetoday_statusoff = '';
        settingHTML('onlinetoday_status', $onlinetoday_statuson, $onlinetoday_statusoff);

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

        // Birthday Page Mod Begin
        $bday_status_on = $bday_status_off = '';
        settingHTML('bday_status', $bday_status_on, $bday_status_off);
        // Birthday Page Mod End

======
Find:
======

        printsetting1($lang['reportpoststatus'], 'reportpostnew', $reportposton, $reportpostoff);

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

        // Birthday Page Mod Begin
        printsetting1($lang['bday_06'], 'bday_statusnew', $bday_status_on, $bday_status_off);
        // Birthday Page Mod End

======
Find:
======

        $onlinetoday_statusnew = formOnOff('onlinetoday_statusnew');

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

        // Birthday Page Switch: Starts
        $bday_statusnew = formOnOff('bday_statusnew');
        // Birthday Page Switch: Ends

======
Find:
======

        $db->query("UPDATE ".X_PREFIX."settings SET

================
Replace Code With:
================

        $db->query("UPDATE ".X_PREFIX."settings SET
            bday_status='$bday_statusnew',

===================
Note Before Continuing:
===================

Save and upload these affected files at this time. Once you are done, go to your forums and then to the administration panel.
From there select templates and follow the instructions below.

Please also upload the included bday.php file to your forum root directory.

===============================
Step 6: Create a new template called bday
===============================
==========================
Add the following code and submit
==========================

<table cellspacing="0" cellpadding="0" border="0" width="$THEME[tablewidth]" align="center">
<tr><td bgcolor="$THEME[bordercolor]">
<table border="0" cellspacing="$THEME[borderwidth]" cellpadding="$THEME[tablespace]" width="100%">
<tr>
<td class="category mediumtxt" align="center"><font color="$THEME[cattext]"><strong>$lang[bday_03]</strong></font></td>
</tr>
<tr>
<td bgcolor="$THEME[altbg1]" class="mediumtxt">$lang[bday_08]<br /> <br /> <strong>$happybday</strong> <br /> <br /><strong>$lang[bday_04]</strong></td>
</tr>
</table>
</td>
</tr>
</table>
<br />

=================================
Step 7: Create a new template called bdayno
=================================
==========================
Add the following code and submit
==========================

<table cellspacing="0" cellpadding="0" border="0" width="$THEME[tablewidth]" align="center">
<tr><td bgcolor="$THEME[bordercolor]">
<table border="0" cellspacing="$THEME[borderwidth]" cellpadding="$THEME[tablespace]" width="100%">
<tr>
<td class="category mediumtxt" align="center"><font color="$THEME[cattext]"><strong>$lang[bday_03]</strong></font></td>
</tr>
<tr>
<td bgcolor="$THEME[altbg1]" class="mediumtxt">$lang[bday_09]</td>
</tr>
</table>
</td>
</tr>
</table>
<br />

==================================
Step 8: Create a new template called bdaypage
==================================
==========================
Add the following code and submit
==========================

<table cellspacing="0" cellpadding="0" border="0" width="$THEME[tablewidth]" align="center">
<tr>
<td bgcolor="$THEME[bordercolor]">
<table border="0" cellspacing="$THEME[borderwidth]" cellpadding="$THEME[tablespace]" width="100%">
<tr>
<td class="category mediumtxt" align="center" colspan="2"><font color="$THEME[cattext]"><strong>$lang[bday_02]</strong></font></td>
</tr>
<tr>
<td class="mediumtxt" bgcolor="$THEME[altbg1]" align="center" valign="center">
$lang[bday_10]
<a href="#1">$lang[textjan]</a> : <a href="#2">$lang[textfeb]</a> : <a href="#2"></a><a href="#3">$lang[textmar]</a>
: <a href="#2"></a><a href="#4">$lang[textapr]</a> : <a href="#2"></a><a href="#5">$lang[textmay]</a>
: <a href="#2"></a><a href="#6">$lang[textjun]</a> : <a href="#2"></a><a href="#7">$lang[textjul]</a>
: <a href="#2"></a><a href="#8">$lang[textaug]</a> : <a href="#2"></a><a href="#9">$lang[textsep]</a>
: <a href="#2"></a><a href="#10">$lang[textoct]</a> : <a href="#2"></a><a href="#11">$lang[textnov]</a>
: <a href="#2"></a><a href="#12">$lang[textdec]</a>
<br />
<br />
<table width="100%" border="0" cellspacing="0" cellpadding="4" align="center" class="smalltxt">
<tr valign="top">
<td width="33%"><a name="1"></a><strong>$lang[textjan]</strong><br />
<img src="$THEME[imgdir]/bday_divide.gif" alt="$lang[bday_01]" /><br />
$list_1
<br />
</td>
<td width="33%"><a name="2"></a><strong>$lang[textfeb]</strong><br />
<img src="$THEME[imgdir]/bday_divide.gif" alt="$lang[bday_01]" /><br />
$list_2
<br />
</td>
<td width="33%"><a name="3"></a><strong>$lang[textmar]</strong><br />
<img src="$THEME[imgdir]/bday_divide.gif" alt="$lang[bday_01]" /><br />
$list_3
<br />
</td>
</tr>
<tr valign="top">
<td width="33%"><a name="4"></a><strong>$lang[textapr]</strong><br />
<img src="$THEME[imgdir]/bday_divide.gif" alt="$lang[bday_01]" /><br />
$list_4
<br />
</td>
<td width="33%"><a name="5"></a><strong>$lang[textmay]</strong><br />
<img src="$THEME[imgdir]/bday_divide.gif" alt="$lang[bday_01]" /><br />
$list_5
<br />
</td>
<td width="33%"><a name="6"></a><strong>$lang[textjun]</strong><br />
<img src="$THEME[imgdir]/bday_divide.gif" alt="$lang[bday_01]" /><br />
$list_6
<br />
</td>
</tr>
<tr valign="top">
<td width="33%"><a name="7"></a><strong>$lang[textjul]</strong><br />
<img src="$THEME[imgdir]/bday_divide.gif" alt="$lang[bday_01]" /><br />
$list_7
<br />
</td>
<td width="33%"><a name="8"></a><strong>$lang[textaug]</strong><br />
<img src="$THEME[imgdir]/bday_divide.gif" alt="$lang[bday_01]" /><br />
$list_8
<br />
</td>
<td width="33%"><a name="9"></a><strong>$lang[textsep]</strong><br />
<img src="$THEME[imgdir]/bday_divide.gif" alt="$lang[bday_01]" /><br />
$list_9
<br />
</td>
</tr>
<tr valign="top">
<td width="33%"><a name="10"></a><strong>$lang[textoct]</strong><br />
<img src="$THEME[imgdir]/bday_divide.gif" alt="$lang[bday_01]" /><br />
$list_10
<br />
</td>
<td width="33%"><a name="11"></a><strong>$lang[textnov]</strong><br />
<img src="$THEME[imgdir]/bday_divide.gif" alt="$lang[bday_01]" /><br />
$list_11
<br />
</td>
<td width="33%"><a name="12"></a><strong>$lang[textdec]</strong><br />
<img src="$THEME[imgdir]/bday_divide.gif" alt="$lang[bday_01]" /><br />
$list_12
<br />
</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
</tr>
</table>
<br />

===================
Note Before Continuing:
===================

Image Files Required:

There are two images included with this download - top_birthday.gif and bday_divide.gif.
Please upload both to all of your theme folders at this time and retaining the original image file names.
You may also make your own images but be sure they are uploaded to all of your theme folders. Otherwise your forum will display images as broken.

=========================
INSTALLATION COMPLETE!
=========================
Enjoy!