From 8cd3c68934269df205a62daee44cca8fc638ff54 Mon Sep 17 00:00:00 2001 From: fox Date: Fri, 1 Mar 2019 11:33:41 +0000 Subject: Update page 'MakingPlugins' --- MakingPlugins.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/MakingPlugins.md b/MakingPlugins.md index 9303115..1b7d001 100644 --- a/MakingPlugins.md +++ b/MakingPlugins.md @@ -11,3 +11,13 @@ List of hooks you can use is available in classes/pluginhost.php. Some javascript hooks are also available (js/PluginHost.js). Some example plugins are available in the [samples](https://git.tt-rss.org/git/tt-rss-samples) repository. + +## Localization support + +See ``time_to_read`` plugin for a complete example here: https://git.tt-rss.org/fox/ttrss-time-to-read + +- Plugin translations are placed in a separate Gettext domain (name equals to lowercase plugin class). +- Translation (.po) file in ``(plugin dir)/locale/LANG/`` name should correspond to Gettext domain name. +- On the PHP side, either use ``P__``, ``P__ngettext``, etc. shortcut functions defined in ``classes/pluginhost.php`` or call ``_dgettext`` group of functions directly. +- On the Javascript side, translations are combined together, so you can use the usual ``__()`` shortcut function. + -- cgit v1.2.3