vb.org Archive

vb.org Archive (https://vborg.vbsupport.ru/index.php)
-   vBulletin 3 Articles (https://vborg.vbsupport.ru/forumdisplay.php?f=187)
-   -   [How-To] Use API for Private Messages (https://vborg.vbsupport.ru/showthread.php?t=120186)

harmor19 07-02-2006 10:00 PM
[How-To] Use API for Private Messages
 
Have you ever wanted to create a hack that'll private message users when they reach a certain point in the script?
For instance say you wanted to private message user "abc" when he or she reaches the end of the form.

The first thing you'll need to do is require "includes/class_dm.php" along with "global.php".

I have put the Private Message API into a function. I decided to do this in my own script due to the repetiveness.

PHP Code:
function pm_api($fromuserid, $fromusername, $title, $message, $recipients)
{
    global $vbulletin, $botpermissions;
    
    $pmdm =& datamanager_init('PM', $vbulletin, ERRTYPE_ARRAY);
        $pmdm->set('fromuserid', $fromuserid);
        $pmdm->set('fromusername', $fromusername);
        $pmdm->set('title', $title);
        $pmdm->set('message', $message);
        $pmdm->set_recipients($recipients, $botpermissions);
        $pmdm->set('dateline', TIMENOW); 
        $pmdm->save();
        unset($pmdm);
        
        return $pmdm;
    
} 
Now that you have the function you'll need to create a method to use with it.
Let's say you owned a auction type forum and wanted to private message an user after they've entered their product's information into the form.

PHP Code:
$fromuserid = 1;
        $fromusername = "Auctioneer";
        $title = "Your Entry is Being Reviewed";
        $message = "Hello ".$vbulletin->userinfo['username'].",
                      We are now reviewing your entry.";
         $recipients = $vbulletin->userinfo['username'];

pm_api($fromuserid, $fromusername, $title, $message, $recipients); 
To put it all together
PHP Code:
<?php

// ######################## SET PHP ENVIRONMENT ###########################
error_reporting(E_ALL & ~E_NOTICE);

// ##################### DEFINE IMPORTANT CONSTANTS #######################
define('THIS_SCRIPT', 'test'); 

// #################### PRE-CACHE TEMPLATES AND DATA ######################
// get special phrase groups
$phrasegroups = array();

// get special data templates from the datastore
$specialtemplates = array();

// pre-cache templates used by all actions
$globaltemplates = array();

// pre-cache templates used by specific actions
$actiontemplates = array();

// ########################## REQUIRE BACK-END ############################
require_once('./global.php');
require_once('./includes/class_dm.php');

// #################### HARD CODE JAVASCRIPT PATHS ########################
$headinclude = str_replace('clientscript', $vbulletin->options['bburl'] . '/clientscript', $headinclude);

// ########################################################################
// ######################### START MAIN SCRIPT ############################
// ########################################################################

//create a function for the Private Message API.
function pm_api($fromuserid, $fromusername, $title, $message, $recipients)
{
    global $vbulletin, $botpermissions;
    
    $pmdm =& datamanager_init('PM', $vbulletin, ERRTYPE_ARRAY);
        $pmdm->set('fromuserid', $fromuserid);
        $pmdm->set('fromusername', $fromusername);
        $pmdm->set('title', $title);
        $pmdm->set('message', $message);
        $pmdm->set_recipients($recipients, $botpermissions);
        $pmdm->set('dateline', TIMENOW); 
        $pmdm->save();
        unset($pmdm);
        
        return $pmdm;
    
}

$fromuserid = 1;
        $fromusername = "Auctioneer";
        $title = "Your Entry is Being Reviewed";
        $message = "Hello ".$vbulletin->userinfo['username'].",
                      We are now reviewing your entry.";
         $recipients = $vbulletin->userinfo['username'];

pm_api($fromuserid, $fromusername, $title, $message, $recipients);

?>

akanevsky 07-03-2006 01:12 AM
I believe this article was already posted.

harmor19 07-03-2006 02:30 AM
I searched for "private message api" and only my thread came up.

Code Monkey 07-03-2006 03:41 AM
<a href="https://vborg.vbsupport.ru/showthread.php?t=82786" target="_blank">https://vborg.vbsupport.ru/showthread.php?t=82786</a>

From over a year ago. It is listed in the summary of How To's that is stickied in this forum.

harmor19 07-03-2006 07:32 AM
Well that sucks, well I explain another approach to do it.

pyro.699 07-03-2006 12:42 PM
No, thankyou!
I dont know how, but you solved my Pm Counters not updating problem! When no-one else wanted to answer it!

Thanks a ton!
~Cody Woolaver

harmor19 07-03-2006 12:46 PM
Quote:
Originally Posted by pyro.699
No, thankyou!
I dont know how, but you solved my Pm Counters not updating problem! When no-one else wanted to answer it!

Thanks a ton!
~Cody Woolaver
You're Welcome.

Honestly I don't know where it would update the counters. Perhaps the 'save()' function?

I'm glad you found my tutorial useful.

pyro.699 07-03-2006 12:53 PM
nope, i had a save ^^; its actchually still puzzling, because all you had wa puting it in a function, and adding return and unset.... which shouldent have made any differance! but, whats with the global at the top? i never had that...
(my guess is that its because it is in a function)

Code Monkey 07-03-2006 01:34 PM
No need to return a value.

PHP Code:
unset($pmdm);
        
return $pmdm; 

harmor19 07-03-2006 01:59 PM
Quote:
Originally Posted by pyro.699
nope, i had a save ^^; its actchually still puzzling, because all you had wa puting it in a function, and adding return and unset.... which shouldent have made any differance! but, whats with the global at the top? i never had that...
(my guess is that its because it is in a function)
The reason I globalize "$vbulletin" and "$botpermissions" is to carry the value of those two variables into the function (I think that's how to explain it).
If I haven't have globalized those two the API would be rendered useless.



Quote:
Originally Posted by JumpD
No need to return a value.

PHP Code:
unset($pmdm);
        
return $pmdm; 
I can remove those two tidbits?
It's been a while but I think I tried to use the function without returning the value and it didn't work. I could be wrong though.

Adrian Schneider 07-03-2006 03:07 PM
Yeah you can remove them ... in this case it doesn't matter, because you are deleting the variable, then returning it (null)... no point.

harmor19 07-03-2006 03:15 PM
Oh Ok.
And to think I'm a coder. :shrugs:

brandondrury 04-30-2007 06:38 PM
I see this article is nearly a year old, but I figured I'd ask anyway.

I'm using vBulletin 3.6.5.

Any idea why this isn't updating the user that they have a private message?

For example, this is what I see at the top right of my forum even though I have about 10 PMs sent using this script.
Quote:
Welcome, brandondrury.
You last visited: Today at 07:14 PM
Private Messages: Unread 0, Total 0.
Thanks,
Brandon Drury

brandondrury 06-03-2007 02:13 PM
PHP Code:
$db->query_write("UPDATE user SET pmunread=pmunread+1,pmtotal=pmtotal+1 WHERE userid=$userid"); 
This took care of it.

Brandon

liquidx 02-03-2008 12:31 PM
I know this is an old thread but does anyone have a proper solution for the problem brandon described in #13?

His fix doesn't work properly.
It does make the PM appear in the upper-right as unread and total.. but it does not allow for the new PM popup to appear.

Napalmus 03-25-2013 09:39 AM
Hey guys, thanks for this topic, it helps to send PMs on vBulletin 4.x version, but now I would like to read PMs of specific user using his ID or anything, do someone has an idea how to display them ?

MagicPID 12-27-2013 07:32 PM
@harmor19 - I am bumping this to recommend that this be moved to vBulletin 4 Articles as it is working on vBulletin 4.2.1.
A query though: How do you get a message to span multiple lines (like <br /> in HTML)?


All times are GMT. The time now is 09:20 PM.

Powered by vBulletin® Version 3.8.12 by vBS
Copyright ©2000 - 2025, vBulletin Solutions Inc.

X vBulletin 3.8.12 by vBS Debug Information
  • Page Generation 0.01205 seconds
  • Memory Usage 1,792KB
  • Queries Executed 10 (?)
More Information
Template Usage:
  • (1)ad_footer_end
  • (1)ad_footer_start
  • (1)ad_header_end
  • (1)ad_header_logo
  • (1)ad_navbar_below
  • (6)bbcode_php_printable
  • (4)bbcode_quote_printable
  • (1)footer
  • (1)gobutton
  • (1)header
  • (1)headinclude
  • (6)option
  • (1)post_thanks_navbar_search
  • (1)printthread
  • (17)printthreadbit
  • (1)spacer_close
  • (1)spacer_open 
Phrase Groups Available:
  • global
  • postbit
  • showthread
Included Files:
  • ./printthread.php
  • ./global.php
  • ./includes/init.php
  • ./includes/class_core.php
  • ./includes/config.php
  • ./includes/functions.php
  • ./includes/class_hook.php
  • ./includes/modsystem_functions.php
  • ./includes/class_bbcode_alt.php
  • ./includes/class_bbcode.php
  • ./includes/functions_bigthree.php 
Hooks Called:
  • init_startup
  • init_startup_session_setup_start
  • init_startup_session_setup_complete
  • cache_permissions
  • fetch_threadinfo_query
  • fetch_threadinfo
  • fetch_foruminfo
  • style_fetch
  • cache_templates
  • global_start
  • parse_templates
  • global_setup_complete
  • printthread_start
  • bbcode_fetch_tags
  • bbcode_create
  • bbcode_parse_start
  • bbcode_parse_complete_precache
  • bbcode_parse_complete
  • printthread_post
  • printthread_complete