INSTALL

=========================
How to install WoW Armory
=========================

SYSTEM REQUIREMENTS:
1. Apache HTTP Server with mod_rewrite
2. PHP 5 (PHP 6 is not supported) with XMLWriter package installed and enabled
3. MySQL 5 Server or higher

INSTALLATION STEPS:
1. Create new MySQL database (`armory`, for expample) with utf8_general_ci encoding;
2. Unzip sql/wowarmory_release_r{LATEST_REVISION}.sql.7z to any folder;
3. Upload unpacked wowarmory_release_r{LATEST_REVISION}.sql and wowarmory_spell_release_r{LATEST_REVISION}.sql into `armory` database.
4. Rename includes/classes/configuration.php.default to configuration.php and edit this file (read comments).
   Characters DB configs are stored in
       $ArmoryConfig['multiRealm'][1]['*_characters']
   And World DB configs are stored in
       $ArmoryConfig['multiRealm'][1]['*_mangos']
   You should edit these values according with your MySQL configs (user/password/dbname).
5. Downloads icons archive from "Downloads" on GitHub.com and unpack it to "wow-icons/_images/"
6. Unzip htaccess.zip archive and place unpacked .htaccess file to root site dir for correct scripts work.
7. If there are some sql updates in 'sql/updates' dir (rev. {LATEST_REVISION} or higher), you need to upload it to DB too.
8. For 3D Viewer installation info read 3DViewer_info.txt
9. For full work you need to patch MaNGOS core with tools/{SERVER}/wowarmory_patch.patch
   and your characters DB with provided SQL update (characters.sql - in the same folder).
10. If you use UNIX system, you need to manage access rights to allow script write data to 'cache' folder.
11. If you have diffirent servers (MaNGOS and Trinity Core):
    Open 'includes/classes/configuration.php' and edit $ArmoryConfig['multiRealm'][{REALM_ID}]['type'] to 'trinity' or 'mangos'.
	
========================
Как установить Оружейную
========================

СИСТЕМНЫЕ ТРЕБОВАНИЯ:
1. Web-сервер Apache с подключенным модулем mod_rewrite
2. PHP 5 (PHP 6 не поддерживается) с установленным и подключенным пакетом XMLWriter
3. MySQL-сервер 5 или выше.

ПОРЯДОК УСТАНОВКИ:
1. Создайте новую базу сервера MySQL (`armory`, к примеру) с кодировкой utf8_general_ci;
2. Распакуйте архив sql/wowarmory_release_r{ПОСЛЕДНЯЯ_РЕВИЗИЯ}.sql.7z в любую папку;
3. Залейте распакованный wowarmory_release_r{ПОСЛЕДНЯЯ_РЕВИЗИЯ}.sql и wowamory_spell_release_r{ПОСЛЕДНЯЯ_РЕВИЗИЯ}.sql в базу `armory`
4. Переименуйте файл includes/classes/configuration.php.default в configuration.php и отредактируйте его (см. комментарии).
   Внимание!
   Параметры подключения к базе персонажей находятся в:
       $ArmoryConfig['multiRealm'][1]['*_characters']
   Параметры подключения к игровой базе (мир) находятся в:
       $ArmoryConfig['multiRealm'][1]['*_mangos']
   Вы должны изменить значения этих параметров согласно вашим настройкам MySQL (пользователь/пароль/имя базы) 
5. Скачайте архив иконок из раздела "Downloads" на GitHub.com и распакуйте в папку "wow-icons/_images/"
6. Распакуйте архив htaccess.zip и поместите распакованный файл .htaccess в корень сайта для правильной работы скриптов.
7. Если в папке 'sql/updates' присутствуют обновления для базы (ревизии {ПОСЛЕДНЯЯ_РЕВИЗИЯ} и выше), вам будет необходимо так же залить их базу. 
8. Как установить и настроить 3D просмотрщик читайте в файле 3DViewer_info.txt
9. Для работы страниц персонажа вам необходимо пропатчить ядро MaNGOS файлом tools/{СЕРВЕР}/wowarmory_patch.patch,
	 а так же, базу персонажей файлом characters.sql (в папке патча).
10. Если вы используете UNIX-систему, вам необходимо изменить права доступа к папке cache чтобы скрипт мог записывать кэшированные файлы.
11. Если у вас запущено несколько реалмов с разными серверами (MaNGOS и Trinity Core):
    Откройте файл 'includes/classes/configuration.php' и измените параметр $ArmoryConfig['multiRealm'][{ИД_РЕАЛМА}]['type'] на 'trinity' или 'mangos'.