added a New Member Widget to let the admin pass some information to new members

[friendica-addons.git] / newmemberwidget / newmemberwidget.php

diff --git a/newmemberwidget/newmemberwidget.php b/newmemberwidget/newmemberwidget.php
new file mode 100644 (file)
index 0000000..04ca86c
--- /dev/null
+++ b/newmemberwidget/newmemberwidget.php
@@ -0,0 +1,58 @@
+<?php
+
+/***
+ * Name: New Member Widget
+ * Description: Adds a widget for new members into the sidebar of the network page. The widget will be displayed for the 1st 14days of a account existance and contains a link to the new member page and a free-form text the admin can define.
+ * Version: 1
+ * Author: Tobias Diekershoff <https://f.diekershoff.de/profile/tobias>
+ ***/
+
+require_once('include/bbcode.php');
+
+function newmemberwidget_install () {
+    register_hook( 'network_mod_init', 'addon/newmemberwidget/newmemberwidget.php', 'newmemberwidget_network_mod_init');
+    logger('newmemberwidget installed');
+}
+function newmemberwidget_uninstall () {
+    unregister_hook( 'network_mod_init', 'addon/newmemberwidget/newmemberwidget.php', 'newmemberwidget_network_mod_init');
+}
+
+function newmemberwidget_network_mod_init ( $a, $b) {
+    if (x($_SESSION['new_member'])) {
+       $t = '<div id="newmember_widget" class="widget">'.EOL;
+       $t .= '<h3>'.t('New Member').'</h3>'.EOL;
+       $t .= '<a href="newmember" id="newmemberwidget-tips">' . t('Tips for New Members') . '</a>i<br />'.EOL;
+       if (get_config('newmemberwidget','linkglobalsupport')==1)
+           $t .= '<a href="https://helpers.pyxis.uberspace.de/profile/helpers" target="_new">'.t('Global Support Forum').'</a><br />'.EOL;
+       if (get_config('newmemberwidget','linklocalsupport')==1)
+           $t .= '<a href="'.$a->get_baseurl().'/profile/'.get_config('newmemberwidget','localsupport').'" target="_new">'.t('Local Support Forum').'</a><br />'.EOL;
+       $ft = get_config('newmemberwidget','freetext');
+       if (!trim($ft)=="")
+           $t .= '<p>'.bbcode(trim($ft)).'</p>';
+       $t .= '</div><div class="clear"></div>';
+       $a->page['aside'] = $t . $a->page['aside'];
+    }
+}
+
+function newmemberwidget_plugin_admin_post( &$a ) {
+    $ft = ((x($_POST, 'freetext')) ? trim($_POST['freetext']) : "");
+    $lsn = ((x($_POST, 'localsupportname')) ? notags(trim($_POST['localsupportname'])) : "");
+    $gs = intval($_POST['linkglobalsupport']);
+    $ls = intval($_POST['linklocalsupport']);
+    set_config ( 'newmemberwidget', 'freetext',           trim($ft));
+    set_config ( 'newmemberwidget', 'linkglobalsupport',  $gs);
+    set_config ( 'newmemberwidget', 'linklocalsupport',   $ls);
+    set_config ( 'newmemberwidget', 'localsupport',       trim($lsn));
+}
+
+function newmemberwidget_plugin_admin(&$a, &$o){
+    $t = get_markup_template('admin.tpl','addon/newmemberwidget');
+    $o = replace_macros($t, array(
+       '$submit' => t('Save Settings'),
+       '$freetext' => array( "freetext", t("Message"), get_config( "newmemberwidget", "freetext" ), t("Your message for new members. You can use bbcode here.")),
+       '$linkglobalsupport' => array( "linkglobalsupport", t('Add a link to global support forum'), get_config( 'newmemberwidget', 'linkglobalsupport'), t('Should a link to the global support forum be displayed?')." (<a href='https://helpers.pyxis.uberspace.de/profile/helpers'>@helpers</a>)"),
+       '$linklocalsupport' => array( "linklocalsupport", t('Add a link to the local support forum'), get_config( 'newmemberwidget', 'linklocalsupport'), t('If you have a local support forum and wand to have a link displayed in the widget, check this box.')),
+       '$localsupportname' => array( "localsupportname", t('Name of the local support group'), get_config( 'newmemberwidget', 'localsupport'), t('If you checked the above, specify the <em>nickname</em> of the local support group here (i.e. helpers)')),
+    ));
+}
+