AIMP Forum

AIMP for Windows => Дополнения / Addons => Плагины / Plugins => Topic started by: Soolo on January 04, 2012, 13:00:36

Title: Правила раздела "Плагины"
Post by: Soolo on January 04, 2012, 13:00:36
Незнание не освобождает от ответственности!

Сначала внимательно читаем Правила форума (https://www.aimp.ru/forum/index.php?topic=74)


Правила раздела "Плагины"

1. Для каждого плагина создавайте отдельную тему.

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

     Если плагин написан на основе AIMP Plugins API и работает только на АИМП, то в названии темы необходимо это указать:
     Для SDK for AIMP v3.60 указывайте [AIMP3.60].
     Для SDK for AIMP v4 указывайте [AIMP4].
     Для SDK for AIMP v5 указывайте [AIMP5].

     Если плагин является звуковым эффектом:
     Для VST2 указывайте [VST2]
     Для Winamp DSP указывайте [DSP]

     Структура темы:
     2.1 Название плагина;                                 
     2.2 Версия плагина;
            Пример:
            Название: Accelerometer
            Версия: 1.0
     2.3 Описание плагина со скриншотами его работы.
     2.4 Изменения в плагине (если такие имеются).
            Заметка: Если вы выкладываете новую версию своего плагина, здесь вы должны указать какие изменения вы сделали.
            Если изменений в плагине не было, этот пункт для заполнения не обязателен.
     2.5 Файл для скачивания (Добавляется при написании сообщения внизу окна в закладке "Дополнительные опции...").

3. Картинки размещайте, желательно, на специальных хостингах для картинок:
     https://imgbb.com
     https://hostingkartinok.com
     
4. Файлы плагинов прикрепляйте к сообщению, при апдейте – замените в первом сообщении на обновлённую версию.
     [Ограничение по размеру вложения 4096 кбайт]
     Плагины, размер которых превышает 1 MB, рекомендуется заливать на файлообменники:
     https://drive.google.com (требуется учётная запись)
     https://disk.yandex.ru (требуется учётная запись)
     https://cloud.mail.ru (требуется учётная запись)
     https://www.dropbox.com (требуется учётная запись)
Внимание! Выкладывать плагины нужно в виде заархивированной папки, имеющей имя файла главной .dll (подробнее... (https://www.aimp.ru/forum/index.php?topic=44978.0))

5. Плагин обязательно должен иметь название. Название плагина должно быть написано латиницей.

6. По умолчанию плагинам присваиваются следующие типы лицензий:
    - BSD 3-Clause (https://opensource.org/licenses/BSD-3-Clause);
    - другой тип лицензии, если автор укажет это в теме.

7. Любой плагин, опубликованный на форуме, может быть помещён в каталог дополнений AIMP (https://www.aimp.ru/?do=catalog&os=windows&id=2), если автор не выразит своё несогласие с этим пунктом.

8. Огромная просьба! Выкладывайте, пожалуйста, исходники плагинов, особенно, если не планируете дальнейшее развитие проекта.
     Во-первых, сам плагин получит шанс на дальнейшее развитие; во-вторых, новички смогут найти решение некоторых вопросов для новых проектов; в-третьих, меньше шанс навсегда потерять исходники (что часто случается, примеров на форуме масса).
     Исходники можно как прикрепить к теме, так и воспользоваться файлообменником.
     Так же рекомендуется использовать веб-сервисы для хостинга IT-проектов:
     https://github.com
     https://bitbucket.org

9. Заказ плагинов здесь (https://www.aimp.ru/forum/index.php?topic=25755.0). Так же можно создать отдельную тему-просьбу для обсуждения будущего функционала плагина.

10. Метки к темам:

(https://www.aimp.ru/forum/Themes/Bliss/images/post/solved.gif) - плагин опубликован (плагин для публикации);
(https://www.aimp.ru/forum/Themes/Bliss/images/post/exclamation.gif) - плагин в активной разработке;
(https://www.aimp.ru/forum/Themes/Bliss/images/post/question.gif) - тема-просьба, тема-вопрос;
(https://www.aimp.ru/forum/Themes/Bliss/images/post/smiley.gif) - есть ответ на вопрос, просьба выполнена;
(https://www.aimp.ru/forum/Themes/Bliss/images/post/lamp.gif) - плагин разработан не для AIMP;
(https://www.aimp.ru/forum/Themes/Bliss/images/post/thumbdown.gif) - плагин нестабилен, заброшен, проблемы на новых версиях АИМПа или на новых ОС.

Об изменении статуса просьба уведомлять в теме или с помощью кнопки "Сообщить модератору"!
Title: Публикация плагинов в каталоге
Post by: Soolo on January 04, 2012, 13:08:14
Внимание! Во избежание проблем с UAC, все настройки плагина нужно хранить в папке профиля пользователя AIMP (подробнее... (https://www.aimp.ru/forum/index.php?topic=38683.0)).


Что нужно для постинга плагинов в каталог?

1. Архив с файлами плагина:

Формат zip, имя  должно подчиняться следующему формату: %plugin_name%.zip (без пробелов, вместо них нужно использовать "_").
Структура архива:
.zip\%plugin_name%\%plugin_name%.dll
.zip\%plugin_name%\x64\%plugin_name%.dll
Внутри папок так же должен быть файл txt с описанием плагина и процесса установки.
[!] По возможности, на двух языках (русский, английский)


2. Файл описания:

Имя файла описания: %plugin_name%.txt (без пробелов, вместо них нужно использовать "_")
Структура файла описания:
Code: [Select]
Назначение: Декодеры, Визуализации, Расширения функционала, Удаленное управление, Разное (соответствующее, через запятую)
Версия: AIMP2, AIMP3 (соответствующие, через запятую)

Name: %plugin_name% (название плагина)
Version: 1.0 (версия плагина)
Author: %plugin_author% (автор плагина)
AuthorContact: (адрес почты / номер ICQ)
Topic: (ссылка на тему на форуме)
Description: (заметки к плагину)
[!] Заметки к плагину, по возможности, на двух языках (русский, английский)

Назначение: Расширения функционала, Удаленное управление
Версия: AIMP2, AIMP3

Name: Accelerometer
Version: 1.1.104
Author: bescheidener
AuthorContact: xxx@yyy.zzz
Topic: https://www.aimp.ru/forum/index.php?topic=19104.0
Description: Плагин для управления AIMP с помощью жестов мыши

3. Скриншот (не обязательно):

Имя файла %plugin_name%.jpg (без пробелов, вместо них нужно использовать "_")
Формат/качество JPG/85-90%
Размер 200 х 150 (с точностью до пикселя)