X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=plugins%2Fdemo_plugin%2Fdemo_plugin.php;h=95ea7fe2d029767f16c000d1672e9aa0bacf4cd4;hb=e1850388348d4bfdf463a5aa341bc470da79cf32;hp=18834e5331d91cc9d217c18a284056097bcc23db;hpb=1a84bf1e2bc45787d9cfa81fa427a11a3aba623a;p=github%2Fshaarli%2FShaarli.git
diff --git a/plugins/demo_plugin/demo_plugin.php b/plugins/demo_plugin/demo_plugin.php
index 18834e53..95ea7fe2 100644
--- a/plugins/demo_plugin/demo_plugin.php
+++ b/plugins/demo_plugin/demo_plugin.php
@@ -14,6 +14,51 @@
* and check user status with _LOGGEDIN_.
*/
+use Shaarli\Config\ConfigManager;
+use Shaarli\Plugin\PluginManager;
+use Shaarli\Router;
+
+/**
+ * In the footer hook, there is a working example of a translation extension for Shaarli.
+ *
+ * The extension must be attached to a new translation domain (i.e. NOT 'shaarli').
+ * Use case: any custom theme or non official plugin can use the translation system.
+ *
+ * See the documentation for more information.
+ */
+const EXT_TRANSLATION_DOMAIN = 'demo';
+
+/*
+ * This is not necessary, but it's easier if you don't want Poedit to mix up your translations.
+ */
+function demo_plugin_t($text, $nText = '', $nb = 1)
+{
+ return t($text, $nText, $nb, EXT_TRANSLATION_DOMAIN);
+}
+
+/**
+ * Initialization function.
+ * It will be called when the plugin is loaded.
+ * This function can be used to return a list of initialization errors.
+ *
+ * @param $conf ConfigManager instance.
+ *
+ * @return array List of errors (optional).
+ */
+function demo_plugin_init($conf)
+{
+ $conf->get('toto', 'nope');
+
+ if (! $conf->exists('translation.extensions.demo')) {
+ // Custom translation with the domain 'demo'
+ $conf->set('translation.extensions.demo', 'plugins/demo_plugin/languages/');
+ $conf->write(true);
+ }
+
+ $errors[] = 'This a demo init error.';
+ return $errors;
+}
+
/**
* Hook render_header.
* Executed on every page redering.
@@ -30,18 +75,70 @@ function hook_demo_plugin_render_header($data)
{
// Only execute when linklist is rendered.
if ($data['_PAGE_'] == Router::$PAGE_LINKLIST) {
-
// If loggedin
if ($data['_LOGGEDIN_'] === true) {
- // Buttons in toolbar
- $data['buttons_toolbar'][] = '
DEMO_buttons_toolbar';
+ /*
+ * Links in toolbar:
+ * A link is an array of its attributes (key="value"),
+ * and a mandatory `html` key, which contains its value.
+ */
+ $button = array(
+ 'attr' => array (
+ 'href' => '#',
+ 'class' => 'mybutton',
+ 'title' => 'hover me',
+ ),
+ 'html' => 'DEMO buttons toolbar',
+ );
+ $data['buttons_toolbar'][] = $button;
}
- // Fields in toolbar
- $data['fields_toolbar'][] = 'DEMO_fields_toolbar';
+ /*
+ * Add additional input fields in the tools.
+ * A field is an array containing:
+ * [
+ * 'form-attribute-1' => 'form attribute 1 value',
+ * 'form-attribute-2' => 'form attribute 2 value',
+ * 'inputs' => [
+ * [
+ * 'input-1-attribute-1 => 'input 1 attribute 1 value',
+ * 'input-1-attribute-2 => 'input 1 attribute 2 value',
+ * ],
+ * [
+ * 'input-2-attribute-1 => 'input 2 attribute 1 value',
+ * ],
+ * ],
+ * ]
+ * This example renders as:
+ *
+ */
+ $form = array(
+ 'attr' => array(
+ 'method' => 'GET',
+ 'action' => '?',
+ 'class' => 'addform',
+ ),
+ 'inputs' => array(
+ array(
+ 'type' => 'text',
+ 'name' => 'demo',
+ 'placeholder' => 'demo',
+ )
+ )
+ );
+ $data['fields_toolbar'][] = $form;
}
// Another button always displayed
- $data['buttons_toolbar'][] = 'DEMO';
+ $button = array(
+ 'attr' => array(
+ 'href' => '#',
+ ),
+ 'html' => 'Demo',
+ );
+ $data['buttons_toolbar'][] = $button;
return $data;
}
@@ -90,7 +187,7 @@ function hook_demo_plugin_render_includes($data)
function hook_demo_plugin_render_footer($data)
{
// footer text
- $data['text'][] = 'Shaarli is now enhanced by the awesome demo_plugin.';
+ $data['text'][] = '
'. demo_plugin_t('Shaarli is now enhanced by the awesome demo_plugin.');
// Free elements at the end of the page.
$data['endofpage'][] = '