Скрипт — разработчикам: различия между версиями

Если вы не нашли в этом материале нужную информацию, но сами докопались до истины - добавьте информацию для других разработчиков. Если не получилось разобратся - пишите <nick>Bick</nick>

*В функцию-точку входа может передаватся один параметр с настройками скрипта. Но об этом ниже.

*Не добавляйте проверку адреса странички. Если на странице, которую открыл пользователь ваш скрипт не должен работать - он не будет зарошен.

Чтобы гарантировать игрокам безопасность, перед добавлением в каталог все скрипты проверяются модераторами скриптов. Для безболезненной проверки и гарантированого добавления скрипта, он должен соблюдать такие правила:

*Скрипт не должен нарушать текущие [http://www.ganjawars.ru/help/index.php?sid=91&pid=2 Правила игры], в особенности пункт касающийся [http://www.ganjawars.ru/help/index.php?sid=91&pid=2#p33 использования автоматических скриптов]. Если вы не уверены - проконсультируйтесь с представителями синдиката <synd>1321 GW - Полиция</synd>.

*Скрипт не должен вредить его пользователям (продавать вещи,выполнять рассылку писем, переводить деньги и другое без подтверждения пользоваеля).

*С целью обезопасить пользователей от вредоносного кода старйтесь минимально исопльзовать подключение скриптов или других данных со сторонних сайтов. Если есть необходимость - пишите <nick>Bick</nick> и картинки/широкоиспользуемые js библиотеки будут размещены на сайте GanjaWiki (их список внизу этой страницы).

В GanjaScripts существует 2 понятия - '''Скрипт''' и '''Версия'''. Однажды добавив скрипт, вы можете добавлять к нему новые версии.

*'''Название''' - Название скрипта в котологе. Длина не должна превышать 50 символов, название должно быть уникальным и не содержать служебных конструкций языков программирования. Допускаются названия на русском языке. Обязательно для заполнения.

*'''Короткое описание''' - Описание которое будет видно в каталоге. Длина не должна превышать 90 символов,не должно содержать служебных конструкций языков программирования. Обязательно для заполнения. Вы сможете изменить это поле в будущем.

*'''Описание''' - Полное описание, которое будет видно на страничке информации скрипта. Длина не должна превышать 600 символов,не должно содержать служебных конструкций языков программирования. Вы сможете изменить это поле в будущем.

*'''Статья в Вики''' - Название статьи в GanjaWiki, посвященной этому скрипту. Не обязательно, но крайне желательно для заполнения. ''Внимание: не указывайте адрес. Только название''. Вы сможете изменить это поле в будущем.

*'''Название версии''' - Например - ''1.00'' или ''0.9 Beta''. Длина до 10 символов. Вы не сможете изменить это поле в будущем.

*'''Файл настроек''' - html-файл для настройки скрипта. Про него читайте ниже. Не обязательно указывать. Вы не сможете изменить это поле в будущем.

*''Файл скрипта'' - js-файл с кодом скрипта. Его вы тоже не сможете изменить. Обязательно для заполнения.

*''Работает на'' - Маска адресов страниц, на которых будет работать скрипт. Строка ''http://www.ganjawars.ru/info.php*'' означает что скрипт выполняется только на страничках информации персонажа. Обязательно для заполения. Не забывайте указывать префикс ''http://www''. Невозможно изменить в будущем.

*'''Название класа''' - Название функции-точки входа в скрипт. Обязательно для заполнения.

*'''Функции''' - Список функций данной версии, разделённых '';''. Не обязательно заполнять, можно изменить в будущем.

В будущем, при добавлении новых функций в скрипт - просто создайте новую версию.

На страничку [http://www.ganjawiki.ru/scripts/author.php Авторам] вы увидете список всех ваших скриптов. Нажав на название скрипта вы можете:

Где-то выше упоминалось о том, что в функцию-точку входа может быть передан один параметр - настройки скрипта. Этот параметр представляет из себя обьект, свойства которого - переменные из файла настроек. Для примера файла настроек выше будет создан такой и передан в скрипт обьект со свойствами ''object.var1'' и ''object.testvar2'', а скрипт который будет принимать эти значения и выводить их alertom будет выглядеть так:

При создании файла настроек старайтесь сделать его максимально удобным для пользователя. Например если пользователь должен выбрать звук на какое-то событие - повторите форму из [http://www.ganjawars.ru/info.edit.php Личных настроек] ГВ с возможностью прослушивания выбраного звука.

Если вам надо как-то обрабатывать введеные пользователем данные прямо на страничке настроек - форма ввода настроек имеет ''name=settingsform''.

Где UIN - номер ICQ на который отправлять сообщений, MESSAGE - текст сообщения ('''без исопльзования кириллицы''', в ближайшее время это условие уберём).

Сообщение дойдёт пользователю через 0-15 секунд (100% не более чем через 15).

''Не пытайтесь использовать эту возможность в сторонних скриптах используя интерфейс GanjaScripts, и не используйте для рассылок. Мы ведём подробные протоколы исопльзования.''

*[http://www.ganjawiki.ru/scripts/libs/prototype.js prototype.js] - взят с [[http://www.prototypejs.org/assets/2007/1/18/prototype.js http://www.prototypejs.org/assets/2007/1/18/prototype.js]]