forked from GNUsocial/gnu-social
ad7623a87f
This will apply to *ALL* plugins in *ALL* languages, so should probably only be used when doing site customization...
You'd probably do:
$config['site']['locale_path'] = '/srv/awesome/data/locale';
$config['plugins']['locale_path'] = '/srv/awesome/data/locale';
with a structure like:
srv/
awesome/
data/
locale/
en/
LC_MESSAGES/
statusnet.po
OpenID.po
AnonymousFave.po
etc, all alongside each other. You could separate plugins from the core if you like.
Where locale files have not already been generated, you can build one for a plugin like so:
php scripts/update_po_templates.php --plugin=MyPlugin
and pull out the template file:
plugins/MyPlugin/locale/MyPlugin.pot
Edit that (make sure you at least set the CHARSET, probably to UTF-8) and save your customized .po
files into the structure as above, and use msgfmt to generate .mo files for final output.
126 lines
3.7 KiB
PHP
126 lines
3.7 KiB
PHP
<?php
|
|
/**
|
|
* StatusNet, the distributed open-source microblogging tool
|
|
*
|
|
* Utility class for plugins
|
|
*
|
|
* PHP version 5
|
|
*
|
|
* LICENCE: This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program 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 Affero General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Affero General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* @category Plugin
|
|
* @package StatusNet
|
|
* @author Evan Prodromou <evan@status.net>
|
|
* @copyright 2008 StatusNet, Inc.
|
|
* @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
|
|
* @link http://status.net/
|
|
*/
|
|
|
|
if (!defined('STATUSNET') && !defined('LACONICA')) {
|
|
exit(1);
|
|
}
|
|
|
|
/**
|
|
* Base class for plugins
|
|
*
|
|
* A base class for StatusNet plugins. Mostly a light wrapper around
|
|
* the Event framework.
|
|
*
|
|
* Subclasses of Plugin will automatically handle an event if they define
|
|
* a method called "onEventName". (Well, OK -- only if they call parent::__construct()
|
|
* in their constructors.)
|
|
*
|
|
* They will also automatically handle the InitializePlugin and CleanupPlugin with the
|
|
* initialize() and cleanup() methods, respectively.
|
|
*
|
|
* @category Plugin
|
|
* @package StatusNet
|
|
* @author Evan Prodromou <evan@status.net>
|
|
* @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
|
|
* @link http://status.net/
|
|
*
|
|
* @see Event
|
|
*/
|
|
|
|
class Plugin
|
|
{
|
|
function __construct()
|
|
{
|
|
Event::addHandler('InitializePlugin', array($this, 'initialize'));
|
|
Event::addHandler('CleanupPlugin', array($this, 'cleanup'));
|
|
|
|
foreach (get_class_methods($this) as $method) {
|
|
if (mb_substr($method, 0, 2) == 'on') {
|
|
Event::addHandler(mb_substr($method, 2), array($this, $method));
|
|
}
|
|
}
|
|
|
|
$this->setupGettext();
|
|
}
|
|
|
|
function initialize()
|
|
{
|
|
return true;
|
|
}
|
|
|
|
function cleanup()
|
|
{
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Checks if this plugin has localization that needs to be set up.
|
|
* Gettext localizations can be called via the _m() helper function.
|
|
*/
|
|
protected function setupGettext()
|
|
{
|
|
$class = get_class($this);
|
|
if (substr($class, -6) == 'Plugin') {
|
|
$name = substr($class, 0, -6);
|
|
$path = common_config('plugins', 'locale_path');
|
|
if (!$path) {
|
|
// @fixme this will fail for things installed in local/plugins
|
|
// ... but then so will web links so far.
|
|
$path = INSTALLDIR . "/plugins/$name/locale";
|
|
}
|
|
if (file_exists($path) && is_dir($path)) {
|
|
bindtextdomain($name, $path);
|
|
bind_textdomain_codeset($name, 'UTF-8');
|
|
}
|
|
}
|
|
}
|
|
|
|
protected function log($level, $msg)
|
|
{
|
|
common_log($level, get_class($this) . ': '.$msg);
|
|
}
|
|
|
|
protected function debug($msg)
|
|
{
|
|
$this->log(LOG_DEBUG, $msg);
|
|
}
|
|
|
|
function onPluginVersion(&$versions)
|
|
{
|
|
$cls = get_class($this);
|
|
$name = mb_substr($cls, 0, -6);
|
|
|
|
$versions[] = array('name' => $name,
|
|
// TRANS: Displayed as version information for a plugin if no version information was found.
|
|
'version' => _('Unknown'));
|
|
|
|
return true;
|
|
}
|
|
}
|