PluginsHelper.php

Go to the documentation of this file.

<?php

namespace Elgg\Traits\Cli;

use Elgg\Exceptions\InvalidParameterException;
use Elgg\Exceptions\PluginException;

trait PluginsHelper {

    public function activate($id, $force = false) {

        $plugin = elgg_get_plugin_from_id($id);
        if (!$plugin) {
            throw new InvalidParameterException(elgg_echo('PluginException:InvalidID', [$id]));
        }

        if (!$force) {
            try {
                return $plugin->activate();
            } catch (PluginException $e) {
                return false;
            }
        }

        $conflicts = $this->getConflicts($id);
        foreach ($conflicts as $conflict) {
            $this->deactivate($conflict, true);
        }

        $requires = $this->getRequires($id);
        foreach ($requires as $require) {
            $this->activate($require, true);
        }

        try {
            return $plugin->activate();
        } catch (PluginException $e) {
            return false;
        }
    }

    public function deactivate($id, $force = false) {
        $plugin = elgg_get_plugin_from_id($id);
        if (!$plugin) {
            throw new InvalidParameterException(elgg_echo('PluginException:InvalidID', [$id]));
        }

        if (!$force) {
            try {
                return $plugin->deactivate();
            } catch (PluginException $e) {
                return false;
            }
        }

        $dependents = $this->getDependents($id);
        foreach ($dependents as $dependent) {
            $this->deactivate($dependent, true);
        }

        try {
            return $plugin->deactivate();
        } catch (PluginException $e) {
            return false;
        }
    }

    protected function getDependents($id) {
        $dependents = [];

        $active_plugins = elgg_get_plugins();

        foreach ($active_plugins as $plugin) {
            $dependencies = $plugin->getDependencies();
            if (!array_key_exists($id, $dependencies)) {
                continue;
            }
                
            if (elgg_extract('must_be_active', $dependencies[$id], true)) {
                $dependents[] = $plugin->getID();
            }
        }

        return $dependents;
    }

    public function getConflicts($id) {
        $result = [];

        $plugin = elgg_get_plugin_from_id($id);
        $conflicts = $plugin->getConflicts();

        foreach ($conflicts as $plugin_id => $plugin_version) {
            // @todo need to validate version
            if (elgg_get_plugin_from_id($plugin_id)) {
                $result[] = $plugin_id;
            }
        }

        return $result;
    }

    public function getRequires($id) {
        $result = [];

        $plugin = elgg_get_plugin_from_id($id);
        foreach ($plugin->getDependencies() as $plugin_id => $config) {
            if (!elgg_extract('must_be_active', $config, true)) {
                continue;
            }
            
            if (!elgg_get_plugin_from_id($plugin_id)) {
                continue;
            }
            
            $result[] = $plugin_id;
        }

        return $result;
    }
}