This mod allows the integration between SMF and Pligg (open source social bookmarking tool).
Introduction
It only works with PLIGG 9.1 (not 9.5 which just appeared).
THIS IS CONSIDERED BETA STAGE and should not be used on live forums. (even if I do use it
).
Functionality
a) Let's you copy the users from SMF Database to Pligg's database [allows to copy only new users, or all the users]
b) Everytime a user logs into their SMF account, a cookie is created for Pligg too, and user is automatically logged on there too.
c) When the user logs off from SMF, it will automatically be logged off from Pligg too.
d) Users can use the same username/password to login on their Pligg account (once their accout on Pligg is created using this mod).
e) If the user changes his/her email/password, these will be reflected on their Pligg account too.
f) Pligg account is automatically created on each registration of a new member on the SMF forum. If you have selected 'member activation', their Pligg account is only created when they activate their account.
g) If a user account is deleted from the SMF forum, their account is also removed from Pligg.
h) Admins on SMF will automatically be God on Pligg, and global moderators it's up for you to decide what their rank will be on Pligg (there's a dropdown from which you can select).
Limitations
a) As the mod uses SMF Integration API, you can't have other integrations active. I've coded it so if the SMF_INTEGRATION_SETTINGS is defined, then the mod will fail to run and ask you to remove it so it won't break your other integrations.
b) This mod is one way only integration, as Pligg is under heavy development at the moment. This means that users created on Pligg side won't have their accounts created back on SMF. Also, passwords resetted on Pligg won't be reflected on the SMF side. Only registrations on SMF will automatically create accounts on Pligg.
c) Pligg source code needs to be modified for Pligg to recognise SMF encrypted passwords. The mod's zip file includes all the files from Pligg 9.1 that I've updated and you need to replace those in the original 9.1 distribution. More on the Installation part, below.
d) Passwords that are reset (and thus changed) on Pligg will not be reflected back on SMF.
License
The mod's code is offered under the rules governing SimpleMachine's mods.
The Pligg's changed code is offered in compliance with Pligg's license.
Installation Pligg Setup - first step.
a) First you need to install Pligg 9.1. Please have the database user name and database password handy.
b) Then you need to replace the files found on the 'pligg' directory in the mod's archive with their corresponding Pligg files. The changes are related to the way Pligg handles the passwords (make Pligg's password hashing compatible with SMF).
At this moment, your 'god' account on Pligg will not work anymore as the password in the database is encrypted with the original Pligg algorithm and doesn't match SMF one.
Mod Setup - second step (last)
a) You need to install the mod.
b) You need to go to 'Pligg Bridge' found under the main menu to the right:
(PS: don't worry if you see a warning, each time you click it the module tries to connect to the Pligg database, and the first time settings are not correct, hence the warning).
http://www.hex.ro/files/pliggintegra...ligg11_scr.png
c) You need to provide informations about Pligg's database / domain and save it. If there are errors, you will be notified by a red message what the error was.
d) Then you need to go to the second tab, "Copy Users":
http://www.hex.ro/files/pliggintegra...igg11_copy.png
There you can select what the rank the Global Moderators from SMF will have, and if you need to replace the users you already copied on Pligg from SMF (UPDATE operation), or only add the new ones.
On first run, you need to copy all of them, on subsequent runs you need to update only if something has changed (such as the user websiteUrl/email/password on SMF and somehow the module didn't update at the moment when it was changed). One other reason I found I need to UPDATE previously copied users is when a user changed their Pligg password and now when they logged onto SMF they were not automatically logged onto Pligg.
To verify
To verify, you need to log out of SMF and log back in. If everything is alright, when you switch to Pligg you should already be connected as your username and be God [SMF admins will always be created with God rank on Pligg]
That's it
So far I run it on three forums [all of them are SMF 1.1.2] each with Pligg 9.1 installed. No problems
However there might be bugs and I'm looking forward to hear what you guys have to say.
Also, I tried to keep the Pligg's cookie as long as SMF's cookie. If you log out, Pligg's cookie is also deleted (this can be changed if you edit a like found at the beginning of the PliggIntegration.php file in SMF's Sources directory).
One thing about the domain (that you are asked).
Cookies need to belong to a certain domain. If your Pligg site is pligg.yourdomain.com you can either enter a domain like
pligg.yourdomain.com (and path /), or .yourdomain.com (. at the beggining meaning on any subdomain) and / as path.
If you have your pligg under for example yourdomain.com/pligg , then the domain should be yourdomain.com and the path /pligg/
ATTENTION: http path must always end with / for cookie to be set.
I've tested with IE 6 and Firefox 2.0.2 -> but should work on Opera/Safari too (the cookies, I mean).
Good luck