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

[leonsio]

also vbulletin runs unter php5 without any problems

you should install WAMP on your windows this package include apache/php5/mysql4x and then test all your applications on it with php5

[Wordplay]

did you read my last reply? if not please do...

and you just wrote unter... deutsch? predator kenn ich ja bereits, ein deutsches coder team hier ja?

[leonsio]

ja hab dein kommentar gelesen
man kann xoops modul erstellen, jedoch ist dieser von mir vorerst nicht geplannt

f?r deutschprachige hilfe benutze www.vbhacks-germany.com forum

[Wordplay]

no my english is just fine... so if you dont mind i'll just stay here... merely because registering there would just be too much extra work that i doubt will help me get on... as you're here and you're the only person i need to be talking to concerning this.

you said vbulletin works just fine on php5 server? you mean i wouldn't have to change anything when moving to a php5 server? are you certain of this?

[leonsio]

<a href="http://www.c4u.to" target="_blank">www.c4u.to</a> is my forum and it works/runs on php 5.0.x and mysql 4.1

[Wordplay]

cool. heard php 5.1.x is not too stable with vbulletin so i should be running 5.0.x then right? ok i'll upgrade my server then later tonight. and then install this.

could you please... please do me the favor of finding somebody who made it work with xoops? if you say its possible somebody must've done it by now right? or can you atleast point me in a direction to look around at?

[leonsio]

also i have not tested php5.1 with vbulletin

but i will update my server to php 5.1 and mysql 5.0 soon

xoops... also i can try to make a module but not in this year

for questions except VB_SOAP addon use other threads here ( for modules -> Vbulletin application connector )

[Wordplay]

too bad... in my opinion xoops completely outshines joomla. i wish that would work. never is it possible for me to get what i really need. i hope somebody works on it sometime soon.

thanks none the less.

[Wordplay]

leonsio i cant find anybody willing to work on the xoops and vbulletin intigration... as nobody seems to have the soap expiriance... and asking around on other forums turned out useless as people expirianced with xoops seem to not know a thing or two about vbulletin, probably because it has never before been possible to make both work together. but if you run a search on:
bbpixel.com
xoops.org

and a couple of other xoops sites. you will swiftly see how many people have been longing for these 2 to work.

you said you wont be able to work on it before new year... and i dont have a choice but to wait.

so i'll just be patient... please let me know when approximately you'll be able to make it work.

[leonsio]

also its realy easy to make common logins from other applications with vbulletin ( and this addon )

look at the examples in the package

in the login.php you can find code to "login" on vbulletin

as result you will get all needed cookies ($connection->_cookies)

you must just walt this array and set cookies

PHP Code:

                            foreach( $connection->_cookies AS $name => $value)
                            {
                                              setcookie($name, $value[0], $lifetime, $value[1], $value[2]);
                            } 


if you have set all this cookies, the user will be logged in vbulletin