INSTALL

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

SYSTEM REQUIREMENTS:
1. Apache HTTP Server with Mod Rewrite
2. PHP5 (PHP6 not supported) with XMLWriter package installed and enabled
3. MySQL5 Server

INSTALLATION STEPS:
1. Create new MySQL database (`armory`, for expample) with utf8_general_ci encoding;
2. Unzip sql/wowarmory_rc1_r82.sql.7z to any folder;
3. Upload unpacked wowarmory_rc1_r82.sql into `armory` database. 
   Attention! SQL Query will take a long time while uploading, be prepare for it!
   If you get error 'MySQL server has gone away', change Query limit in MySQL server config file (my.ini (or my.cnf)).
	Google it, if you don't know what it is;
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. 82 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/armory_character_stats/wowarmory_character_stats_*.patch
   and your characters DB with provided SQL update (characters.sql - in the same folder).
   Trinity Core users: patch for TC is placed in tools/trinity_core 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. PHP5 (PHP6 не поддерживается) с установленным и подключенным пакетом XMLWriter
3. MySQL-сервер 5

ПОРЯДОК УСТАНОВКИ:
1. Создайте новую базу сервера MySQL (`armory`, к примеру) с кодировкой utf8_general_ci;
2. Распакуйте архив sql/wowarmory_rc1_r82.sql.7z в любую папку;
3. Залейте распакованный wowarmory_rc1_r82.sql в базу `armory`
   Внимание! SQL запрос будет выполняться достаточно долгое время, будьте к этому готовы!
	Если вы получаете ошибку 'MySQL Server has gone away', измените лимит запроса в конфигурационном файле сервера MySQL
	(my.ini (или my.cnf)). Используйте Google, если не знаете что это и как менять;
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' присутствуют обновления для базы (ревизии 82 и выше), вам будет необходимо так же залить их базу. 
8. Как установить и настроить 3D просмотрщик читайте в файле 3DViewer_info.txt
9. Для работы страниц персонажа вам необходимо пропатчить ядро MaNGOS файлом tools/armory_character_stats/wowarmory_character_stats_*.patch,
	 а так же, базу персонажей файлом characters.sql (в папке патча).
    Пользователи Trinity Core: патч для TC находится в папке tools/trinity_core
10. Если вы используете UNIX-систему, вам необходимо изменить права доступа к папке cache чтобы скрипт мог записывать кэшированные файлы.
11. Если у вас запущено несколько реалмов с разными серверами (MaNGOS и Trinity Core):
    Откройте файл 'includes/classes/configuration.php' и измените параметр $ArmoryConfig['multiRealm'][REALM_ID]['type'] на 'trinity' или 'mangos'.