ilComponentBuildPluginInfoObjective Class Reference

Inheritance diagram for ilComponentBuildPluginInfoObjective:

Collaboration diagram for ilComponentBuildPluginInfoObjective:

Public Member Functions
	getArtifactPath ()
	build ()

Protected Member Functions
	addPlugin (array &$data, string $type, string $component, string $slot, string $plugin)
	scanDir (string $dir)
	fileExists (string $path)
	isDir (string $dir)
	isDotFile (string $file)
	buildPluginPath (string $type, string $component, string $slot, string $plugin)

Protected Attributes
const	BASE_PATH = "./Customizing/global/plugins/"
const	PLUGIN_PHP = "plugin.php"
const	PLUGIN_CLASS_FILE = "classes/class.il%sPlugin.php"

Detailed Description

Definition at line 21 of file class.ilComponentBuildPluginInfoObjective.php.

Member Function Documentation

addPlugin()

ilComponentBuildPluginInfoObjective::addPlugin ( array &  $data, string  $type, string  $component, string  $slot, string  $plugin  )

protected

Definition at line 57 of file class.ilComponentBuildPluginInfoObjective.php.

References $id, $ilias_max_version, $ilias_min_version, $learning_progress, XapiProxy\$plugin, $responsible, $responsible_mail, $supports_export, $type, $version, buildPluginPath(), and fileExists().

Referenced by build().

                                                                                                             : void
    {
        $plugin_path = $this->buildPluginPath($type, $component, $slot, $plugin);
        $plugin_php = $plugin_path . static::PLUGIN_PHP;
        if (!$this->fileExists($plugin_php)) {
            throw new \RuntimeException(
                "Cannot read $plugin_php."
            );
        }

        $plugin_class = $plugin_path . sprintf(static::PLUGIN_CLASS_FILE, $plugin);
        if (!$this->fileExists($plugin_class)) {
            throw new \RuntimeException(
                "Cannot read $plugin_class."
            );
        }

        require_once($plugin_php);
        if (!isset($id)) {
            throw new \InvalidArgumentException("$path does not define \$id");
        }
        if (!isset($version)) {
            throw new \InvalidArgumentException("$path does not define \$version");
        }
        if (!isset($ilias_min_version)) {
            throw new \InvalidArgumentException("$path does not define \$ilias_min_version");
        }
        if (!isset($ilias_max_version)) {
            throw new \InvalidArgumentException("$path does not define \$ilias_max_version");
        }

        if (isset($data[$id])) {
            throw new \RuntimeException(
                "Plugin with id $id already exists."
            );
        }

        $data[$id] = [
            $type,
            $component,
            $slot,
            $plugin,
            $version,
            $ilias_min_version,
            $ilias_max_version,
            $responsible ?? "",
            $responsible_mail ?? "",
            $learning_progress ?? null,
            $supports_export ?? null,
            $supports_cli_setup ?? null
        ];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

build()

ilComponentBuildPluginInfoObjective::build

(

)

Definition at line 33 of file class.ilComponentBuildPluginInfoObjective.php.

References $data, XapiProxy\$plugin, $type, addPlugin(), isDir(), isDotFile(), and scanDir().

                           : Setup\Artifact
    {
        $data = [];
        foreach (["Modules", "Services"] as $type) {
            $components = $this->scanDir(static::BASE_PATH . $type);
            foreach ($components as $component) {
                if ($this->isDotFile($component)
                    || ! $this->isDir(static::BASE_PATH . "$type/$component")) continue;
                $slots = $this->scanDir(static::BASE_PATH . "$type/$component");
                foreach ($slots as $slot) {
                    if ($this->isDotFile($slot)
                        || ! $this->isDir(static::BASE_PATH . "$type/$component/$slot")) continue;
                    $plugins = $this->scanDir(static::BASE_PATH . "$type/$component/$slot");
                    foreach ($plugins as $plugin) {
                        if ($this->isDotFile($plugin)
                            || ! $this->isDir(static::BASE_PATH . "$type/$component/$slot/$plugin")) continue;
                        $this->addPlugin($data, $type, $component, $slot, $plugin);
                    }
                }
            }
        }
        return new Setup\Artifact\ArrayArtifact($data);
    }

Here is the call graph for this function:

buildPluginPath()

ilComponentBuildPluginInfoObjective::buildPluginPath ( string  $type, string  $component, string  $slot, string  $plugin  )

protected

Definition at line 137 of file class.ilComponentBuildPluginInfoObjective.php.

Referenced by addPlugin().

                                                                                                     : string
    {
        return static::BASE_PATH . "$type/$component/$slot/$plugin/";
    }

Here is the caller graph for this function:

fileExists()

ilComponentBuildPluginInfoObjective::fileExists ( string  $path )

protected

Definition at line 122 of file class.ilComponentBuildPluginInfoObjective.php.

Referenced by addPlugin().

                                               : bool
    {
        return file_exists($path) && is_file($path);
    }

Here is the caller graph for this function:

getArtifactPath()

ilComponentBuildPluginInfoObjective::getArtifactPath

(

)

Definition at line 27 of file class.ilComponentBuildPluginInfoObjective.php.

                                     : string
    {
        return \ilArtifactComponentRepository::PLUGIN_DATA_PATH;
    }

isDir()

ilComponentBuildPluginInfoObjective::isDir ( string  $dir )

protected

Definition at line 127 of file class.ilComponentBuildPluginInfoObjective.php.

Referenced by build().

                                         : bool
    {
        return file_exists($dir) && is_dir($dir);
    }

Here is the caller graph for this function:

isDotFile()

ilComponentBuildPluginInfoObjective::isDotFile ( string  $file )

protected

Definition at line 132 of file class.ilComponentBuildPluginInfoObjective.php.

Referenced by build().

                                              : bool
    {
        return ( substr($file, 0, 1) === '.' );
    }

Here is the caller graph for this function:

scanDir()

ilComponentBuildPluginInfoObjective::scanDir ( string  $dir )

protected

Returns

string[]

Definition at line 113 of file class.ilComponentBuildPluginInfoObjective.php.

Referenced by build().

                                           : array
    {
        if (!file_exists($dir)) {
            return [];
        }
        $result = scandir($dir);
        return array_values(array_diff($result, [".", ".."]));
    }

Here is the caller graph for this function:

Field Documentation

BASE_PATH

const ilComponentBuildPluginInfoObjective::BASE_PATH = "./Customizing/global/plugins/"

protected

Definition at line 23 of file class.ilComponentBuildPluginInfoObjective.php.

PLUGIN_CLASS_FILE

const ilComponentBuildPluginInfoObjective::PLUGIN_CLASS_FILE = "classes/class.il%sPlugin.php"

protected

Definition at line 25 of file class.ilComponentBuildPluginInfoObjective.php.

PLUGIN_PHP

const ilComponentBuildPluginInfoObjective::PLUGIN_PHP = "plugin.php"

protected

Definition at line 24 of file class.ilComponentBuildPluginInfoObjective.php.

---

The documentation for this class was generated from the following file:

• Services/Component/classes/Setup/class.ilComponentBuildPluginInfoObjective.php