Twitch-Login
Diese Erweiterung ergänzt den Login mit Twitch.
TeamSpeak-API
Dieses Plugin dient als Schnittstelle zwischen weiteren Plugins und Ihrem TeamSpeak-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 Server-Verbindungen eingestellt werden, auf diese dann von anderen Plugins zugegriffen werden können.
Fragen und Antworten
Wie erstelle ich eine neue Verbindung?
Gehe ins ACP -> Konfiguration -> TeamSpeak -> Server -> TeamSpeak-Server 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.5.2">eu.hanashi.wsc.teamspeak-api</requiredpackage>Lass deine Nutzer die Serververbindung im ACP mit Hilfe der option.xml auswählen:
XML: option.xml
<option name="my_plugin_teamspeak_identity">
<categoryname>my_category</categoryname>
<optiontype>TeamSpeakConnectionSelect</optiontype>
</option>Den Namen (im Beispiel my_plugin_teamspeak_identity) und die richtige Kategorie (im Beispiel my_category) musst du natürlich selbst wählen.
Nun erstellst du eine PHP-Klasse im Verzeichnis lib/system/teamspeak welche die Klasse AbstractTeamSpeakHandler erbt:
PHP: MyPluginTeamSpeakHandler.class.php
<?php
namespace wcf\system\teamspeak;
class MyPluginTeamSpeakHandler extends AbstractTeamSpeakHandler {
protected $teamspeakID = MY_PLUGIN_TEAMSPEAK_IDENTITIY;
}Den Datei- und Klassennamen darfst du natürlich selbst wählen. Vergiss dabei nicht die richtige Konstante anstatt MY_PLUGIN_TEAMSPEAK_IDENTITIY einzusetzen.
Nun kannst du in anderen Klassen auf die TeamSpeak-API zugreifen. Hier ein Beispiel in einer Action-Klasse:
PHP: MyAction.class.php
<?php
namespace wcf\action;
use wcf\system\teamspeak\MyPluginTeamSpeakHandler;
class MyAction extends AbstractAction {
public function execute() {
parent::execute();
// TeamSpeak-Befehl: serverlist
$serverlist = MyPluginTeamSpeakHandler::getInstance()->serverlist();
// TeamSpeak-Befehl: clientlist -uid -country
$clientlist = MyPluginTeamSpeakHandler::getInstance()->clientlist(['-uid', '-country']);
// TeamSpeak-Befehl: sendtextmessage targetmode=1 target=1 msg=Hello\sWorld!
MyPluginTeamSpeakHandler::getInstance()->sendtextmessage(['targetmode' => 1, 'target' => 1, 'msg' => 'Hello World!']);
}
}Wie führe ich einen TeamSpeak-Befehl aus?
Der TeamSpeak-Befehl ist immer gleich der Methode. Die Parameter werden als Array an die Parameter übergeben. Hier einige Beispiele:
PHP
<?php
use wcf\system\teamspeak\MyPluginTeamSpeakHandler;
// TemSpeak-Befehl: serverlist
MyPluginTeamSpeakHandler::getInstance()->serverlist();
// TemSpeak-Befehl: clientlist -uid -away -groups
MyPluginTeamSpeakHandler::getInstance()->clientlist(['-uid', '-away', '-groups']);
// TemSpeak-Befehl: clientdbfind pattern=Hanashi
MyPluginTeamSpeakHandler::getInstance()->clientdbfind(['pattern' => 'Hanashi']);
// TemSpeak-Befehl: clientdbfind pattern=FPMPSC6MXqXq751dX7BKV0JniSo= -uid
MyPluginTeamSpeakHandler::getInstance()->clientdbfind(['pattern' => 'FPMPSC6MXqXq751dX7BKV0JniSo=', '-uid']);
// TemSpeak-Befehl: sendtextmessage targetmode=2 target=12 msg=Hello\sWorld!
MyPluginTeamSpeakHandler::getInstance()->sendtextmessage(['targetmode' => 2, 'target' => 12, 'msg' => 'Hello World!']);-
TeamSpeak-API 3.0.2
- 21. März 2023
- 2,41 MB
Fehlerbehebung
- behebt die Sicherheitslücke CVE-2023-27560 in phpseclib
-
TeamSpeak-API 3.0.1
- 30. September 2022
- 385,28 kB
Verbesserungen
- Codestyle-Anpassungen
- Primary Key in Install-Script hinzugefügt
- TypeScript Formatierung (siehe Repository)
- phpseclib aktualisiert
- XML-Stil vereinheitlicht
- Template-Formatierung vereinheitlicht
Fehlerbehebung
- im ACP Menü war eine falsche Seite zum Anlegen eines TeamSpeak-Servers verlinkt
-
TeamSpeak-API 3.0.0
- 16. Juli 2021
- 370,59 kB
Achtung: Es wird nun mindestens WoltLab Suite 5.3 vorausgesetzt.
- CHANGE: Umstellung auf Database PHP API
- CHANGE: Umstellung auf FormBuilder
- CHANGE: ungenutzte uses entfernt
- CHANGE: Umstellung auf GuzzleHttp für HTTP/HTTPS-Query
- CHANGE: Umstellung des JavaScript-Codes auf TypeScript
- CHANGE: phpseclib2 auf phpseclib3 aktualisiert
- FEATURE: Query-Passwort wird beim Bearbeiten des Servers im ACP nicht mehr ausgegeben
- FEATURE: bessere Auswahl der TeamSpeak-Server
- FEATURE: bessere Fehlerausgabe wenn Server nicht angelegt werden kann
-
TeamSpeak-API 2.1.1
- 15. Juli 2021
- 252,03 kB
- CHANGE: Umstellung auf PSR-12
-
TeamSpeak-API 2.1.0
- 19. November 2020
- 252,36 kB
- FIX: Parameter bei HTTP/HTTPS-Query wurden falsch übergeben
- FIX: Infinite Loop
- FEATURE: Voraussetzungen für multiplen Server Select eingebaut
-
TeamSpeak-API 2.0.0
- 26. Oktober 2020
- 1,39 MB
- FEATURE: die Nutzung von HTTP- und HTTPS-Server-Querys ist nun möglich
- CHANGE: Rohe Rückgaben beim execute wurden entfernt
- CHANGE: Code-Optimierungen
-
TeamSpeak-API 1.5.7
- 13. Mai 2020
- 249,55 kB
FIX: Deprecated PHP 7.4 function
-
TeamSpeak-API 1.5.6
- 18. April 2020
- 249,67 kB
Mit SSH wurde fälschlicherweise eine ErrorException anstatt einer TeamSpeakException ausgegeben
-
TeamSpeak-API 1.5.5
- 10. März 2020
- 251,12 kB
Verbesserte Ausgabe bei Fehlern zum Besseren Debugging.
-
TeamSpeak-API 1.5.4
- 13. Juli 2019
- 251,24 kB
- CHANGE; Umstellung auf MEDIUMINT damit höhere Ports verwendet werden können
