Major Additions - [AJAX] vB Pager 3.0.4

This modification currently contains a vulnerability. You are hereby advised to uninstall this modification until such time that the author provides a fix.
- vBulletin.org Staff

[AJAX] vB Pager 3.0.4

Hack Version: 3.0.4
vB-version: 3.5.x
Developer: WwW.UAEWEB.CoM
Install-difficulty: Few minutes!

Introduction:
vB Pager is a text-based instant messaging system over your community between members. Users can exchange short & quick messages amongst each other. Unlike the regular private messaging system, the paged user is guaranteed to read your message & reply to it (if you choose this option) instantly & easily.

• Features:
  • Uses AJAX Technology to Send pager messages / Get pager messages / Add & Remove a member to buddy list / Add & Remove a member from Ignore list. (No Refresh Required)
• Main Features:
  • vB Pager Buddy List ?pop-up? window is used to keep track of the friends you wish to interact with. By going to your "vB Pager Buddies", you'll be able to see which of your friends are currently online and offline, and be able to send them a pager message. Adding people to your buddy list also allow you to send pager messages to multiple forum members at the same time. You may add any member of the forums to your buddy list by clicking the icon next to their names in the vB Pager Online Members Page or Clicking the Manage Buddies Link to add/remove members into your list.
  • vB Pager Ignore List ?pop-up? window lists are used for those people who's messages you wish not recieve from.
  • Received Pager Messages are Draggable Inline Popups.
  • Sending a message opens up a small window where you can type in message to be sent.
  • Optional Anonymity: you can choose to hide your username when paging another user on the forum, & define which Usergroup can utilize this option.
  • The window comes in with a built-in character counter to enable the user to keep track of the characters typed.
  • Logs of all incoming and outgoing pager messages ?Inbox/Sent Items? member has, can be viewed and deleted.
  • Download Stored Messages as XML, CSV, TXT.
  • Members can turn the vB Pager Off anytime they wish not to receive pager messages, and they can select the option to receive pager messages from those who are in their Pager Buddy List only.
• Admin CP Features:
  • vB Pager Options
    • Switch the paging system on or off anytime you wish!
    • vB Pager AJAX Check Period control.
    • Set to mark all read messages as deleted messages after being read by end users and prune them automaticly every one hour with cron job.(v3.0.4)
    • vB Pager Display Window Refresh Period control .
    • Set Floodcheck - Minimum Time Between Pager Messages.
    • Set Maximum Pager Messages Per-Page in inbox/sent items.
    • Allow vB Code in Pager Messages control.
    • Set the Sizes of Width and Height of the vB Pager Buddy List Window.
    • Set the Width Size of the Received Pager Message Box.(v3.0.1)
    • Enable Notification Sound on New Received Pager Message.(v3.0.1)
    • Enable/Disable the display of Avatar.(v3.0.2)
    • Banned Users.
  • Pager Message Statistics
    • Mass prune stored pager messages (All, Unread, and Deleted Messages).
    • search for users with X number of pager messages.
    • Delete pager messages for user x.
• Usergroup based Permissions:
  • Can Send Pager Messages. (Yes/No)
  • Maximum Stored Pager Messages.
  • Minimum Number of Posts Required Before Can Send Pager Messages.
  • Minimum Number of Posts Required (Per Day) Before Can Send Pager Messages.
  • Maximum Number of Pager Messages Can Send Per Day.
  • Maximum Recipients to Send Pagers at a time.
  • Maximum Characters Per Pager Message.
  • Can Hide Their Username When Paging Another User. (Yes/No)
  • Can Use Allow Reply Option When Sending Pager. (Yes/No)
  • Can Send Pager Message to All Users. (Yes/No)
• Other Features:
  • XML Product.
  • Fully Phrased.
  • No file edits.
• Screenshots, Updates, FAQs & Add-Ons:
  • See second & third post.
• Contents of vbpager.zip:
  • README.txt
  • Uploads
    • pager.php
    • pager_sound.wav (v3.0.1)
    • admincp
      • pageradmin.php
    • includes
      • xml
        • bitfield_pager.xml
        • cpnav_pager.xm
    • images
      • statusicon
        • vbpager.gif
        • vbpager_icon.gif
        • vbpager_user_buddylist_invisible.gif
        • vbpager_user_buddylist_online.gif
        • vbpager_user_ignorelist_invisible.gif
        • vbpager_user_ignorelist_online.gif
        • vbpager_user_invisible.gif
        • vbpager_user_offline.gif
        • vbpager_user_online.gif
        • vbpager_user_remove.gif
• Contents of xml Product:
  • vB Pager Templates
    • PAGER
    • PAGERBUDDYLIST
    • pagerbuddylistbit
    • pager_messagelist
    • pager_messagelistbit
    • pager_multipager
    • pager_newpager
  • vB Pager plugins
  • • vB Pager (cache_temlates)
    • vB Pager (parse_templates)
    • vB Pager (profile_updateoptions)
    • vB Pager (template_groups)
    • vB Pager (userdata_doset)
    • vB Pager (userdata_start)
    • vB Pager (cron_script_cleanup)
  • vB Pager phrases
    • Many of 'em
  • vB Pager Database Modifications
    • New Tables (pagerreceipt, pagertext)
    • Alterd Tables (user, usergroup, usertextfield)

How to Install:

• Simply download the zip file, Unzip it to a directory on your computer and follow the steps from the README.txt
• Remember to Change vB Pager Pemrissions from the Usergroup Manager.
• Make sure that you got your forum url filled in the Help Site Name / URL / Contact Details under your vBulletin Options. See this post
• Make sure that you got your forum directory name filled in the Forum Directory Name under your vB Pager Options.
• Please Read This Post befor asking for help.

How to Uninstall:

• Simply remove all uploaded files, revert your edited templates, and uninstall vB Pager Product from the Manage Products under the Plugin System in your ADMINCP.

Known Issues:

• Permissions are not being inherited from secondary usergroups.

Thanks to aberg for the Dutch translation.

PLEASE REMEMBER TO BACKUP BEFORE YOU BEGIN!
If you like this hack, please be kind and click on

[RFViet]

How can i page to unregistered users ???

[uae]

Originally Posted by Throtex

This is a great hack, and my users have been enjoying it without too many problems for several weeks now! Great job!

I don't have a lot of resources on my server, so I have to be careful with things like this, but even with only 256M of RAM and ~30 users at a time (peak) everything seems to run ok.

I did however notice a gradual slowdown over the past few days. After having no luck with any mySQL settings (memory use is already well under control) I remembered to purge the deleted messages. That seems to have sped everything back up, though it could have been a coincidence.

Since I haven't had a chance to explore how this script works, I'm not even sure if deleting messages should really have an impact on server loads. Could anyone shed some light on this? I'm guessing the reason there are message limits in the usergroup settings isn't because a few text messages take up a lot of disk space.

If so, it may be useful to introduce an option where messages are purged automatically when read, and perhaps not saved to the sent items list. My users don't like having to delete their messages when they hit the cap, but if storing a lot of messages does nothing to performance I might as well just take the cap off ... no?

A pager message is only stored once, it's only a record which points to the message text, so the message you have sent and see in your sent items is the same message the recipients gets and see in their inbox, so it's not a duplicate of the same message.
Messages are purged automatically if marked as deleted from both side.
Sure I can have an option where it would mark a message as a deleted message just after you click on the close or the reply button, but again, some people wants to have a record "log" of their conversation and maybe, download "export messages" them later.

You can always force members to clear their inbox/sent items by restricting number of messages they can store.
It should not have an impact on the server loads.

Originally Posted by m-e-h.com

Your Hack is great, but it has one problem:
The AJAX refresh (to check for new messages) generates traffic - even to users who deactivated the pager.
Next problem: The refresh is done at all opened windows / tabs.

So if a user has deactivates the pager and opens 5 tabs / windows he has about 7 kb traffic every x seconds for a feature he don't want to use.
This is a big disadvantage for users with volume-based tariffs and for us because we probably have to pay for this additional and unnecessary traffic.

Is it possible solve this problem?

Thx!

Thank you sir,
There is an option where some usergroup can send pager messages to users with pager turned off, and we should call all the functions and queries, even if they trund the pager off.

I don't think I can do anything about the mutli windows part, but you can always turn the AJAX check to 0 and have the pager pops up manually, so there will be no AJAX check.

Originally Posted by RFViet

How can i page to unregistered users ???

You can not send pager messages to unregistered users.

[m-e-h.com]

There is an option where some usergroup can send pager messages to users with pager turned off, and we should call all the functions and queries, even if they trund the pager off.

Allright, this option was activted. One problem less...
/edit
I'm sorry, but it doesn't work. I deactivated the pager but I still have traffic every x seconds. :disappointed:

I don't think I can do anything about the mutli windows part, but you can always turn the AJAX check to 0 and have the pager pops up manually, so there will be no AJAX check.

This would be a solution - but not a good one, because in this case, you coluld use the private message-system instead of the pager.

First possible sulution: A seperate pager-window.
Second possible solution: The reload-time or the whole reload-options could be set by the user within preset - admin-defined - ranges. Maybe with a hint like "This can produce additional traffic...".

cm

[Gommeke]

I want to know how I can uninstall this hack.
Since I installed it users cannot edit their settings anymore.
Quit annoying, I should say.

[Gommeke]

Warning: mysql_fetch_array(): supplied argument is not a valid MySQL result resource in O:\FOO\www\includes\class_core.php on line 694
Date: Sunday 19th of February 2006 09:45:35 PM
Username: Niet geregistreerd
IP Address: 81.246.189.159

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

Warning: mysql_free_result(): supplied argument is not a valid MySQL result resource in O:\FOO\www\includes\class_core.php on line 744
Date: Sunday 19th of February 2006 09:45:35 PM
Username: Niet geregistreerd
IP Address: 81.246.189.159

I got these errors after installing the VBpager-plugin.

Users can not alter their settings.

Can someone help me out here.

[alfaowner]

Hey, im feeling this! This is the best addon to any board ever!!!!

[SwissPegasus]

Many thanks to uae. Since you was on my forum, and fix the logout bug, everything works just perfect. Thank you very much.

[Toky0]

I'm on my way to work right now. So I'm sorry for not searching the thread.. But I have the hack installed and running with the exception of the message window poping up. Does anyone know why it won't show up? I've checked everything I know of in the options and still nothing. Please help. :nervous:

EDIT: The attached image is the message box I speak of.

[Tracer Gun Kata]

My Internet Explorer is Crashing when a new Pager Message received?
vB Pager hack does not like the use of custom color scrollbar, so you if you are using a custom css for the elements of a scroll bar, remove it from your css.

I have looked through and searched through this topic and found no reference on how to remove it..

Could someone just give me a step by step?

[Totti]

Open the install-instructions and follow them from button to top
[uploading becomes deleting and so on]

But be careful, before installing hacks you should know roundabout what you are doing