http://opensource.org/licenses/gpl-license.php GNU General Public License v2 Prime Trash Bin Allows topics and posts to be kept when they are deleted so that they can be reviewed before being permanently deleted (or undeleted). Also, provides the ability to enter a reason for the deletion, and allows deleted topics to be moved to a specified Trash Bin forum. These deleted topics and posts can be viewed, undeleted, or permanently deleted by those with the proper permissions. Permanent deletion will occur when deleting topics in the Trash Bin forum or topics and posts that have already been marked as deleted. The deletion options are set from the "Board Settings" section of the Administration Control. Support is given for both prosilver and subsilver2 templates. If you are using other templates then you will need to modify the template instructions to fit your templates. Creating, maintaining, and updating MODs requires a lot of time and effort, so if you like this MOD and have the desire to express your thanks through donations, that would be greatly appreciated. My Paypal ID is primehalo@gmail.com, or contact me for my mailing address. The suggested donation amount for this MOD is $20.00 (but any amount will help). Ken F. Innes IV primehalo@gmail.com primehalo 1.1.6 easy 3.0.10 2007-09-19 0.2.0 Renamed the MOD from "Prime Recycle Bin" to "Prime Trash Bin" Allow topics to be deleted in place, without requiring them to be moved to a special folder. Update user post counts when deleting and undeleting. Update last post info when deleting and undeleting. Log deletes and undeletes. Added board permissions for permanently deleting and undeleting. When revealing a deleted post, the poster and subject is now listed in addition to the post itself. Allows the entering of a reason for deletion without requiring a separate MOD. Fixed a lot of minor bugs. Updated the styling for showing deleted topics and posts. Added the undelete option to the quickmod and moderator control panel. Reorganized the code so most future updates should only require copying over the included files. 2008-01-07 0.2.9 Fixed an "Undefined index: user_id" error that could occur with deleted posts in the moderator control panel. Fixed a bug where topics were not permanently deleted when selecting the "Permanently delete this topic" option. 2008-01-12 0.2.10 When viewing the contents of a deleted post, the author would always show up as Guest. 2008-01-12 0.2.11 Fixed a minor styling issue with a subsilver2 template. 2008-01-19 0.2.12 Added a define that can be set to allow users to view deleted topic titles. 2008-01-30 0.2.13 Fixed a bug where selecting multiple posts to delete from the MCP would only end up deleting the first post. 2008-01-31 0.2.14 Allow the viewing of a deleted post's content on the search results page when the results are displayed as posts. Added a link to the deleted post next to the deleted post announcement so the post can be accessed from the search results page and so users can send the link for moderators to look over. 2008-02-01 0.2.15 Allow the viewing of a deleted topic's content on the search results page when the results are displayed as posts. Added a link to the deleted topic next to the deleted topic announcement so the topic can be accessed from the search results page and so users can send the link for moderators to look over. 2008-02-01 0.2.16 Added IN_PHPBB check to the included PHP files. 2008-02-26 0.2.17 Hide the poll on a deleted topic. 2008-03-05 0.2.18 Attempted fix for potential error when moving multiple threads to the Trash Bin forum. 2008-04-06 0.2.19 Fixed an "Undefined variable: forum_id" error that may happen while viewing a deleted topic. 2008-04-08 0.2.19a Updated instructions for the phpBB 3.0.1 release. 2008-05-04 0.2.20 Fixed a bug that caused global announcements to not undelete properly. 2008-06-18 0.2.21 Fixed: A deleted Global Announcement topic would fail to display the name of the user who deleted it, showing "Guest" instead. Fixed: A user would not be able to see the contents of a deleted post even if they had permission to do so. Only users who could delete or undelete the post had the ability to view it. Repackaged for MODX 1.2.0. 2008-06-23 1.0.0 Link to the included stylesheet file from within the template header file rather than the common CSS file (so there is one less file edit and there is no need to refresh the theme after installation). 2008-06-26 1.0.1 Fixed: An administrator would not be able to permanently delete posts from the MCP. Fixed: The option to permanently delete would not show up when deleting posts from the MCP. 2008-07-27 1.0.2 Fixed a bug whereby deleting a post would sometimes cause two log entries. Repackaged to fix the Firefox 3 restricted parent directory issue. Included an optional file for removing database fields added by this MOD (to assist in uninstallation). 2008-08-14 1.0.2a Added a Dutch translation. 2008-08-20 1.0.3 Permanently delete shadow topics. 2008-08-22 1.0.4 Fixed a bug introduced by the previous bug fix where attempting to delete a single topic from the MCP would present the original, permanent delete form. 2008-08-23 1.0.5 Fixed a bug where deleting topics to the Trash Bin forum, then deleting the forum from which they were deleted, then undeleting the topics would cause them to be moved to the forum which no longer exists, thus making them inaccessible except through directly accessing the database. Fixed a string in the language file which referenced the Trash Bin forum as the Recycle Bin forum (the name change happened a while back; I'm stunned it took me this long to notice the mistake). 2008-08-26 1.0.6 Fixed a mistake in the installation instructions dealing with the search page. Fixed a bug that could cause the contents of a deleted topic to be displayed on the search results page. Don't automatically give administrators permission to undelete and permanently delete, but do give these permissions to founders. Added an option to hide the placeholders for deleted topics and posts. Make available permissions allowing users to undelete and permanently delete their own posts (these are forum-based permissions, just like the board's "Can delete own posts" permission). 2009-04-30 1.0.7 Fixed a bug that decremented a user's post count again during a permanent post delete, even though it had already been reduced when the post was marked as deleted. 2009-06-10 1.0.8 Fixed a bug that would display an error message about the forum not existing when attempting to permanently delete a post from a global announcement. Fixed an SQL error message that could be displayed when attempting to permanently delete a post from the MCP without having the proper permissions to do so. Fixed an SQL error message that could be displayed when attempting to mark a post as deleted from the MCP while having the proper permissions to do so but without having the permissions to permanently delete. 2009-08-17 1.0.8a Updated instruction for phpBB3.0.5. 2009-12-15 1.0.8b Added a Ukrainian translation. 2010-01-03 1.0.9 Fixed: The last post information for forums and topics would not be updated when marking a post as deleted. 2010-02-20 1.0.10 Fixed: Some posts would not be displayed in situations where there were multiple pages in a topic. 2010-06-01 1.0.10a Added an Arabic translation. 2010-06-01 1.0.10b Added an Slovak translation. 2010-10-01 1.0.10c Added an Polish translation. 2010-10-26 1.0.11 Hide the quick reply on deleted topics. 2010-12-28 1.1.0 Updated instructions for phpBB3.0.8. Renamed some files. Security fix. 2011-01-27 1.1.1 Fix a bug that would not present the option to permanently delete all posts from a user in the ACP. 2011-02-04 1.1.2 Added an option to sort topics by the deletion date in the Trash Bin forum. Added spaces between the checkboxes and the text on the delete confirmation page. 2011-03-09 1.1.3 Fixed: when the placeholders for mock-deleted posts are hidden on a topic with multiple pages, the number of pages were not recalculated and then remaining posts were not redistributed across the pages. Remove the pagination for deleted topics when the viewer does not have permission to see the contents of the deleted topic. 2011-07-19 1.1.3a Updated the French translation. 2011-08-05 1.1.4 Updated the Polish translation. Bug fix: When mock-deleting multiple posts, if one of the posts encountered was the only post in an already mock-deleted topic, then mock-deletion would immediately cease causing some of the posts not to be mock-deleted. 2012-01-30 1.1.5 Updated for phpBB 3.0.10 Updated the German translation. 2012-03-30 1.1.6 Fixed: If a user's forum permission "Can permanently delete own posts" was set to Yes, that user could permanently delete any posts in that forum. Fixed: When deleting a user, selecting "Delete all posts" would permanently delete all posts, and selecting "Permanently delete all posts" would not delete any posts. subsilver2 Arabic German French Dutch Polish Russian Slovak Ukrainian Update 0.2.0 to 0.2.2 Update 0.2.16 to 0.2.17 Update 0.2.20 to 1.0.0 (subsilver2) Update 0.2.20 to 1.0.0 Update 0.2.3 to 0.2.4 Update 0.2.4 to 0.2.5 Update 0.2.5c to 0.2.5d Update 0.2.5d to 0.2.6 Update 0.2.6 to 0.2.7 Update 0.2.7 to 0.2.8 Update 1.0.4 to 1.0.5 Update 1.0.5 to 1.0.6 Update 1.0.6 to 1.0.7 Update 1.0.7 to 1.0.8 Update 1.0.8 to 1.0.9 Update 1.0.9 to 1.0.10 Update 1.0.10 to 1.0.11 Update 1.0.11 to 1.1.0 Update 1.1.0 to 1.1.1 Update 1.1.1 to 1.1.2 Update 1.1.2 to 1.1.3 Update 1.1.3 to 1.1.4 Update 1.1.4 to 1.1.5 Update 1.1.5 to 1.1.6
update_db.php ]]> ]]> ]]> ]]> ]]> setup('acp/common');]]> add_lang('mods/prime_trash_bin_b'); //-- end: Prime Trash Bin ---------------------------------------------------//]]> add_lang('mods/prime_trash_bin_b'); include($phpbb_root_path . 'includes/prime_trash_bin_b.' . $phpEx); //-- end: Prime Trash Bin (Topics) ------------------------------------------//]]> array('lang' => 'OVERRIDE_STYLE', 'validate' => 'bool', 'type' => 'radio:yes_no', 'explain' => true),]]> array('lang' => 'PRIME_FAKE_DELETE', 'validate' => 'string', 'type' => 'select', 'function' => 'make_fake_delete_select', 'params' => array('{CONFIG_VALUE}'), 'explain' => true), 'trash_forum' => array('lang' => 'PRIME_TRASH_FORUM', 'validate' => 'string', 'type' => 'select', 'function' => 'make_trash_select', 'params' => array('{CONFIG_VALUE}'), 'explain' => true), //-- end: Prime Trash Bin (Topics) ------------------------------------------//]]> The following FIND will match several lines in the file. We want the one that is found just after our previous FIND. acl_get('f_list', get_trash_forum())) { unset($display_vars['vars']['recycle_bin_forum']); } //-- end: Prime Trash Bin (Topics) ------------------------------------------//]]> u_action . '&u=' . $user_id)); //-- end: Prime Trash Bin (Posts) -------------------------------------------//]]> The following FIND will match several lines in the file. We want the one that is found just after our previous FIND. lang['CONFIRM_OPERATION'], build_hidden_fields(array(]]> request_var('delete_reason', '', true), 'delete_forever' => request_var('delete_forever', false), //-- end: Prime Trash Bin (Posts) -------------------------------------------//]]> $inactive_reason, )); ]]> add_lang('mods/prime_trash_bin_a'); $template->assign_var('S_CAN_DELETE_FOREVER', auth_fake_delete('delete')); } //-- end: Prime Trash Bin (Posts) -------------------------------------------//]]> assign_block_vars('topicrow', $topic_row);]]> add_lang('acp/common');]]> add_lang('mods/prime_trash_bin_b'); //-- end: Prime Trash Bin ---------------------------------------------------//]]> add_lang('mods/prime_trash_bin_b'); //-- end: Prime Trash Bin ---------------------------------------------------//]]> add_lang('mcp'); trigger_error('NO_TOPIC_SELECTED'); } include($phpbb_root_path . 'includes/prime_trash_bin_b.' . $phpEx); mcp_unstifle_topic($topic_ids); break; case 'undelete_post': $post_ids = (!$quickmod) ? request_var('post_id_list', array(0)) : array(request_var('p', 0)); if (!sizeof($post_ids)) { $user->add_lang('mcp'); trigger_error('NO_POST_SELECTED'); } include($phpbb_root_path . 'includes/prime_trash_bin_b.' . $phpEx); mcp_unstifle_post($post_ids); break; //-- end: Prime Trash Bin (Topics) ------------------------------------------//]]> ($total == 1) ? $user->lang['VIEW_TOPIC_POST'] : sprintf($user->lang['VIEW_TOPIC_POSTS'], $total), )); ]]> The first FIND is just to get your cursor into position so the next FIND will locate the correct line. sql_query($sql);]]> sql_query($sql); while ($row2 = $db->sql_fetchrow($result)) { $topic_id = (int) $row2['topic_id']; $first_post_ids[$topic_id] = $row2['first_post_id']; $last_post_ids[$topic_id] = $row2['last_post_id']; } $db->sql_freeresult($result); } //-- end: Prime Trash Bin (Posts) -------------------------------------------//]]> lang[$row['log_operation'] . '_2'])) { $row['log_operation'] = $row['log_operation'] . '_2'; } //-- end: Prime Trash Bin ---------------------------------------------------// ]]> The first FIND is just to get your cursor into position so the next FIND will locate the correct line. sql_query($sql);]]> $row) { if ((!empty($row['topic_deleted_time']) || !empty($row['post_deleted_time'])) && !auth_fake_delete('list', $row['forum_id'])) { $total_match_count--; unset($rowset[$key]); } } if ($old_match_count != $total_match_count) { $template->assign_var('SEARCH_MATCHES', str_replace($old_match_count, $total_match_count, $l_search_matches)); } //-- end: Prime Trash Bin ---------------------------------------------------//]]> (!empty($row['post_id'])) ? append_sid("{$phpbb_root_path}viewtopic.$phpEx", "f=$forum_id&t=" . $row['topic_id'] . '&p=' . $row['post_id'] . (($u_hilit) ? '&hilit=' . $u_hilit : '')) . '#p' . $row['post_id'] : '') )); ]]> 't.topic_first_poster_name', 't' => 't.topic_last_post_time', 'r' => 't.topic_replies', 's' => 't.topic_title', 'v' => 't.topic_views');]]> add_lang('mods/prime_trash_bin_a'); $sort_by_text['d'] = $user->lang['PRIME_DELETED_DATE']; $sort_by_sql['d'] = 't.topic_deleted_time'; } //-- end: Prime Trash Bin (Topics) ------------------------------------------//]]> acl_get('m_approve', $forum_id)) ? 'AND p.post_approved = 1' : ''); if ($sort_dir == 'd') { $sql .= " AND (p.post_time > {$topic_data['post_time']} OR (p.post_time = {$topic_data['post_time']} AND p.post_id >= {$topic_data['post_id']}))"; } else { $sql .= " AND (p.post_time < {$topic_data['post_time']} OR (p.post_time = {$topic_data['post_time']} AND p.post_id <= {$topic_data['post_id']}))"; }]]> acl_get('m_approve', $forum_id)) ? $topic_data['topic_replies_real'] : $topic_data['topic_replies'];]]> 0 AND post_id <> ' . $topic_data['topic_first_post_id']; $result = $db->sql_query($sql); $row = $db->sql_fetchrow($result); $db->sql_freeresult($result); $topic_replies = $topic_replies - $row['deleted_posts']; } //-- end: Prime Trash Bin (Posts) -------------------------------------------//]]> = $min_post_time " . (($auth->acl_get('m_approve', $forum_id)) ? '' : 'AND post_approved = 1');]]> acl_get('m_approve', $forum_id)) ? 'AND p.post_approved = 1' : '') . " " . (($join_user_sql[$sort_key]) ? 'AND u.user_id = p.poster_id': '') . " $limit_posts_time ORDER BY $sql_sort_order";]]> sql_fetchrow($result)) {]]> bg1 bg2 reported]]> reported]]> deleted_topic]]> ]]> ]]> The initial FIND is just to get your cursor into position so the final FIND will locate the correct line. {L_POST_DETAILS}]]> ]]> deleted_post]]> {POST_IPADDR} ({POST_IP}){POST_IP} ({L_LOOKUP_IP}) ]]>
{L_PRIME_POST_DELETED_REASON}: {DELETED_REASON}]]> ]]> ]]> For those of you adapting this to a different template style, the HTML you're adding is basically just a copy of the HTML which appears directly underneath where it's being added, with some template variables removed (ones that we don't want displayed, such as post count and last post info) and "DELETED_MSG" added. ]]>

{L_PRIME_TOPIC_DELETED_MSG}

{DELETED_MSG}
]]> bg1bg2]]> bg2]]> deleted_post]]> ]]> ]]> ]]> ]]> For those of you adapting this to a different template style, the HTML you're adding is basically just a copy of the HTML which appears directly underneath where it's being added, with some template variables removed (ones that we don't want displayed, such as post count and last post info) and "DELETED_MSG" added. ]]>
  • {NEWEST_POST_IMG} {searchresults.TOPIC_TITLE} {searchresults.UNAPPROVED_IMG} {REPORTED_IMG}
    {searchresults.PAGINATION} {searchresults.ATTACH_ICON_IMG} {searchresults.DELETED_MSG}
    • ]]>         ]]> ]]> reported]]> reported]]> deleted_post]]>     For those of you adapting this to a different template style, the HTML you're adding is basically just a copy of the HTML which appears directly underneath where it's being added, with some template variables removed (ones that we don't want displayed, such as post count and last post info) and "DELETED_MSG" added. bg1 bg2 global-announce announce sticky reported">]]>
  • {NEWEST_POST_IMG} {topicrow.TOPIC_TITLE} {topicrow.UNAPPROVED_IMG} {REPORTED_IMG}
    {topicrow.PAGINATION} {topicrow.ATTACH_ICON_IMG} {topicrow.DELETED_MSG}
    • ]]>         ]]> ]]>     For those of you adapting this to a different template style, the HTML you're adding is basically just a copy of the HTML in which a post is displayed, with some template variables removed (ones that we don't want displayed, such as post count and last post info) and "DELETED_MSG" added. ]]>

    {L_PRIME_TOPIC_DELETED_MSG}

    {DELETED_MSG}
    {L_BACK_TO_TOP}
    ]]>         online]]> online]]> deleted_post]]>     Make sure to delete the install_db.php file once it has been successfully executed. After installing the MOD, you'll need to log into the Administration Control Panel and take care of a few things. First, purge the cache! Next, under the "Board configuration" section, click "Board Settings", and setup the deletion options. Now, if you want to assign permissions to moderators, click the "Permissions" tab, and under the "Permission Roles" section click "Moderator Roles" section. From here, click on a moderator type to edit, and set their undelete/permanent delete permissions.