Bots stellen gerade für den Almanach einen riesen Mehrwert da. Das haben wir mit Botmunculi und dem Waffenprojekt eindrucksvoll bewiesen. Ein Bot kann quasi alle Aufgaben übernehmen, die ein Schreiber machen kann, die keine Kreativität oder hohe Intelligenz erfordern (Wenn du sowas programmieren kannst gehts natürlich auch ;-D). Damit jeder, der mit PHP umgehen kann einen eigenen Bot programmieren kann, hat der Botmaster Death-lord bereits alles nötige programmiert, du musst nur noch deinen eigenen Einsatz programmieren.
Wenn du dich entschieden hast, einen eigenen Boteinsatz zu planen oder spezifische fragen hast sag einfach dem Botmaster Bescheid! Bei allen Fragen, die bei dir aufkommen wendest du dich bitte an mich oder die Diskussion.
Inhaltsverzeichnis
Regeln
- Jeder Bot bekommt einen eigenen Benutzer, der im Namen das Wort Bot enthält.
- Auf der Benutzerseite muss ein Link auf diese Seite vorliegen, sowie eine kurze Erklärung was ein Bot ist und was deiner macht.
- Die Arbeitsgeschwindigkeit darf nur unter Absprache mit Scharesoft 15 Bearbeitungen/Min. nicht überschreiten.
- Ein Boteinsatz muss direkt vorher im IRC Chat angekündigt werden. Während des Einsatzes herrscht Anwesenheitspflicht im Chat.
- Jeder Boteinsatz wird ebenso im den Botmaster und Scharesoft mitgeteilt werden.
- Bei Verstoß wird dein Bot aus der Ferne unverzüglich abgeschaltet.
- Jede Änderung vom Bot im Almanach muss, sofern möglich, einen erklärenden Kommentar beinhalten.
Dokumentation
Um die Dokumentation nachvollziehen zu können benötigst du die Dateien vom Botmaster.
Installation
Wichtig ist die config.php. In dieser Datei musst du die Benutzerdaten des Bots und sämtliche anderen Konfigurationsvariablen einstellen. Optionale sind als solche gekennzeichnet.
Um zu prüfen ob die Installation erfolgreich verlief, wählst du im Botmenü die Erweiterung Installation aus und startest den Vorgang, erhältst du eine Bestätigung, verlief die Installation erfolgreich (Dauert einige Sekunden). Falls nicht, kontaktiere den Botmaster oder sichte deine Logdateien.
Botmenü
Das Botmenü ist die Oberfläche des Bots. Zu dieser gelangst du über die Datei index.php. Hier siehst du einen Totmannsknopf, welcher Automatisch nach einer gewissen Zeit (Abhängig von der Geschwindigkeit) automatisch die Ausführung beendet. Durch Klick auf diesen bestätigst du deine Anwesenheit. Hierdurch wird eine ständige Aufmerksamkeit garantiert. Mit der Geschwindigkeit kannst du kontrollieren, wie oft der Bot eine Seite bearbeiten. Diese hat Auswirkungen auf den Server des Almanachs. Unter Erweiterung wählst du die gewünschte Erweiterung aus. Nun kannst du den Vorgang starten. Im Log Fenster findest du nun sämtliche Nachrichten des Bots, diese werden auch gespeichert (vgl. Logdateien).
Den Bot erweitern
Dies gelingt sehr einfach! Jedes Mal, wenn der Bot eine Aktion ausführt, ruft er die Datei deiner Extension auf. In dieser Datei kannst du dann machen was du möchtest :-)! Die Kommunikation mit dem MediaWiki gelingt über die abstrakte Klasse core, von dieser sollte die Klasse, die du für deine Erweiterung erstellst erben. Die Datei deiner Extension wird unter dem Namen den du nach dem Schema in der config.php Datei eingegeben hast in dem Ordner Extensions gespeichert (Dateiname: EXTENSIONNAME.php; Beispiel: Erweiterung: Installation. Datei: Installation.php).
Logdateien
Nichts ist wichtiger als einen kleinen Fehler im Nachhinein nach zu vollziehen und wieso er eigentlich aufgetreten ist. Dafür wird in vier verschiedenen Dateien (Im Logs Verzeichnis) alles geloggt:
- Sämtliche Meldungen im Logfenster des Botmenüs (log.txt)
- Sämtliche Fehler, die von PHP gemeldet werden (PHP_Fehler.log)
- Sämtliche Fehler, die mit core::logError Methode geloggt wurden (PHP_Fehler_Benutzerdefiniert_Gesendete_Meldungen.log)
- Sämtliche Rückgaben der API (Http_Kommunikation_Log.txt)
