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

Modification Version: 3.0

Modification Author: John Briggs

Updated/Repackaged for 1.9.11: John Scruggs http://www.kubasaki-bbs.com (kuba1)
                                                   miqrogroove  http://www.miqrogroove.com/forums/

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

Modification Copyright: 2008 The XMB Group. All rights reserved.

Modification Compatibility: XMB 1.9.11   This Modification will not work properly with any other versions.

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

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

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

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

Insert each line below and press the submit button.

ALTER TABLE `$table_settings` ADD `avatargal` set('on','off') NOT NULL default 'on';
ALTER TABLE `$table_settings` ADD `avatargalpp` smallint(6) NOT NULL default '20';
ALTER TABLE `$table_settings` ADD `avatargalpr` smallint(6) NOT NULL default '5';
=======================================================================================================================================
=======
Step 2:
=======

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

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

        $index_statson = $index_statsoff = '';
        settingHTML('index_stats', $index_statson, $index_statsoff);

===============
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['textmemliststatus'], 'memliststatusnew', $memliston, $memlistoff);

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

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

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

        $index_statsnew = formOnOff('index_statsnew');

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

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

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

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

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

            avatargal='$avatargalnew',
            avatargalpp='$avatargalppnew',
            avatargalpr='$avatargalprnew',

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

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

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

/* Set Up HTML Templates and Themes */

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

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

==========
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="'.$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, $altbg1, $altbg2, $lang;

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

    // Avatar Gallery Mod Begin
    global $SETTINGS;
    // Avatar Gallery Mod End

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

    if ($current == 'favorites') {
        $output .= "<td bgcolor=\"$altbg1\" width=\"15%\" class=\"ctrtablerow\">" .$lang['textfavorites']. "</td>";
    } else {
        $output .= "<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') {
        $output .= "<td bgcolor=\"$altbg2\" width=\"10%\" class=\"ctrtablerow\"><a href=\"avatars.php\">" .$lang['avatargallery']. "</a></td>";
    }
    // Avatar Gallery Mod End

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

        if ($SETTINGS['avastatus'] == 'on') {
            $avatar = postedVar('newavatar', 'javascript', TRUE, TRUE, TRUE);

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

        // Avatar Gallery Mod Begin
        if ($SETTINGS['avatargal'] == 'on' And $self['avatar'] == postedVar('newavatar', 'javascript', TRUE, FALSE, TRUE)) {
            $avatar = $db->escape_var($self['avatar']);
        } elseif ($SETTINGS['avastatus'] == 'on') {
            $avatar = postedVar('newavatar', 'javascript', TRUE, TRUE, TRUE);
        // 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:
=======

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

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

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

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

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

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

It is required that you create sub-folders within the "images/avatars" folder on your server.
All avatars should be saved & uploaded to those folders.

=======================================================================================================================================