Разработчикам плагинов Aml Pages

ВКонтакте Телеграм Форум RSS-лента

В этом разделе Вы найдете информацию по разработке плагинов Aml Pages: документация по разработке плагинов, SDK и примеры реальных плагинов c исходным кодом.

• Общие сведения
• Возможности плагинов
• Сохранение данных в Aml Pages
• Документация
• Plugin SDK
• Примеры
• Доработать плагин?
• Обратная связь
• Официальный блог Aml Pages

Общие сведения

Список возможностей плагинов достаточно обширен, краткий перечень можно посмотреть здесь.

Плагины Aml Pages - это стандартные (regular) библиотеки динамической компоновки Windows (*.DLL). DLL экспортирует определенные функции, используя которые, Aml Pages взаимодействует с плагином. Все что нужно для работы плагина:

1. Размещение в директории плагинов (субдиректория "Plugins" в директории Aml Pages).
2. Предоставлять минимальный набор функций для работы (Aml_GetPluginInfo).

Cхема работы плагинов достаточно проста.

1. Плагины предоставляют функции общего назначения для получения программой информации о плагине:
       Aml_GetPluginInfo: предоставление общей информации о плагине,
   и
       Aml_GetMenuItemInfo: предоставление информации о командах меню плагина, если плагин встраивается в меню Aml Pages.
   Функция Aml_GetMenuItemInfo необходима, только если плагин должен добавлять свои команды в меню Aml Pages.
   
   
2. Все остальные функции плагина не обязательны для реализации и зависят от назначения плагина.
   Используя специфичные функции плагин может реализовать различную функциональность: от показа обычного диалога до изменения данных документа.
   
   
3. Aml Pages предоставляет плагину сервисные функции.
   Сервисные функции, управляют самой Aml Pages, или же выполняют некоторую "рутинную" работу - т.е. представляют собой "джентльменский" набор полезных функций.
   Для вызова сервисной функции необходимо получить ее адрес в исполняемом файле AmlPages.EXE и вызввать по полученному адресу.
   Получить адрес функции можно, используя стандартный Windows API:
   GetProcAddress("ИМЯ_ФУНКЦИИ").
   
   
   Все рутинные операции по получению адресов, проверке аргументов (в отладочной версии плагина) может выполнять вспомогательный модуль APPHelper, включенный в состав SDK.

Документация

Программирование плагинов Aml Pages 9.62 сборка 2535 ^{[01 апреля, 2015]}

Документация на русском языке по программированию плагинов Aml Pages в формате HTML Help. Описание схемы работы плагинов, функций плагинов и их аргументов, включает примеры с исходными кодом.

Скачать [zip, 757K ]

COM-библиотеку для сохранения данных в документы - AmlDataSender см. здесь.

Plugin SDK

   //Пример:
   //Где-то в StdAfx.h... "..."
   #include "..."
   #include "..."
   ...
 #define AML_PAGES_PLUGIN //Определяем макрос AML_PAGES_PLUGIN, нужно, чтобы включить Plugin API. 
 #include "plugins.h" //Включаем Aml Pages Plugin API...
 #include "APPHelper.h" //заголовочный файл сервисных функций, предоставляемых плагину самой Aml Pages
//  ...

//   #include "..."

Примеры

Новые версии документации по разработке плагинов выпускаются периодически. Но есть одно "НО". Некоторые из примеров являются вполне рабочими и восстребованными плагинами и их новые версии выходят значительно чаще. Поэтому примеры, приведенные в этом разделе ниже, могут быть более новой версии, чем примеры в составе документации.

Aml Assist 3.61 ^[30/09/2024]

Плагин Aml Assist включен в стандартный дистрибутив Aml Pages. Плагин для выполнения массы рутинных операций быстро - в один-два клика. Поддерживает сохранение текста и веб страниц из Internet Explorer », Google Chrome, Mozilla Firefox, [видео-ролик] Microsoft Word, OpenOffice, Microsoft Outlook, The Bat, и очень многих других приложений. Позволяет быстро вставить файл или текст в документы Aml Pages простым перетаскиванием на панель плагина. Предлагает дополнительную плавающую панель на рабочем столе для управления Aml Pages + некоторые мелочи: быстрое открытие или импорт последних использованных файлов, мгновенное создание липких листочков, быстрое сворачивание\разворачивание окна Aml Pages, перетаскивание файлов и текста на панель плагина и многое другое. Несколько популярных способов быстрого открытия документов описаны в статье "Как мгновенно открыть документ". Этот плагин делает работу с Aml Pages более уютной и выполняет многие рутинные операции значительно быстрее и проще. Обратите внимание: Для корректного сохранения текста в формате HTML, перетаскиваемого из Firefox, рекомендуется использовать версию Firefox 3.0 и старше. Также может управлять главным окном Aml Pages и окнами других приложений. В два клика располагает окно Aml Pages и выбранное окно другого приложения рядом - это удобно, если Вам нужно перенести что-либо мышью из других приложений. Команды плагина Вы найдете в меню "Плагины\Aml Assist". Установка плагина стандартная: скачали zip-архив плагина и выбрали команду меню Aml Pages "Плагины\Установить плагин". Приложение AmlAssistDirect.exe можно использовать для запуска Aml Assist напрямую. Таким образом, можно запускать Aml Assist еще до запуска Aml Pages, например в автозагрузке Windows. После можно запустить уже из панели плагина и саму Aml Pages. Для работы плагина необходима версия Aml Pages 9.54 сборка 2482 или старше. Рекомендуется Aml Pages 9.99 сборка 2950 или старше. Скачать, [279K] Попросить исходный код Статьи об использовании Aml Assist Видео-ролик с примером использования Aml Assist Маленькие хитрости. Часть 7-ая. Aml Assist Плагин Aml Assist Наверх  |  Как установить плагин  |  Обсуждение в форуме

Рис.1.: панель Aml Assist на рабочем столе Рис.2.: настройки Aml Assist (см. в Aml Pages меню "Плагины\Aml Assist\Настройки") Демонстрационный видео-ролик

Aml Data Sender ^[30/11/2007]

DLL-библиотека для сохранения данных в документы Aml Pages в различных форматах (Plain Text, RTF, HTML, Web Archives).
Используя AmlDataSender.Dll, несложно разработать приложение, сохраняющее данные в документы Aml Pages в различных форматах. Сохранение реализовано тем же самым алгоритмом, который применяется и в популярном плагине IE2Aml. Для отправки используется COM-объект Aml  Data Sender.

Архив включает библиотеку AmlDataSender.dll и примеры на С++ (MFC, WinAPI), Visual Basic (VB6, VB.Net), Delphi.
Отдельное СПАСИБО Сергею Пуховскому aka SPP за пример на Delphi.
Скачать (Bin+Source), [ 120K ]

Table Maker 1.02 ^[13/07/2008]

Плагин от автора Aml Pages. Создание таблиц в Редакторе текста Aml Pages.
Установка: скопируйте файл TableMaker.DLL в директорию "Plugins" в папке Aml Pages И перезапустите Aml Pages. Распространяется вместе с исходным кодом.

Версии Aml Pages 9.07 и старше поддерживают работу с таблицами непосредственно сами, да причем еще и с большими возможностями.

Скачать (Bin+Source, VC++), [44 кб]

Попросить исходный код
Статьи об использовании Table Maker

Поддержка таблиц в Aml Pages 9.07

Плагины : Table Maker

FavEx 3.11 ^[01/12/2014]

FavEx это устаревший плагин.
Новые версии Aml Pages полностью сами поддерживают ссылки на разделы других документов, и более комфортными способами, например панель История.

Плагин для создания ссылок на разделы других документов в меню "Избранное". Позволяет быстро открыть документ Aml Pages и сразу перейти к нужному разделу. Позволяет создавать ссылки на другие документы в меню Избранное. Также показывает последние измененые разделы всех документов пользователя. Плагин работает интегрированно с плагином Aml Assist, добавляя свои команды и в его меню.


Установка: распакуйте библиотеку FavEx.DLL из в zip-архива в директорию "Plugins" в папке Aml Pages и выберите команду меню "Плагины\Обновить список" (если Aml Pages уже работает). Команды плагина добавляются в меню "Избранное". Для работы плагина необходима версия Aml Pages 9.22 сборка 2177 или старше.

Скачать, [128K]

 |  Попросить исходный код
См. также: Статьи об использовании FavEx

Быстрый доступ к часто используемым заметкам

Плагин FavEx

Плагин Aml Shortcut

Несколько способов мгновенно открыть документ

Aml2Pic 1.0 ^[22/09/2007]

Плагин, сохраняющий текст разделов документа Aml Pages в графические файлы (extended metafiles). Распространяется вместе с исходным кодом (VC++ 6.0). Для работы требует установленного принтера.

Установка: распакуйте библиотеку Aml2Pic.DLL из директории Release в zip-архиве в директорию "Plugins" в папке Aml Pages и выберите команду меню "Плагины\Обновить список" (если Aml Pages уже работает).

Скачать, [ 44K]

Попросить исходный код

CopyOnSel ^[18.11.2006]

Плагин от автора Aml Pages, автоматически копирующий текст в буфер обмена при изменении выделения в Редакторе текста Aml Pages. Исходный код плагина включен в состав zip-архива. Установка: скопируйте файл CopyOnSel.DLL в директорию "Plugins" в папке Aml Pages и перезапустите Aml Pages. Распространяется вместе с исходным кодом.

Скачать (Bin+Source, VC++), [44 кб]

Необходима Aml Pages 9.0.0.1824 или старше.

Line Highlighter ^[19/05/2010]

Плагин, подсвечивающий строку ввода в редакторе текста Aml Pages и автоматически скрывающий дерево при переходе в редактор текста.
Установка: скопируйте файл LineHL.DLL в директорию "Plugins" в папке Aml Pages И перезапустите Aml Pages. Распространяется вместе с исходным кодом.

Скачать (Bin+Source, VC++), [ 4.3K ]

Quotes Auto Completion 1.00 ^[04.02.2007]

Автоматически завершает «двойные» и "одинарные" кавычки при вводе текста в Aml Pages. Установка: скопируйте файл QAC.DLL в директорию "Plugins" в папке Aml Pages И перезапустите Aml Pages. Распространяется вместе с исходным кодом.

Этот плагин был разработан для ранних версий Aml Pages 9.05 и младше. Новые версии Aml Pages умеют в кавычки сами. Версии Aml Pages 10.02 build 2969 и старше поддерживают автозакрытие кавычек непосредственно сами, причем делают это лучше и удобнее. Автоматическое закрытие кавычек устанавливается в настройках Aml Pages, на вкладке "Редактор".

Настройки редактора текста в версии Aml Pages

Скачать (Bin+Source, VC++), [44 кб]

Необходима Aml Pages 9.00 cборка 1824 или старше

Наверх  |  Как установить плагин  |  Обсуждение в форуме

Exec 2.02 ^[09/04/2008]

Пример плагина. Простенький "запускатор" программ, "открыватор" документов и т.д. Вместе с исходным кодом плагина и комментариями от автора Aml Pages. Установка: скопируйте файл Exec.DLL в директорию "Plugins" в папке Aml Pages.

Скачать (Bin+Source, VC6), [45 кб]

Необходима Aml Pages 9.0.0.1746 или старше.

Para ^[01.03.2007]

Плагин от автора Aml Pages, форматирование абзацев текста.
Установка: скопируйте файл Para.DLL в директорию "Plugins" в папке Aml Pages И перезапустите Aml Pages. Распространяется вместе с исходным кодом

Скачать (Bin+Source, VC++), [43 кб]

Попросить исходный код
Необходима Aml Pages 9.0.0.1824 или старше.

Translit

Плагин от автора Aml Pages, транслитерация текста в редакторе Aml Pages. Установка: скопируйте файл Translit.DLL в директорию "Plugins" в папке Aml Pages и перезапустите Aml Pages. Распространяется вместе с исходным кодом.

"Ух и незаменимая вещь для общения в аське транслитом!!!" © Imqer

Скачать (Bin+Source, VC++), [43 кб]

Попросить исходный код
Необходима Aml Pages 9.0.0.1824 или старше.

PSBaseWinAPI

Демонстрирует базовую функциональность плагина, а также работу c некоторыми сервисными функциями Aml Pages.

Проект DLL (VC). Необходимая версия Aml Pages 9.0.0.1711 или старше.
Скачать: PSBaseWinAPI.zip [Bin+Source, 55 кб];

Обратная связь

В настоящий момент интерфейс плагинов Aml Pages активно развивается. Если у Вас возникли какие-либо вопроссы, связанные с плагинами Вы можете обратиться к автору Aml Pages:

1. Через форму обратной связи;
2. Через форум проекта Aml Pages;
3. По электронной почте проекта: amlpages@amlpages.com;
4. На личный адрес автора Aml Pages: carc@rambler.ru;

Как доработать плагин?

Вы хотите создать плагин и получить за это бесплатную регистрацию? Не знаете с чего начать? Ниже описаны некоторые идеи, до которых у авторов "руки не доходят". Вы можете как продолжить наработки авторов ("сорсами" поделимся), или же вообще создать собственный плагин с нуля. Для связи с нами Вы можете использовать электронную почту amlpages@amlpages.com или форму обратной связи.

Проверка орфографии текста

Вообще проверка орфографии это постоянная потребность пользователей. Некоторые наработки уже есть с использованием технологии Microsoft Check Speller API. Это технология реализована MS обобщенно и используется для проверки орфографии в приложениях MS Office. Удалось реализовать проверку орфографии в редакторе текста плагином Aml Speller. Но довести плагин до ума (поддержку нескольких языков, "нормальные" пользовательские диалоги) времени не хватает.

Хотите продолжить - милости просим.

Интеграция с веб-браузерами

Плагин IE2Aml сохраняет данные из Internet Explorer в документы Aml Pages непосредственно из окна браузера. Специфика плагина заключается исключительно в интеграции с IE, сама же передача данных из плагина в Aml Pages реализована обобщенно в отдельной COM-библиотеке Aml Data Sender.

С использованием библиотеки AmlDataSender.DLL можно создать и аналогичный плагин для других популярных браузеров (Opera, FireFox). Разработка подобного плагина будет сведена только к получению данных из веб-браузеров. Кстати говоря, библиотеке Aml Data Sender абсолютно "все равно" откуда отправляются данные - это может быть и MS Outlook, и MS Word, и OpenOffice да и вообще любая другая программа.

Aml Assist

Плагин Aml Assist выполняет массу операций: сохраняет в документы электронные письма из Microsoft Outlook, файлы из файловых менеджеров, текст из Microsoft Word и OpenOffice, веб страницы из Internet Explorer и Mozilla Firefox, создает липкие листочки, открывает документы, интегрирует команды других плагинов в свое меню, наконец управляет окном самой Aml Pages.
Бинарный файл плагина включен в дистрибутив самой Aml Pages. Но также плагин распространяется и отдельно, причем вместе с исходным кодом. Так что посмотреть, как он всё это "вытворяет" может каждый.

Интеграция с MS Word

Импорт документов Word это вечная проблема. Но некоторые наработки все-таки уже есть в плагине Word2Aml. Плагин импортирует данные, управляя Word`ом через OLE-автоматизацию (преобразуя данные в формат RTF). Но довести плагин для работы со всеми версиями MS Word как всегда не хватает времени.

Управление окном Aml Pages

Здесь идеи могут быть вообще безграничны. Примером такого плагина является Aml Assist. Плагин распространяется с исходным кодом и Вы легко можете его доработать.

Открытые плагины

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