| | |
| | | | program/include/rcube_plugin.php | |
| | | | | |
| | | | This file is part of the Roundcube Webmail client | |
| | | | Copyright (C) 2008-2009, Roundcube Dev. - Switzerland | |
| | | | Licensed under the GNU GPL | |
| | | | Copyright (C) 2008-2009, The Roundcube Dev Team | |
| | | | | |
| | | | Licensed under the GNU General Public License version 3 or | |
| | | | any later version with exceptions for skins & plugins. | |
| | | | See the README file for a full license statement. | |
| | | | | |
| | | | PURPOSE: | |
| | | | Abstract plugins interface/class | |
| | |
| | | +-----------------------------------------------------------------------+ |
| | | | Author: Thomas Bruederli <roundcube@gmail.com> | |
| | | +-----------------------------------------------------------------------+ |
| | | |
| | | $Id$ |
| | | |
| | | */ |
| | | |
| | | /** |
| | |
| | | $this->home = $api->dir . $this->ID; |
| | | $this->urlbase = $api->url . $this->ID . '/'; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Initialization method, needs to be implemented by the plugin itself |
| | | */ |
| | | abstract function init(); |
| | | |
| | | |
| | | |
| | | /** |
| | | * Attempt to load the given plugin which is required for the current plugin |
| | | * |
| | | * @param string Plugin name |
| | | * @return boolean True on success, false on failure |
| | | */ |
| | | public function require_plugin($plugin_name) |
| | | { |
| | | return $this->api->load_plugin($plugin_name); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Load local config file from plugins directory. |
| | | * The loaded values are patched over the global configuration. |
| | |
| | | public function load_config($fname = 'config.inc.php') |
| | | { |
| | | $fpath = $this->home.'/'.$fname; |
| | | $rcmail = rcmail::get_instance(); |
| | | if (is_file($fpath) && !$rcmail->config->load_from_file($fpath)) { |
| | | raise_error(array('code' => 527, 'type' => 'php', |
| | | $rcube = rcube::get_instance(); |
| | | if (is_file($fpath) && !$rcube->config->load_from_file($fpath)) { |
| | | rcube::raise_error(array( |
| | | 'code' => 527, 'type' => 'php', |
| | | 'file' => __FILE__, 'line' => __LINE__, |
| | | 'message' => "Failed to load config from $fpath"), true, false); |
| | | return false; |
| | | } |
| | | |
| | | |
| | | return true; |
| | | } |
| | | |
| | |
| | | { |
| | | $this->api->register_hook($hook, $callback); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Unregister a callback function for a specific (server-side) hook. |
| | | * |
| | | * @param string $hook Hook name |
| | | * @param mixed $callback Callback function as string or array with object reference and method name |
| | | */ |
| | | public function remove_hook($hook, $callback) |
| | | { |
| | | $this->api->unregister_hook($hook, $callback); |
| | | } |
| | | |
| | | /** |
| | | * Load localized texts from the plugins dir |
| | | * |
| | |
| | | public function add_texts($dir, $add2client = false) |
| | | { |
| | | $domain = $this->ID; |
| | | |
| | | $lang = $_SESSION['language']; |
| | | $lang = $_SESSION['language']; |
| | | $langs = array_unique(array('en_US', $lang)); |
| | | $locdir = slashify(realpath(slashify($this->home) . $dir)); |
| | | $texts = array(); |
| | | $texts = array(); |
| | | |
| | | // Language aliases used to find localization in similar lang, see below |
| | | $aliases = array( |
| | | 'de_CH' => 'de_DE', |
| | | 'es_AR' => 'es_ES', |
| | | 'fa_AF' => 'fa_IR', |
| | | 'nl_BE' => 'nl_NL', |
| | | 'pt_BR' => 'pt_PT', |
| | | 'zh_CN' => 'zh_TW', |
| | | ); |
| | | |
| | | // use buffering to handle empty lines/spaces after closing PHP tag |
| | | ob_start(); |
| | | |
| | | foreach (array('en_US', $lang) as $lng) { |
| | | @include($locdir . $lng . '.inc'); |
| | | $texts = (array)$labels + (array)$messages + (array)$texts; |
| | | foreach ($langs as $lng) { |
| | | $fpath = $locdir . $lng . '.inc'; |
| | | if (is_file($fpath) && is_readable($fpath)) { |
| | | include $fpath; |
| | | $texts = (array)$labels + (array)$messages + (array)$texts; |
| | | } |
| | | else if ($lng != 'en_US') { |
| | | // Find localization in similar language (#1488401) |
| | | $alias = null; |
| | | if (!empty($aliases[$lng])) { |
| | | $alias = $aliases[$lng]; |
| | | } |
| | | else if ($key = array_search($lng, $aliases)) { |
| | | $alias = $key; |
| | | } |
| | | |
| | | if (!empty($alias)) { |
| | | $fpath = $locdir . $alias . '.inc'; |
| | | if (is_file($fpath) && is_readable($fpath)) { |
| | | include $fpath; |
| | | $texts = (array)$labels + (array)$messages + (array)$texts; |
| | | } |
| | | } |
| | | } |
| | | } |
| | | |
| | | ob_end_clean(); |
| | |
| | | |
| | | $rcmail = rcmail::get_instance(); |
| | | $rcmail->load_language($lang, $add); |
| | | |
| | | |
| | | // add labels to client |
| | | if ($add2client) { |
| | | $js_labels = is_array($add2client) ? array_map(array($this, 'label_map_callback'), $add2client) : array_keys($add); |
| | |
| | | } |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Wrapper for rcmail::gettext() adding the plugin ID as domain |
| | | * |
| | |
| | | */ |
| | | public function gettext($p) |
| | | { |
| | | return rcmail::get_instance()->gettext($p, $this->ID); |
| | | return rcube::get_instance()->gettext($p, $this->ID); |
| | | } |
| | | |
| | | /** |
| | |
| | | { |
| | | $this->api->include_stylesheet($this->resource_url($fn)); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Append a button to a certain container |
| | | * |
| | |
| | | foreach (array('imagepas', 'imageact', 'imagesel') as $key) |
| | | if ($p[$key]) |
| | | $p[$key] = $this->api->url . $this->resource_url($p[$key]); |
| | | |
| | | |
| | | $this->api->add_content($this->api->output->button($p), $container); |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Generate an absolute URL to the given resource within the current |
| | | * plugin directory |
| | |
| | | else |
| | | return $fn; |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Provide path to the currently selected skin folder within the plugin directory |
| | | * with a fallback to the default skin folder. |
| | | * |
| | | * @return string Skin path relative to plugins directory |
| | | */ |
| | | protected function local_skin_path() |
| | | public function local_skin_path() |
| | | { |
| | | $skin_path = 'skins/'.$this->api->config->get('skin'); |
| | | if (!is_dir(realpath(slashify($this->home) . $skin_path))) |
| | | $skin_path = 'skins/default'; |
| | | $rcmail = rcube::get_instance(); |
| | | $skin_path = 'skins/' . $rcmail->config->get('skin'); |
| | | if (!is_dir(realpath(slashify($this->home) . $skin_path))) |
| | | $skin_path = 'skins/default'; |
| | | return $skin_path; |
| | | } |
| | | |
| | |
| | | return $this->ID.'.'.$key; |
| | | } |
| | | |
| | | |
| | | } |
| | | |