Скрипт базовой витрины

Материал из Alawar
Перейти к: навигация, поиск

<style type="text/css">

</style>

Работа с экземпляром партнерских витрин <p style="margin-bottom: 0cm;">Данный документ содержит информацию по развертыванию партнерских XML-витрин на сервере партнера, а также по их дальнейшей работе. Документ предназначен для программистов, разрабатывающих партнерские XML-витрины, а также для партнеров, желающих разворачивать витрины на своем сервере самостоятельно. <p style="margin-top: 0.85cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;" lang="en-US">Содержание

  1. <p style="margin-bottom: 0cm;">Определения, используемые в данном документе
  2. <p style="margin-bottom: 0cm;">Введение: что это

    такое, для чего нужно, как это работает, примеры готовых витрин, FAQ

  3. <p style="margin-bottom: 0cm;">Интеграция шаблона

    витрины

  4. <p style="margin-bottom: 0cm;">Развертывание готовой

    XML-витрины на сервере партнера

  5. <p style="margin-bottom: 0cm;">Приложение 1. Описание

    форматов данных

    1. <p style="margin-bottom: 0cm;">Описание формата данных игр
    2. <p style="margin-bottom: 0cm;">Описание формата

      данных жанров

  6. <p style="margin-bottom: 0cm;">Приложение 2.

    Дополнительная информация по эксплуатации витрины

    1. <p style="margin-bottom: 0cm;">Описание основных значений конфигурации витрины
    2. <p style="margin-bottom: 0cm;">Параметры кеширования

      данных на витрине

<p style="margin-bottom: 0cm; page-break-before: always;">

<p style="margin-top: 0.85cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Определения

<p style="margin-bottom: 0cm;">Игра – продукт компании Alawar Entertainment, Inc., представляющий собой компьютерную игру. Игра содержит текстовое описание, дату выхода, ссылки на графические материалы, дистрибутив игры, ссылку на регистрацию игры.

<p style="margin-bottom: 0cm;">Партнерская программа Alawar – набор услуг AlawarEntertainment, Inc. по предоставлению развлекательного игрового контента любым веб-ресурсам.

<p style="margin-bottom: 0cm;">Витрина – сайт или раздел сайта участника Партнерской программы, предоставляющий информацию о продуктах компании Alawar Entertainment, Inc.

<p style="margin-bottom: 0cm;">Шаблон витрины – неделимый набор файлов, включающий в себя графические материалы, стили и php-файлы, отображающие контент витрины. (Ссылка на архив с шаблоном витрины).

<p style="margin-bottom: 0cm;">Скрипт витрины (ядро витрины, движок витрины) – программный скрипт, реализующий работу витрины на сервере партнера. Распространяется через Партнерскую программу Alawar.

<p style="margin-bottom: 0cm;">XML-витрина – разновидность скрипта витрины компании Alawar Entertainment, Inc. Данные об играх на витрину загружаются из XML-файла. Далее по тексту «Витрина».

<p style="margin-bottom: 0cm;">Рекламные блоки – это блоки небольшого размера, с описанием небольшого количества новых, хитовых или других игр. Эти блоки вставляются в другие разделы партнерского сайта и являются входными точками на партнерскую витрину. Примеры (http://www.klerk.ru/humour/)

<p style="margin-bottom: 0cm;">Административная зона витрины – это раздел витрины, где можно указать или изменить основные параметры витрины. В этот раздел можно попасть по адресу http://[aдрес-витрины]/admin/index.php, где [адрес-витрины] – URI Витрины на сервере Партнера. Пример: Если витрина расположена по адресу http://alawar-vitrina-example, то в административную зону можно попасть по следующей ссылке: http://alawar-vitrina-example/admin/index.php.

<p style="margin-bottom: 0cm; page-break-before: always;">

<p style="margin-top: 0.85cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Введение

<p style="margin-bottom: 0cm;">Партнерская программа Alawar – система партнерских витрин для распространения игрового контента. Партнерская витрина включает в себя все игры, представленные в портфолио Alawar Entertainment и предполагает размещение казуальных скачиваемых мини-игр и онлайновых флеш-игр. Примеры витрин можно увидеть здесь (http://partner.alawar.ru/showrooms.php).

<p style="margin-bottom: 0cm;">Игры распространяются по условно-бесплатной (shareware) лицензии. Пользователь имеет право бесплатно поиграть в любую скачанную игру, после чего ему будет предложено приобрести ключ и активировать полную версию. Приобрести ключ можно через SMS, банковский перевод, электронную карту, электронные деньги и пр.

<p style="margin-bottom: 0cm;">Правила участия в Партнерской программе находятся здесь:
http://partner.alawar.ru/partners_gs.php
Ответы на часто задаваемые вопросы по Партнерской программе можно найти здесь:
http://partner.alawar.ru/faq.php

<p style="margin-bottom: 0cm;">Партнерская программа предоставляет ряд возможностей по интеграции контента, такие как xml-витрина, javascript-витрина, распространение флеш-игр и др. Более подробная информация представлена на официальном сайте Партнерской программы:
http://partner.alawar.ru/vitr/vconfig/

<p style="margin-bottom: 0cm; page-break-before: always;">

<p style="margin-top: 0.85cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Интеграция шаблона витрины

<p style="margin-bottom: 0cm;">Интеграция шаблона витрины – это добавление набора файлов шаблона витрины для изменения ее внешнего вида.

<p style="margin-bottom: 0cm;">Вы можете воспользоваться одним из двух предложенных вариантов интеграции шаблона – использовать готовый шаблон из Партнерской зоны или создать собственный шаблон.

<p style="margin-top: 0.35cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Начало работы

<p style="margin-bottom: 0cm;">Перед началом работы витрины необходимо сделать следующее:

  1. <p style="margin-bottom: 0cm;">Следует переименовать файл “config.inc.php.templates” на “config.inc.php” в корне витрины.
  2. <p style="margin-bottom: 0cm;">Указать свой PID

    (идентификатор партнера), для этого нужно изменить файл config.inc.php в корне витрины:
    define( 'PARTNER_ID', XXXX );
    где XXXX - идентификатор партнера в Партнерской программе.

  3. <p style="margin-bottom: 0cm;">Выставить кодировку,

    в которой будет отображаться витрина:
    define('SA_CODEPAGE', XXXX);
    где XXXX – любое из значений 'windows-1251' или ' utf-8'.
    Файлы шаблона витрин должны быть в выбранной кодировке.

<p style="margin-top: 0.35cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Использование

готового шаблона

<p style="margin-bottom: 0cm;">Для внедрения на сайт готового шаблона вам необходимо сделать следующее:

  1. <p style="margin-bottom: 0cm;">Скопировать архив шаблона из Партнерской зоны (ссылка).
  2. <p style="margin-bottom: 0cm;">Распаковатьархив впапку

    «…/alawar-vitrina-example/var/ru/_templates/».

  3. <p style="margin-bottom: 0cm;">Включить использование

    выбранного шаблона в административной зоне витрины. На главной странице административной зоны в выпадающем списке «Название шаблона» нужно выбрать необходимый шаблон и сохранить изменения, нажав кнопку «Submit».

<p style="margin-top: 0.35cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Создание

нового шаблона

<p style="margin-bottom: 0cm;">Для создания нового шаблона вам необходимо сделать следующее:

<p style="margin-bottom: 0cm;">Необходимо преобразовать эскиз витрины (набор html-файлов, графических материалов, стилей) в набор шаблонов для отображения каталога игр с помощью программных скриптов витрины.

<p style="margin-bottom: 0cm;">Файлы шаблонов составляют следующую структуру:

<p style="margin-bottom: 0cm;">Пути указываются относительно папки, в которой находятся файлы шаблонов: …/alawar-vitrina-example/var/ru/_templates/default_tpl/

<p style="margin-bottom: 0cm;">* /default/base.php – точка входа на витрину. В этом файле могут быть размещены «хедер» и «футер» Партнерского сайта, должен быть включен файл шаблона «main.php» (см. ниже), интерфейс отображения скриншотов к играм.

<p style="margin-bottom: 0cm;">* /default/main.php – содержит меню жанров игр, выносные блоки с «хитовыми» и «новыми» играми, включение файлов-шаблонов со списками «хитовых», «новых» игр, по жанрам, со страницей игры. Также может содержать подключение страницы поиска, отправки сообщений в техподдержку и др.

<p style="margin-bottom: 0cm;">* /casualpcgames/game_list.php – содержит списки игр.

<p style="margin-bottom: 0cm;">* /casualpcgames/game.php – содержит страницу игры.

<p style="margin-bottom: 0cm;">* /casualpcgames/404.php – содержит сообщение, что данная страница не может быть отображена.

<p style="margin-bottom: 0cm;">* /casualpcgames/notexist.php – содержит сообщение о том, что по такому адресу страницы не существует.

<p style="margin-bottom: 0cm;">/onlinegames/game_list.php – может содержать список онлайновых флеш-игр.

<p style="margin-bottom: 0cm;">/default/search.php – в этом файле может находиться список игр, найденный в результате поиска.

<p style="margin-bottom: 0cm;">/default/support.php – здесь может находиться код формы техподдержки.

<p style="margin-bottom: 0cm;">/default/advert_block.php – может содержать рекламные блоки с «хитовыми», «новыми» и другими играми.

<p style="margin-bottom: 0cm;">* - минимальный набор шаблонов, присутствие которых необходимо для работы витрины.

<p style="margin-bottom: 0cm;">По шагам:

  1. <p style="margin-bottom: 0cm;">Берем архив ядра базовой витрины и распаковываем в отдельную папку.
  2. <p style="margin-bottom: 0cm;">Из архива с эскизом

    витрины копируем файлы картинок и стилей в папку шаблона (Пример: …/alawar-vitrina-example/var/ru/_templates/default_tpl/).

  3. <p style="margin-bottom: 0cm;">Установки в основном

    файле конфигурации. В корне дистрибутива витрины открываем файл config.inc.php.templates:

<p style="margin-left: 1.14cm; margin-bottom: 0cm;">Меняем

значение константы "PARTNER_ID" на значение идентификатора партнера этой витрины. Здесь также можно изменить и другие параметры витрины.

<p style="margin-left: 1.14cm; margin-bottom: 0cm;">При разработке нового шаблона витрины рекомендуется отключать кеширование страниц витрины. Для этого выставляем значение свойства «SA_HTML_CACHE_LIFETIME» в 0.

  1. <p style="margin-bottom: 0cm;">Создаем папки и пустые php-файлы шаблонов. В эти файлы копируем фрагменты html-кода, предоставленного в эскизе витрины. Разбиение html-кода можно делать, следуя рекомендациям, указанным в описании структуры файлов шаблона витрины.
  2. <p style="margin-bottom: 0cm;">Далее необходимо

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

  3. <p style="margin-bottom: 0cm;">При создании нового

    шаблона следует обратить внимание на следующие моменты:

    1. <p style="margin-bottom: 0cm;">Пункты меню жанров могут быть активными и неактивными, в зависимости от параметров «cat», «act» и «code», передаваемых на витрину. Поэтому необходимо на каждый пункт меню навешивать соответствующие условия на активность.
    2. <p style="margin-bottom: 0cm;">На странице с игрой

      внизу также можно отображать список игр того же жанра, к которому относится сама игра.

<p style="margin-bottom: 0cm;">

<p style="margin-bottom: 0cm;">

<p style="margin-bottom: 0cm;">Формат данных указан в Приложении 1.

<p style="margin-bottom: 0cm;">Документация кода витрины предоставлена по данной ссылке.

<p style="margin-bottom: 0cm;">Для быстрой интеграции шаблона предлагаем вам ознакомиться с основными операциями.

<p style="margin-bottom: 0cm;">Основные операции, которые могут вам потребоваться при разработке нового шаблона:

<p style="margin-bottom: 0cm;">Таблица 1. Основные операции при создании шаблона витрины

<col width="153"><col width="453"><tbody>
Название операции Код и результат реализации


Создание модели
Получение списка жанров

$genres

= $model->createGenreMenu();

<p style="margin-bottom: 0cm;">

<p style="margin-bottom: 0cm;">Результат:Массив с информацией по жанрам.

<p style="margin-bottom: 0cm;">Каждый элемент имеет следующие поля:

<p style="margin-bottom: 0cm;">

<p style="margin-bottom: 0cm;">array(

<p style="margin-bottom: 0cm;">'name' => 'имя-жанра',

<p style="margin-bottom: 0cm;">'code' => 'код-жанра',

<p style="margin-bottom: 0cm;">'action' => 'genre', // служебная информация для формирования uri к странице жанра

<p lang="en-US">);

</td></tr>
Получение списка хитовых игр </td><p style="margin-bottom: 0cm;" lang="en-US">$iTopGames =

$model->getTopGames();

<p style="margin-bottom: 0cm;" lang="en-US">$_temp = $iTopGames->getItems();

<p style="margin-bottom: 0cm;">$topGames = $_temp->getArray();

<p style="margin-left: 3.13cm; margin-bottom: 0cm;">

<p style="margin-bottom: 0cm;">Результат: Массив объектов игра, содержащий название игры, ее описание, ссылки на графические материалы и скачиваемый дистрибутив игры. Объекты отсортированы по убыванию рейтинга.

<p style="margin-bottom: 0cm;">

<p style="margin-bottom: 0cm;">Пример объекта:

<p style="margin-bottom: 0cm;">object(SA_PCGame)#11 (9) { ["id"]=> int(6363) ["code"]=> bool(false) ["name"]=> string(15) "Веселая ферма 3" ["dictionaries"]=> array(3) { ["all-games"]=> array(1) { ["all-games"]=> bool(false) } ["Genre"]=> array(1) { ["arcade"]=> string(3) "684" } ["Rating"]=> array(1) { ["rating-hit"]=> string(3) "684" } } ["Properties"]=> array(8) { ["SymbolCode"]=> string(13) "farm-frenzy-3" ["ReleaseDate"]=> string(19) "2009-07-21 10:00:00" ["Description45"]=> string(41) "Бизнес-симулятор крестьянского хозяйства."


<p style="margin-bottom: 0cm;" lang="en-US">…

["RelatedItems"]=> array(1) { [105566]=> array(4) { ["id"]=> string(6) "105566" ["Source"]=> string(11) "onlinegames" ["Name"]=> string(15) "Веселаяферма 3" ["Properties"]=> array(2) { ["Width"]=> string(3) "640" ["Height"]=> string(3) "585" } } } ["Files"]=> array(1) { ["distrib"]=> array(5) { ["Type"]=> string(7) "distrib" ["Timestamp"]=> string(10) "1255584196" ["Name"]=> string(22) "FarmFrenzy3Rus_758.exe" ["Size"]=> string(7) "91.02Mb" ["Url"]=> string(52) "http://www.alawar.ru/download/FarmFrenzy3Rus_758.exe" } } }

</td></tr>
Получение спискановых игр </td><p style="margin-bottom: 0cm;">$iNewGames =

$model->getNewGames();

<p style="margin-bottom: 0cm;" lang="en-US">$_temp = $iNewGames->getItems();

<p style="margin-bottom: 0cm;">$newGames = $_temp->getArray();

<p style="margin-bottom: 0cm;">

<p style="margin-bottom: 0cm;">Результат: Массив объектов игра, содержащий название игры, ее описание, ссылки на графические материалы и скачиваемый дистрибутив игры. Объекты отсортированы по убыванию даты выхода игры.


<p style="margin-bottom: 0cm;">

Объект имеет такую же структуру, как и в описанном выше пункте получения списка хитовых игр

</td></tr>
Получение списка игр определенного

жанра

</td>
<p style="margin-bottom: 0cm;" lang="en-US">$iGames =

$model->getGamesByGenre($game->getGenreCode());

<p style="margin-bottom: 0cm;" lang="en-US">$_temp = $iGames->getItems();

<p style="margin-bottom: 0cm;">$games = $_temp->getArray();

<p style="margin-bottom: 0cm;" lang="en-US">

<p style="margin-bottom: 0cm;">Результат: Массив объектов игра, содержащий название игры, ее описание, ссылки на графические материалы и скачиваемый дистрибутив игры. В массив входят лишь объекты игр указанного жанра, отсортированные по убыванию рейтинга в указанном жанре.

<p style="margin-bottom: 0cm;">

Объект имеет такую же структуру, как и в описанном выше пункте получения списка хитовых игр.

</td></tr>
Вывод информациипо игре </td><p style="margin-bottom: 0cm;" lang="en-US">$game->getProperty('Description45');

<p style="margin-bottom: 0cm;">или

<p style="margin-bottom: 0cm;" lang="en-US">$game->getProperty('Description80');

<p style="margin-bottom: 0cm;">или

<p style="margin-bottom: 0cm;" lang="en-US">$game->getProperty('Description450');

<p style="margin-bottom: 0cm;">или

<p style="margin-bottom: 0cm;">$game->getProperty('Description2000');

<p style="margin-bottom: 0cm;" lang="en-US">

<p style="margin-bottom: 0cm;">Результат: Строка с описанием игры размером до указанной величины.

Подробнее формат данных игры можете посмотреть в Приложении 2.


</td></tr>
Подготовка раздела с флеш-играми </td><p style="margin-bottom: 0cm;">Раздел с онлайновыми

флеш-играми располагается на отдельной странице.

<p style="margin-bottom: 0cm;">В адресной строке должен присутствовать параметр «cat», равный «onlinegames». В этом случае автоматически инициализируется массив $games с объектами онлайн-игр.

<p style="margin-bottom: 0cm;">Иначе нужно создавать отдельную модель с онлайновыми флеш-играми. Пример:

<p style="margin-bottom: 0cm;">$onlineModel = $showroom->CreateModel('ru','onlinegames');

<p style="margin-bottom: 0cm;" lang="en-US">$iTopGames = $onlineModel->getTopGames();

<p style="margin-bottom: 0cm;" lang="en-US">$_temp = $iTopGames->getItems();

<p style="margin-bottom: 0cm;">$oGames = $_temp->getArray();

<p style="margin-bottom: 0cm;">

Результат: Массив $oGames объектов онлайновые флеш-игры, содержащий название игры, ее описание, ссылки на графические материалы и скачиваемый дистрибутив игры. Объекты отсортированы по убыванию рейтинга.

</td></tr>
В разделе простых игр получение

онлайн-аналога простой игры

</td>
<p style="margin-bottom: 0cm;" lang="en-US">$onlineGames =

$game->getRelatedItems('onlinegames');

<p style="margin-bottom: 0cm;" lang="en-US">$keys = array_keys( $onlineGames );

<p style="margin-bottom: 0cm;">$key = $keys[0];

<p style="margin-bottom: 0cm;" lang="en-US">$onlineModel = $showroom->CreateModel('ru', 'onlinegames');

<p style="margin-bottom: 0cm;" lang="en-US">$iGames = $onlineModel->getAllGames();

<p style="margin-bottom: 0cm;" lang="en-US">$oGame = $iGames->getItem( $key );

Результат: Объект – онлайновая флеш-игра, аналог исходной PC-игре.

</td></tr>
В разделе онлайн-игр получение

простой игры - аналога онлайн-игры

</td>
<p style="margin-bottom: 0cm;" lang="en-US">$pcGames =

$game->getRelatedItems('casualpcgames');

<p style="margin-bottom: 0cm;" lang="en-US">$keys = array_keys( $pcGames );

<p style="margin-bottom: 0cm;" lang="en-US">$key = $keys[0];

<p style="margin-bottom: 0cm;" lang="en-US">$casualpcModel = $showroom->CreateModel('ru', 'casualpcgames');

<p style="margin-bottom: 0cm;" lang="en-US">$iGames = $casualpcModel->getAllGames();

<p style="margin-bottom: 0cm;">$pcGame = $iGames->getItem( $key );

Результат: Объект – PC-игра, аналог исходной онлайновой флеш-игры.

</td></tr></tbody></col><p style="margin-bottom: 0cm;">

<p style="margin-top: 0.35cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Создание рекламных блоков с играми

<p style="margin-bottom: 0cm;">Чтобы сделать рекламный блок, нужно получить соответствующий набор игр   «хитовые», «новые» или игры определенного жанра, см. таблицу с операциями для разработки нового шаблона. После чего вывести в блок название, иконки игр, ссылки на страницы с подробной информацией о них; возможно, описание игр.

<p style="margin-bottom: 0cm; page-break-before: always;">

<p style="margin-top: 0.85cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Развертывание готовой XML-витрины на сервере партнера

<p style="margin-bottom: 0cm;">Для развертывания витрины необходимо иметь скрипт витрины и сервер, удовлетворяющий требованиям (Подробнее в Приложении 3).

<p style="margin-left: 0.5cm; margin-top: 0.35cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Необходимые действия:

  1. <p style="margin-bottom: 0cm;">Файлы витрины выкладываются на сервер в нужную папку.
  2. <p style="margin-bottom: 0cm;">Права доступа на

    папки var и все содержащиеся в ней подпапки должны быть выставлены в 775 или в 777 в зависимости от настроек сервера (желательно 777).

  3. <p style="margin-bottom: 0cm;">Нужно проверить

    значения параметров «PARTNER_ID», «SA_CODEPAGE», «SA_USE_LOCAL_IMG_STORAGE» и «SA_USE_LOCAL_DISTRIB_STORAGE», содержащихся в конфигурационном файле “config.inc.php”, он находится в корневой папке витрины. Описание данного файла смотрите ниже.

  4. <p style="margin-bottom: 0cm;">Нужно зайти в

    административную зону витрины (Пример: http://alawar-vitrina-example/admin/index.php). Для этого нужно ввести логин и пароль (по умолчанию login:vitr; password:pass), эти значения задаются в конфигурационном файле, мы настоятельно рекомендуем сменить стандартный логин и пароль на более сложные значения, чтобы обезопасить работу административной зоны витрины. В административной зоне витрины необходимо произвести первоначальную загрузку данных об играх (на вкладке “Cache” нужно нажать кнопку “Reload Now”).


  5. <p style="margin-bottom: 0cm;">Витрина готова к

    эксплуатации.

<p style="margin-left: 0.5cm; margin-top: 0.35cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Опциональные

действия:

  1. <p style="margin-bottom: 0cm;">Чтобы сменить кодировку витрины, необходимо:
  1. <p style="margin-bottom: 0cm;">В файле “config.inc.php”

    изменить значение константы “SA_CODEPAGE” на название необходимой кодировки; значение по умолчанию – “windows-1251”.

  2. <p style="margin-bottom: 0cm;">Необходимо

    перекодировать в соответствующую кодировку файлы шаблонов, они находятся в папках “var/ru/_templates/*/”;

    • - любая папка в этом каталоге.
  3. <p style="margin-bottom: 0cm;">Код витрины

    задокументирован, поэтому смена кодировки затронет эти комментарии, в связи с этим необходимо аналогично пункту (b) перекодировать все файлы витрины в соответствующую кодировку.

  1. <p style="margin-bottom: 0cm;">Чтобы загрузить

    локальную графику или дистрибутивы на сервер, нужно, чтобы соответствующие параметры “SA_USE_LOCAL_IMG_STORAGE” и “SA_USE_LOCAL_DISTRIB_STORAGE” конфигурационного файла имели значение “true”. После этого нужно зайти на администраторскую страницу витрины, перейти на вкладки “Images” и “Distrib Storage” соответственно, затем нажать на кнопку “Reload Now”.

<p style="margin-left: 1cm; margin-bottom: 0cm;">Кроме этого,

обновлять графику, дистрибутивы и данные об игрых соответственно можно также используя кронтаб. Для этого в его конфигурации нужно прописать следующие строки:

<p style="margin-left: 1cm; margin-bottom: 0cm;">25 2,9 * * * .../alawar-vitrina-example/admin/reload-images.php

<p style="margin-left: 1cm; margin-bottom: 0cm;" lang="en-US">35 4,8 *

  • * .../alawar-vitrina-example/admin/reload-distribs.php

<p style="margin-left: 1cm; margin-bottom: 0cm;" lang="en-US">45 5,7 *

  • * .../alawar-vitrina-example/admin/reload-xml.php

<p style="margin-left: 1cm; margin-bottom: 0cm;" lang="en-US">

<p style="margin-left: 1cm; margin-bottom: 0cm;">Также сервер витрины должен удовлетворять определенным требованиям, если производится кеширование дистрибутивов и графики.

<p style="margin-left: 1cm; margin-bottom: 0cm;">

<p style="margin-bottom: 0cm; page-break-before: always;">

<p style="margin-top: 0.85cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Приложение 1.

<p style="margin-top: 0.35cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Описание форматов данных

    1. <p style="margin-bottom: 0cm;">Описание формата данных игр.
<p style="margin-bottom: 0cm;">Тег в xml

дан относительно ALAWAR_EXPORT/Languages/Language/Catalogs/Catalog@”casualpcgames”/Items/Item

<p style="margin-bottom: 0cm;">Таблица 2. Форматы данных

<col width="90"><col width="327"><col width="177"><tbody>
Название элемента описания игры Тег в xml Метод выборки из объекта игры
Имя

Name </td>

<p lang="en-US">$game->name </td></tr>
Символьный код </td>Properties/Property@SymbolCode </td><p lang="en-US">$game->getProperty('SymbolCode') </td></tr>
Дата выхода игры </td>Properties/Property@ReleaseDate </td>$game->getProperty(' ReleaseDate') </td></tr>
Описание игры длиной 45 символов </td>Properties/Property@Description45 </td>$game->getProperty(' Description45') </td></tr>
Описание игры длиной 80 символов </td>Properties/Property@Description80 </td>$game->getProperty(' Description80') </td></tr>
Описание игры длиной 450 символов </td>Properties/Property@Description450 </td>$game->getProperty(' Description450') </td></tr>
Описание игры длиной 2000 символов </td>Properties/Property@Description2000 </td>$game->getProperty(' Description2000') </td></tr>
Ссылка на покупку игры </td>Properties/Property@OrderUrl </td>$game->getProperty(' OrderUrl') </td></tr>
Images (иконки для

игр)

</td></tr>
Иконка размера 44x44 на

белом фоне (icon44x44)


</td>
<p lang="en-US">Images/Image@icon44x44 </td>$game->getImage('icon44x44') </td></tr>
Иконка размером 44x44 с

фоном игры (icon44x44bg)

</td>
<p lang="en-US">Images/Image@icon44x44bg </td>$game->getImage('icon44x44bg') </td></tr>
Иконка размером 100x100

на белом фоне (icon100x100)

</td>
<p lang="en-US">Images/Image@icon100x100 </td>$game->getImage('icon100x100') </td></tr>
Иконка размером 100x100

с фоном игры (icon100x100bg)

</td>
<p lang="en-US">Images/Image@icon100x100bg </td>$game->getImage('icon100x100bg') </td></tr>
Логотип игры размером 190x140

игры (logo190x140)

</td>
<p lang="en-US">Images/Image@logo190x140 </td>$game->getImage('logo190x140') </td></tr>
Рисунок размером 586x152 (banner586x152) </td><p lang="en-US">Images/Image@banner586x152 </td>$game->getImage('banner586x152') </td></tr>
Screenshot (Скриншоты) </td></tr>
URL иконки скриншота

(small)

</td>
<p lang="en-US"> </td>$Screenshots[$i]['small']['Url'] </td></tr>
Ширина иконки скриншота

(small)

</td>
</td>$Screenshots[$i]['small']['Width'] </td></tr>
Высота иконки скриншота

(small)

</td>
</td>$Screenshots[$i]['small']['Height'] </td></tr>
URL скриншота (big) </td></td>$Screenshots[$i]['big']['Url'] </td></tr>
Ширина скриншота (big) </td></td>$Screenshots[$i]['big']['Width'] </td></tr>
Высота скриншота (big) </td></td>$Screenshots[$i]['big']['Height'] </td></tr>
Files (Дистрибутив

игры)

</td></tr>
Ссылка на скачиваемый дистрибутив

(distrib)

</td>
<p lang="en-US">Files/File@distrib </td>$game->getDownloadFileUrl() </td></tr>
RelatedItem (Элементы

связанные с данным)

</td></tr>
Массив объектов игр, связанных с

данным

</td>
RelatedItems/RelatedItemCatalog@onlinegames/RelatedItem </td>$game->getRelatedItems('onlinegames') </td></tr>
<p style="margin-bottom: 0cm;">Onlinegames

(онлайновые флеш-игры)

<p style="margin-bottom: 0cm;">Тег в xml дан относительно ALAWAR_EXPORT/Languages/Language/Catalogs/Catalog@”onlinegames”/Items/Item

</td></tr>
URL онлайн-игры </td>Properties/Property@PageUrl </td>$oGame->getProperty('PageUrl

')

</td></tr>
Рекомендуемая ширина окна с

онлайн-игрой

</td>
Properties/Property@Width </td>$oGame->getProperty(' Width') </td></tr>
Рекомендуемая высота окна с

онлайн-игрой

</td>
Properties/Property@Height </td>$oGame->getProperty('Height ') </td></tr>
Ширина swf-файла с игрой </td>Properties/Property@swfWidth </td>$oGgame->getProperty('SwfWidth ') </td></tr>
Высота swf-файла с игрой </td>Properties/Property@swfHeight </td>$oGame->getProperty(' SwfHeight') </td></tr>
HTML-код тега embed

для вставки игры на страницу

</td>
Properties/Property@Embed </td>$oGame->getProperty('Embed

')

</td></tr></tbody></col><p style="margin-top: 0.35cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Описание формата данных жанров

<p style="margin-bottom: 0cm;">Данные жанров игр имеют следующий формат:

<p style="margin-left: 2cm; margin-bottom: 0cm;">array(

<p style="margin-left: 2cm; margin-bottom: 0cm;">'name' => 'имя-жанра',

<p style="margin-left: 2cm; margin-bottom: 0cm;">'code' => 'код-жанра',

<p style="margin-left: 2cm; margin-bottom: 0cm;">'action' => 'genre', // служебная информация для формирования URI к странице жанра

<p style="margin-left: 2cm; margin-bottom: 0cm;">);

<p style="margin-top: 0.85cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-before: always; page-break-after: avoid;">Приложение 2. Дополнительная информация по эксплуатации витрины

<p style="margin-top: 0.35cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Описание основных значений конфигурации витрины

<p style="margin-bottom: 0cm;">Таблица 3. Описание основных значений конфигурации витрины.

<col width="208"><col width="394"><tbody>
Константа SA_CODEPAGE Кодировка витрины (Пример:

windows-1251”, “urf-8”, “koi8-r”); Рекомендуемое значение – windows1251.

Константа SA_CACHE_LIFETIME Задает время жизни данных об играх,

значение указывается в секундах; по умолчанию – 86400 .Данная константа задает период обновления данных об играх с сервера AlawarEntertainment, Inc.

Константа SA_USE_LOCAL_IMG_STORAGE Если на витрине используется локальная

графика для игр, то значение параметра должно быть “true”; значение по умолчанию – “false”.

Константа

SA_USE_LOCAL_DISTRIB_STORAGE

Если на витрине используются локальные

дистрибутивы игр, то значение параметра должно быть “true”; значение по умолчанию – “false”.

Константа SA_HTML_CACHE_LIFETIME Время жизни кеша страниц витрины,

значение указывается в секундах; по умолчанию – 86400 секунд. Данная константа задает период обновления html-кода страниц витрины на сервере партнера.

Константа SA_DEFAULT_LANGUAGE

Должна соответствовать

рынку:

Русский рынок: (ru).

</td></tr>
Константа SA_DEFAULT_CATALOG </td><p style="margin-bottom: 0cm;">Коды основного каталога

игр витрины могут быть следующими:

<p style="margin-bottom: 0cm;"> Простые казуальные игры - (casualpcgames).

<p style="margin-bottom: 0cm;"> Онлайновые флеш-игры - (onlinegames).

<p style="margin-bottom: 0cm;">Данная константа задает раздел витрины по умолчанию.

</td></tr>
Константа SA_ADMIN_LOGIN </td>Задается логин для входа в

административную зону витрины

</td></tr>
Константа SA_ADMIN_PASSWORD </td>Задается пароль для входа в

административную зону витрины

</td></tr></tbody></col><p style="margin-left: 3.15cm; margin-bottom: 0cm;">

<p style="margin-top: 0.35cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Параметры кеширования данных на витрине

<p style="margin-bottom: 0cm;">При эксплуатации витрины необходимо помнить следующие моменты:

  1. <p style="margin-bottom: 0cm;">Витрина в соответствии с конфигурационным файлом (константа SA_CACHE_LIFETIME) обновляет данные по играм с сервера Alawar. Рекомендуемый интервал обновления 86400секунд.
  2. <p style="margin-bottom: 0cm;">Витрина в процессе

    работы создает html-кеш страниц витрины для повышения производительности работы (константа SA_HTML_CACHE_LIFETIME конфигурационного файла). Это позволяет ускорить загрузку страниц витрины.

  3. <p style="margin-bottom: 0cm;">Очистку кеша витрины

    (отображения актуального контента) необходимо проводить следующим образом:

<p style="margin-left: 1.25cm; margin-bottom: 0cm;">Вариант 1

(более осторожный и долгий):

<p style="margin-left: 1.91cm; margin-bottom: 0cm;">Выставить в файле config.inc.php значение константы «SA_HTML_CACHE_LIFETIME» в 0. После этого перегрузить необходимые страницы витрины.

<p style="margin-left: 1.25cm; margin-bottom: 0cm;">Вариант 2 (Радикальный):

<p style="margin-left: 2cm; margin-bottom: 0cm;">Необходимо удалить все файлы из папки «…/alawar-vitrina-example/var/cache/pages/».

<p style="margin-top: 0.85cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Приложение 3. Системные требования

<p style="margin-bottom: 0cm;">Базовая витрина - это веб-приложение, написанное на PHP, которое устанавливается на сервер. Непосредственная работа с ним производится через веб-браузер - Internet Explorer, Mozilla или др. Для успешной работы нужно, чтобы и сервер, и клиент удовлетворяли определенным требованиям.

<p style="margin-top: 0.35cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Требования для сервера:

  • <p style="margin-bottom: 0cm;">Операционная система: Unix (Linux), Windows
  • <p style="margin-bottom: 0cm;">Веб-сервер: Apache
  • <p style="margin-bottom: 0cm;">Версия

    PHP: PHP4 >= 4.3.0 or PHP5. PHP может быть и как модуль Apache и в режиме CGI.

  • <p style="margin-bottom: 0cm;">Опция Safe mode должна

    быть выставлена в "Off".

<p style="margin-bottom: 0cm;">Рекомендуется (не

обязательно) для веб-сервера также установить:

  • <p style="margin-bottom: 0cm;">Apache с модулями mod_rewrite (для формирования SEF-путей); gd module (для корректной работы captcha).
<p style="margin-top: 0.35cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Требования

для клиента:

  • <p style="margin-bottom: 0cm;">Рекомендуемые: браузер Mozilla Firefox для любой операционной системы, Internet Explorer 7+ для Windows
  • <p style="margin-bottom: 0cm;">Required: любой графический

    браузер для любой ОС (Netscape, IE, Opera, Konqueror для Windows, Unix, Mac)

  • <p style="margin-bottom: 0cm;">Hardware: достаточно

    современный компьютер

<p style="margin-top: 0.35cm; margin-bottom: 0cm; page-break-inside: avoid; page-break-after: avoid;">Замечание

по поводу использования памяти:

<p style="margin-bottom: 0cm;">Сейчас в Базовой витрине есть части, которые требуют больше 128 Мб памяти,  сконфигурированные в php.ini по умолчанию. Во многих случаях это не является проблемой, так как ограничение используется далеко не всегда.

<p style="margin-bottom: 0cm;">