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/>.

/**

 * Utility classes and functions for text editor integration.

 *

 * @package    core

 * @subpackage editor

 * @copyright  2009 Petr Skoda {@link http://skodak.org}

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

 */

defined('MOODLE_INTERNAL') || die();

/**

 * Returns users preferred editor for given format

 *

 * @param int $format text format or null of none

 * @return texteditor object

 */

function editors_get_preferred_editor($format = NULL) {

    global $USER, $CFG;

    if (!empty($CFG->adminsetuppending)) {

        // Must not use other editors before install completed!

        return get_texteditor('textarea');

    }

    $enabled = editors_get_enabled();

    $preference = get_user_preferences('htmleditor', '', $USER);

    if (isset($enabled[$preference])) {

        // Edit the list of editors so the users preferred editor is first in the list.

        $editor = $enabled[$preference];

        unset($enabled[$preference]);

        array_unshift($enabled, $editor);

    }

    // now find some plugin that supports format and is available

    $editor = false;

    foreach ($enabled as $e) {

        if (!$e->supported_by_browser()) {

            // bad luck, this editor is not compatible

            continue;

        }

        if (!$supports = $e->get_supported_formats()) {

            // buggy editor!

            continue;

        }

        if (is_null($format) || in_array($format, $supports)) {

            // editor supports this format, yay!

            $editor = $e;

            break;

        }

    }

    if (!$editor) {

        $editor = get_texteditor('textarea'); // must exist and can edit anything

    }

    return $editor;

}

/**

 * Returns users preferred text format.

 * @return int standard text format

 */

function editors_get_preferred_format() {

    global $USER;

    $editor = editors_get_preferred_editor();

    return $editor->get_preferred_format();

}

/**

 * Returns list of enabled text editors

 * @return array of name=>texteditor

 */

function editors_get_enabled() {

    global $CFG;

    if (empty($CFG->texteditors)) {

        $CFG->texteditors = 'tiny,textarea';

    }

    $active = array();

    foreach(explode(',', $CFG->texteditors) as $e) {

        if ($editor = get_texteditor($e)) {

            $active[$e] = $editor;

        }

    }

    if (empty($active)) {

        return array('textarea'=>get_texteditor('textarea')); // must exist and can edit anything

    }

    return $active;

}

/**

 * Returns instance of text editor

 *

 * @param string $editorname name of editor (textarea, tiny, ...)

 * @return object|bool texeditor instance or false if does not exist

 */

function get_texteditor($editorname) {

    global $CFG;

    $libfile = "$CFG->libdir/editor/$editorname/lib.php";

    if (!file_exists($libfile)) {

        return false;

    }

    require_once($libfile);

    $classname = $editorname.'_texteditor';

    if (!class_exists($classname)) {

        return false;

    }

    return new $classname();

}

/**

 * Get the list of available editors

 *

 * @return array Array ('editorname'=>'localised editor name')

 */

function editors_get_available() {

    $editors = array();

    foreach (core_component::get_plugin_list('editor') as $editorname => $dir) {

        $editors[$editorname] = get_string('pluginname', 'editor_'.$editorname);

    }

    return $editors;

}

/**

 * Setup all JS and CSS needed for editors.

 * @return void

 */

function editors_head_setup() {

    global $CFG;

    if (empty($CFG->texteditors)) {

        $CFG->texteditors = 'tiny,textarea';

    }

    $active = explode(',', $CFG->texteditors);

    foreach ($active as $editorname) {

        if (!$editor = get_texteditor($editorname)) {

            continue;

        }

        if (!$editor->supported_by_browser()) {

            // bad luck, this editor is not compatible

            continue;

        }

        $editor->head_setup();

    }

}

/**

 * Base abstract text editor class.

 *

 * @copyright  2009 Petr Skoda {@link http://skodak.org}

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

 * @package moodlecore

 */

abstract class texteditor {

    /**

     * Is editor supported in current browser?

     * @return bool

     */

    abstract public function supported_by_browser();

    /**

     * Returns list of supported text formats

     * @return array Array (FORMAT=>FORMAT)

     */

    abstract public function get_supported_formats();

    /**

     * Returns main preferred text format.

     * @return int text format

     */

    abstract public function get_preferred_format();

    /**

     * Supports file picker and repos?

     * @return object book object

     */

    abstract public function supports_repositories();

    /**

     * @var string $text The text set to the editor in the form.

     * @since 3.0

     */

    protected $text = '';

    /**

     * Set the text set for this form field. Will be called before "use_editor".

     * @param string $text The text for the form field.

     */

    public function set_text($text) {

        $this->text = $text;

    }

    /**

     * Get the text set for this form field. Can be called from "use_editor".

     * @return string

     */

    public function get_text() {

        return $this->text;

    }

    /**

     * Add required JS needed for editor

     *

     * Valid options may vary by editor. See the individual editor

     * implementations of this function for documentation.

     *

     * @param string $elementid id of text area to be converted to editor

     * @param array $options Editor options

     * @param obejct $fpoptions file picker options

     * @return void

     */

    abstract public function use_editor($elementid, ?array $options=null, $fpoptions = null);

    /**

     * Setup all JS and CSS needed for editor.

     * @return void

     */

    public function head_setup() {

    }

}