nodebb-plugin-import-smf

a SMF 2.0 forum exporter to be required by nodebb-plugin-import.

What is this?

It's just an exporter of SMF 2.0, that provides an API that nodebb-plugin-import can use to exporter source forum data and import it to NodeBB's database. So, it's not really a conventional nodebb-plugin.

Why is it even a NodeBB plugin?

it doesn't really need to be, nor that you can use it within NodeBB it self, but, having this as a plugin have few benefits:

• a nodebb- namespace, since you can't really use it for anything else
• it can easily require NodeBB useful tools, currently

Attachments note

Before you start import, make a copy of your attachments and place it in ./tmp/attachments/originals, then run this command to strip everything after the _ with it.

find $PWD -type f -name "*_*" -exec rename 's/(_.*)//' {} \;

So they would look something like this

then when the export runs, it will copy the files to a sibling folder to originals, called migrated, so something like this.

Then when the import is done, copy the migrated folder and place it in /path/to/nodebb/public/uploads/_imported_attachments/migrated and copy your smf avatars files into /path/to/nodebb/public/uploads/_imported_profiles/avatars

Usage within NodeJS only

// you don't have to do this, nodebb-plugin-import will require this plugin and use its api
// but if you want a run a test

var exporter = require('nodebb-plugin-import-smf');

exporter.testrun({
    dbhost: '127.0.0.1',
    dbport: 3306,
    dbname: 'smf',
    dbuser: 'user',
    dbpass: 'password',

    tablePrefix: 'smf_'
}, function(err, results) {

    /*
        results[0] > config
        results[1] > [groupsMap, groupsArray]
        results[2] > [usersMap, usersArray]
        results[3] > [messagesMap, messagesArray]
        results[4] > [categoriesMap, categoriesArray]
        results[5] > [topicsMap, topicsArray]
        results[6] > [postsMap, postsArray]
    */
});

SMF Versions tested on:

• SMF 2.0.3