Title: Private Messages User Guide for Snitz 3.4.03

Author: @tomic

Download: http://www.skepticfriends.org/download/privatemessages3_4_02.zip
Support: http://forum.snitz.com/forum/

File History:
Created 8-27-2002 - @tomic

September 5: Maximum Allowed Private Messages
                    Private Messages On/Off toggle

September 7: PMs added to topic.asp

September 12: Updated Files: readme.txt
                    members.asp
                    pop_profile.asp

September 29: Updated Files: readme.html
                    Added PM to Active Users
                    Assorted Improvements and fixes

October 2: Updated Files: privateread.asp - Added MSN support

October 3: Updated Files: privateread.asp, pm_view.asp - fixed MSN support, made changes to database queries.

Ease of Installation (10-Hard, 1-Easy): 7 (If you do everything in this readme)

Files in zip

Your zip package should contain the following file structure:

ASP FILES

ASP files should be loaded to your forum directory.

readme.html
admin_pmmaint.asp
dbs_PrivateMessages.asp
dbs_PrivateMessages2.asp
inc_privatemessages.asp
pm_delete.asp
pm_members.asp
pm_options.asp
pm_pop_members.asp
pm_view.asp
privatedelete.asp
privatemess.asp
privatemess2.asp
privateread.asp
privatesend.asp
privatesend_info.asp
privatesent.asp

IMAGES

Images should be loaded to the directory designated for images.

icon_pm.gif
icon_pm_new.gif
icon_pm_new2.gif
icon_pm_old.gif
icon_pm1.gif
icon_pm2.gif
icon_privatemessage.gif
pmdelete.gif
pmforward.gif
pminbox.gif
pmmemberlist.gif
pmnew.gif
pmoutbox.gif
pmprivatepref.gif
pmreceive.gif
pmreply.gif

The files below are included for reference only. Do not upload.

inc_iconfiles.asp
members.asp
pop_profile.asp
topic.asp

Upload all the files from the zip to directories indicated except for the example files.
If any files need to be overwritten, back up your old files for safety.
If you do not back these files up and you want to start over you will
have a problem!


To Install:

First Run the database setup...
All ASP files included in this zip file are to be uploaded to your main forum directory except for inc_iconfile.asp and members.asp and pop_profile.asp. Those are included as examples of how the code should look when you have made the specified changes. Otherwise you will overwrite your other MODs. Images shpuld be uploaded to your forum image directory or your forum directory. Yes, I said it twice ; )

I recommend that all Access users use the Connectstring in your config.asp file labeled as Access2000 This mod will behave better with it, instead of the connectstring labeled as Access97. You can still use an Access97 database with the Access2000 connectstring.

examples of Access97 connectstrings: (not recommended that you use these with this mod)

'strConnString = "DRIVER={Microsoft Access Driver (*.mdb)}; DBQ=c:\inetpub\dbroot\snitz_forums_2000.mdb" '## MS Access 97
'strConnString = "DRIVER={Microsoft Access Driver (*.mdb)}; DBQ=" & Server.MapPath("/dbroot/snitz_forums_2000.mdb") '## MS Access 97 using virtual path

examples of Access2000 connectstrings:

'strConnString = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=c:\inetpub\dbroot\snitz_forums_2000.mdb;" '## MS Access 2000
'strConnString = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" & Server.MapPath("/fpdb/snitz_forums_2000.mdb") '## MS Access 2000 using virtual path

Goto your Admin Options and then click on "MOD Setup"

There are 2 options in the drop down box:

Private Messages Mod (Default) <-- All users should try this one first

Private Messages Mod for Access97 Connectstring <--

Access database users who receive an error with the first option should try this one. (only if there is no way for you to use the Access2000 connectstring) By using this one, there are 3 fields that don't get set with a DEFAULT value and you may experience problems running the Private Messages Mod.
Note:
Since this MOD uses application variables, you should run 'Check Installation' after completing all the installation steps so that the variables are loaded.


Files to edit:

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.


CONFIG.ASP.ASP

Add the following: (about line 128)

Add the following: (about line 400)


DEFAULT.ASP
Find: (about line 574)

Right above that but below "end if" insert the following:


INC_ICONFILES.ASP
Add the following: (about line 150)


ADMIN_HOME.ASP

Add the following: (about line 140)

This ads a link to admin_pmmaint.asp to your admin menu. This page is for adding/removing Private Messages from your pages and setting your PM variables and deleting old messages. You can choose to remove Private Messages that are 15,45 or 60 days old. You can also set the maximum number of PMs a member can send and turn PMs on and off.




MEMBERS.ASP
Find following: (about line 110)


Add ,M_PMRECEIVE to this line so it now looks like:



Find following: (about line 148)


Add ,M_PMRECEIVE to this line so it now looks like:



Find following: (about line 370)


Add the following directly below on line 371:



Find following: (about line 393)


Add the following directly below on line 394:



Find following: (about line 426)


Add the following directly below on line 427:




TOPIC.ASP
Find following: (about line 97)


Add , M.M_PMRECEIVE to this line so it now looks like:



Find following: (about line 125)


Immediately below it add this:



Find following: (about line 311)


Add , M.M_PMRECEIVE so that it now looks like:



Find following: (about line 513)


Add the following directly below on line 514:


You will need to readjust the numbering following rM_PM = 6 because PM's are now filling the #6 spot in
the array. So after rM_PM = 6 start it up again at rM_TITLE = 7 then the next is 8 and so on.


Find following: (about line 548)


Add the following directly below on line 549:



Find following: (about line 645)


Add the following directly below:



Find following: (about line 853)


Add the following directly below:



INC_HEADER.ASP
Add the following: (about line 260)

Look for the folowing (near line 460):


Make it look like this:



Private Messages version 3.4 Readme -- Best viewed in Internet Explorer 5+ or Mozilla 1+