1. Открываем Visual Studio Express 2012 и создаем новый проект «Библиотека классов».

2. Добавляем ссылку на Interface.dll и Components.dll (находятся в корневой папке программы).

3. Объявляем новый класс, который унаследуем от Interface.IPlugin

4. Описываем информацию о плагине.

public string Name 
{ 
    get { return "Тест"; } 
} 
 
public string Version 
{ 
    get { return "1.0"; } 
} 
 
public string Author 
{ 
    get { return "Username"; } 
} 
 
public string Description 
{ 
    get { return "Тестовый плагин"; } 
} 
 
public string[] Commands 
{ 
    get { return new string[] { "!тест" }; } 
} 
 
public string[][] Help 
{ 
    /* 
    * Вывод команды в справке 
    * Первое значение - номер типа справки 
    * 1 - Основное 
    * 2 - Пользователи 
    * 3 - Игры 
    * 4 - Вип команды 
    * 5 - Админские команды 
    * 
    * Второе значение - строка выводимая в справке 
    */ 
    get { return new string[][] { new string[] { "1", Commands[0] + " - тестовая команда" } }; } 
}

Public ReadOnly Property Name As String Implements [Interface].IPlugin.Name 
    Get 
        Return "Тест" 
    End Get 
End Property 
 
Public ReadOnly Property Version As String Implements [Interface].IPlugin.Version 
    Get 
        Return "1.0" 
    End Get 
End Property 
 
Public ReadOnly Property Author As String Implements [Interface].IPlugin.Author 
    Get 
        Return "Username" 
    End Get 
End Property 
 
Public ReadOnly Property Description As String Implements [Interface].IPlugin.Description 
    Get 
        Return "Тестовый плагин" 
    End Get 
End Property 
 
Public ReadOnly Property Commands As String() Implements [Interface].IPlugin.Commands 
    Get 
        Return New String() {"!тест"} 
    End Get 
End Property 
 
Public ReadOnly Property Help As String()() Implements [Interface].IPlugin.Help 
    Get 
        'Вывод команды в справке
        'Первое значение - номер типа справки
        '1 - Основное
        '2 - Пользователи
        '3 - Игры
        '4 - Вип команды
        '5 - Админиские команды

        'Второе значение - строка выводимая в справке 
        Return New String()() {New String() {"1", Command(0) + " - тестовая команда"}} 
    End Get 
End Property

5. Ставим обработчик точки входа в плагин.

public void Main(Interface.IResult Application) 
{ 
    Application.ReceivedMessageEvent += new ReceivedMessageEventHandler(Application_ReceivedMessageEvent); 
}

Public Sub Main(Application As Interface.IResult)
    Application.ReceivedMessageEvent += New ReceivedMessageEventHandler(Application_ReceivedMessageEvent) 
End Sub

6. Прописываем обработчик события принятия сообщения.

public bool Application_ReceivedMessageEvent(object sender, Components.ReceivedMessageEventArgs eArgs) 
{ 
    // Делаем необходимые проверки 
    ((IResult)sender).SendMessage(eArgs.UIN, "Тестовое сообщение"); // Отсылаем ответ отправителю 
    return true; // Если все проверки были пройдены — возвращаем истину, иначе — ложь 
}

Public Function Application_ReceivedMessageEvent(sender As Object, eArgs As Components.ReceivedMessageEventArgs) As Boolean
    ' Делаем необходимые проверки
    DirectCast(sender, IResult).SendMessage(eArgs.UIN, "Тестовое сообщение")
    ' Отсылаем ответ отправителю
    Return True
    ' Если все проверки были пройдены — возвращаем истину, иначе — ложь 
End Function

7. Компилируем, нажав F6.

8. Копируем получившийся *.dll файл в папку /plugins.

9. Запускаем чат и проверяем успешность загрузки плагина.

Ссылка на данную страницу: http://icqmanager.net/index/doc/0-24-2

В шаблонах сообщений присутствует возможность вывода практический любой динамической информации из чата (никнейм пользователя, ID комнаты, текущего часа и т.д.), что осуществляется путем помещения переменной в код шаблона.

Все переменные по своей структуре подобны <module:type>

module — инициализирует все переменные заданного модуля (всего их 4).

type — тип переменной, для которой необходимо получить значение.

Стоит учитывать, что в шаблоне каждого сообщения доступны только те модули, которые связаны с выводом этих сообщений. К примеру, в сообщении о смене комнаты невозможно разместить данные из модуля «Викторина (quiz)». Однако, модуль «Время (time)» работает во всех шаблонах.

Ниже приводится таблица переменных для всех модулей чата.

Движок чата также поддерживает условные операторы.

Их применение бывает зачастую своеобразным, что и делает их полезным инструментом для создания уникального чата.

Синтаксис условных блоков следующий:

<?if(<expression>)?> — задает границу начала условия и выражение.

<?else?> — задает границу инверсии выражения, если первое выражение возвратило ложь, выведется то, что стоит после этого кода.

<?endif?> — задает конечную границу условия.

Пример условия:

<?if(<time:tod>='1')?>Доброй ночи<?endif?><?if(<time:tod>='2')?>Доброе утро<?endif?><?if(<time:tod>='3')?>Добрый день<?endif?><?if(<time:tod>='4')?>Добрый вечер<?endif?>

Для расширения возможности «программирования» выводимых сообщений были добавлены функции для работы со строками.

Любая из функций выполнится только в том случае, если она заключена между <? и ?>, иначе выведется обычным текстом.

Ссылка на данную страницу: http://icqmanager.net/index/doc/0-24-3

Программа чата использует функции для работы с базами данных чата (пользователи, комнаты), которые могут быть также использованы и через плагины. Набор всех этих функции расположен в единой библиотеке API.ChatManager.dll

  class Modules
  ├── class Users
  │   ├── class Get
  │   │   ├── enum TypeId
  │   │   ├── enum TypeInfo
  │   │   ├── Dictionary Operation(TypeId type, long id)
  │   ├── class Set
  │   │   ├── enum TypeId
  │   │   ├── enum TypeInfo
  │   │   ├── Operation(TypeId typeId, long id, TypeInfo typeInfo, string value)
  ├── class Rooms
  │   ├── class Get
  │   │   ├── enum TypeInfo
  │   │   ├── Dictionary Operation(long id)
  │   ├── class Set
  │   │   ├── enum TypeInfo
  └── └── └── Operation(long id, TypeInfo typeInfo, string value)

Ссылка на данную страницу: http://icqmanager.net/index/doc/0-24-4