Proyectos de Subversion Moodle

<?php

// This file is part of Moodle - http://moodle.org/

//

// Moodle is free software: you can redistribute it and/or modify

// it under the terms of the GNU General Public License as published by

// the Free Software Foundation, either version 3 of the License, or

// (at your option) any later version.

//

// Moodle is distributed in the hope that it will be useful,

// but WITHOUT ANY WARRANTY; without even the implied warranty of

// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

// GNU General Public License for more details.

//

// You should have received a copy of the GNU General Public License

// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

namespace tiny_aiplacement;

use aiplacement_editor\utils;

use core\context;

use core_ai\aiactions\generate_image;

use core_ai\aiactions\generate_text;

use core_ai\manager;

use editor_tiny\editor;

use editor_tiny\plugin;

use editor_tiny\plugin_with_buttons;

use editor_tiny\plugin_with_configuration;

use editor_tiny\plugin_with_configuration_for_external;

use editor_tiny\plugin_with_menuitems;

/**

 * Tiny AI placement plugin.

 *

 * @package    tiny_aiplacement

 * @copyright  2024 Matt Porritt <matt.porritt@moodle.com>

 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

 */

class plugininfo extends plugin implements

    plugin_with_buttons,

    plugin_with_menuitems,

    plugin_with_configuration,

    plugin_with_configuration_for_external {

    /**

     * @var array|string[] The possible actions for the plugin.

     */

    protected static array $possibleactions = [

        'generate_text' => generate_text::class,

        'generate_image' => generate_image::class,

    ];

    #[\Override]

    public static function is_enabled(

        context $context,

        array $options,

        array $fpoptions,

        ?editor $editor = null

    ): bool {

        return in_array(true, self::get_allowed_actions($context, $options));

    }

    #[\Override]

    public static function is_enabled_for_external(context $context, array $options): bool {

        // Assume files are allowed. Otherwise, the generate_image action is ignored.

        $options['maxfiles'] = 1;

        return self::is_enabled($context, $options, []);

    }

    #[\Override]

    public static function get_available_buttons(): array {

        return array_map(fn ($action) => "tiny_aiplacement/{$action}", self::$possibleactions);

    }

    #[\Override]

    public static function get_available_menuitems(): array {

        return array_map(fn ($action) => "tiny_aiplacement/{$action}", self::$possibleactions);

    }

    #[\Override]

    public static function get_plugin_configuration_for_context(

        context $context,

        array $options,

        array $fpoptions,

        ?editor $editor = null

    ): array {

        global $USER;

        $userid = (int) $USER->id;

        $allowedactions = self::get_allowed_actions($context, $options);

        return array_merge([

            'contextid' => $context->id,

            'userid' => $userid,

            'policyagreed' => manager::get_user_policy_status($userid),

        ], $allowedactions);

    }

    #[\Override]

    public static function get_plugin_configuration_for_external(context $context): array {

        // Assume files are allowed. Otherwise, the generate_image action is ignored.

        $options = ['maxfiles' => 1];

        $settings = self::get_plugin_configuration_for_context($context, $options, []);

        unset($settings['contextid']);

        unset($settings['userid']);

        return array_map(fn($value) =>  is_bool($value) ? ($value ? '1' : '0') : $value, $settings);

    }

    /**

     * Get the allowed actions for the plugin.

     *

     * @param context $context The context that the editor is used within

     * @param array $options The options passed in when requesting the editor

     * @return array The allowed actions.

     */

    private static function get_allowed_actions(context $context, array $options): array {

        $allowedactions = [];

        foreach (self::$possibleactions as $action => $actionclass) {

            $allowedactions[$action] = utils::is_html_editor_placement_action_available(

                context: $context,

                actionname: $action,

                actionclass: $actionclass,

            );

            if ($allowedactions[$action] && $action == 'generate_image') {

                // For generate image, we need to check if the user has the capability to upload files.

                $canhavefiles = !empty($options['maxfiles']);

                $canhaveexternalfiles = !empty($options['return_types']) && ($options['return_types'] & FILE_EXTERNAL);

                $allowedactions[$action] = $canhavefiles || $canhaveexternalfiles;

            }

        }

        return $allowedactions;

    }

}