srag/removeplugindataconfirm

This package is abandoned and no longer maintained. No replacement package was suggested.

Demand if plugin data should be removed on uninstall

0.9.0 2022-07-18 08:59 UTC

Requires

• php: >=7.2
• srag/dic: >=0.1.0
• srag/librarylanguageinstaller: >=0.1.0

GPL-3.0-only

• data
• plugin
• confirm
• uninstall
• ILIAS

README

Demand if plugin data should be removed on uninstall

This project is licensed under the GPL-3.0-only license

Usage

Composer

First add the following to your composer.json file:

"require": {
  "srag/removeplugindataconfirm": ">=0.1.0"
},

And run a composer install.

If you deliver your plugin, the plugin has it's own copy of this library and the user doesn't need to install the library.

Tip: Because of multiple autoloaders of plugins, it could be, that different versions of this library exists and suddenly your plugin use an older or a newer version of an other plugin!

So I recommand to use srag/librariesnamespacechanger in your plugin.

Use

First declare your plugin class like follow:

//...
use srag\RemovePluginDataConfirm\x\PluginUninstallTrait;
//...
use PluginUninstallTrait;
//...
/**
 * @inheritDoc
 */
protected function deleteData() : void {
    // TODO: Delete your plugin data in this method
}
//...

You don't need to use DICTrait, it is already in use!

If your plugin is a RepositoryObject use RepositoryObjectPluginUninstallTrait instead:

//...
use srag\RemovePluginDataConfirm\x\RepositoryObjectPluginUninstallTrait;
//...
use RepositoryObjectPluginUninstallTrait;
//...

Remove also the methods beforeUninstall, afterUninstall, beforeUninstallCustom and uninstallCustom in your plugin class.

Expand you plugin class for installing languages of the library to your plugin

...
	/**
     * @inheritDoc
     */
    public function updateLanguages(/*?array*/ $a_lang_keys = null) : void {
		parent::updateLanguages($a_lang_keys);

		$this->installRemovePluginDataConfirmLanguages();
	}
...

Notice to also adjust dbupdate.php so it can be reinstalled if the data should already exists!

Requirements

• ILIAS 6.0 - 7.999
• PHP >=7.2