==README for addon_mergetopics.php==
Release date: May 8, 2006.
Latest update: February 13, 2026.
miniBB version: 3.3 or later
Author: Paul Puzyrev (minibb.com).

addon_mergetopics.php is an add-on to miniBB, which allows forums administrator and moderators to "attach" one topic to another with no way back. This operation is called "mergeing" topics and could be often used, if you are mergeing similar discussions into one.

==INSTALLATION==

**** Copy addon_mergetopics.php to your forums directory.

**** Copy /lang/mergetopics_eng.php to your forums' /lang/ directory (translate if necessary)

**** Paste the code provided in bb_plugins.code.txt, in your bb_plugins.php file.

Note: if you have File Upload add-on installed, paste the Merge code AFTER File Upload code in bb_plugins.php (because Merge add-on "moves" the file to the corresponding topic when merging, and it needs file extenstion function to be included before).

**** Edit templates/main_posts.html and closer to the bottom of file, where topic's administration menu is available, right after {$stickyTopic} paste: {$mergeTopic}

==USING==

Log-in as admin, go to the topic to merge, and click on the "Merge topic" link at the bottom of page. New window must open, where you need to specify topic ID, which you want to merge desired topic with.

Find the topic to merge, which you want to merge desired topic with. Go the topic, and look at the URL field. It should look like this:

/index.php?action=vthread&forum=4&topic=503

Look at the fragment "topic=some_digits". "Some_digits" will be your topic ID (in our case, it is 503).

In a case of mod_rewrite enabled, your URL may look like:

/4_503_0.html

Topic ID will be the 2nd number in this "filename".

If you have a custom mod_rewrite hyperlinks installed, instruct your moderators on how to determine topic ID and forum ID, because for custom cases they may look different.

All topic messages will be attached to the end of the topic which ID was defined in the specified field. Topic title will be listed at the first line of the first merged topic message.

After proceeding, don't forget to check out that topic was successfully moved, and also check that old topic was deleted and not existing anymore.

==IMPORTANT NOTE==

It is not possible to merge older topic with a newer one. In that case it appears the messages could be completely messed up, and this may result in sorting results, also as viewing latest post information in topic listings. It is possible to merge only newer topics with the older topics, which is actually the purpose of this add-on.

If you would like to merge topic A on topic B, check the last message posted in B and the first message in A. If B's date appears to be earlier than A's, you are allowed to merge A on B.

==FINALLY==

Hope, you'll enjoy. Please, post bugs and suggestions on our forums:
https://www.minibb.com/forums/
