Software Information
    Document Software:  XMB Version 1.9.11
    Author: The XMBGroup
    Reference: http://xmbforum.com

Hack/Modification Information
    Branch Title: Birthday Page
    Version: 5.1
    Last Updated: 18 January 2009

Author Information
    Author: Darryl
                Lee Jian Yuan
    Updated: Wormhole 1.9.0       3.0
                   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
                   The XMB Group 1.9.10      5.0
                   Robert Chapin 1.9.11      5.1

=============================================================================
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
=============================================================================

=============================================================================
Action I:	Find
=============================================================================

/* Set Up HTML Templates and Themes */

=============================================================================
Action II:	Add Code Above:
=============================================================================


// Birthday Page - Language: Starts
if (!isset($lang['bday_11'])) {
    require_once(ROOT.'include/translation.inc.php');
    $phrases = array();
    $phrases['bday_01'] = "Birthdays";
    $phrases['bday_02'] = "$bbname Member Birthdays";
    $phrases['bday_03'] = "Happy Birthday!";
    $phrases['bday_04'] = "HAPPY BIRTHDAY!";
    $phrases['bday_05'] = "Birthday List";
    $phrases['bday_06'] = "Birthday List Status:";
    $phrases['bday_07'] = "Viewing Birthdays";
    $phrases['bday_08'] = "$bbname would like to say Happy Birthday to the people who are celebrating their birthday today, they are:";
    $phrases['bday_09'] = "There are no registered birthdays today on $bbname.<br />";
    $phrases['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 />";
    $phrases['bday_11'] = "Birthday Listing";
    setManyLangValues($phrases, $langfile);
    loadLang($langfile);
}
// Birthday Page - Language: Ends

=============================================================================
Action III:	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>';
}

=============================================================================
Action IV:	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 online.inc.php
=============================================================================
=============================================================================
Action I:	Find
=============================================================================

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

=============================================================================
Action II:	Add Code Below
=============================================================================

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

=============================================================================
Step 4:	Open cp.php
=============================================================================
=============================================================================
Action I:	Find
=============================================================================

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

=============================================================================
Action II:	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

=============================================================================
Action III:	Find
=============================================================================

        printsetting1($lang['textmemliststatus'], 'memliststatusnew', $memliston, $memlistoff);

=============================================================================
Action IV:	Add Code Below
=============================================================================

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

=============================================================================
Action V:	Find
=============================================================================

        $memliststatusnew = formOnOff('memliststatusnew');

=============================================================================
Action VI:	Add Code Below
=============================================================================

        // Birthday Page Mod Begin
        $bday_statusnew = formOnOff('bday_statusnew');
        // Birthday Page Mod End

=============================================================================
Action V:	Find
=============================================================================

        $sql = "UPDATE ".X_PREFIX."settings SET

=============================================================================
Action VI:	Add Code Below:
=============================================================================

            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.

=============================================================================
Step 5:	Create a new template called bday
=============================================================================
=============================================================================
Action I:	Add the following code and submit
=============================================================================

<table cellspacing="0" cellpadding="0" border="0" width="$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 6:	Create a new template called bdayno
=============================================================================
=============================================================================
Action I:	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 7:	Create a new template called bdaypage
=============================================================================
=============================================================================
Action I:	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="#3">$lang[textmar]</a> : <a href="#4">$lang[textapr]</a> : <a href="#5">$lang[textmay]</a> : <a href="#6">$lang[textjun]</a> : <a href="#7">$lang[textjul]</a> : <a href="#8">$lang[textaug]</a> : <a href="#9">$lang[textsep]</a> : <a href="#10">$lang[textoct]</a> : <a href="#11">$lang[textnov]</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 a couple of images included with this download - birthday.gif and
bday_divide.gif. Please upload both to each of your theme folders at this
time. You may also make your own images, but ensure they are uploaded and retain the original file names.
Otherwise, your forum will display images as broken.

=============================================================================
INSTALLATION COMPLETE
=============================================================================

The installation of this modification is now complete. You can modify the settings in your admin cp. Enjoy!
