==README for Multiple Topics Action add-on for miniBB==
Release date: September 3, 2008.
Latest update: September 30, 2018.
miniBB version: Developed and tested on 2.2b but may work on earlier versions as well (not lower than 2.0 RC5); compatible with the latest release
Author: Paul Puzyrev (minibb.com).


Multiple Topics Action add-on allows to delete or move many topics simultaneously just checking the boxes, which should appear for admin/moderators under Topics listing. That way the moderation of your board may be completed in a much faster term. Operating many topics at once will work like you would remove topics separately with all related add-ons stuff affected, for example, with all attached files if you own File Attachments add-on installed; or a Poll, if you have Polls add-on installed and there is some Poll attached to the topic which may be allowed to delete by settings rules. Messages and topics amount will be re-calculated after deleting of each topic, so if something interrupts on the way, it shall not affect forums. When you check-out the boxes, the add-on will load all processes in a iframe, so you may watch the progress right away (though sometimes it works too fast to notice something). 


==INSTALLATION==


**** Copy files addon_massdeletetpc.php, addon_massdeletetpciframe.php to your forums folder.

**** Copy the template file /templates/addon_massdeletetpc.html to your forums' /templates/ folder.

**** Copy /lang/massdeletetpc_eng.php to your forums /lang/ folder (translate the language pack if needed, renaming it using your forums language prefix)

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

***** Under bb_plugins.php, there should be a function called parseTopic(). It may be used by other add-ons, if it's already present, just paste the proper block of code from bb_plugins_parseTopic.code.txt before the ending } of that function; else paste the function in whole from that file. THIS FUNCTION CAN BE DECLARED ONLY ONCE, else it could stop your forums from working. Make sure to not mess the proper blocks of code.

**** Edit the template file located under /templates/main_topics.html, and following the example under main_topics.code.txt, paste {$massDeleteTopicsForm1} and {$massDeleteTopicsForm2} (will indicate <form> tag when needed); {$massDeleteTopicsButton} (will indicate deletion link).

**** The similar code as described above, could be also pasted in the similar manner to the /templates/main_last_discuss_more.html (then the mass moving/deletion options will be also available from the "extra navigation" pages going from the front forums page).

**** Edit the template file located under /templates/main_topics_cell.html, and following the example under main_topics_cell.code.txt, paste {$deleteCheckbox} (it will indicate a checkbox in each topic's row).


==USAGE INSTRUCTIONS==


Log-in as admin or moderator, enter any forum's topic listing, and you shall notice a checkbox near each topic, with the Delete button above the listing, or Move dropdown. Check the topics you would like to delete or move, and accept your action. Functions will execute in the new opened window. Wait patiently, watching the deletion/moving progress, and close the window after it completes. Refresh the topics page if you would like to be sure everything is deleted; or just go to the next page to moderate other topics. You can be sure your selected topics were absolutely deleted or moved, if the script reported so!

Note: under Mozilla Firefox, if you refresh the older topics page, it may keep checkboxes on their previous place, but selecting different topics. Unfortunately it's a Firefox bug (or a feature?) and it can't be fixed at the scripts level. On Windows, you may press Shift+F5 (or reload the page holding Shift button) to completely refresh the page. 

Note #2: if you use custom header and footer for your forums, they should be preferrably disabled when the script performs its action under iframe. For example, your setup under setup_options.php may look like this:

if(!defined('MASS_TOPICS')){
$includeHeader='header.php';
$includeFooter='footer.php';
}

==THANKS==


This add-on has been initially sponsored and developed with the help of:

- Work At Home Forum - http://www.work-at-home-forum.com/
- The Dream Team 3D Forum - http://www.tdt3d.com

==FINALLY==

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