Ce manuel documente le client de messagerie instantanée WeeChat, il fait partie de WeeChat.
La dernière version de ce document peut être téléchargée sur cette page : http://weechat.org/doc
1. Introduction
WeeChat (Wee Enhanced Environment for Chat) est un client de discussion libre, rapide et léger, conçu pour différents systèmes d’exploitation.
Ce manuel documente l’API WeeChat des extensions, utilisée par les extensions en C pour interagir avec le cœur de WeeChat.
2. Extensions dans WeeChat
Une extension est un programme C qui peut appeler des fonctions WeeChat définies dans une interface.
Ce programme C n’a pas besoin des sources WeeChat pour être compilé et peut
être dynamiquement chargé dans WeeChat avec la commande /plugin
.
Cette extension doit être une bibliothèque dynamique, pour un chargement dynamique par le système d’exploitation. Sous GNU/Linux, le fichier a une extension ".so" et ".dll" sous Windows.
L’extension doit inclure le fichier "weechat-plugin.h" (disponible dans le code source WeeChat). Ce fichier définit les structures et types utilisés pour communiquer avec WeeChat.
2.1. Macros
L’extension doit utiliser des macros (pour définir quelques variables) :
- WEECHAT_PLUGIN_NAME("name")
-
nom de l’extension
- WEECHAT_PLUGIN_DESCRIPTION("description")
-
description courte de l’extension
- WEECHAT_PLUGIN_VERSION("1.0")
-
version de l’extension
- WEECHAT_PLUGIN_LICENSE("GPL3")
-
licence de l’extension
2.2. Fonctions principales
L’extension doit utiliser deux fonctions :
-
weechat_plugin_init
-
weechat_plugin_end
2.2.1. weechat_plugin_init
Cette fonction est appelée quand l’extension est chargée par WeeChat.
Prototype :