WebDiplomacy/README.txt

Проект "webDiplomacy" является частью материалов лаборатории создания сайтов.

webDiplomacy readme, для вебмастеров:

Примечание для игроков (Note to players)

webDiplomacy doesn't have an install wizard which checks and installs everything for you, the code is made available mainly for developers who want to create unique webDiplomacy servers (e.g. with unique translations or rule variants), or work on the official code. If your only experience of PHP and MySQL is installing phpBB, say, you may have trouble with this software.

If you just want to play with friends try to find an existing webDiplomacy server and set up a private game there. (http://webdiplomacy.net/ is the official server.)

webDiplomacy не имеет мастера установки, который проверяет и устанавливает всё за вас. Код предоставлен в основном для разработчиков, которые хотят создать уникальные серверы webDiplomacy (например, с переводом или редким вариантом), или работать над официальным кодом. Если ваш единственный опыт PHP и MySQL устанавливает PhpBB, скажем, вас могут возникнуть проблемы с это программное обеспечение.

Если вы просто хотите играть с друзьями попробовать найти существующий сервер webDiplomacy и создать частных игре (http://webdiplomacy.net/ является официальным сервером).

Требования к ПО (requirements)

- PHP 5.2+

• MySQL 5, with support for MyISAM, InnoDB, and memory tables
• The GD 2 PHP extension, with FreeType support
• Ability to send e-mail from the server (Access to an SMTP server or sendmail)
• Quite a bit of disk space (depending on the expected size of the server; if

your hosting space is measured in MB you may not have enough)

• Quite a bit of processing power (if you've only got an account with an oversold

shared-hosting company you may have problems; webDiplomacy probably uses more resources per user than, say, phpBB)

• Ability to set up a crontab to fetch a web-page every 5 minutes or so, to run

the game processing / server maintenance script

• PHP 5.2 +
• MySQL 5, с поддержкой MyISAM, InnoDB, и память таблицы
• GD 2 PHP расширения, с поддержкой FreeType
• Возможность отправлять сообщения электронной почты с сервера (доступ к серверу SMTP или Sendmail)
• Совсем немного места на диске (в зависимости от ожидаемого размера сервера, если

хостинг пространство измеряется в мегабайтах вас может не хватить)

• Совсем немного вычислительной мощности (если Вы только получили счета с перепроданности

общие-хостинга компании могут возникнуть проблемы; webDiplomacy, вероятно, использует больше ресурсов на пользователя, чем, скажем, PhpBB)

• Возможность установки до кронтаб для извлечения веб-страницу каждые 5 минут или около того, чтобы запустить

игры обработки / обслуживание серверов сценарий

Инсталляция (Installing)

Скрипты базы данных (Database scripts)

Run install/install.sql to set up the initial data-set, you can run this in phpMyAdmin's "Import" tab, if you don't have shell access.

Запустить установку / install.sql создать начальный набор данных, вы можете запустить это в PhpMyAdmin's "Импорт" на вкладке, если вы не имеете доступ к оболочке.

Конфигурирование (Config)

Edit config.sample.php to work with your setup, being very careful to read the warnings about security issues. The salts/secrets, errorlog/orderlog directories, can all leave your server wide open if you don't set them right. Rename to config.php when ready.

Изменить config.sample.php работать с вашей установки, будучи очень осторожны, чтобы читать предупреждения о вопросах безопасности. Соли / секреты, ErrorLog / orderlog каталогов, можно все Оставь свой сервер широко открыты, если вы не установили их права. Переименовать в config.php, когда будете готовы.

Вход как клиент (Log-on)

Once you've set config.php up you can use the random gameMasterSecret you entered to authenticate as the admin. First create a user via the registration page, then once logged on go to gamemaster.php?gameMasterSecret=[yoursecret] .

It will give you admin rights, then refresh the page as admin to run the gamemaster script for the first time, which will initialize various stats and maintenance processes. (This only works for the first user that does it, any other admins/moderators have to be set via the admin control-panel.)

Go to the Admin CP via the menu, find the "Toggle Maintenance Mode" action and run it, preventing others from using the server up while you're testing it.

Как только вы установили config.php до Вы можете использовать случайные gameMasterSecret вы ввели для аутентификации в качестве администратора. Сначала создайте пользователей через страницу регистрации, то После входа на К gamemaster.php? gameMasterSecret = [yoursecret].

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

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

Тест (Test)

Once that's set up you should go to Help->DATC. With Maintenance mode on it will show a screen which can run through the DATC tests, which provides an easy way to test that the installation was successful. Click Batch-test and it'll run through all the tests one by one. If maps are being generated successfully then everything is probably going to work. (Batch-testing the DATC tests may have problems in IE, try Firefox/Chrome/Safari until this is fixed.)

Как только это создали вы должны пойти в Help-> DATC. С обеспечением режима на нем будет Показать экран, который может проходить через испытания DATC, которая обеспечивает простой способ тест, установка прошла успешно. Нажмите кнопку Batch-тест, и он будет пробегать Все испытания по одному. Если карты генерируется успешно, то все , вероятно, будет работать. (Batch-тестирования DATC испытаний могут возникнуть проблемы в IE, Попробуйте Firefox / Chrome / Safari пока это не исправлено.)

Откройте (Open up)

Once you've looked around, posted a test message etc, and double-checked your config.php file for security issues, you can disable Maintenance mode via the admin CP to allow regular users to access the installation.

После того как вы смотрели вокруг, оставленных т.д. тестовое сообщение и дважды проверили свои config.php файл по вопросам безопасности, вы можете отключить режим технического обслуживания с помощью Admin CP чтобы позволить обычным пользователям для доступа к установке.

Начало цикла обработки (Start a processing cycle)

Now you need to set the system up so that games are automatically processed. This means running gamemaster.php?gameMasterSecret=[yoursecret] every 5 minutes or so from an automated script, via cron for example. Here is an example crontab:

For example here is my cron line:

• /5 * * * * /usr/bin/wget -O - 'http://webdiplomacy.net/gamemaster.php?gameMasterSecret=12345' >/dev/null 2>&1

'*/5 * * * *' sets the times the script should run (every 5 minutes) '/usr/bin/wget' is the program which downloads the script thus running it. 'http://webdiplomacy.net/gamemaster.php?gameMasterSecret=12345' is the gamemaster URL '-O - ' specifies to output to standard output '>/dev/null 2>&1' specifies that the standard output should be discarded (i.e. just run the page without saving the results)

=> Начало цикла обработки Теперь вам нужно настроить систему так, что игры будут автоматически обработаны. Это означает запуск gamemaster.php? gameMasterSecret = [yoursecret] каждые 5 минут или около того из автоматизированных сценариев, через хрон например. Вот пример кронтаб:

Например вот мой хрон линия:

• / 5 * * * * / USR / BIN / Wget-O - "http://webdiplomacy.net/gamemaster.php?gameMasterSecret=12345 '> / Dev / нуль 2> & 1

'* / 5 * * * *' устанавливает раз сценарий должен работать (каждые 5 минут) "/ USR / BIN / Wget" является программой, которая загружает сценарий таким образом ее запуска. "Http://webdiplomacy.net/gamemaster.php?gameMasterSecret=12345" является GameMaster URL "-О -" указывает на стандартный вывод '> / Dev / нуль 2> & 1 "указывает, что стандартный вывод должен быть уничтожен (т.е. просто запустите страницы без сохранения результатов)

Проверить (Check)

Once you're seeing the Last process time at the bottom of the page staying within 5 minutes of the current time the background processing is working, and everything should be up and running.

Как только вы видите в последний раз процесс в нижней части страницы пребывания в течение 5 минут текущее время фоновой обработки работает, и все должно быть запущен и работает.

См. также

• Свод правил (Rulebook)

Ссылки

• Официальный сайт

При создании этой страницы использовались материалы страницы README.txt согласно лицензии GNU Affero General License