//Readme file for WP_SMF Version 1.06         (By DMRY, updated by jjgallow July 12, 2007)

This program is designed to bridge SimpleMachines Forum to Wordpress.
You can check for updates at:
http://www.earthorbit.com/opensource/  --My site.You can reach me through links to threads I visit.
and
http://www.dmry.net/wordpress-smf-bridge-plugin-10/    ---Original Author's website (DMRY).

Version 1.06 is required to operate the brand new Twin Plugin, SMF_Wordpress.
SMF_Wordpress is a plugin designed for the SMF Forum. 
 
Installation is the same as all SMF plugins...

However, SMF_Wordpress should be installed AFTER WP_SMF.  
SMF_Wordpress requires WP_SMF Version 1.06 to run.  Without it, nothing will work.
SMF_Wordpress will not work with earlier versions of WP_SMF.


By itself, little has changed for WP_SMF version 1.06.
There are some bug fixes, but the Main enhancement is compatibility with the Twin Plugin.
With SMF_Wordpress installed in the forum, most problems are solved.
SMF_Wordpress will allow the forum to communicate back to Wordpress.

Users and webmasters may finally experience a real integration!


Below is the old Readme for WP_SMF.  I will update it soon  :)

Here's what it does:
Bridge all basic user data changes from Wordpress to SMF.
IE., It will create a user in SMF that was created in Wordpress.
     It will modify a user in SMF that was modified in Wordpress.
     It will delete a user in SMF that was deleted in Wordpress.
     It will integrate features from SMF into Wordpress (Theme Integration)
It can also "Integrate Previous Users", a new feature in 1.05.
    This means it will take your existing SMF users and integrate them into Wordpress.
    This means it will take your existing Wordpress users and integrate them into SMF.

Here's what it doesn't do:
It doesn't do anything from SMF to wordpress, so, if you're using it:
   Don't create users through SMF (use Wordpress).
   Don't modify users through SMF (or if you do, know that you'll need to do it in Wordpress).
   Don't delete users in SMF (they'll still be in Wordpress, and it will create problems).
It doesn't automatically integrate wordpress features into your SMF theme.

I am working on all of these deficiencies!  My answer will be a twin plugin for SMF.
Meanwhile, you can still do pretty much anything if you're willing to do it through Wordpress.



Here's what you need:

-Wordpress, installed.  Most versions should work, including WPMU. (I'm using 2.2)
	

-SMF installed.  Version 1.1.1 or Later is best.  (I'm using 1.1.2, and I'm testing 1.1.3)
     -SMF should have UTF8 character coding.  
           You can select this option on a fresh install, or:
           Read up at http://www.simplemachine.org on how to convert it properly.
     -You can use the same database as wordpress, or a different one.  I prefer different.


Here's what you do:

Unpack the WP_SMF rar (or zip) file into the wp-content/plugins folder of wordpress.
   (you should now have this folder:  wp-content/plugins/WP_SMF/)


Log into your Wordpress Admin, go the the Plugins panel, and Activate WP_SMF.


From your Wordpress Admin Panel, go to Plugins-->SMF. Enter the folder of your SMF directory.
   (this is how the plugin is able to communicate with SMF)


You're done(sort of)!  
All future user registrations and modifications (in wordpress) will be understood by SMF as well.


Next..
Do you have users that existed previous to this bridge?  Yes, you do. Admin is an existing user!

This latest step is new to Version 1.05:  
   You can choose to "Integrate Previous Users".  
   You should see lots of warnings about your database blowing up here.  
   Those warnings are real!  If you're using Version 1.05, you are a guinea pig for this feature.
   If your site has real users, then Backup your Databases (both Wordpress and SMF)!
   When your databases are backed up, you can click on "Integrate Previous Users".
   Basically, any previous users in SMF will be duplicated in Wordpress, and Visa Versa.
   On top of that, they will all be linked together.

This new feature of 1.05 means that established sites can use WP_SMF (at their own risk).
If they've backed their databases up, they can enjoy using both Wordpress and SMF.
While the two programs play nice with this new bridge, they are still independant of each other.
One of them can be uninstalled without losing data in the other.
One can be upgraded without crashing the other.
It's the way to go.



cheers,

jjgallow



For more detailed instructions and features, go to:  
http://www.dmry.net/wordpress-smf-bridge-plugin-10/

This is the author's website.  

You cannot currently get this version from their site...but that may change.

Note:  You NO LONGER need to copy Settings.php.  This version handles this through the admin panel.



Troubleshooting:

Did you back your database up?  ...  :)

One problem some may run into is that certain users will not link properly.
Their profiles may not update each other, for instance.
The most common reason for this is that they have different passwords.
The username in Wordpress and SMF must have the same password to link.
-Another cause is duplicate names, as in two of the same username in SMF.
-The most difficult situation is this:  The user was linked in the past,
     but then was deleted from SMF, then re-registered.
    That's trouble, and if at all possible, just delete the username in wordpress, and start over.
   If you really don't want to lose the username in wordpress, you need to go into phpmyadmin,
    and delete the usermeta in wpsmfusers (or just contact me through the smf forum).
-I will eventually create a fix for this, but it is low on the priority list.
-My next project is creating a plugin for SMF,
   ..which should stop most of these problems from occuring anyway.