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

[quanvo81]

no sound plays for me. I mean I can't hear any sound every time a pager message popup, only registered users can hear the sound, other than that, other user groups can't hear, like admin etc..

[Allan]

Very nice, thanks for this hack

French Translate from Devil (just phrases)

[berayiwu5]

I have a question about installation. (I am not a programmer.)

The installation instruction lists three steps:

Step 1. Upload all the files from the "files" directory in this zip into your forum directory.
Step 2. Import product-pager.xml as a new product.
Step 3. Edit templates as instructed below.

I know how to complete Step 1 and Step 3, but I don't know what Step 2 means exactly. How do I "import product-pager.xml as a new product"?
Your tip is immensely appreciated.

[Xplorer4x4]

Originally Posted by berayiwu5

I have a question about installation. (I am not a programmer.)

The installation instruction lists three steps:


Step 1. Upload all the files from the "files" directory in this zip into your forum directory.
Step 2. Import product-pager.xml as a new product.
Step 3. Edit templates as instructed below.

I know how to complete Step 1 and Step 3, but I don't know what Step 2 means exactly. How do I "import product-pager.xml as a new product"?
Your tip is immensely appreciated.

Be sure you are runing vB 3.5.X and log into the admin cp. Towards the bottom of the left menu will be a typical drop down menu called plug ins. Open it and click manage product. Once that page is loaded there will be a link in the main frame that says import product.

[FROGGYJ]

fixed, nevermind

[FROGGYJ]

oops delete.

[berayiwu5]

Originally Posted by Xplorer4x4

Be sure you are runing vB 3.5.X and log into the admin cp. Towards the bottom of the left menu will be a typical drop down menu called plug ins. Open it and click manage product. Once that page is loaded there will be a link in the main frame that says import product.

It worked. Fabulous. Thanks.

[snakes1100]

Here's one i havent seen anyone post.

Warning: Division by zero in /includes/functions.php on line 1821

This is appearing in the popups when trying to delete your messages.

This is happening in IE and FF.

Also, an issue with this only working when someone is in the usercp, on the forum index page the system doesnt work.

[snakes1100]

Originally Posted by bashy

Hi

I have not been able to send a message using Firefox, its as if the character limit is set to 0. I have checked this with my admin account also and still have the sam issue.

Also the page popup windows also grab my side blocks therefore makes it look a right mess...If you want a test account please let me know and i will pm you

Aslo still says xx amount pager messages in the navbar although they been deleted

Not sure on the first issue, most likely mkportal is causing all your issues.

The deleted issue and messages still showing up in the navbar is this. This total is actually the amount of messages the user has sent in total on the system and is not deleteable by the user, to remove that total you need to prune the system.

Im assuming maybe eau is grabbing the wrong info for that total from the DB, it should be grabbing the total from the amount of messages in the users inbox/sent box and combine that total together.

You can simply remove that call from the navbar or eau needs to grab the correct info. Ill look into it more as i dont like it either.

[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!

cm