Discord-API

Dieses Plugin dient als Schnittstelle zwischen weiteren Plugins und Ihrem Discord-Server. Dieses Plugin ist vor allem für Entwickler relevant. Es kann allerdings auch als Basis-Plugin für andere Plugins dienen.

Es können verschiedenen Bots angelegt werden, auf diese dann von anderen Plugins zugegriffen werden können.

Fragen und Antworten

Wie erstelle ich einen neuen Bot?

Gehe ins ACP -> Konfiguration -> Discord -> Discord-Bots -> Discord-Bot hinzufügen.

Wie kann ich die API in meinem Plugin implementieren?

Füge die Abhängigkeit zu diesem Plugin in deiner package.xml ein:

XML: package.xml
<requiredpackage minversion="1.0.0">dev.hanashi.wsc.discord-api</requiredpackage>

Erstelle einen Bot im ACP. Dieser erhält eine ID. Mit Hilfe von folgenden Code kannst du die API verwenden:

PHP
$discord = wcf\system\discord\DiscordApi::getApiByID($botID);

Die $botID musst du natürlich anpassen.

Nun kannst du mit Discord kommunizieren. Hier ein Beispiel um einen Channel abzurufen:

PHP
$discord->getChannel($channelID);

  • Discord-API 2.6.2

    • 22. Oktober 2023
    • 43,14 kB

    Technische Änderungen

    • unnötige Gateway-Testerfunktion entfernt
    • DiscordGateway überarbeitet
    • jQuery-Code entfernt

  • Discord-API 2.6.1

    • 11. September 2023
    • 44,42 kB

    Fehlerbehebung im Zusammenhang mit den Fontawesome Icons

  • Discord-API 2.6.0

    • 8. September 2023
    • 44,42 kB

    Diese Version setzt nun mindestens WSC 6.0.0 voraus.

    • Anpassungen für WSC 6.0
    • wcf\system\discord\SecretFormField ist nun deprecated und wird in einer späteren Version entfernt
    • Anpassungen für PHP 8.1/.2

  • Discord-API 2.5.1

    • 24. Oktober 2022
    • 44 kB

    Änderungen

    • Typed Propertys werden nicht mehr mit null initialisiert
    • korrekte Verwendung von unserialize
    • einfache Style-Anpassungen

    Fehlerbehebungen

    • PHP deprecation behoben

  • Discord-API 2.5.0

    • 20. Oktober 2022
    • 43,74 kB

    Neue Funktionen

    • Discord Message Flags wurden hinzugefügt
    • beim DiscordSelectOptionType kann nun ein Maximum an Kanälen über alle Server angegeben werden

    Verbesserungen

    • SQL-ANSI Standard
    • EventHandler in DiscordInteractionAction überarbeitet, die alten sind nun deprecated
    • Kommentare in den Database Objects ergänzt
    • der DiscordSelectOptionType wurde optisch überarbeitet
    • bei den Channel Types werden die Kanäle nun für 10 Sekunden gecached um Rate Limits vorzubeugen

    Fehlerbehebungen

    • die Interaction Endpoint Url im ACP war falsch
    • fehlende Sprachvariablen beim Color Option Type wurden hinzugefügt
    • es wurden keine Webhooks in einem Channel angelegt, wenn bereits von einem anderen Bot ein Webhook angelegt wurde

  • Discord-API 2.4.0

    • 17. Oktober 2022
    • 42,73 kB

    Änderungen

    • Embed Color Typ wurde umgebaut
    • es gibt eine neue Disord-Interaction-Klasse mit Events
    • importHelpers wurden auf true gesetzt
    • der Button zum einmaligen Verbinden im ACP wurde entfernt, dieser hat nur zur Verwirrung geführt
    • der Option-Type DiscordBotMultiSelectOptionType wurde überarbeitet

  • Discord-API 2.3.0

    • 29. September 2022
    • 326,14 kB

    Neue Funktionen

    • die multiple Channelliste im ACP ist nun filterbar
    • es wurde ein Konfigurationsassistent eingefügt, der beim Anlegen eines Bots unterstützt
    • die Optionen DiscordWebhookChannelMultiSelectOptionType und DiscordChannelMultiSelectOptionType unterstützen nun die extra Information channeltypes um nach bestimmten Channeltypen zu filtern

    Verbesserungen

    • Template-Formatierungen wurden vereinheitlicht
    • die Open Source Lizenz wurde in der package.xml hinzugefügt

    Fehlerbehebungen

    • in der letzten Version wurden fälchlicherweise Types für Application Command entfernt, diese wurden wieder eingefügt

  • Discord-API 2.2.0

    • 15. September 2022
    • 279,55 kB
    • FEATURE: neue Application Command API-Funktionen
    • FEATURE: neue Auto Moderation API-Funktionen
    • FEATURE: neue Forum API-Funktionen
    • FEATURE: Ergänzung vorhandener API-Funktionen

  • Discord-API 2.1.1

    • 22. Februar 2022
    • 273,92 kB
    • FIX: Embed Color Option hatte Probleme im Livemodus

  • Discord-API 2.1.0

    • 21. Februar 2022
    • 273,92 kB
    • FEATURE: Methoden für Sticker hinzugefügt
    • FEATURE: Methoden für Scheduled Events hinzugefügt
    • FEATURE: Methode für Crosspost hinzugefügt
    • FEATURE: DiscordEmbedColorOptionType hinzugefügt