PS PM-System

<div class="markdown-heading" dir="auto"> <h1 class="heading-element" dir="auto" tabindex="-1">PS PM-System</h1> <a id="user-content-ps-pm-system" class="anchor" href="https://github.com/Power-Source/private-messaging#ps-pm-system" aria-label="Permalink: PS PM-System"></a></div> <p dir="auto">Private Nachrichten fuer ClassicPress. Das PS PM-System gibt Mitgliedern einen geschuetzten Posteingang, direkte Konversationen und private Dateifreigabe direkt im Frontend.</p> <div class="markdown-heading" dir="auto"> <h2 class="heading-element" dir="auto" tabindex="-1">Funktionsumfang</h2> <a id="user-content-funktionsumfang" class="anchor" href="https://github.com/Power-Source/private-messaging#funktionsumfang" aria-label="Permalink: Funktionsumfang"></a></div> <ul dir="auto"> <li>Posteingang mit Suche, ungelesenen Nachrichten, gesendeten Nachrichten und Archiv</li> <li>Neue Nachrichten aus dem Posteingang, der Admin-Bar oder per "Message Me"-Schaltflaeche schreiben</li> <li>Konversationen archivieren oder loeschen</li> <li>Lesebestaetigungen je Benutzer aktivieren oder deaktivieren</li> <li>Private Anhaenge wie Bilder, Videos und Dokumente sicher innerhalb einer Unterhaltung teilen</li> <li>Speicherlimit pro Benutzer fuer Nachrichtenanhaenge verwalten</li> <li>Benutzerliste zum Blockieren eingehender Nachrichten pflegen</li> <li>Responsive Frontend-Oberflaeche fuer Desktop und Mobilgeraete</li> </ul> <div class="markdown-heading" dir="auto"> <h2 class="heading-element" dir="auto" tabindex="-1">Voraussetzungen</h2> <a id="user-content-voraussetzungen" class="anchor" href="https://github.com/Power-Source/private-messaging#voraussetzungen" aria-label="Permalink: Voraussetzungen"></a></div> <ul dir="auto"> <li>ClassicPress 2.6 oder neuer</li> <li>PHP mit den fuer ClassicPress erforderlichen Erweiterungen</li> <li>Ein angemeldeter Benutzer fuer Posteingang, Versand und Dateianhaenge</li> </ul> <div class="markdown-heading" dir="auto"> <h2 class="heading-element" dir="auto" tabindex="-1">Installation</h2> <a id="user-content-installation" class="anchor" href="https://github.com/Power-Source/private-messaging#installation" aria-label="Permalink: Installation"></a></div> <ol dir="auto"> <li>Den Ordner <code>private-messaging</code> nach <code>wp-content/plugins/</code> kopieren und das Plugin in ClassicPress aktivieren.</li> <li>Im Backend unter <strong>Messaging &gt; Settings</strong> eine Posteingangsseite auswaehlen oder erstellen lassen.</li> <li>Die Seite mit dem Posteingang aufrufen und eine Testnachricht zwischen zwei Benutzerkonten senden.</li> <li>Optional Add-ons in der Add-on-Verwaltung von Messaging aktivieren und ihre Einstellungen pruefen.</li> </ol> <p dir="auto">Der Posteingang kann auch mit dem Shortcode <code>[message_inbox]</code> auf einer Seite ausgegeben werden.</p> <div class="markdown-heading" dir="auto"> <h2 class="heading-element" dir="auto" tabindex="-1">Bedienung</h2> <a id="user-content-bedienung" class="anchor" href="https://github.com/Power-Source/private-messaging#bedienung" aria-label="Permalink: Bedienung"></a></div> <div class="markdown-heading" dir="auto"> <h3 class="heading-element" dir="auto" tabindex="-1">Nachrichten</h3> <a id="user-content-nachrichten" class="anchor" href="https://github.com/Power-Source/private-messaging#nachrichten" aria-label="Permalink: Nachrichten"></a></div> <p dir="auto">Im Posteingang kann eine Unterhaltung geoeffnet, beantwortet, archiviert oder geloescht werden. Die linke Liste zeigt Absender, Betreff, Anhang und Sendezeit; die Unterhaltung selbst erhaelt den groessten Teil der verfuegbaren Flaeche.</p> <div class="markdown-heading" dir="auto"> <h3 class="heading-element" dir="auto" tabindex="-1">Einstellungen</h3> <a id="user-content-einstellungen" class="anchor" href="https://github.com/Power-Source/private-messaging#einstellungen" aria-label="Permalink: Einstellungen"></a></div> <p dir="auto">Benutzer verwalten Lesebestaetigungen direkt im Reiter <strong>Einstellungen</strong>. Bei aktivierter Blockliste wird pro Zeile ein Benutzername eingetragen. Diese Benutzer koennen dem aktuellen Konto keine Nachricht senden.</p> <div class="markdown-heading" dir="auto"> <h3 class="heading-element" dir="auto" tabindex="-1">Anhaenge</h3> <a id="user-content-anhaenge" class="anchor" href="https://github.com/Power-Source/private-messaging#anhaenge" aria-label="Permalink: Anhaenge"></a></div> <p dir="auto">Anhaenge sind an die jeweilige Unterhaltung gebunden. Nur Teilnehmer einer Unterhaltung koennen auf deren Dateien zugreifen. Rollen und Speicherlimits werden in den Messaging-Einstellungen verwaltet.</p> <div class="markdown-heading" dir="auto"> <h2 class="heading-element" dir="auto" tabindex="-1">Add-ons</h2> <a id="user-content-add-ons" class="anchor" href="https://github.com/Power-Source/private-messaging#add-ons" aria-label="Permalink: Add-ons"></a></div> <table> <thead> <tr> <th>Add-on</th> <th>Zweck</th> </tr> </thead> <tbody> <tr> <td>bbPress Integration</td> <td>Fuegt in bbPress-Themen eine Schaltflaeche fuer Direktnachrichten hinzu.</td> </tr> <tr> <td>Blacklist</td> <td>Blockiert Nachrichten von eingetragenen Benutzern.</td> </tr> <tr> <td>Sendeberechtigungen</td> <td>Beschraenkt den Nachrichtenversand auf festgelegte ClassicPress-Rollen.</td> </tr> <tr> <td>Benachrichtigungen</td> <td>Zeigt Benachrichtigungen fuer neue Nachrichten.</td> </tr> <tr> <td>WYSIWYG</td> <td>Stellt einen Editor fuer formatierte Nachrichten bereit.</td> </tr> <tr> <td>Broadcast</td> <td>Versendet Nachrichten an mehrere bzw. alle Benutzer.</td> </tr> <tr> <td>Gruppengespraech (Beta)</td> <td>Ermoeglicht Unterhaltungen mit mehreren Teilnehmern.</td> </tr> <tr> <td>Bad Words Filter</td> <td>Filtert konfigurierte Begriffe aus Nachrichteninhalten.</td> </tr> </tbody> </table> <div class="markdown-heading" dir="auto"> <h2 class="heading-element" dir="auto" tabindex="-1">PSOURCE-Integration</h2> <a id="user-content-psource-integration" class="anchor" href="https://github.com/Power-Source/private-messaging#psource-integration" aria-label="Permalink: PSOURCE-Integration"></a></div> <div class="markdown-heading" dir="auto"> <h3 class="heading-element" dir="auto" tabindex="-1">PS Community</h3> <a id="user-content-ps-community" class="anchor" href="https://github.com/Power-Source/private-messaging#ps-community" aria-label="Permalink: PS Community"></a></div> <p dir="auto">Wenn PS Community mit dem Medienmodul aktiv ist, erweitert das PM-System die Anhangsansicht:</p> <ul dir="auto"> <li>Bilder und Videos lassen sich in der Community-Medienansicht oeffnen.</li> <li>Eigene, kompatible Anhaenge koennen aus einer Unterhaltung in eine eigene PS-Community-Galerie uebernommen werden.</li> <li>Die Galerieauswahl beschraenkt sich auf Galerien des angemeldeten Benutzers; Systemgalerien und fremde Galerien stehen nicht zur Auswahl.</li> </ul> <p dir="auto">Die Einbindung ist optional. Ohne PS Community bleibt der private Versand und Download von Anhaengen voll funktionsfaehig.</p> <p dir="auto">PS Community kann das PM-System ausserdem als Profil-Reiter integrieren. Diese Profilintegration wird von PS Community konfiguriert und setzt voraus, dass beide Plugins aktiv sind.</p> <div class="markdown-heading" dir="auto"> <h3 class="heading-element" dir="auto" tabindex="-1">ClassicPress-Avatare und PS Community</h3> <a id="user-content-classicpress-avatare-und-ps-community" class="anchor" href="https://github.com/Power-Source/private-messaging#classicpress-avatare-und-ps-community" aria-label="Permalink: ClassicPress-Avatare und PS Community"></a></div> <p dir="auto">Das PM-System verwendet die ClassicPress-Funktion <code>get_avatar()</code>. Ist der Avatar-Filter von PS Community aktiv, erscheinen Community-Profilbilder deshalb automatisch in Nachrichtenlisten und Unterhaltungen. Gibt es kein verfuegbares Avatarbild, zeigt das PM-System Initialen als Fallback.</p> <div class="markdown-heading" dir="auto"> <h3 class="heading-element" dir="auto" tabindex="-1">bbPress</h3> <a id="user-content-bbpress" class="anchor" href="https://github.com/Power-Source/private-messaging#bbpress" aria-label="Permalink: bbPress"></a></div> <p dir="auto">Mit aktivem bbPress-Add-on koennen Mitglieder aus Themen heraus eine private Nachricht an andere Teilnehmer starten. Die Berechtigungen des PM-Systems gelten weiterhin.</p> <div class="markdown-heading" dir="auto"> <h2 class="heading-element" dir="auto" tabindex="-1">Datenschutz und Sicherheit</h2> <a id="user-content-datenschutz-und-sicherheit" class="anchor" href="https://github.com/Power-Source/private-messaging#datenschutz-und-sicherheit" aria-label="Permalink: Datenschutz und Sicherheit"></a></div> <ul dir="auto"> <li>Nachrichten und Anhaenge sind fuer die Teilnehmer der jeweiligen Unterhaltung bestimmt.</li> <li>E-Mail-Benachrichtigungen und Lesebestaetigungen lassen sich durch Benutzer und Administratoren steuern.</li> <li>Die Datenschutzerklaerung des Plugins beschreibt die gespeicherten Nachrichten-, Status- und Anhangsdaten genauer.</li> <li>Fuer produktive Seiten sollten Rollen, Anhangsberechtigungen, Speicherlimits und die Datenschutzerklaerung vor der Freischaltung geprueft werden.</li> </ul> <div class="markdown-heading" dir="auto"> <h2 class="heading-element" dir="auto" tabindex="-1">Entwicklung</h2> <a id="user-content-entwicklung" class="anchor" href="https://github.com/Power-Source/private-messaging#entwicklung" aria-label="Permalink: Entwicklung"></a></div> <p dir="auto">Die Styles werden aus <code>assets/main.css</code> erzeugt:</p> <div class="highlight highlight-source-shell notranslate position-relative overflow-auto" dir="auto"> <pre>npm install npm run build</pre> <div class="zeroclipboard-container"></div> </div> <p dir="auto">Der Build aktualisiert <code>assets/main.min.css</code>. Lokale Node-Abhaengigkeiten liegen in <code>node_modules/</code> und werden nicht versioniert.</p> <div class="markdown-heading" dir="auto"> <h2 class="heading-element" dir="auto" tabindex="-1">Lizenz</h2> <a id="user-content-lizenz" class="anchor" href="https://github.com/Power-Source/private-messaging#lizenz" aria-label="Permalink: Lizenz"></a></div> <p dir="auto">GPL-2.0-or-later. Siehe die Plugin-Kopfzeile in <code>messaging.php</code> und die Datei <code>readme.txt</code>.</p>