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

[Wordplay]

so basically this isnt really an intigration but rather just logs users into both programs, which remain standalone softwares?

[leonsio]

*update*

added function getOnlineUsers(KEY)
this function will return an array with all logged in users

the count of the array can be different, you will only get user which you can see
also if the user can not see we who is online list, he will get nothing

for admins the list will include invisible users too

[Philipp G?rard]

This sounds promising. When are you going to implement the addTopic/addPosting-functions?

[leonsio]

not this year

[leonsio]

Originally Posted by twitch

So... would this be able to work with vwar? http://www.vwar.de and my vbulletin forum so that users will synch?

I am looking for some sort of vwar bridge or something to synch the 2 user databases together. A vwar bridge would be a great tool for the vbulletin community.

one use has created vwar module for my connector for joomla
its the same as vbulletin connector, i will port the module in the next weeks for vbulletin

to use it with this connector and vbulletin

http://forum.joomla.org/index.php/to...html#msg125646

release thread of the connector for vbulletin

so it is posible to have common login between joomla<->vbulletin->vwar ( or vbulletin<->joomla->vwar )

it will be only one login needed

[rob.wisniewski]

This is really interesting and almost exactly what I'm looking to do. However I don't believe my host has the SOAP extension installed for me. both of my applications are running in the same process/domain so I can theoretically call your server.php directly without the SOAP layer. I tried to hack this by removing the references and verification of the $key, but this seems to fall apart. (interestingly enough I just get a <html></body></html> response.. can't figure that one out). Any ideas on calling your libraries from another php file? Specifically I'd be calling this from the portion of MediaWiki that logs a user into mediawiki.

[leonsio]

you need php5 to run this script

key should not be a problem, you can call the functions direct $test=new VBSOAP();

$result=$test->doLogin(KEY, .....);


sorry but i dont have enouth time at the moment to make the script php4 conform
i dont know why you get html code, the script dont produce any html outputs

try to update to php5, its a easiest way to get this script working

[boiboi]

Originally Posted by leonsio

look at first post

you needs PHP5 and soap extension

for a client you can use a PEAR::SOAP, examples are at the first site of this thread

Good concept but most folks are probably still on php4

[leonsio]

php4 has very very slow performance

it is posible to run it with php4 but its not so good and not so fast like php5

( the extension in php4 is written in php, the soap extension in php5 is written in c )

[jliu]

Very nice concept. I tried it, but got message --

[faultstring] => looks like we got no XML document
[faultcode] => SOAP-ENV:Client

Any idea where I got it wrong?

Thanks!