vBulletin SOAP API

sorry for my bad english


Changes:

v. 1.0.7
Bugfix in the updateUser function
added getOnlineUsers() function, to get the list of the logged in users

v. 1.0.6
updateUser uand deleteUser updated, now is posible to call it with userid or other field from user table
getStats() funktion added, to get forum stats


v. 1.0.5
Added updateUser, deleteUser to update user data ( email/password, username )
or delete user

v. 1.0.4
Added doActivateSession function to let vbulletin accept sessionid

v. 1.0.3
functions to get userdata and postdata are now done
postmessage returns as formated html

v. 1.0.2
added support for vbulletin "session"
the server can now send all needed cookies, to the client, last 2 optional:
(PREFIXsessionhash/lastvisit/lastactivity/(userid/password))

v. 1.0.1
rename login funtion to doLogin
add placeholder for getUser/setUser, getPost/setPost, getThread/setThread functions
change URL in the WSDL file to relative URL




this is a beta version !!

what this hack do:

this hack provide a soap api to access vbulletin functions over internet
( for example: ebay, amazon or google have they webservices api to access is over soap )

this hack has at the moment this functions

1. login to vbulletin
you must give username and password, as response you get userid and password as md5 ( with salt ) hash

so that you can set vbulletin cookie on your application

2.
a. last X post from the forum
b. last X post from the forum, which the user ( which is loged in, see 1. ) can see

3. manipulate a user, get user information , create users or delete then

4.
get forum statistics from vbulletin ( Sponsored by 1Agency (www.1agency.de) )
you will get new user, max threads/posts and some other stuff as result

5.
get all logged in users in vbulletin


what can you do with this hack ?

you can make common login with your application ( written in PHP/ASP(.NET)/JAVA/C or any language which supports SOAP calls ( for example mozilla firefox ^^)).
to make common login, you must set vbulletin cookie, see 1.

or you can write firefox extension to get last 10 thread from your forum, with threads that you can see

or synchronise users from your application and vbulletin ( this feauture is on development )

other planced feautures are:
write comment
write thread
get thread ( with all comments )


whis SOAP-SERVER is written in PHP5 with SOAP - extension
so that you need to be php5 and soap extension installed on your server
( all new destributions provides php5 and soap extensions as rpm packages )

it is posible to write this server in php4 oder php5 without soap extension ( with nuSOAP or PEAR::SOAP ) but this is not planed at the time, sorry
php
Clients can be written in Java, ASP or PHP, with all language which supports soap
so that you can make common login between an ASP or JSP CMS and Vbulletin


how to install

unpack the package, move the "soap" folder in your forum root
and install the product with product installer

to test the functionality i have included some test files in /soap/examples

you must change the url and username/password and the key in this files


later i will make some examples for typo3/joomla/xoops to access and login into vbulletin

i will accept every help and feedback to make this extension better

updated example is in the "soap" folder

[ImportPassion]

Originally Posted by leonsio

for RHEL you should better take Centos RPMs

http://rpm.pbone.net/index.php3?stat...soap&srodzaj=3

no good.

php = 5.0.4-4.centos4 is needed by php-soap-5.0.4-4.centos4

[leonsio]

extrackt rpm file with rpm2cpio

[kickorg]

local test on win xp, apache 2.0.55 + php 5.1 as modul + php soap extension

SoapFault Object
(

.... somethingthing .....

[faultstring] => Call to undefined function vbrand()
[faultcode] => SOAP-ENV:Server
)

any idea?

[leonsio]

which vbulletin do you use?
in which folder is server.php located?
if you use other folder than /soap you must edit a patch to you forum at the top of the server.php

vbrand functions is in the functions.php, which is loaded by the constructor of the class
so that i think it can not be found

look at the CWD constant

define('CWD', '../' ); <-- i think you must change this

example to: ./ if you running server.php in the forumroot

[kickorg]

vb 3.5.1 new installed yesterday

path's:

"vbroot"/soap/server.php
"vbroot"/soap/examples/test.php

i also think that functions.php not can be found but i dont know why. i have changed nothing and i follow exactly your instructions. hope u can understand my english

p.s.: "i have changed nothing means that i have changed nothing in the server.php class", sure i have changed the needed paras like the key etc..

[leonsio]

hmm it can be a windows specific problem

try to set an absolute path to the CWD constant
and please check a path in the config.php file from vbulletin
(attention windows and linux have different path
c:/forum/ <-- windows
/var/www/forum <-- linux
)

hmm i think i must find anythere a windows pc and test it

but it is not so simple, as it sounds

i have at work only solaris computers, at home i'm using macosx and my root server is linux .....

[kickorg]

ok now it works. great addon man

the error comes because i have not defined in config.php the path to the forum ->

$config['Misc']['forumpath'] = 'path/to/board';

in config.php i read that i must only define this path if vb print an error that i must define it - you know what i mean?

[leonsio]

Originally Posted by kickorg

ok now it works. great addon man

the error comes because i have not defined in config.php the path to the forum ->

$config['Misc']['forumpath'] = 'path/to/board';

in config.php i read that i must only define this path if vb print an error that i must define it - you know what i mean?

okay, great i will try to include forumpath check in the construct

[kickorg]

in "server.php" at function "getpost" i have found a the line "print_r($threadinfo)" ->

        public function getPost($key, $postid)
        {
		global $vbulletin;

                if($this->access_key != $key)
                {
                        throw new SoapFault("Server","Bad Key");
                }

		$postinfo = verify_id('post', $postid, 0, 1);
		$threadinfo = verify_id('thread', $postinfo['threadid'], 0, 1);
print_r($threadinfo);
....

i think u have set this line for debug mode and this should not set in the released version, right?

[leonsio]

hmm yes thx, i will remove it in the next release