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

[Snake]

This is nice! Thanks!

[KevinM]

I'm starting to get excited.. could this be adapted to allow one login across multiple vbulletin forums.

E.g. I have 40 different forums across numerous servers. The Holy Grail of hacks for me would be to when someone registered at one forum, it could work across my network of different forums.

What do you think?

[Marco van Herwaarden]

This sounds very promissing, thank you for sharing.

[leonsio]

Originally Posted by KevinM

I'm starting to get excited.. could this be adapted to allow one login across multiple vbulletin forums.

E.g. I have 40 different forums across numerous servers. The Holy Grail of hacks for me would be to when someone registered at one forum, it could work across my network of different forums.

What do you think?

yes it is posible, you must install VB_SOAP on all your forums
and the login script must walk all soap servers to get userdata and set cookie


----------------------------------------------------------------

user synchronisation solution ( next version )

i will dont make an feauture which allow you to get or save multiple users at one time
because soap is not designet to send big data cross the internet
on big forums with more as 1000 users it will makes only problems with the transport of data ( http timeouts/ php memory size ... )

but i will make an function, to save user or to get user

how can you synchronize your users on multiple application

the solution is:

example A

you have user A ( with the name test ) on your CMS and user B ( with the same name "test" ) on vbulletin the passwords must be same

the CMS use SHA1 as password hash and vbulletin use MD5

if the user login on the CMS you must make an call to vbulletin with the username and password ( plain ) to vbulletin
and you will get the userid and hashn of password with salt
so you can set cookie and the user is logged in on vbulletin

with the function getUser you can get all data from vbulletin for example to synchronise the data of CMS with vbulletin


example B

you have user A ( with the name test ) on vbulletin but not on CMS

if the user A try to login on CMS, normaly the login will be deny, but you can make an call to vbulletin with the username and password of user A

an if the user will be acceppt, you can get all data from the user with the function "getUser" and create a user A on your CMS


where many application with different authentification methods, so it is not allways posible to synchronise users ( password hash is not match is the biggest problem)
so you should only create your user on CMS if it user login and exist on vbulletin

on registration of the user ( on CMS ) you can make a call to vbulletin with the user data ( function setUser) ans so create a user on vbulletin

[Princeton]

I've been gone for a while ...
this looks great!

Thanks for sharing.

[Borgs8472]

Originally Posted by leonsio

yes it is posible, you must install VB_SOAP on all your forums
and the login script must walk all soap servers to get userdata and set cookie

Then it should be an official vb add-on

Of course someone (e.g. vb)

It'd need something like ezboard uses where you can have a global login, or a login for a certain board only (like in the case where someone has your name there first). Or a way to allowed duplicate names, which obviously wouldn't have the same userids.

Then rather than registering for a vbforum, you'd just login with a reference to another board the first time.

Or something.

ONE DAY!

[leonsio]

new version 1.0.2 is online

[leonsio]

new version 1.0.3 is online

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

[leonsio]

yes it is posible to make bridges for any applications

but i dont want to make it at this time

i have included some examples in this package, so look at it and you can make easy common login with vwar or any other application

as next example i will include some joomla modules (common login, last posts, diskuss bot )

perhaps later i will try to make some other connectors
it is realy easy to make bridges with this API