torunar/transmogrify

There is no license information available for the latest version (v3.2.0) of this package.

Transmogrify allows you to transfer your InVision (ex. IP.Board) forum to the Discourse forum

Maintainers

Details

bitbucket.org/torunar/transmogrify

Homepage

Source

Installs: 5

Dependents: 0

Suggesters: 0

Security: 0

v3.2.0 2018-04-03 07:21 UTC

Unknown License 758b75ea8060e206b79ebcb41041a9dcd565a112

  • Mike Schekotov <torunar.woop@gmail.com>

This package is auto-updated.

Last update: 2021-05-29 01:14:09 UTC

README

About

Transmogrify allows you to transfer your InVision (ex. IP.Board) forum to the Discourse forum.

The tool fetches forums, topics, posts and users from your old forum's database and transfers them via Discourse RESTful API.

Discourse configuration

Before running a tool, the Discourse should be configured to minimise side effects, induced by the built-in rate limits and anti-spam protection system.

Log in into your Discourse administration panel, go to the Settings tab and set the following settings accordingly:

unique posts mins                    0
rate limit create topic              0
rate limit create post               0
rate limit new user create topic     0
rate limit new user create post      0
auto close topics post count         0
max topics per day                   900000  (higher = better)
max topics in first day              900000  (higher = better)
max replies in first day             900000  (higher = better)
max post length                      99000   (higher = better)
max new accounts per registration ip 900000  (higher = better)

newuser max replies per topic        99000   (higher = better)
newuser max mentions per post        100     (higher = better)
newuser max links                    100     (higher = better)
newuser max images                   100     (higher = better)
newuser max attachments              5       (higher = better)
newuser spam host threshold          99000   (higher = better)

min post length                      1       (lower = better)
min first post length                1       (lower = better)
body min entropy                     1       (lower = better)
title min entropy                    1       (lower = better)
min topic title length               1       (lower = better)
min title similar length             1024    (higher = better)

allow duplicate topic titles         enable
default email direct                 disable (prevents email notifications on @mentions)
disable emails                       enable  (disables all the email notifications)

You will also need to create an API key to interact with your Discourse forum.

Log in into your Discourse administration panel, go to the API tab and press the button with the key icon to generate an API key.

Usage

Clone the repo:

$ git clone https://bitbucket.org/torunar/transmogrify.git

Go to the tool folder:

$ cd transmogrify

Install dependencies via composer:

$ composer install

Run the tool:

$ php ./bin/transmogrify dbHost dbUser dbPassword dbName dbPrefix ipbAddress apiKey [discourseAddress [forumIds [topicsLimit [postsLimit]]]]

Arguments:

  • dbHost — database host of your InVision forum.
  • dbUser — database user.
  • dbPassword — database password ("" or '' must be specified for the empty password).
  • dbName — database name.
  • dbPrefix — table prefix ("" or '' must be specified for the empty prefix).
  • ipbAddress - network address of the IPB forum.
  • apiKey — API key for the Discourse forum.
  • discourseAddress — network address of the Discourse forum (default: http://localhost:4000).
  • forumIds — comma-separated list of forum IDs to transfer (e.g. 10,12,13,25,42).
  • topicsLimit — max amount of topics per forum to transfer.
  • postsLimit — max amount of posts per topic to transfer.