elkarte / Elkarte

sources/ElkArte/AdminController/ManageDraftsModule.php

<?php

/**
 * Allows for the modifying of the forum drafts settings.
 *
 * @package   ElkArte Forum
 * @copyright ElkArte Forum contributors
 * @license   BSD http://opensource.org/licenses/BSD-3-Clause (see accompanying LICENSE.txt file)
 *
 * @version 2.0 dev
 */

namespace ElkArte\AdminController;

use ElkArte\AbstractController;
use ElkArte\DraftsIntegrate;
use ElkArte\EventManager;
use ElkArte\Hooks;
use ElkArte\Languages\Txt;
use ElkArte\SettingsForm\SettingsForm;
use ElkArte\User;
use Exception;

/**
 * Drafts administration controller.
 * This class allows to modify admin drafts settings for the forum.
 *
 * @package Drafts
 */
class ManageDraftsModule extends AbstractController
{
	/**
	 * Used to add the Drafts entry to the Core Features list.
	 *
	 * @param array $core_features The core features array
	 */
	public static function addCoreFeature(array &$core_features): void
	{
		$core_features['dr'] = [
			'url' => getUrl('admin', ['action' => 'admin', 'area' => 'managedrafts', '{session_data}']),
			'settings' => [
				'drafts_enabled' => 1,
				'drafts_post_enabled' => 2,
				'drafts_pm_enabled' => 2,
				'drafts_autosave_enabled' => 2,
				'drafts_show_saved_enabled' => 2,
			],
			'setting_callback' => static function ($value) {
				require_once(SUBSDIR . '/ScheduledTasks.subs.php');
				toggleTaskStatusByName('remove_old_drafts', $value);
				$modules = ['admin', 'post', 'display', 'profile', 'personalmessage', 'messageindex'];

				// Enabling, let's register the modules and prepare the scheduled task
				if ($value)
				{
					enableModules('drafts', $modules);
					calculateNextTrigger('remove_old_drafts');
					Hooks::instance()->enableIntegration(DraftsIntegrate::class);
				}
				// Disabling, just forget about the modules
				else
				{
					disableModules('drafts', $modules);
					Hooks::instance()->disableIntegration(DraftsIntegrate::class);
				}
			},
		];
	}

	/**
	 * Integrate drafts in to the delete member chain
	 *
	 * @param int[] $users
	 * @throws Exception
	 */
	public static function integrate_delete_members(array $users): void
	{
		$db = database();

		// Delete any drafts...
		$db->query('', '
			DELETE FROM {db_prefix}user_drafts
			WHERE id_member IN ({array_int:users})',
			[
				'users' => $users,
			]
		);
	}

	/**
	 * Integrate draft permission in to the members and board permissions
	 *
	 * @param array $permissionGroups
	 * @param array $permissionList
	 */
	public static function integrate_load_permissions(array &$permissionGroups, array &$permissionList): void

The parameter $permissionGroups is not used and could be removed.

	{
		$permissionList['board'] += [
			'post_draft' => [false, 'topic'],
			'post_autosave_draft' => [false, 'topic'],
		];

		$permissionList['membergroup'] += [
			'pm_draft' => [false, 'pm'],
			'pm_autosave_draft' => [false, 'pm'],
		];
	}

	/**
	 * Integrate draft permission in to illegal guest permissions
	 */
	public static function integrate_load_illegal_guest_permissions(): void
	{
		global $context;

		$context['non_guest_permissions'] += [
			'post_draft',
			'post_autosave_draft',
		];
	}

	/**
	 * Integrate draft options in to the topics maintenance procedures
	 *
	 * @param array $topics_actions
	 */
	public static function integrate_topics_maintenance(array &$topics_actions): void
	{
		global $txt;

		$topics_actions['olddrafts'] = [
			'url' => getUrl('admin', ['action' => 'admin', 'area' => 'maintain', 'sa' => 'topics', 'activity' => 'olddrafts']),
			'title' => $txt['maintain_old_drafts'],
			'submit' => $txt['maintain_old_remove'],
			'confirm' => $txt['maintain_old_drafts_confirm'],
			'hidden' => [
				'session_var' => 'session_id',
				'admin-maint_token_var' => 'admin-maint_token',
			]
		];
	}

	/**
	 * Drafts maintenance integration hooks
	 *
	 * @param array $subActions
	 */
	public static function integrate_sa_manage_maintenance(array &$subActions): void
	{
		$subActions['topics']['activities']['olddrafts'] = static function () {
			$controller = new ManageDraftsModule(new EventManager());
			$controller->setUser(User::$info);
			$controller->pre_dispatch();
			$controller->action_olddrafts_display();
		};
	}

	/**
	 * This method removes old drafts.
	 */
	public function action_olddrafts_display(): void
	{
		global $context, $txt;

		validateToken('admin-maint');

		require_once(SUBSDIR . '/Drafts.subs.php');
		$drafts = getOldDrafts($this->_req->getPost('draftdays', 'intval', 0));

		// If we have old drafts, remove them
		if (count($drafts) > 0)
		{
			deleteDrafts($drafts, -1, false);
		}

		// Errors?  no errors, only success !
		$context['maintenance_finished'] = [
			'errors' => [sprintf($txt['maintain_done'], $txt['maintain_old_drafts'])],
		];
	}

	/**
	 * Default method.
	 * Requires admin_forum permissions
	 *
	 * @uses Drafts language file
	 */
	public function action_index()
	{
		isAllowedTo('admin_forum');
		Txt::load('Drafts');

		$this->action_draftSettings_display();
	}

	/**
	 * Modify any setting related to drafts.
	 *
	 * - Requires the admin_forum permission.
	 * - Accessed from ?action=admin;area=managedrafts
	 *
	 * @event integrate_save_drafts_settings
	 * @uses Admin template, edit_topic_settings sub-template.
	 */
	public function action_draftSettings_display(): void
	{
		global $context, $txt;

		isAllowedTo('admin_forum');
		Txt::load('Drafts');

		// Initialize the form
		$settingsForm = new SettingsForm(SettingsForm::DB_ADAPTER);

		// Initialize it with our settings
		$settingsForm->setConfigVars($this->_settings());

		// Setup the template.
		$context['page_title'] = $txt['managedrafts_settings'];
		$context['sub_template'] = 'show_settings';

		$context[$context['admin_menu_name']]['object']->prepareTabData([
			'title' => 'drafts',
			'description' => 'managedrafts_settings_description',
		]);

		// Saving them ?
		if (isset($this->_req->query->save))
		{
			checkSession();

			call_integration_hook('integrate_save_drafts_settings');

			// Protect them from themselves.
			$this->_req->post->drafts_autosave_frequency = min((int) $this->_req->post->drafts_autosave_frequency, 30);

			$settingsForm->setConfigValues((array) $this->_req->post);
			$settingsForm->save();
			redirectexit('action=admin;area=managedrafts');
		}

		// Some javascript to enable / disable the frequency input box
		theme()->addInlineJavascript('
			var autosave = document.getElementById(\'drafts_autosave_enabled\');

			createEventListener(autosave);
			autosave.addEventListener(\'change\', toggle);
			toggle();

			function toggle()
			{
				var select_elem = document.getElementById(\'drafts_autosave_frequency\');

				select_elem.disabled = !autosave.checked;
			}', true);

		// Final settings...
		$context['post_url'] = getUrl('admin', ['action' => 'admin', 'area' => 'managedrafts', 'save']);
		$context['settings_title'] = $txt['managedrafts_settings'];

		// Prepare the settings...
		$settingsForm->prepare();
	}

	/**
	 * Returns all admin drafts settings in config_vars format.
	 *
	 * @event integrate_modify_drafts_settings
	 */
	private function _settings()
	{
		global $txt;

		Txt::load('Drafts');

		// Here are all the draft settings, a bit lite for now, but we can add more :P
		$config_vars = [
			// Draft settings ...
			['check', 'drafts_post_enabled'],
			['check', 'drafts_pm_enabled'],
			['int', 'drafts_keep_days', 'postinput' => $txt['days_word'], 'subtext' => $txt['drafts_keep_days_subnote']],
			'',
			['check', 'drafts_autosave_enabled', 'subtext' => $txt['drafts_autosave_enabled_subnote']],
			['int', 'drafts_autosave_frequency', 'postinput' => $txt['manageposts_seconds'], 'subtext' => $txt['drafts_autosave_frequency_subnote']],
		];

		call_integration_hook('integrate_modify_drafts_settings', [&$config_vars]);

		return $config_vars;
	}

	/**
	 * Return the form settings for use in admin search
	 */
	public function settings_search()
	{
		if (isModuleEnabled('drafts'))
		{
			return $this->_settings();
		}

		return ['check', 'dummy_drafts'];
	}
}