Imports data from Vanilla or PunBB formats into a discourse instance.
Ruby
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
lib
spec
.gitignore
COPYRIGHT.txt
Gemfile
Gemfile.lock
LICENSE.txt
README.md
forum2discourse.gemspec

README.md

forum2discourse

Imports from Vanilla or PunBB formats into a discourse instance.

USAGE

  1. Add forum2discourse gem to the discourse gemfile, and bundle install.
  2. Export the F2D_CONNECTION_STRING environment variable to point at the PunBB or Vanilla database. This uses datamapper-style connection strings. (http://datamapper.org/getting-started.html) - for example:
$ export F2D_CONNECTION_STRING=mysql://root@127.0.0.1:3306/database_name
  1. Run the relevant rake task within bundle exec
$ RAILS_ENV=production bundle exec rake forum2discourse:import_vanilla
$ RAILS_ENV=production bundle exec rake forum2discourse:import_punbb

NOTES

In order for people to be able to use their existing user accounts, you will need to manually reset each user's password; passwords/authentication methods are not included.

EXTENDING

To extend this library for another forum type:

  1. Create 'lib/tasks/import_(type).rb' by copying existing.
  2. Create 'lib/forum2discourse/models/(type)' to map the columns (see Vanilla models for an example)
    1. Each should respond to a to_discourse method that returns a Forum2Discourse::Models::Discourse::{Topic|Post|User|Category} instance
    2. Remember to define the relationships.
  3. Create an exporter in 'lib/forum2discourse/exporters'.

COPYRIGHT

Forum2Discourse is copyright (c) 2013 Initforthe Ltd (www.initforthe.com) and Bytemark Hosting (www.bytemark.co.uk).

LICENSE

GNU GPL v2. See LICENSE.txt