Import initial du site depuis le serveur

2026-04-27 06:52:16 +00:00
parent 81b39e856b
commit f57f9fe1d5
1871 changed files with 214417 additions and 32138 deletions
@@ -0,0 +1,185 @@
+<?php
+
+/**
+ * Roundcube Help Plugin
+ *
+ * @author Aleksander 'A.L.E.C' Machniak
+ * @author Thomas Bruederli <thomas@roundcube.net>
+ * @license GNU GPLv3+
+ *
+ * Configuration (see config.inc.php.dist)
+ */
+
+class help extends rcube_plugin
+{
+    // all task excluding 'login' and 'logout'
+    public $task = '?(?!login|logout).*';
+
+    // we've got no ajax handlers
+    public $noajax = true;
+
+    function init()
+    {
+        $this->load_config();
+        $this->add_texts('localization/', false);
+
+        // register task
+        $this->register_task('help');
+
+        // register actions
+        $this->register_action('index', [$this, 'action']);
+        $this->register_action('about', [$this, 'action']);
+        $this->register_action('license', [$this, 'action']);
+
+        $this->add_hook('startup', [$this, 'startup']);
+        $this->add_hook('error_page', [$this, 'error_page']);
+    }
+
+    function startup($args)
+    {
+        $rcmail = rcmail::get_instance();
+
+        if (!$rcmail->output->framed) {
+            // add taskbar button
+            $this->add_button([
+                    'command'    => 'help',
+                    'class'      => 'button-help',
+                    'classsel'   => 'button-help button-selected',
+                    'innerclass' => 'button-inner',
+                    'label'      => 'help.help',
+                    'type'       => 'link',
+                ], 'taskbar'
+            );
+
+            $this->include_script('help.js');
+            $rcmail->output->set_env('help_open_extwin', $rcmail->config->get('help_open_extwin', false), true);
+        }
+
+        // add style for taskbar button (must be here) and Help UI
+        $this->include_stylesheet($this->local_skin_path() . '/help.css');
+    }
+
+    function action()
+    {
+        $rcmail = rcmail::get_instance();
+
+        if ($rcmail->action == 'about') {
+            $rcmail->output->set_pagetitle($this->gettext('about'));
+        }
+        else if ($rcmail->action == 'license') {
+            $rcmail->output->set_pagetitle($this->gettext('license'));
+        }
+        else {
+            $rcmail->output->set_pagetitle($this->gettext('help'));
+        }
+
+        // register UI objects
+        $rcmail->output->add_handlers([
+                'helpcontent'  => [$this, 'help_content'],
+                'tablink'      => [$this, 'tablink'],
+        ]);
+
+        $rcmail->output->set_env('help_links', $this->help_metadata());
+        $rcmail->output->send(!empty($_GET['_content']) ? 'help.content' : 'help.help');
+    }
+
+    function help_content($attrib)
+    {
+        $rcmail = rcmail::get_instance();
+//        $rcmail->output->set_env('content', $content);
+
+        if (!empty($_GET['_content'])) {
+            if ($rcmail->action == 'about') {
+                return file_get_contents($this->home . '/content/about.html');
+            }
+            else if ($rcmail->action == 'license') {
+                return file_get_contents($this->home . '/content/license.html');
+            }
+        }
+    }
+
+    function tablink($attrib)
+    {
+        $rcmail = rcmail::get_instance();
+
+        $attrib['name'] = 'helplink' . $attrib['action'];
+        $attrib['href'] = $rcmail->url(['_action' => $attrib['action'], '_extwin' => !empty($_REQUEST['_extwin']) ? 1 : null]);
+        $attrib['rel']  = $attrib['action'];
+
+        // title might be already translated here, so revert to it's initial value
+        // so button() will translate it correctly
+        $attrib['title'] = $attrib['label'];
+
+        $attrib['onclick'] = sprintf("return show_help_content('%s', event)", $attrib['action']);
+
+        return $rcmail->output->button($attrib);
+    }
+
+    function help_metadata()
+    {
+        $rcmail  = rcmail::get_instance();
+        $content = [];
+
+        // About
+        if (is_readable($this->home . '/content/about.html')) {
+            $content['about'] = 'self';
+        }
+        else {
+            $default = $rcmail->url(['_task' => 'settings', '_action' => 'about', '_framed' => 1]);
+            $content['about'] = $rcmail->config->get('help_about_url', $default);
+            $content['about'] = $this->resolve_language($content['about']);
+        }
+
+        // License
+        if (is_readable($this->home . '/content/license.html')) {
+            $content['license'] = 'self';
+        }
+        else {
+            $content['license'] = $rcmail->config->get('help_license_url', 'http://www.gnu.org/licenses/gpl-3.0-standalone.html');
+            $content['license'] = $this->resolve_language($content['license']);
+        }
+
+        // Help Index
+        $src       = $rcmail->config->get('help_source', 'http://docs.roundcube.net/doc/help/1.1/%l/');
+        $index_map = $rcmail->config->get('help_index_map', []);
+
+        // resolve task/action for deep linking
+        $rel = !empty($_REQUEST['_rel']) ? $_REQUEST['_rel'] : '';
+        list($task, ) = explode('/', $rel);
+        if (!empty($index_map[$rel])) {
+            $src .= $index_map[$rel];
+        }
+        else if (!empty($index_map[$task])) {
+            $src .= $index_map[$task];
+        }
+
+        $content['index'] = $this->resolve_language($src);
+
+        return $content;
+    }
+
+    function error_page($args)
+    {
+        $rcmail = rcmail::get_instance();
+
+        if (
+            $args['code'] == 403
+            && $rcmail->request_status == rcube::REQUEST_ERROR_URL
+            && ($url = $rcmail->config->get('help_csrf_info'))
+        ) {
+            $args['text'] .= '<p>' . html::a(['href' => $url, 'target' => '_blank'], $this->gettext('csrfinfo')) . '</p>';
+        }
+
+        return $args;
+    }
+
+    private function resolve_language($path)
+    {
+        // resolve language placeholder
+        $rcmail  = rcmail::get_instance();
+        $langmap = $rcmail->config->get('help_language_map', ['*' => 'en_US']);
+        $lang    = !empty($langmap[$_SESSION['language']]) ? $langmap[$_SESSION['language']] : $langmap['*'];
+
+        return str_replace('%l', $lang, $path);
+    }
+}