=======================================================================================================================================
Modification Title: Avatar Gallery

Modification Version: 1.1

Modification Author: John Briggs

Modification Description:
This modification will provide an avatar gallery to your board which is configurable via the admin panel.
This modification will provide the ability for members to select an avatar from a folder of provided avatar images.

Modification Copyright:  2007-2008 XMBMods.com. All rights reserved.

Modification Compatibility: XMB 1.9.8 SP3

Modification Install Note: Before adding this modification to your forum you should back up all files related to this modification.

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

Modification Author Note:
This modification is developed and released for use with XMB 1.9.8 Engage Final SP3 which is provided by XMBGarage.com.

=======================================================================================================================================
=======
Step 1:
=======

=============================
Go To Admin Panel -> Insert Raw SQL
=============================

Upload provided file named "SQL.txt" & click "Submit Changes" button.

=======================================================================================================================================
=======
Step 2:
=======

=============
Edit File: cp.php
=============

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

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

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

        // Avatar Gallery Mod Begin
        $avatargalon = $avatargaloff = '';
        settingHTML('avatargal', $avatargalon, $avatargaloff);
        // Avatar Gallery Mod End
        
==========
Find Code:
==========

        printsetting2($lang['textmpp'], 'memberperpagenew', ((int)$SETTINGS['memberperpage']), 3);

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

        // Avatar Gallery Mod Begin
        printsetting2($lang['avatarsperpage'], 'avatargalppnew', ((int)$SETTINGS['avatargalpp']), 3);
        printsetting2($lang['avatarsperrow'], 'avatargalprnew', ((int)$SETTINGS['avatargalpr']), 3);
        // Avatar Gallery Mod End
        
==========
Find Code:
==========

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

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

        // Avatar Gallery Mod Begin
        printsetting1($lang['avatargalstatus'], 'avatargalnew', $avatargalon, $avatargaloff);
        // Avatar Gallery Mod End
        
==========
Find Code:
==========

        $onlinetoday_statusnew = formOnOff('onlinetoday_statusnew');

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

        // Avatar Gallery Mod Begin
        $avatargalppnew = formInt('avatargalppnew');
        $avatargalprnew = formInt('avatargalprnew');
        $avatargalnew = formOnOff('avatargalnew');
        // Avatar Gallery Mod End

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

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

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

        $db->query("UPDATE ".X_PREFIX."settings SET
            avatargal='$avatargalnew',
            avatargalpp='$avatargalppnew',
            avatargalpr='$avatargalprnew',

=======================================================================================================================================
=======
Step 3:
=======

================
Edit File: header.php
================

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

// '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:
===============

// Avatar Gallery-link
if (X_MEMBER && $SETTINGS['avatargal'] == 'on') {
    $links[] = '<img src="'.$THEME['imgdir'].'/top_avatars.gif" alt="'.$lang['avatargallery'].'"  border="0" /> <a href="avatars.php"><font class="navtd">'.$lang['avatargallery'].'</font></a>';
}

=======================================================================================================================================
=======
Step 4:
=======

=================
Edit File: memcp.php
=================

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

    global $THEME, $bordercolor, $tablewidth, $tablespacing, $altbg1, $altbg2, $lang;

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

    global $THEME, $bordercolor, $tablewidth, $tablespacing, $altbg1, $altbg2, $lang, $SETTINGS;

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

    if ($current == 'favorites') {
        echo "<td bgcolor=\"$altbg1\" width=\"15%\" class=\"ctrtablerow\">" .$lang['textfavorites']. "</td>";
    } else {
        echo "<td bgcolor=\"$altbg2\" width=\"15%\" class=\"ctrtablerow\"><a href=\"memcp.php?action=favorites\">" .$lang['textfavorites']. "</a></td>";
    }

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

    // Avatar Gallery Mod Begin
    if ($SETTINGS['avatargal'] == 'on') {
        echo '<td bgcolor="'.$THEME['altbg2'].'" width="10%" class="ctrtablerow"><a href="avatars.php">'.$lang['avatargallery'].'</a></td>';
    }
    // Avatar Gallery Mod End
    
=======================================================================================================================================
=======
Step 5:
=======

=======================
Edit File: include/online.inc.php
=======================

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

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

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

    // Avatar Gallery Mod Begin
    } else if (false !== strpos($url, '/avatars.php')) {
        $location = $lang['onlineavatars'];
    // Avatar Gallery Mod End
    
=======================================================================================================================================
=======
Step 6:
=======

=======================
Edit File: lang/English.lang.php
=======================

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

?>

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

// Avatar Gallery Mod Begin
$lang['avatars'] = "Avatars";
$lang['avatargallery'] = "Avatar Gallery";
$lang['avatargalstatus'] = "Avatar Gallery Status:";
$lang['avatarsperpage'] = "Avatars Per Page:";
$lang['avatarsperrow'] = "Avatars Per Row:";
$lang['onlineavatars'] = "Viewing avatar gallery";
$lang['updateavatar'] = "Update Avatar";
$lang['avatarnologin'] = "You must be logged in or registered.";
$lang['folderdoesnotexist'] = "The specified folder does not exist.";
$lang['avatarfeaturedisabled'] = "The avatar gallery has been disabled.";
$lang['avatarupdated'] = "Your avatar has been updated successfully.";
$lang['noavatarselected'] = "You must first choose an avatar.";
$lang['noavatarsinfolder'] = "There are no avatars to display in this folder.";
$lang['currentavatarmsg'] = "The image below is your current avatar.";
$lang['welcomeavatarmsg']= "Welcome to $bbname - Avatar Gallery!";
$lang['navigateavatarmsg'] = "By navigating through the folders on the left, you can choose a new avatar by browsing our gallery and making your selection.";
$lang['avatarnologin'] = "Sorry, but you must be registered or logged in to use the avatar gallery.";
// Avatar Gallery Mod End

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

=======================================================
Go To Admin Panel -> Templates -> Create Template Name -> avatar_gallery
=======================================================

===========================
Add Code & Click Submit Changes:
===========================

<form method="post" action="avatars.php">
<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" colspan="2"><font color="$THEME[cattext]"><strong>$lang[avatargallery]</strong></font></td>
</tr>
$multipage
<tr class="tablerow">
<td bgcolor="$THEME[altbg1]" valign="top" width="25%"><img src="$THEME[imgdir]/topav.gif" alt="$lang[altfolder]" border="0" /> <a href="avatars.php"><strong>$lang[avatars]</strong></a>$subfolders</td>
<td bgcolor="$THEME[altbg2]" valign="top" width="75%">
<table cellpadding="0" cellspacing="0" border="0" width="100%">
<tr>
$avatars
</table>
</td>
</tr>
$submitbutton
$multipage
</table>
</td>
</tr>
</table>
</form>

=======================================================================================================================================
=======
Step 8:
=======

===============================================================
Go To Admin Panel -> Templates -> Create Template Name -> avatar_gallery_multipage
===============================================================

===========================
Add Code & Click Submit Changes:
===========================

<tr class="tablerow" bgcolor="$THEME[altbg2]">
<td colspan="2">&nbsp;$multipage</td>
</tr>

=======================================================================================================================================
=======
Step 9:
=======

Upload the 4 images provided named "openav.gif", "closeav.gif", top_avatars.gif, and "topav.gif" to all theme folders.

Upload the provided file named "avatars.php" to your forum root path.

Note: All avatars should be saved/uploaded to the "images/avatars" folder of your board in sub-folders within.

=======================================================================================================================================
========
Step 10:
========

All avatars should be saved & uploaded to the "images/avatars" folder of your board.
it is best to create sub-folders within the "images/avatars" folder for multi avatars.

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