Whodownloaded_IP with Dates

Welcome to Mr Blunt's "Whodownloaded_IP" Series for vBulletin 3.5.2


This is FREE CODE AND CAN BE used, abused, and released as desired!!
I only ask it REMAIN FREE - unless maybe you compensate me as well??
If any code looks familiar, I'm sorry and ASSURE YOU it's coincidence!!

Paypal Donations are graciously accepted if you like this script.
I'm just a broke amateur who enjoys writing free stuff (for now).
Donations goto my - Help Rebuild My PC Fund.
But the script is free if your broke too ... So enjoy it either way!!


mr_blunt@sbcglobal.net

Please email me for comments, questions, or anything else on your mind.
Put the exact word "Whodownloaded" in subject to get by my spam filters!
My nick "Mr Blunt" is also at www.vbulletin.org & www.vbulletin.com
Support thread: https://vborg.vbsupport.ru/showthread.php?t=93167


IMPORTANT KEY NOTES:
This script REQUIRES vBulletin 3.5.0 or above and was tested with vb 3.5.2
Failure to upload all files to server WILL PRODUCE DATABASE ERRORS.
Install "Product" file as a "PRODUCT" ... not as a "PLUGIN" or "STYLE".


Features of Whodownloaded_IP:

1. Log fileid & userid for EVERY download.
2. Optionally log date, username, filename for easy tracing after deletions.
3. Optionally log IP's and ALT_IP's (ALT_IP could be the IP behind a proxy).
4. File deletions won't delete OUR info, so admins can still backtrack.
5. Customizable width of popup so admins & members get different sizes.
6. Customizable viewing permissions for the popup.
7. Customizable phrases for non english forums.
8. The button to open popup is easy to add to templates.
9. Click any name in the popup to view user's profile.
10. Click file date in the popup to view the post where the file is located.
11. Hover the paperclip by dates to get downloads id# for easy referencing.
12. Template edits are "additions", not "modifications", so no conflictions.
13. Powered by one 3rd party database table, a few vBulletin addon fields.
14. Admins can now search database by any criteria (partial terms are OK).

Whodownloaded (PRE-IP-v100) Uninstallation Procedures
JUST IN CASE YOU HAVE ANY OF MY OLD vb3.0.x VERSIONS:
Uninstall any "NON-IP" version before installing this.
vBulletin PHP FILE: attachment.php -- (307 versions edited this)
3rd Party PHP FILE: whodownloaded.php
vBulletin TEMPLATE: postbit_attachment
vBulletin TEMPLATE: headinclude
3rd Party TEMPLATE: whodownloads
3rd Party TEMPLATE: whodownloadsbit
3rd Party TEMPLATE: whodownloads_error
3rd Party TEMPLATE: whodownloads_error_nop
vBulletin DATABASE TABLE: user
3rd Party DATABASE FIELD: user.downloads

1. Revert my old code out of "postbit_attachment" template.
2. Revert my old code out of "headinclude" template (if still there).
3. Revert all other templates listed (that deletes them).
4. Delete the whodownloaded.php file.
5. vB350 gave a new attachment.php so forget about that old file, forever.
6. DO NOT DELETE OLD "downloads" FIELD UNTIL WE TRANSFER DATA TO NEW TABLE!
7. DO NOT DELETE OLD "downloads" FIELD UNLESS NO OTHER HACKS ARE USING IT!!
8. NEVER DELETE VBULLETIN'S "USER" TABLE ... NEVER EVER!!!!!!!!

Whodownloaded_IP Installation/Upgrade Procedures:

1. For non-English forums - EDIT product phrases in the Product XML.
2. UPLOAD & Overwrite all files from the UPLOAD folder to your server.
3. IMPORT 'product_blunts_whodl_ip.xml' and select "Allow Overwrite".
4. MERGE 'style_blunts_whodl_ip.xml' over your styles (ignore version).
5. SET controls in AdminCP 'Usergroup Permissions'.
6. SET controls in AdminCP 'vBulletin Options'.
7. DONE ... Hope You Enjoy It!!!

NOTE: If you have other hacks that edit a same STYLE TEMPLATE, then SKIP STEP #4 AND manually edit templates as listed further down.

Test it and come back to the file's vbulletin.org forum support thread and CLICK INSTALL so I can alert you when this hack gets important updates. NO, I DO NOT SPAM!!! Alerts will only be sent AFTER major changes!!


Whodownloaded_IP Uninstallation Procedures:

1. Revert (or remove code from) any templates which you added button to.
2. Delete file 'includes/xml/bitfield_blunts_whodl_ip.xml' from server.
3. Delete file 'includes/xml/cpnav_blunts_whodl_ip.xml' from server.
4. Delete PRODUCT 'Whodownloaded_IP' from AdminCP Products.
5. Read Screen & Click button if you want to delete data table (optional).
6. Delete file 'blunts_whodownloaded_ip.php' from server.
7. Delete file 'admincp/bitfield_blunts_whodl_ip.xml' from server.
8. Delete file '/images/attach/blunts_whodl_vertical.bmp' from server.
9. Done ... Thank You For Checking It Out!!!

Do NOT uninstall prior versions before v120 is installed.
And the order of steps is important, so please be careful.


Whodownloaded_IP Files To Upload:

1. /blunts_whodownloaded_ip.php
2. /admincp/admin_blunts_whodl_ip.php
3. /images/attach/blunts_whodl_vertical.bmp
4. /includes/xml/bitfield_blunts_whodl_ip.xml
5. /includes/xml/cpnav_blunts_whodl_ip.xml

Whodownloaded_IP Product File Contents:
File Name: product_blunts_whodl_ip.xml
Product ID: blunts_whodl_ip
Title: Whodownloaded_IP
Version: 1.2.0

3rd Party PLUGIN: Whodownloaded IP - Enable Bitfields
3rd Party PLUGIN: Whodownloaded IP - Enable Viewing
3rd Party PLUGIN: Whodownloaded IP - Enable Logging
3rd Party MASTER PHRASES: 65 Phrases with 'blunts_whodl_' prefix
3rd Party MASTER TEMPLATE: blunts_whodownloaded_ip_main
3rd Party MASTER TEMPLATE: blunts_whodownloaded_ip_namebit
3rd Party MASTER TEMPLATE: blunts_whodownloaded_ip_datebit
3rd Party DATABASE TABLE: blunts_whodownloaded_ip
3rd Party DATABASE FIELD: blunts_whodownloaded_ip.whodownloaded_ipid
3rd Party DATABASE FIELD: blunts_whodownloaded_ip.userid
3rd Party DATABASE FIELD: blunts_whodownloaded_ip.username
3rd Party DATABASE FIELD: blunts_whodownloaded_ip.filename
3rd Party DATABASE FIELD: blunts_whodownloaded_ip.fileid
3rd Party DATABASE FIELD: blunts_whodownloaded_ip.ipaddress
3rd Party DATABASE FIELD: blunts_whodownloaded_ip.alt_ip
3rd Party DATABASE FIELD: blunts_whodownloaded_ip.dateline
3rd Party DATABASE FIELD: usergroup.bluntswhodlpermissions
3rd Party DATABASE FIELD: settinggroup.blunts_whodl
3rd Party DATABASE FIELD: settings.blunts_whodl_popisactive
3rd Party DATABASE FIELD: settings.blunts_whodl_poplarge
3rd Party DATABASE FIELD: settings.blunts_whodl_popsmall
3rd Party DATABASE FIELD: settings.blunts_whodl_logwhat


Whodownloaded_IP Style File Contents:
File Name: style_blunts_whodl_ip.xml
OVERWRITES these 4 standard vBulletin templates:

vBulletin Template: modifyattachmentsbit (November 1st, 2005)
vBulletin Template: postbit_attachment (Aug 20th, 2005)
vBulletin Template: postbit_attachmentmoderated (Aug 20th, 2005)
vBulletin Template: postbit_attachmentthumbnail (Aug 20th, 2005)

Use these manual template edit instructions if you use other hacks!!

Template: modifyattachmentsbit
FIND THIS:

<div class="smallfont">$post[postdate] <if condition="!$show['detailedtime']"><span class="time">$post[posttime]</span></if></div>

ADD THIS BELOW IT:

<if condition="$show['blunts_whodl_width']"><div class="smallfont"><input type="button" class="button" value="$vbphrase[blunts_whodl_who_downloaded]" tabindex="1" onclick="window.open('blunts_whodownloaded_ip.php?$session[sessionurl]fid=$post[attachmentid]','blunts_whodownloaded_ip','toolbar=no, scrollbars=yes, resizable=yes, width=$show[blunts_whodl_width], height=450, top=50, left=50'); return false;" title="$vbphrase[blunts_whodl_who_downloaded]: $post[attachmentid]" /></div></if>

Template: postbit_attachment
Template: postbit_attachmentmoderated
FIND THE LAST:

</tr>

ADD THIS BEFORE IT:

<td><if condition="$show['blunts_whodl_width']"><input type="button" class="button" value="$vbphrase[blunts_whodl_who_downloaded]" tabindex="1" onclick="window.open('blunts_whodownloaded_ip.php?$session[sessionurl]fid=$attachment[attachmentid]','blunts_whodownloaded_ip','toolbar=no, scrollbars=yes, resizable=yes, width=$show[blunts_whodl_width], height=450, top=50, left=50'); return false;" title="$vbphrase[blunts_whodl_who_downloaded]: $attachment[attachmentid]" /></if></td>

Template: postbit_attachmentthumbnail
FIND THE LAST:

&nbsp;<if condition="$show['br']"><br /><br /></if>

ADD THIS BEFORE IT:

<if condition="$show['blunts_whodl_width']">
	<if condition="is_browser('ie', '5.5')">
		<input type="button" class="button" value="$vbphrase[blunts_whodl_who_downloaded]" tabindex="1" onclick="window.open('blunts_whodownloaded_ip.php?$session[sessionurl]fid=$attachment[attachmentid]','blunts_whodownloaded_ip','toolbar=no, scrollbars=yes, resizable=yes, width=$show[blunts_whodl_width], height=450, top=50, left=50'); return false;" title="$vbphrase[blunts_whodl_who_downloaded]: $attachment[attachmentid]" style="writing-mode:tb-rl" />
	<else />
		<a href="blunts_whodownloaded_ip.php?$session[sessionurl]fid=$attachment[attachmentid]"<if condition="$show['newwindow']"> target="_blank"</if>><img class="button" src="$stylevar[imgdir_attach]/blunts_whodl_vertical.bmp" alt="$vbphrase[blunts_whodl_who_downloaded]" border="1" title="$vbphrase[blunts_whodl_who_downloaded]: $attachment[attachmentid]" /></a>
	</if>
</if>

Version History:

v-1.0.0 - July 29th, 2005:

1. Initial vb350 release which adds ip & date logging to old vb3 hack.

v-1.0.5 - August 9th, 2005:

1. Prevent logging of non-thumbnail image views (images loaded by showthread).
2. Use escape_string to clean dB insertion variables during dB writes.
3. Moved names above users date/IP list.
4. Added paperclip hover target to show id# of the logged download.
5. Added phrase 'blunts_whodl_download_id' for use in hover paperclip.
6. Added vertical button BMP FILE for non-IE users (next to thumbs).
7. Added vertical button WITH CODE for IE users (next to thumbs).
8. Tweaked the popup's gui layout to give some nice borders.
9. Cut the dB reading down to 2 queries.
10. Began building up the 2 queries & other things for future search features.
11. Set the php environment & pre-cache templates.
12. URL input (was attachment=X) is now fid=X (fid is attachmentid or fileid).

v-1.0.7 - August 20th, 2005:

1. Added the time of download to any dates shown.
2. Added 'bitfield_blunts_whodl_ip.xml' (upload to 'INCLUDES/XML' folder).
3. Added 'bluntswhodlpermissions' field to vB's 'usergroup' table.
4. Added 5 Custom Usergroup Permissions to AdminCP (and phrases for them).
5. Added 10 Custom vBulletin Options to AdminCP (and phrases for them).
6. Added comments to the installation process to be echoed back to user.
7. Added code to seek/transfer data from old whodownloaded hacks to new table.
8. Repaired the integer fields in our dB table to be INT(10) and UNSIGNED.
9. Modified the internal product templates again (they install themselves).
10. Modified STYLE file again (you can keep using v105's if you want to).
11. Changed all but one global phrase to be in my own 'phrase group'.
12. Shuffled some things around in the PHP script.
13. Renamed style and product files to conform with the other underscores.

v-1.1.0 - November 1st, 2005:

1. Tweaked all of the "product codes" for (hopefully) the final time.
2. Added a new AdminCP Nav Group (left column) with hotlinks to key features.
3. Added a search engine for admins who have permission to control plugins.
4. Added ability for admins to manually edit/delete entries from database.
5. Importing & Deletion of old 3.0.x data can optionally be done at any time.
6. Deletion of main database table is now optional during uninstallation.
7. Found another template that can use a button (modifyattachmentsbit).

v-1.2.0 - December 12th, 2005:

1. MANDATORY FIX to correct issues which made 1.1.0 incompatible with vb351+ .... I strongly recommend updating this product before upgrading to vb351 or vb352, if you haven't yet.
2. Moved a lot of the install code from the product file to the admin file.
3. Condensed the rest of the install/uninstall code.
4. Changed the format of all files from Windows to UNIX.
5. Updated all the screenshots (zip file has 11 pics so are not shown).
6. Removed the Beta Tag from the product.

To Do and/or Wish List:

1. I'm still looking for someone to help me add better language support.

Known Bug List:

1. Installation messages are english only since code installs before phrases.
2. Non-IE5.5 shows horizontal href text next to thumbs IF THE BMP isn't found ... which looks REALLY dumb ... so make sure you upload the BMP to the proper folder on your server!!

Credits:

1. Mostly Jelsoft for their dedication and "easy to read & modify" code!!
2. vbulletin.com, vbulletin.org, & php.com for their excellent resources!!
3. The MEMBERS and MODS who MAKE these forums great resources!!
4. Special SHOUT to MarcoH64 and Andreas for help when I needed it.
5. AND OF COURSE TWTCommish for his original v2 whodownloaded hack!!

mr_blunt@sbcglobal.net

[Boofo]

Any way to have the button only show for certain usergroups? Maybe a setting?

[Mr Blunt]

#5 in my to-do list

In the meantime, the plugin is easy to edit.
Might LOOK tough, but it's not.
Edit the Product XML file before installation (or edit the plugin itself after, whichever).

Add something like this in the VIEWING plugin somewhere:

PHP Code:

if ($vbulletin->userinfo['usergroupid'] == X OR $vbulletin->userinfo['usergroupid'] == Y)
{
    $show['blunts_whodl_width'] = 500;
    $show['blunts_whodl_names'] = true;
    $show['blunts_whodl_dates'] = true;
    $show['blunts_whodl_dates_to_just_poster'] = true;
    $show['blunts_whodl_ips'] = true;
    $show['blunts_whodl_altips'] = true;
} 


Notice everything I just cut n pasted is the the same except for the IF statement itself.

Only thing you have to be careful about is nesting the IF'S.
With my one big nest, the first condition that succeeds will exit the "nest".

And you don't need to use my "one nest" either.
You can have a seperate conditional at the bottom!!

Example you could add a conditional at the end and if that condition is met it will override any previous condition which might/might not have been met.

If that didn't make sense, say so.

[laycomp]

Wow, great release!

By the look of the screens it looks like you've done a great job on the d/l stats, congratulations man! ...I think this calls for "beers on the house!"

Thanks MrBlunt, I look forward to installing this soon ...thanks again and I will report back.

[Mr Blunt]

I'm too much of a perfectionist so I'm still not happy with my work yet.

I really don't like having the usernames underneath the dates.
Just doesn't look right at all IMHO.
But that's just cosmetic stuff that hopefully I'll conquer soon.


Here's my dilema with that if anyone can help:


One username with his count next to it, but many dates so I can't eval the username beforehand because I don't know if his individual count is complete until I check next row's username.

I understand how to build seperate evals but I couldn't figure out how to join them correctly after that user is complete. If I could merge two different evals from within php, then I would create 3 eval vars ... one for name, one for dates, and the third merges the two together and unset the first two after it verifies this is the "next user" .... so that we can start processing on the next name from the long list.

[belinea]

Great Job Mr. Blunt

Many thanks for this great hack.

[belinea]

The downloads were correctly logged in vb3_blunts_whodownloaded_ip

But when I click on the "Who downloaded button" I get the following information:

Viewed By: 0 Memebers And 0 Guests
No Users Found

[Mr Blunt]

Hmmm, I'm stumped.

The "no user found" means your getting to the point in the code where we query my DB table and no data was returned from the table for the attachmentid number which was input.

This means all your settings and permissions are in good shape or we wouldn't have gotten that far into the code.


1) I hope you aren't expecting to see data from downloads PRIOR TO latest installation of v100 (previous versions or not) because I haven't gotten that far yet (#1 & #2 in my to-do list)

2) You say "they were correctly logged" ... Are you saying you went into phpmyadmin and "browsed" through the table manually and verified that the correct attachmentid number (I call it FILEID) and such was written to AND IS currently sitting in my table for the file you downloaded?

3) I hate to quote things that were erased, but my email notification which had your original post mentioned a database error ... and since the error was quoted, it wasn't included in the email so I don't know what the specific error said. If you could repost that database error for me, maybe it will give me a clue as to why my query isn't returning a result (feel free to remove the IP's from the message as I don't need or want that info).

[belinea]

Now all works fine. I have changed nothing. But it works now. :speechless:

[laycomp]

Mr. Blunt, I am using vb2 which is already using Commish's Hack. Soon I will attempt to upgrade to vb3. What would be the best way to install your hack so that I can still keep OLD attachments under the watchful eye of your WhoDownloaded IP hack? I have a huge db, 2 gigs ...mmm.. any tips or suggestions?

Regards~