Title: Active Users vs. 4.0.17
Author: Nathan Bales of ls3k.com
Other Contributors: Dayve of burningsouls.com
                   
         GauravBhabu of forumsquare.com
                             Richard Kinser
                        
         Slemieux
Beta Testers: Dayve of burningsouls.com
                    Gremlin of http://www.daoc-halo.com/
                    RuiRib
Languages-Translators: English 1033 - Nathan Bales
                                   Portuguese (Portugal) 2070 - RuiRib
                                   Dutch 1043 - Roland "Frutzle" Pot
                                   Hebrew 1037 (incomplete) - milki
                                   French 1036
- Ayoye
                                   Portuguese (Brazil) 1046 - Marcos Vinicius de Souza
                                   Danish 1030 - Kim Keller Rasmussen
                                   Japanese 1041 - Taku Shingai
                                   Swedish 1053 - Tomas Alsbro
                                   Italian 1040 - Vincenzo Daniele
                                   Spanish 1034 - Mariano Martín
Download: http://www.ls3k.com/snitz/mods.asp
Support: http://forum.snitz.com/forum/
File History
: Created 4-5-2002 - Nathan Bales - 4.0b1
                   Modified 4-13-2002 - Nathan Bales -- Now reflects bugs found during beta testing. - 4.0.00
                   Modified 4-15-2002 - Nathan Bales -- Now reflects bugs found during first day of distribution - 4.0.05
                   Modified 4-25-2002 - Nathan Bales -- Now reflects vs. - 4.0.06
                   Modified 8-13-2002 - Nathan Bales -- Now reflects vs. - 4.0.1, updated for Snitz 3.4 RC2
                   Modified 8-20-2002 - Nathan Bales -- Reflects bugs that popped up when installing in 2.4
                   Modified 8-21-2002 - Nathan Bales -- More bugs, maybe I should start testing the fixes I make. 4.0.13
                   Modified 8-26-2002 - Nathan Bales -- Few more bugs, 4.0.16

Table of contents (this file):

Features:

Ease of Installation (10-Hard, 1-Easy): 5

Terms of use and distribution:  (Found on all ls3k made and packaged mods)
This is a module made available for Snitz forums. (http://forum.snitz.com)
It is released under the same terms (General Public License) as Snitz forums as requited by the terms of the GPL.

General Public License

The existence of Ls3k Mods relies on charity.  If you wish to donate to ls3k please see our website here: http://www.ls3k.com/snitz/donations.asp
Corporate users are strongly encouraged to donate.

Disclaimer:

Installation: WARNING: FOLLOW THESE DIRECTIONS IN THE ORDER THEY ARE PRESENTED!

Files in zip

Your zip package should contain the following file structure:

3303 (FOLDER)

active_users.asp
inc_activeusers.asp
admin_config_activeusers.asp
dbs_activeusers.asp
audbsetup.asp
icon_icq.gif

34 (FOLDER)

active_users.asp
inc_activeusers.asp
admin_config_activeusers.asp
dbs_activeusers.asp
audbsetup.asp

LANG (FOLDER)

LangMODS_Ls3kAU4.asp
LangMODS_Ls3kAU4_1030.asp
LangMODS_Ls3kAU4_1033.asp
LangMODS_Ls3kAU4_1034.asp
LangMODS_LS3kAU4_1036.asp
LangMODS_Ls3kAU4_1037.asp
LangMODS_Ls3kAU4_1040.asp
LangMODS_Ls3kAU4_1041.asp
LangMODS_Ls3kAU4_1043.asp
LangMODS_Ls3kAU4_1046.asp
LangMODS_Ls3kAU4_1053.asp
LangMODS_Ls3kAU4_2070.asp

At this point you need to determine if you need to use the Snitz 3.3.03 compatible files (for Snitz versions 3.3.03, 4.0b1, 4.0b2, and 4.0b3), or the Snitz 3.4 compatible files (for Snitz version 3.4 and 4.0b4+).  If you forum is older than version 3.3.03 then you will need to use the Active Users version 3.4b available at the Snitz Exchange

TIP:
If you don't know your Snitz Forums 2000 version, it is in your admin options > main forum config.

TIP: Now is a good time to use that 'close forum' feature that is the left-most icon in the header row of the table on default.asp

Version 3.3.03 Compatible
 

 

Version 3.4 Compatible

Upload all the files from the 3303 directory.  If any files need to be overwritten, back up your old files.

WARNING: This mod is not an upgrade of version 3.5! You need to remove the inc_activeusers.asp include from inc_top.asp
 

Upload all the files from the 34 directory.  If any files need to be overwritten, back up your old files.

Update Database

  • AFTER you have uploaded all the files from your 3303 directory and BEFORE you make any changes to existing files, you need to update the database.
  • Navigate you to your administration panel.  http://your-forum/admin_home.asp
  • Second from the bottom in the "Other Configuration Options and Features" column is the MOD Setup panel, open that.
    NOTE: If this page does not load correctly then come to the Snitz Support Forums and ask for "Richards non-fso mod setup file" and instructions for how to use it.
  • There should be a select form object in the center of the file.  Select "Active Users 4.0.1 for Snitz 3.3.03 compatable"
  • Make sure the checkbox is checked.
  • Click Update!
    NOTE: If you get the error, that is fine, it only means that is fine, you must have had Active Users 3.5 installed.

    Adding Column M_AUHIDE...
    Column already exists

  • From your browser run the audbsetup.asp filehttp://your-forum/audbsetup.asp When is says "Update Complete" then proceed onto modifying files.

Update Database

NOTE: If you have upgraded your forum from 3.3.0x and had active users installed before the upgrade, then you have the option of running these scripts or not.  If you choose to run them, you run the risk of loosing your old record.
  • AFTER you have uploaded all the files from your 34 directory and BEFORE you make any changes to existing files, you need to update the database.
  • Log in as the original admin account.  That is the one created during installation.
  • Navigate you to your administration panel.  http://your-forum/admin_home.asp
  • Second from the bottom in the "Other Configuration Options and Features" column is the MOD Setup panel, open that.
    NOTE: If this page does not load correctly then you can use the "(Alternative Mod Setup)" link, which is directly following the Mod Setup link
  • There should be a select form object in the center of the file.  Select "Active Users 4.0.1 for Snitz 3.4 compatable"
  • Make sure the checkbox is checked.
  • Click Update!
  • From your browser run the audbsetup.asp filehttp://your-forum/audbsetup.asp When is says "Update Complete" then proceed onto modifying files.

 

File Modifications

WARNING: DO NOT USE FRONTPAGE FOR THIS!
TIP:
A good free editor with line numbers that works really great for editing .asp files is
Araneae

Use your text editors find feature to fine the first chunk of code, and then paste the second chunk of code into the file as instructed.

TIP: Click the "Select All" link to select all of the text and then right-click in the textarea and choose "copy" from the context menu.

ADMIN_HOME.ASP
Find: (About line 75)


Make a blank line beneath that.  Paste the following. 



CONFIG.ASP
Find: (about line 91)


Paste this beneath that:



Find: (about line 303)


Paste this beneath that:



INC_PROFILE.ASP
Find: (about line 518)


Paste this above that: 



POP_PROFILE.ASP
There are three instances of this line on pop_profile.asp


Paste this underneath the second and third instances of the above line. 



Find: (about line 952)


Paste this beneath that: 



Find: (about line 1137)


Paste this beneath that: 

REGISTER.ASP
Find: (about line 198)


Paste this beneath that:

Find: (about line 288)


Paste this after that: 



DEFAULT.ASP
Find: (about line 391)


Paste this ABOVE that. NOTE: Add a %> in front of this, and a <% after it. 

INC_TOP.ASP
Find: (about line 187)


Replace that with this: 

Find: (about line 207)


Replace that with this: 

Find: (about line 109)


Paste this right after that: 

POP_CONFIG_HELP.ASP
Find: (about line 744)


Paste beneath that: 

INC_FUNCTIONS.ASP
Find: (about line 1422)


Paste above that: 



Find: (about line 1422)


Replace that with: 

Glad that's over with eh?  We still have to install languages though.
 

File Modifications

WARNING: DO NOT USE FRONTPAGE FOR THIS!
TIP:
A good free editor with line numbers that works really great for editing .asp files is
Araneae

Use your text editors find feature to fine the first chunk of code, and then paste the second chunk of code into the file as instructed.

TIP: Click the "Select All" link to select all of the text and then right-click in the textarea and choose "copy" from the context menu.

ADMIN_HOME.ASP
Find: (About line 95)


Make a blank line beneath that.  Paste the following. 



CONFIG.ASP
Find: (about line 124)


Paste this beneath that:



Find: (about line 388)


Paste this beneath that:



INC_PROFILE.ASP
Find: (about line 444)


Paste this IN BETWEEN those two lines: 



POP_PROFILE.ASP
There are BOTH instances of this line on pop_profile.asp (about lines 820 and 952)


Paste this underneath both instances of the above line. 



Find BOTH instances of this: (about line 1211 and 1482)


Paste this beneath both of them: 

REGISTER.ASP

Find this: (about line 86)


Replace that with this:

Find BOTH instances of this: (about line 141 & 436)


Paste this beneath both those: 



Find: (about line 182)


Paste this beneath that:

Find: (about line 562)


Paste this after that: 



DEFAULT.ASP
Find: (about line 568)


Paste this ABOVE that. NOTE: Add a %> in front of this, and a <% after it. 

INC_HEADER.ASP
Find: (about line 212)


Add after that: 


POP_CONFIG_HELP.ASP
(Optional)

Find: (about line 983)


Paste above that: 

 

INC_FUNC_COMMON.ASP
Find: (about line 42)


Paste above that: 

 

LOGIN.ASP
Find: (about line 42)


Paste under that: 

Glad that's over with eh?  We still have to install languages though.

 

Language Installation
  1. Upload the LangMODS_Ls3kAU4.asp and LangMODS_Ls3kAU4_1033.asp files to your forum.
     
  2. Include the Mod Lang file into your config.asp
     
    • VERSION 4.0b1, b2 and b3 (and version 3.3.03s already configured for international mods)
      Add this to the very bottom of your existing config.asp file.
      This should be after the last %> in the file.
      <!--#include file="langMODS_Ls3kAU4.asp"-->
       
    • VERSION 3.3.03 (not already configured)
      Add this to the very bottom of your exiting config.asp file
      This replaces the last %> in the file.


       
  3. If you wish to add any of the languages other than English, then remove the ' from in front of the corresponding case statement in the LangMODS_Ls3kAU4.asp file.  Then add a # symbol before the word "include" in the following line.  You can look at the English include for reference.  Re-upload the LangMODS_Ls3kAU4.asp file, and also upload the corresponding language file.

    WARNING: Not all the language packs may contain all the language variables needed for the most recent version of this mod.

Language Installation
  1. Upload the LangMODS_Ls3kAU4.asp and LangMODS_Ls3kAU4_1033.asp files to your forum.
     
  2. Include the Mod Lang file into your config.asp
     
    • VERSION 4.0b4+  (and version 3.4s already configured for international mods)
      Add this to the very bottom of your existing config.asp file.
      This should be after the last %> in the file.
      <!--#include file="langMODS_Ls3kAU4.asp"-->
       
    • VERSION 3.4 (not already configured)
      Add this to the very bottom of your exiting config.asp file
      This replaces the last %> in the file.


       
  3. If you wish to add any of the languages other than English, then remove the ' from in front of the corresponding case statement in the LangMODS_Ls3kAU4.asp file.  Then add a # symbol before the word "include" in the following line.  You can look at the English include for reference.  Re-upload the LangMODS_Ls3kAU4.asp file, and also upload the corresponding language file.

    WARNING: Not all the language packs may contain all the language variables needed for the most recent version of this mod.

     

Configuration / Deployment

TIP: If you closed down your forum above, now would be a good time to open it back up to the public. ;)

To administrate the mods features login as admin.  Go to Admin Options > Config Active Users.  There you will be able to set values and turn features on and off. 

Once you have confirmed that the mod is working, delete the two database update files form your forum directory.  They are dbs_activeusers.asp and audbsetup.asp.

The question marks on the left contain help and tips.

Translations

Do you need a language that is not included in the zip file?  Translate it!! =)

Make sure you know the LCID of the language you wish to translate into.  You can use the English (1033) file as a reference for your translation.  It is called LangMODS_Ls3kAU4_1033.asp

When you complete your translation you can send it to me (nathan@ls3k.com) and I will add it to the distributed zip file.  Make sure you include your name in the langue file!!

LCID Language LCID Language
1078 Afrikaans 1052 Albanian
5121 Arabic(Algeria) 15361 Arabic(Bahrain)
3073 Arabic(Egypt) 2049 Arabic(Iraq)
11265 Arabic(Jordan) 13313 Arabic(Kuwait)
12289 Arabic(Lebanon) 4097 Arabic(Libya)
6145 Arabic(Morocco) 8193 Arabic(Oman)
16385 Arabic(Qatar) 1025 Arabic(Saudi Arabia)
10241 Arabic(Syria) 7169 Arabic(Tunisia)
14337 Arabic(U.A.E.) 9217 Arabic(Yemen)
1069 Basque 1059 Belarusian
1026 Bulgarian 1027 Catalan
3076 Chinese(Hong Kong) 2052 Chinese(PRC)
4100 Chinese(Singapore) 1028 Chinese(Taiwan)
1050 Croatian 1029 Czech
1030 Danish 2067 Dutch(Belgian)
1043 Dutch(Standard) 9 English
3081 English(Australian) 10249 English(Belize)
2057 English(British) 4105 English(Canadian)
9225 English(Caribbean) 6153 English(Ireland)
8201 English(Jamaica) 5129 English(New Zealand)
7177 English(South Africa) 11273 English(Trinidad)
1033 English(United States) 1061 Estonian
1080 Faeroese 1065 Farsi
1035 Finnish 2060 French(Belgian)
3084 French(Canadian) 5132 French(Luxembourg)
1036 French(Standard) 4108 French(Swiss)
2108 Gaelic(Irish) 1084 Gaelic(Scots)
3079 German(Austrian) 5127 German(Liechtenstein)
4103 German(Luxembourg) 1031 German(Standard)
2055 German(Swiss) 1032 Greek
1037 Hebrew 1081 Hindi
1038 Hungarian 1039 Icelandic
1057 Indonesian 1040 Italian(Standard)
2064 Italian(Swiss) 1041 Japanese
1042 Korean 2066 Korean(Johab)
1062 Latvian 1063 Lithuanian
1071 Macedonian 1086 Malaysian
1082 Maltese 1044 Norwegian(Bokmal)
2068 Norwegian(Nynorsk) 1045 Polish
1046 Portuguese(Brazilian) 2070 Portuguese(Standard)
1047 Rhaeto-Romanic 1048 Romanian
2072 Romanian(Moldavia) 1049 Russian
2073 Russian(Moldavia) 1083 Sami(Lappish)
3098 Serbian(Cyrillic) 2074 Serbian(Latin)
1051 Slovak 1060 Slovenian
1070 Sorbian 11274 Spanish(Argentina)
16394 Spanish(Bolivia) 13322 Spanish(Chile)
9226 Spanish(Colombia) 5130 Spanish(Costa Rica)
7178 Spanish(Dominican Republic) 12298 Spanish(Ecuador)
17418 Spanish(El Salvador) 4106 Spanish(Guatemala)
18442 Spanish(Honduras) 2058 Spanish(Mexican)
19466 Spanish(Nicaragua) 6154 Spanish(Panama)
15370 Spanish(Paraguay) 10250 Spanish(Peru)
20490 Spanish(Puerto Rico) 3082 Spanish,Spain-Modern Sort
1034 Spanish(Spain - Traditional Sort) 14346 Spanish(Uruguay)
8202 Spanish(Venezuela) 1072 Sutu
1053 Swedish 2077 Swedish(Finland)
1054 Thai 1073 Tsonga
1074 Tswana 1055 Turkish
1058 Ukrainian 1056 Urdu
1075 Venda 1066 Vietnamese
1076 Xhosa 1085 Yiddish
1077 Zulu 2048 default


Active Users version 4.0 Readme -- Best viewed in Internet Explorer 5+ or Mozilla 1+