From 427ad3ebe2067454e837a2810081402fe601d98e Mon Sep 17 00:00:00 2001
From: loma-one <loma-one@noreply.git.friendi.ca>
Date: Sat, 7 Dec 2024 21:39:13 +0100
Subject: [PATCH] Signatur Addon

This addon allows users to create a signature.

Users can decide whether the signature should appear under a post or additionally under a comment.
---
 signatur/signatur.php | 148 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 148 insertions(+)
 create mode 100644 signatur/signatur.php

diff --git a/signatur/signatur.php b/signatur/signatur.php
new file mode 100644
index 00000000..4c1d9c9a
--- /dev/null
+++ b/signatur/signatur.php
@@ -0,0 +1,148 @@
+<?php
+/*
+ * Name: signatur
+ * Description: Automatically adds a signature to new posts. Admins can define a default signature, and users can configure their own.
+ * Version: 1.2
+ * Author: Matthias Ebers <https://loma.ml/profile/feb>
+ * Status: Beta
+ */
+
+use Friendica\Core\Hook;
+use Friendica\Core\Renderer;
+use Friendica\DI;
+
+function signatur_install()
+{
+    Hook::register('post_local', __FILE__, 'signatur_add_signature');
+    Hook::register('addon_settings', __FILE__, 'signatur_user_settings');
+    Hook::register('addon_settings_post', __FILE__, 'signatur_user_settings_post');
+    Hook::register('addon_admin', __FILE__, 'signatur_admin_settings');
+    Hook::register('addon_admin_post', __FILE__, 'signatur_admin_settings_post');
+}
+
+/**
+ * Adds a signature to new posts.
+ *
+ * @param array &$b Post data.
+ */
+function signatur_add_signature(array &$b)
+{
+    if (!$b['uid']) {
+        return;
+    }
+
+    // Check if the signature feature is enabled for the user
+    $enabled = DI::pConfig()->get($b['uid'], 'signatur', 'enabled', false);
+    if (!$enabled) {
+        return;
+    }
+
+    // Check if the post is a comment
+    if (isset($b['parent']) && $b['parent'] != $b['uri-id']) {
+        // Check if the signature should be added to comments
+        $enable_signature_in_comments = DI::pConfig()->get($b['uid'], 'signatur', 'enable_signature_in_comments', true);
+        if (!$enable_signature_in_comments) {
+            return;
+        }
+    }
+
+    // Get the user's custom signature or the admin default
+    $signature = DI::pConfig()->get($b['uid'], 'signatur', 'text') ??
+                 DI::config()->get('signatur', 'default_text', "---\nDefault Signature");
+
+    // Define the marker as [hr] (horizontal rule)
+    $signature_marker = "[hr]";
+
+    // Check if the marker is already present in the post body
+    if (strpos($b['body'], $signature_marker) !== false) {
+        return; // Signature already exists, do not add it again
+    }
+
+    // Append the signature with the [hr] marker
+    if (!empty($b['body'])) {
+        $b['body'] .= "\n\n{$signature_marker}\n{$signature}";
+    }
+}
+
+/**
+ * User settings for the app.
+ *
+ * @param array &$data Settings data for rendering.
+ */
+function signatur_user_settings(array &$data)
+{
+    if (!DI::userSession()->getLocalUserId()) {
+        return;
+    }
+
+    $uid = DI::userSession()->getLocalUserId();
+    $enabled = DI::pConfig()->get($uid, 'signatur', 'enabled', false);
+    $signature = DI::pConfig()->get($uid, 'signatur', 'text', '');
+    $enable_signature_in_comments = DI::pConfig()->get($uid, 'signatur', 'enable_signature_in_comments', true);
+
+    $t = Renderer::getMarkupTemplate('settings.tpl', 'addon/signatur/');
+    $html = Renderer::replaceMacros($t, [
+        '$description' => DI::l10n()->t('Add a signature to your posts.'),
+        '$enabled'     => ['enabled', DI::l10n()->t('Enable Signature'), $enabled],
+        '$signature'   => ['text', DI::l10n()->t('Your Signature'), $signature, DI::l10n()->t('Enter your custom signature. (Multiline allowed)')],
+        '$enable_signature_in_comments' => ['enable_signature_in_comments', DI::l10n()->t('Enable Signature in Comments'), $enable_signature_in_comments],
+        '$submit'      => DI::l10n()->t('Save'),
+    ]);
+
+    $data = [
+        'addon' => 'signatur',
+        'title' => DI::l10n()->t('Signature Settings'),
+        'html'  => $html,
+    ];
+}
+
+/**
+ * Saves user settings.
+ *
+ * @param array &$b Submitted data.
+ */
+function signatur_user_settings_post(array &$b)
+{
+    if (!DI::userSession()->getLocalUserId() || empty($_POST['signatur-submit'])) {
+        return;
+    }
+
+    $uid = DI::userSession()->getLocalUserId();
+    $enabled = !empty($_POST['enabled']);
+    $signature = trim($_POST['text']);
+    $enable_signature_in_comments = !empty($_POST['enable_signature_in_comments']);
+
+    DI::pConfig()->set($uid, 'signatur', 'enabled', $enabled);
+    DI::pConfig()->set($uid, 'signatur', 'text', $signature);
+    DI::pConfig()->set($uid, 'signatur', 'enable_signature_in_comments', $enable_signature_in_comments);
+}
+
+/**
+ * Admin settings for the app.
+ *
+ * @param string &$o Output string for rendering.
+ */
+function signatur_admin_settings(string &$o)
+{
+    $default_text = DI::config()->get('signatur', 'default_text', "---\nDefault Admin Signature");
+
+    $t = Renderer::getMarkupTemplate('admin.tpl', 'addon/signatur/');
+    $o = Renderer::replaceMacros($t, [
+        '$description' => DI::l10n()->t('Set the default signature for users who have not defined their own.'),
+        '$default_text' => ['default_text', DI::l10n()->t('Default Signature'), $default_text, DI::l10n()->t('This will be used if users do not set their own signature.')],
+        '$submit'      => DI::l10n()->t('Save'),
+    ]);
+}
+
+/**
+ * Saves admin settings.
+ */
+function signatur_admin_settings_post()
+{
+    if (empty($_POST['signatur-admin-submit'])) {
+        return;
+    }
+
+    $default_text = trim($_POST['default_text']);
+    DI::config()->set('signatur', 'default_text', $default_text);
+}