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

Материал из Alawar
Перейти к: навигация, поиск
Строка 1: Строка 1:
<font color="#17365d"><font face="Cambria, serif"><font size="6" style="font-size: 26pt;">Работа с экземпляром партнерских витрин</font></font></font>  
+
<font color="#17365d"><font face="Cambria, serif"><font style="font-size: 26pt" size="6">Работа с экземпляром партнерских витрин</font></font></font>  
  
 
Данный документ содержит информацию по развертыванию партнерских <span lang="en-US">XML</span>-витрин на сервере партнера, а также по их дальнейшей работе. Документ предназначен для программистов, разрабатывающих партнерские <span lang="en-US">XML</span>-витрины, а также для партнеров, желающих разворачивать витрины на своем сервере самостоятельно.  
 
Данный документ содержит информацию по развертыванию партнерских <span lang="en-US">XML</span>-витрин на сервере партнера, а также по их дальнейшей работе. Документ предназначен для программистов, разрабатывающих партнерские <span lang="en-US">XML</span>-витрины, а также для партнеров, желающих разворачивать витрины на своем сервере самостоятельно.  
Строка 5: Строка 5:
 
<font color="#365f91"><font face="Cambria, serif"><font size="4">'''Содержание'''</font></font></font>  
 
<font color="#365f91"><font face="Cambria, serif"><font size="4">'''Содержание'''</font></font></font>  
  
# Определения, используемые в данном документе  
+
#Определения, используемые в данном документе  
# Введение: что это такое, для чего нужно, как это работает, примеры готовых витрин, <span lang="en-US">FAQ</span>  
+
#Введение: что это такое, для чего нужно, как это работает, примеры готовых витрин, <span lang="en-US">FAQ</span>  
# Интеграция шаблона витрины  
+
#Интеграция шаблона витрины  
# Развертывание готовой <span lang="en-US">XML</span>-витрины на сервере партнера  
+
#Развертывание готовой <span lang="en-US">XML</span>-витрины на сервере партнера  
# Приложение 1. Описание форматов данных  
+
#Приложение 1. Описание форматов данных  
## Описание формата данных игр  
+
##Описание формата данных игр  
## Описание формата данных жанров  
+
##Описание формата данных жанров
# Приложение 2. Дополнительная информация по эксплуатации витрины  
+
#Приложение 2. Дополнительная информация по эксплуатации витрины  
## Описание основных значений конфигурации витрины  
+
##Описание основных значений конфигурации витрины  
## Параметры кеширования данных на витрине  
+
##Параметры кеширования данных на витрине
  
<br> <br>  
+
<br><br>
  
 
<font color="#365f91"><font face="Cambria, serif"><font size="4">'''Определения'''</font></font></font>  
 
<font color="#365f91"><font face="Cambria, serif"><font size="4">'''Определения'''</font></font></font>  
Строка 36: Строка 36:
 
'''Административная зона витрины''' – это раздел витрины, где можно указать или изменить основные параметры витрины. В этот раздел можно попасть по адресу <span lang="en-US">http</span>://[<span lang="en-US">a</span>дрес-витрины]/<span lang="en-US">admin</span>/<span lang="en-US">index</span>.<span lang="en-US">php</span>, где [адрес-витрины] – <span lang="en-US">URI</span> Витрины на сервере Партнера. Пример: Если витрина расположена по адресу [http://alawar-vitrina-example/ <font color="#0000ff"><font face="Tahoma, sans-serif"><font size="2"><span lang="en-US"><u>http://alawar-vitrina-example</u></span></font></font></font>], то в административную зону можно попасть по следующей ссылке: [http://alawar-vitrina-example/ <font color="#0000ff"><font face="Tahoma, sans-serif"><font size="2"><span lang="en-US"><u>http://alawar-vitrina-example</u></span></font></font></font>][http://vitrina.ru/admin/index.php <font color="#0000ff"><font size="2"><span lang="en-US"><u>/admin/index.php</u></span></font></font>].  
 
'''Административная зона витрины''' – это раздел витрины, где можно указать или изменить основные параметры витрины. В этот раздел можно попасть по адресу <span lang="en-US">http</span>://[<span lang="en-US">a</span>дрес-витрины]/<span lang="en-US">admin</span>/<span lang="en-US">index</span>.<span lang="en-US">php</span>, где [адрес-витрины] – <span lang="en-US">URI</span> Витрины на сервере Партнера. Пример: Если витрина расположена по адресу [http://alawar-vitrina-example/ <font color="#0000ff"><font face="Tahoma, sans-serif"><font size="2"><span lang="en-US"><u>http://alawar-vitrina-example</u></span></font></font></font>], то в административную зону можно попасть по следующей ссылке: [http://alawar-vitrina-example/ <font color="#0000ff"><font face="Tahoma, sans-serif"><font size="2"><span lang="en-US"><u>http://alawar-vitrina-example</u></span></font></font></font>][http://vitrina.ru/admin/index.php <font color="#0000ff"><font size="2"><span lang="en-US"><u>/admin/index.php</u></span></font></font>].  
  
<br>  
+
<br>
  
 
<font color="#365f91"><font face="Cambria, serif"><font size="4">'''Введение'''</font></font></font>  
 
<font color="#365f91"><font face="Cambria, serif"><font size="4">'''Введение'''</font></font></font>  
Строка 46: Строка 46:
 
Правила участия в Партнерской программе находятся здесь:<br>[http://partner.alawar.ru/partners_gs.php <font color="#0000ff"><u>http://partner.alawar.ru/partners_gs.php</u></font>]<br>Ответы на часто задаваемые вопросы по Партнерской программе можно найти здесь:<br>[http://partner.alawar.ru/faq.php <font color="#0000ff"><u>http://partner.alawar.ru/faq.php</u></font>]  
 
Правила участия в Партнерской программе находятся здесь:<br>[http://partner.alawar.ru/partners_gs.php <font color="#0000ff"><u>http://partner.alawar.ru/partners_gs.php</u></font>]<br>Ответы на часто задаваемые вопросы по Партнерской программе можно найти здесь:<br>[http://partner.alawar.ru/faq.php <font color="#0000ff"><u>http://partner.alawar.ru/faq.php</u></font>]  
  
Партнерская программа предоставляет ряд возможностей по интеграции контента, такие как <span lang="en-US">xml</span>-витрина, <span lang="en-US">javascript</span>-витрина, распространение флеш-игр и др. Более подробная информация представлена на официальном сайте Партнерской программы:<br> [http://partner.alawar.ru/vitr/vconfig/ <font color="#0000ff"><u>http://partner.alawar.ru/vitr/vconfig/</u></font>]  
+
Партнерская программа предоставляет ряд возможностей по интеграции контента, такие как <span lang="en-US">xml</span>-витрина, <span lang="en-US">javascript</span>-витрина, распространение флеш-игр и др. Более подробная информация представлена на официальном сайте Партнерской программы:<br>[http://partner.alawar.ru/vitr/vconfig/ <font color="#0000ff"><u>http://partner.alawar.ru/vitr/vconfig/</u></font>]  
  
<br>  
+
<br>
  
 
<font color="#365f91"><font face="Cambria, serif"><font size="4">'''Интеграция шаблона витрины'''</font></font></font>  
 
<font color="#365f91"><font face="Cambria, serif"><font size="4">'''Интеграция шаблона витрины'''</font></font></font>  
Строка 56: Строка 56:
 
Вы можете воспользоваться одним из двух предложенных вариантов интеграции шаблона – использовать готовый шаблон из Партнерской зоны или создать собственный шаблон.  
 
Вы можете воспользоваться одним из двух предложенных вариантов интеграции шаблона – использовать готовый шаблон из Партнерской зоны или создать собственный шаблон.  
  
<font color="#4f81bd"><font face="Cambria, serif"><font size="3" style="font-size: 13pt;">'''Начало работы'''</font></font></font>  
+
<font color="#4f81bd"><font face="Cambria, serif"><font style="font-size: 13pt" size="3">'''Начало работы'''</font></font></font>  
  
 
Перед началом работы витрины необходимо сделать следующее:  
 
Перед началом работы витрины необходимо сделать следующее:  
  
 
#Следует переименовать файл “<span lang="en-US">config</span>.<span lang="en-US">inc</span>.<span lang="en-US">php</span>.<span lang="en-US">templates</span>” на “<span lang="en-US">config</span>.<span lang="en-US">inc</span>.<span lang="en-US">php</span>” в корне витрины.  
 
#Следует переименовать файл “<span lang="en-US">config</span>.<span lang="en-US">inc</span>.<span lang="en-US">php</span>.<span lang="en-US">templates</span>” на “<span lang="en-US">config</span>.<span lang="en-US">inc</span>.<span lang="en-US">php</span>” в корне витрины.  
 
 
#Указать свой <span lang="en-US">PID</span> (идентификатор партнера), для этого нужно изменить файл <span lang="en-US">config</span>.<span lang="en-US">inc</span>.<span lang="en-US">php</span> в корне витрины:<br><span lang="en-US">define</span>( '<span lang="en-US">PARTNER</span>_<span lang="en-US">ID</span>', <span lang="en-US">XXXX</span> );<br>где <span lang="en-US">XXXX</span> - идентификатор партнера в Партнерской программе.  
 
#Указать свой <span lang="en-US">PID</span> (идентификатор партнера), для этого нужно изменить файл <span lang="en-US">config</span>.<span lang="en-US">inc</span>.<span lang="en-US">php</span> в корне витрины:<br><span lang="en-US">define</span>( '<span lang="en-US">PARTNER</span>_<span lang="en-US">ID</span>', <span lang="en-US">XXXX</span> );<br>где <span lang="en-US">XXXX</span> - идентификатор партнера в Партнерской программе.  
 +
#Выставить кодировку, в которой будет отображаться витрина:<br>define('<span lang="en-US">SA</span>_<span lang="en-US">CODEPAGE</span>', <span lang="en-US">XXXX</span>);<br>где <span lang="en-US">XXXX</span> – любое из значений 'windows-1251' или ' utf-8'.<br>Файлы шаблона витрин должны быть в выбранной кодировке.
  
#Выставить кодировку, в которой будет отображаться витрина:<br>define('<span lang="en-US">SA</span>_<span lang="en-US">CODEPAGE</span>', <span lang="en-US">XXXX</span>);<br>где <span lang="en-US">XXXX</span> – любое из значений 'windows-1251' или ' utf-8'.<br>Файлы шаблона витрин должны быть в выбранной кодировке.
+
<br><font color="#4f81bd"><font face="Cambria, serif"><font style="font-size: 13pt" size="3">'''Использование готового шаблона'''</font></font></font>  
 
 
<br> <font color="#4f81bd"><font face="Cambria, serif"><font size="3" style="font-size: 13pt;">'''Использование готового шаблона'''</font></font></font>  
 
  
 
Для внедрения на сайт готового шаблона вам необходимо сделать следующее:  
 
Для внедрения на сайт готового шаблона вам необходимо сделать следующее:  
  
#Скопировать архив шаблона из Партнерской зоны (ссылка).
+
#<span lang="en-US">Распаковать&nbsp;</span>архив<span lang="en-US"> </span>в<span lang="en-US"> </span>папку<span lang="en-US"> «…/alawar</span><span lang="en-US">-</span><span lang="en-US">vitrina</span><span lang="en-US">-</span><span lang="en-US">example/var/ru/_templates/»</span><span lang="en-US">.</span>  
 
+
#Скопировать архив шаблона из Партнерской зоны (ссылка).
#Распаковать<span lang="en-US">
+
#Включить использование выбранного шаблона в административной зоне витрины. На главной странице административной зоны в выпадающем списке «Название шаблона» нужно выбрать необходимый шаблон и сохранить изменения, нажав кнопку «<span lang="en-US">Submit</span>».
</span>архив<span lang="en-US"> </span>в<span lang="en-US">
 
</span>папку<span lang="en-US">
 
«…/alawar</span><span lang="en-US">-</span><span lang="en-US">vitrina</span><span lang="en-US">-</span><span lang="en-US">example/var/ru/_templates/»</span><span lang="en-US">.</span>  
 
 
 
#Включить использование выбранного шаблона в административной зоне витрины. На главной странице административной зоны в выпадающем списке «Название шаблона» нужно выбрать необходимый шаблон и сохранить изменения, нажав кнопку «<span lang="en-US">Submit</span>».  
 
  
<br> <font color="#4f81bd"><font face="Cambria, serif"><font size="3" style="font-size: 13pt;">'''Создание нового шаблона'''</font></font></font>  
+
<br><font color="#4f81bd"><font face="Cambria, serif"><font style="font-size: 13pt" size="3">'''Создание нового шаблона'''</font></font></font>  
  
 
Для создания нового шаблона вам необходимо сделать следующее:  
 
Для создания нового шаблона вам необходимо сделать следующее:  
Строка 90: Строка 83:
  
 
*/<span lang="en-US">default</span>/<span lang="en-US">base</span>.<span lang="en-US">php</span> – точка входа на витрину. В этом файле могут быть размещены «хедер» и «футер» Партнерского сайта, должен быть включен файл шаблона «<span lang="en-US">main</span>.<span lang="en-US">php</span>» (см. ниже), интерфейс отображения скриншотов к играм.
 
*/<span lang="en-US">default</span>/<span lang="en-US">base</span>.<span lang="en-US">php</span> – точка входа на витрину. В этом файле могут быть размещены «хедер» и «футер» Партнерского сайта, должен быть включен файл шаблона «<span lang="en-US">main</span>.<span lang="en-US">php</span>» (см. ниже), интерфейс отображения скриншотов к играм.
 
 
*/<span lang="en-US">default</span>/<span lang="en-US">main</span>.<span lang="en-US">php</span> – содержит меню жанров игр, выносные блоки с «хитовыми» и «новыми» играми, включение файлов-шаблонов со списками «хитовых», «новых» игр, по жанрам, со страницей игры. Также может содержать подключение страницы поиска, отправки сообщений в техподдержку и др.
 
*/<span lang="en-US">default</span>/<span lang="en-US">main</span>.<span lang="en-US">php</span> – содержит меню жанров игр, выносные блоки с «хитовыми» и «новыми» играми, включение файлов-шаблонов со списками «хитовых», «новых» игр, по жанрам, со страницей игры. Также может содержать подключение страницы поиска, отправки сообщений в техподдержку и др.
 
 
*/<span lang="en-US">casualpcgames</span>/<span lang="en-US">game</span>_<span lang="en-US">list</span>.<span lang="en-US">php</span> – содержит списки игр.
 
*/<span lang="en-US">casualpcgames</span>/<span lang="en-US">game</span>_<span lang="en-US">list</span>.<span lang="en-US">php</span> – содержит списки игр.
 
 
*/<span lang="en-US">casualpcgames</span>/<span lang="en-US">game</span>.<span lang="en-US">php</span> – содержит страницу игры.
 
*/<span lang="en-US">casualpcgames</span>/<span lang="en-US">game</span>.<span lang="en-US">php</span> – содержит страницу игры.
 
 
*/<span lang="en-US">casualpcgames</span>/404.<span lang="en-US">php</span> – содержит сообщение, что данная страница не может быть отображена.
 
*/<span lang="en-US">casualpcgames</span>/404.<span lang="en-US">php</span> – содержит сообщение, что данная страница не может быть отображена.
 
 
*/<span lang="en-US">casualpcgames</span>/<span lang="en-US">notexist</span>.<span lang="en-US">php</span> – содержит сообщение о том, что по такому адресу страницы не существует.
 
*/<span lang="en-US">casualpcgames</span>/<span lang="en-US">notexist</span>.<span lang="en-US">php</span> – содержит сообщение о том, что по такому адресу страницы не существует.
 
+
*/<span lang="en-US">onlinegames</span>/<span lang="en-US">game</span>_<span lang="en-US">list</span>.<span lang="en-US">php</span> – может содержать список онлайновых флеш-игр.  
/<span lang="en-US">onlinegames</span>/<span lang="en-US">game</span>_<span lang="en-US">list</span>.<span lang="en-US">php</span> – может содержать список онлайновых флеш-игр.  
+
*/<span lang="en-US">default</span>/<span lang="en-US">search</span>.<span lang="en-US">php</span> – в этом файле может находиться список игр, найденный в результате поиска.  
 
+
*/<span lang="en-US">default</span>/<span lang="en-US">support</span>.<span lang="en-US">php</span> – здесь может находиться код формы техподдержки.  
/<span lang="en-US">default</span>/<span lang="en-US">search</span>.<span lang="en-US">php</span> – в этом файле может находиться список игр, найденный в результате поиска.  
+
*/<span lang="en-US">default</span>/<span lang="en-US">advert</span>_<span lang="en-US">block</span>.<span lang="en-US">php</span> – может содержать рекламные блоки с «хитовыми», «новыми» и другими играми.
 
 
/<span lang="en-US">default</span>/<span lang="en-US">support</span>.<span lang="en-US">php</span> – здесь может находиться код формы техподдержки.  
 
 
 
/<span lang="en-US">default</span>/<span lang="en-US">advert</span>_<span lang="en-US">block</span>.<span lang="en-US">php</span> – может содержать рекламные блоки с «хитовыми», «новыми» и другими играми.  
 
  
 
*- минимальный набор шаблонов, присутствие которых необходимо для работы витрины.
 
*- минимальный набор шаблонов, присутствие которых необходимо для работы витрины.
Строка 113: Строка 97:
 
По шагам:  
 
По шагам:  
  
#Берем архив ядра базовой витрины и распаковываем в отдельную папку.  
+
#Берем архив ядра базовой витрины и распаковываем в отдельную папку.
 
+
#Из архива с эскизом витрины копируем файлы картинок и стилей в папку шаблона (Пример: …/<span lang="en-US">alawar</span>-<span lang="en-US">vitrina</span>-<span lang="en-US">example</span>/<span lang="en-US">var</span>/<span lang="en-US">ru</span>/_<span lang="en-US">templates</span>/<span lang="en-US">default</span>_<span lang="en-US">tpl</span>/).
#Из архива с эскизом витрины копируем файлы картинок и стилей в папку шаблона (Пример: …/<span lang="en-US">alawar</span>-<span lang="en-US">vitrina</span>-<span lang="en-US">example</span>/<span lang="en-US">var</span>/<span lang="en-US">ru</span>/_<span lang="en-US">templates</span>/<span lang="en-US">default</span>_<span lang="en-US">tpl</span>/).  
+
#Установки в основном файле конфигурации. В корне дистрибутива витрины открываем файл config.inc.php.templates:
 
 
#Установки в основном файле конфигурации. В корне дистрибутива витрины открываем файл config.inc.php.templates:  
 
  
<br> Меняем значение константы "PARTNER_ID" на значение идентификатора партнера этой витрины. Здесь также можно изменить и другие параметры витрины.  
+
<br>Меняем значение константы "PARTNER_ID" на значение идентификатора партнера этой витрины. Здесь также можно изменить и другие параметры витрины.  
  
 
При разработке нового шаблона витрины рекомендуется отключать кеширование страниц витрины. Для этого выставляем значение свойства «<font color="#000000"><span lang="en-US">SA</span></font><font color="#000000">_</font><font color="#000000"><span lang="en-US">HTML</span></font><font color="#000000">_</font><font color="#000000"><span lang="en-US">CACHE</span></font><font color="#000000">_</font><font color="#000000"><span lang="en-US">LIFETIME</span></font>» в 0.  
 
При разработке нового шаблона витрины рекомендуется отключать кеширование страниц витрины. Для этого выставляем значение свойства «<font color="#000000"><span lang="en-US">SA</span></font><font color="#000000">_</font><font color="#000000"><span lang="en-US">HTML</span></font><font color="#000000">_</font><font color="#000000"><span lang="en-US">CACHE</span></font><font color="#000000">_</font><font color="#000000"><span lang="en-US">LIFETIME</span></font>» в 0.  
  
#Создаем папки и пустые <span lang="en-US">php</span>-файлы шаблонов. В эти файлы копируем фрагменты <span lang="en-US">html</span>-кода, предоставленного в эскизе витрины. Разбиение <span lang="en-US">html</span>-кода можно делать, следуя рекомендациям, указанным в описании структуры файлов шаблона витрины.  
+
#Создаем папки и пустые <span lang="en-US">php</span>-файлы шаблонов. В эти файлы копируем фрагменты <span lang="en-US">html</span>-кода, предоставленного в эскизе витрины. Разбиение <span lang="en-US">html</span>-кода можно делать, следуя рекомендациям, указанным в описании структуры файлов шаблона витрины.
 
+
#Далее необходимо заменить названия игр, ссылки на страницу с игрой, ссылки на скачиваемый дистрибутив, пути и размеры графических материалов и др. на соответствующие переменные, константы и методы, с помощью которых можно отобразить необходимые данные. Подробнее о переменных и методах можно узнать в таблице основных операций и таблице формата данных.
#Далее необходимо заменить названия игр, ссылки на страницу с игрой, ссылки на скачиваемый дистрибутив, пути и размеры графических материалов и др. на соответствующие переменные, константы и методы, с помощью которых можно отобразить необходимые данные. Подробнее о переменных и методах можно узнать в таблице основных операций и таблице формата данных.  
+
#При создании нового шаблона следует обратить внимание на следующие моменты:
 
 
#При создании нового шаблона следует обратить внимание на следующие моменты:  
 
 
 
##Пункты меню жанров могут быть активными и неактивными, в зависимости от параметров «<span lang="en-US">cat</span>», «<span lang="en-US">act</span>» и «<span lang="en-US">code</span>», передаваемых на витрину. Поэтому необходимо на каждый пункт меню навешивать соответствующие условия на активность.
 
  
##На странице с игрой внизу также можно отображать список игр того же жанра, к которому относится сама игра.  
+
*Пункты меню жанров могут быть активными и неактивными, в зависимости от параметров «<span lang="en-US">cat</span>», «<span lang="en-US">act</span>» и «<span lang="en-US">code</span>», передаваемых на витрину. Поэтому необходимо на каждый пункт меню навешивать соответствующие условия на активность.
 +
*На странице с игрой внизу также можно отображать список игр того же жанра, к которому относится сама игра.
  
<br> <br>  
+
<br><br>
  
<br>  
+
<br>
  
 
Формат данных указан в Приложении 1.  
 
Формат данных указан в Приложении 1.  
Строка 147: Строка 126:
 
Таблица 1. Основные операции при создании шаблона витрины  
 
Таблица 1. Основные операции при создании шаблона витрины  
  
{| cellspacing="0" cellpadding="7" border="1" width="636"
+
{| border="1" cellspacing="0" cellpadding="7" width="636"
|- valign="TOP"
+
|- valign="top"
 
| width="153" |  
 
| width="153" |  
Название операции  
+
Название операции
  
 
| width="453" |  
 
| width="453" |  
Код и результат реализации  
+
Код и результат реализации
  
|- valign="TOP"
+
|- valign="top"
 
| width="153" |  
 
| width="153" |  
Создание модели  
+
Создание модели
  
 
| width="453" |  
 
| width="453" |  
<br>  
+
<br>
  
|- valign="TOP"
+
|- valign="top"
 
| width="153" |  
 
| width="153" |  
Получение списка<span lang="en-US"> </span>жанров  
+
Получение списка<span lang="en-US"> </span>жанров
  
 
| width="453" |  
 
| width="453" |  
<font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">$</font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;"><span lang="en-US">genres</span></font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">= $</font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;"><span lang="en-US">model</span></font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">-&gt;</font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;"><span lang="en-US">createGenreMenu</span></font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">();</font></font>  
+
<font face="Courier New, monospace"><font style="font-size: 9pt" size="2">$</font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2"><span lang="en-US">genres</span></font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2">= $</font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2"><span lang="en-US">model</span></font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2">-&gt;</font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2"><span lang="en-US">createGenreMenu</span></font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2">();</font></font>  
  
<br>  
+
<br>
  
Результат:<font face="Courier New, monospace"><font size="2" style="font-size: 9pt;"></font></font>Массив с информацией по жанрам.  
+
Результат:<font face="Courier New, monospace"><font style="font-size: 9pt" size="2"></font></font>Массив с информацией по жанрам.  
  
 
Каждый элемент имеет следующие поля:  
 
Каждый элемент имеет следующие поля:  
  
<br>  
+
<br>
  
<font face="Courier New, monospace"><font size="2" style="font-size: 9pt;"><span lang="en-US">array</span></font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">(</font></font>  
+
<font face="Courier New, monospace"><font style="font-size: 9pt" size="2"><span lang="en-US">array</span></font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2">(</font></font>  
  
<font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">'</font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;"><span lang="en-US">name</span></font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">' =&gt; 'имя-жанра',</font></font>  
+
<font face="Courier New, monospace"><font style="font-size: 9pt" size="2">'</font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2"><span lang="en-US">name</span></font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2">' =&gt; 'имя-жанра',</font></font>  
  
<font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">'</font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;"><span lang="en-US">code</span></font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">' =&gt; 'код-жанра',</font></font>  
+
<font face="Courier New, monospace"><font style="font-size: 9pt" size="2">'</font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2"><span lang="en-US">code</span></font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2">' =&gt; 'код-жанра',</font></font>  
  
<font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">'</font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;"><span lang="en-US">action</span></font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">' =&gt; '</font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;"><span lang="en-US">genre</span></font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">', // служебная информация для формирования</font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;"><span lang="en-US">uri</span></font></font><font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">к странице жанра</font></font>  
+
<font face="Courier New, monospace"><font style="font-size: 9pt" size="2">'</font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2"><span lang="en-US">action</span></font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2">' =&gt; '</font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2"><span lang="en-US">genre</span></font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2">', // служебная информация для формирования</font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2"><span lang="en-US">uri</span></font></font><font face="Courier New, monospace"><font style="font-size: 9pt" size="2">к странице жанра</font></font>  
  
<font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">);</font></font>  
+
<font face="Courier New, monospace"><font style="font-size: 9pt" size="2">);</font></font>
  
|- valign="TOP"
+
|- valign="top"
 
| width="153" |  
 
| width="153" |  
Получение списка хитовых игр  
+
Получение списка хитовых игр
  
 
| width="453" |  
 
| width="453" |  
Строка 198: Строка 177:
 
$<span lang="en-US">topGames</span> = $_<span lang="en-US">temp</span>-&gt;<span lang="en-US">getArray</span>();  
 
$<span lang="en-US">topGames</span> = $_<span lang="en-US">temp</span>-&gt;<span lang="en-US">getArray</span>();  
  
<br>  
+
<br>
  
 
Результат: Массив объектов игра, содержащий название игры, ее описание, ссылки на графические материалы и скачиваемый дистрибутив игры. Объекты отсортированы по убыванию рейтинга.  
 
Результат: Массив объектов игра, содержащий название игры, ее описание, ссылки на графические материалы и скачиваемый дистрибутив игры. Объекты отсортированы по убыванию рейтинга.  
  
<br>  
+
<br>
  
 
Пример объекта:  
 
Пример объекта:  
Строка 210: Строка 189:
 
…  
 
…  
  
<span lang="en-US">["RelatedItems"]=&gt; array(1) {
+
<span lang="en-US">["RelatedItems"]=&gt; array(1) { [105566]=&gt; array(4) { ["id"]=&gt; string(6) "105566" ["Source"]=&gt; string(11) "onlinegames" ["Name"]=&gt; string(15) "</span>Веселая<span lang="en-US"> </span>ферма<span lang="en-US"> 3" ["Properties"]=&gt; array(2) { ["Width"]=&gt; string(3) "640" ["Height"]=&gt; string(3) "585" } } } ["Files"]=&gt; array(1) { ["distrib"]=&gt; array(5) { ["Type"]=&gt; string(7) "distrib" ["Timestamp"]=&gt; string(10) "1255584196" ["Name"]=&gt; string(22) "FarmFrenzy3Rus_758.exe" ["Size"]=&gt; string(7) "91.02Mb" ["Url"]=&gt; string(52) "http://www.alawar.ru/download/FarmFrenzy3Rus_758.exe" } } }</span>
[105566]=&gt; array(4) { ["id"]=&gt; string(6) "105566"
 
["Source"]=&gt; string(11) "onlinegames"
 
["Name"]=&gt; string(15) "</span>Веселая<span lang="en-US">
 
</span>ферма<span lang="en-US"> 3" ["Properties"]=&gt;
 
array(2) { ["Width"]=&gt; string(3) "640"
 
["Height"]=&gt; string(3) "585" } } }
 
["Files"]=&gt; array(1) { ["distrib"]=&gt;
 
array(5) { ["Type"]=&gt; string(7) "distrib"
 
["Timestamp"]=&gt; string(10) "1255584196"
 
["Name"]=&gt; string(22) "FarmFrenzy3Rus_758.exe"
 
["Size"]=&gt; string(7) "91.02Mb" ["Url"]=&gt;
 
string(52) "http://www.alawar.ru/download/FarmFrenzy3Rus_758.exe"
 
} } }</span>  
 
  
|- valign="TOP"
+
|- valign="top"
 
| width="153" |  
 
| width="153" |  
Получение<span lang="en-US"> </span>списка<span lang="en-US">
+
Получение<span lang="en-US"> </span>списка<span lang="en-US"> </span>новых<span lang="en-US"> </span>игр
</span>новых<span lang="en-US"> </span>игр  
 
  
 
| width="453" |  
 
| width="453" |  
<span lang="en-US">$iNewGames =
+
<span lang="en-US">$iNewGames = $model-&gt;getNewGames();</span>  
$model-&gt;getNewGames();</span>  
 
  
 
$_temp = $iNewGames-&gt;getItems();  
 
$_temp = $iNewGames-&gt;getItems();  
Строка 238: Строка 202:
 
$<span lang="en-US">newGames</span> = $_<span lang="en-US">temp</span>-&gt;<span lang="en-US">getArray</span>();  
 
$<span lang="en-US">newGames</span> = $_<span lang="en-US">temp</span>-&gt;<span lang="en-US">getArray</span>();  
  
<br>  
+
<br>
  
 
Результат: Массив объектов игра, содержащий название игры, ее описание, ссылки на графические материалы и скачиваемый дистрибутив игры. Объекты отсортированы по убыванию даты выхода игры.  
 
Результат: Массив объектов игра, содержащий название игры, ее описание, ссылки на графические материалы и скачиваемый дистрибутив игры. Объекты отсортированы по убыванию даты выхода игры.  
  
<br>  
+
<br>
  
Объект имеет такую же структуру, как и в описанном выше пункте получения списка хитовых игр  
+
Объект имеет такую же структуру, как и в описанном выше пункте получения списка хитовых игр
  
|- valign="TOP"
+
|- valign="top"
 
| width="153" |  
 
| width="153" |  
Получение списка игр определенного жанра  
+
Получение списка игр определенного жанра
  
 
| width="453" |  
 
| width="453" |  
Строка 255: Строка 219:
 
$_temp = $iGames-&gt;getItems();  
 
$_temp = $iGames-&gt;getItems();  
  
<span lang="en-US">$games =
+
<span lang="en-US">$games = $_temp-&gt;getArray();</span>  
$_temp-&gt;getArray();</span>  
 
  
<br>  
+
<br>
  
 
Результат: Массив объектов игра, содержащий название игры, ее описание, ссылки на графические материалы и скачиваемый дистрибутив игры. В массив входят лишь объекты игр указанного жанра, отсортированные по убыванию рейтинга в указанном жанре.  
 
Результат: Массив объектов игра, содержащий название игры, ее описание, ссылки на графические материалы и скачиваемый дистрибутив игры. В массив входят лишь объекты игр указанного жанра, отсортированные по убыванию рейтинга в указанном жанре.  
  
<br>  
+
<br>
  
Объект имеет такую же структуру, как и в описанном выше пункте получения списка хитовых игр.  
+
Объект имеет такую же структуру, как и в описанном выше пункте получения списка хитовых игр.
  
|- valign="TOP"
+
|- valign="top"
 
| width="153" |  
 
| width="153" |  
Вывод<span lang="en-US"> </span>информации<span lang="en-US">
+
Вывод<span lang="en-US"> </span>информации<span lang="en-US"> </span>по<span lang="en-US"> </span>игре
</span>по<span lang="en-US"> </span>игре  
 
  
 
| width="453" |  
 
| width="453" |  
Строка 286: Строка 248:
 
<span lang="en-US">$game-&gt;getProperty('Description2000');</span>  
 
<span lang="en-US">$game-&gt;getProperty('Description2000');</span>  
  
<br>  
+
<br>
  
 
Результат: Строка с описанием игры размером до указанной величины.  
 
Результат: Строка с описанием игры размером до указанной величины.  
  
Подробнее формат данных игры можете посмотреть в Приложении 2.  
+
Подробнее формат данных игры можете посмотреть в Приложении 2.
  
|- valign="TOP"
+
|- valign="top"
 
| width="153" |  
 
| width="153" |  
Подготовка раздела с флеш-играми  
+
Подготовка раздела с флеш-играми
  
 
| width="453" |  
 
| width="453" |  
Строка 303: Строка 265:
 
Иначе нужно создавать отдельную модель с онлайновыми флеш-играми. Пример<span lang="en-US">:</span>  
 
Иначе нужно создавать отдельную модель с онлайновыми флеш-играми. Пример<span lang="en-US">:</span>  
  
<span lang="en-US">$onlineModel =
+
<span lang="en-US">$onlineModel = $showroom-&gt;CreateModel('ru','onlinegames');</span>  
$showroom-&gt;CreateModel('ru','onlinegames');</span>  
 
  
 
$iTopGames = $onlineModel-&gt;getTopGames();  
 
$iTopGames = $onlineModel-&gt;getTopGames();  
Строка 312: Строка 273:
 
$oGames = $_temp-&gt;getArray();  
 
$oGames = $_temp-&gt;getArray();  
  
<br>  
+
<br>
  
Результат: Массив $oGames объектов онлайновые флеш-игры, содержащий название игры, ее описание, ссылки на графические материалы и скачиваемый дистрибутив игры. Объекты отсортированы по убыванию рейтинга.  
+
Результат: Массив $oGames объектов онлайновые флеш-игры, содержащий название игры, ее описание, ссылки на графические материалы и скачиваемый дистрибутив игры. Объекты отсортированы по убыванию рейтинга.
  
|- valign="TOP"
+
|- valign="top"
 
| width="153" |  
 
| width="153" |  
В разделе простых игр получение онлайн-аналога простой игры  
+
В разделе простых игр получение онлайн-аналога простой игры
  
 
| width="453" |  
 
| width="453" |  
Строка 333: Строка 294:
 
$oGame = $iGames-&gt;getItem( $key );  
 
$oGame = $iGames-&gt;getItem( $key );  
  
Результат: Объект – онлайновая флеш-игра, аналог исходной <span lang="en-US">PC</span>-игре.  
+
Результат: Объект – онлайновая флеш-игра, аналог исходной <span lang="en-US">PC</span>-игре.
  
|- valign="TOP"
+
|- valign="top"
 
| width="153" |  
 
| width="153" |  
В разделе онлайн-игр получение простой игры - аналога онлайн-игры  
+
В разделе онлайн-игр получение простой игры - аналога онлайн-игры
  
 
| width="453" |  
 
| width="453" |  
Строка 350: Строка 311:
 
$iGames = $casualpcModel-&gt;getAllGames();  
 
$iGames = $casualpcModel-&gt;getAllGames();  
  
<span lang="en-US">$pcGame =
+
<span lang="en-US">$pcGame = $iGames-&gt;getItem( $key );</span>  
$iGames-&gt;getItem( $key );</span>  
 
  
Результат: Объект – <span lang="en-US">PC</span>-игра, аналог исходной онлайновой флеш-игры.  
+
Результат: Объект – <span lang="en-US">PC</span>-игра, аналог исходной онлайновой флеш-игры.
  
 
|}
 
|}
  
<br>  
+
<br>
  
<font color="#4f81bd"><font face="Cambria, serif"><font size="3" style="font-size: 13pt;">'''Создание рекламных блоков с играми'''</font></font></font>  
+
<font color="#4f81bd"><font face="Cambria, serif"><font style="font-size: 13pt" size="3">'''Создание рекламных блоков с играми'''</font></font></font>  
  
 
Чтобы сделать рекламный блок, нужно получить соответствующий набор игр &nbsp; «хитовые», «новые» или игры определенного жанра, см. таблицу с операциями для разработки нового шаблона. После чего вывести в блок название, иконки игр, ссылки на страницы с подробной информацией о них; возможно, описание игр.  
 
Чтобы сделать рекламный блок, нужно получить соответствующий набор игр &nbsp; «хитовые», «новые» или игры определенного жанра, см. таблицу с операциями для разработки нового шаблона. После чего вывести в блок название, иконки игр, ссылки на страницы с подробной информацией о них; возможно, описание игр.  
  
<br>  
+
<br>
  
 
<font color="#365f91"><font face="Cambria, serif"><font size="4">'''Развертывание готовой XML-витрины на сервере партнера'''</font></font></font>  
 
<font color="#365f91"><font face="Cambria, serif"><font size="4">'''Развертывание готовой XML-витрины на сервере партнера'''</font></font></font>  
Строка 371: Строка 331:
 
<font color="#4f81bd"><font face="Cambria, serif">'''Необходимые действия:'''</font></font>  
 
<font color="#4f81bd"><font face="Cambria, serif">'''Необходимые действия:'''</font></font>  
  
#Файлы витрины выкладываются на сервер в нужную папку.  
+
#Файлы витрины выкладываются на сервер в нужную папку.
 
+
#Права доступа на папки var и все содержащиеся в ней подпапки должны быть выставлены в 775 или в 777 в зависимости от настроек сервера (желательно 777).
#Права доступа на папки var и все содержащиеся в ней подпапки должны быть выставлены в 775 или в 777 в зависимости от настроек сервера (желательно 777).  
+
#Нужно проверить значения параметров «<font color="#000000"><span lang="en-US">PARTNER</span></font><font color="#000000">_</font><font color="#000000"><span lang="en-US">ID</span></font><font color="#000000">», «</font><font color="#000000"><span lang="en-US">SA</span></font><font color="#000000">_</font><font color="#000000"><span lang="en-US">CODEPAGE</span></font><font color="#000000">»</font>, «SA_USE_LOCAL_IMG_STORAGE» и «SA_USE_LOCAL_DISTRIB_STORAGE», содержащихся в конфигурационном файле “config.inc.php”, он находится в корневой папке витрины. Описание данного файла смотрите ниже.
 
+
#Нужно зайти в административную зону витрины (Пример: [http://alawar-vitrina-example/admin/index.php <font color="#0000ff"><font size="2"><span lang="en-US"><u>http://alawar-vitrina-example/admin/index.php</u></span></font></font>]). Для этого нужно ввести логин и пароль (по умолчанию <span lang="en-US">login</span>:<span lang="en-US">vitr</span>; <span lang="en-US">password</span>:<span lang="en-US">pass</span>), эти значения задаются в конфигурационном файле, '''мы настоятельно рекомендуем сменить стандартный логин и пароль на более сложные значения''', чтобы обезопасить работу административной зоны витрины. В административной зоне витрины необходимо произвести первоначальную загрузку данных об играх (на вкладке “<span lang="en-US">Cache</span>” нужно нажать кнопку “Reload <span lang="en-US">N</span>ow”).
#Нужно проверить значения параметров «<font color="#000000"><span lang="en-US">PARTNER</span></font><font color="#000000">_</font><font color="#000000"><span lang="en-US">ID</span></font><font color="#000000">», «</font><font color="#000000"><span lang="en-US">SA</span></font><font color="#000000">_</font><font color="#000000"><span lang="en-US">CODEPAGE</span></font><font color="#000000">»</font>, «SA_USE_LOCAL_IMG_STORAGE» и «SA_USE_LOCAL_DISTRIB_STORAGE», содержащихся в конфигурационном файле “config.inc.php”, он находится в корневой папке витрины. Описание данного файла смотрите ниже.  
+
#Витрина готова к эксплуатации.
 
 
#Нужно зайти в административную зону витрины (Пример: [http://alawar-vitrina-example/admin/index.php <font color="#0000ff"><font size="2"><span lang="en-US"><u>http://alawar-vitrina-example/admin/index.php</u></span></font></font>]). Для этого нужно ввести логин и пароль (по умолчанию <span lang="en-US">login</span>:<span lang="en-US">vitr</span>; <span lang="en-US">password</span>:<span lang="en-US">pass</span>), эти значения задаются в конфигурационном файле, '''мы настоятельно рекомендуем сменить стандартный логин и пароль на более сложные значения''', чтобы обезопасить работу административной зоны витрины. В административной зоне витрины необходимо произвести первоначальную загрузку данных об играх (на вкладке “<span lang="en-US">Cache</span>” нужно нажать кнопку “Reload <span lang="en-US">N</span>ow”).  
 
 
 
#Витрина готова к эксплуатации.
 
 
 
<br> <font color="#4f81bd"><font face="Cambria, serif">'''Опциональные действия:'''</font></font>
 
 
 
#Чтобы сменить кодировку витрины, необходимо:
 
 
 
<br>
 
 
 
#В файле “config.inc.php” изменить значение константы “<span lang="en-US">SA</span>_<span lang="en-US">CODEPAGE</span>” на название необходимой кодировки; значение по умолчанию – “<span lang="en-US">windows</span>-1251”.
 
 
 
#Необходимо перекодировать в соответствующую кодировку файлы шаблонов, они находятся в папках “<span lang="en-US">var</span>/<span lang="en-US">ru</span>/_<span lang="en-US">templates</span>/*/”; * - любая папка в этом каталоге.
 
 
 
#Код витрины задокументирован, поэтому смена кодировки затронет эти комментарии, в связи с этим необходимо аналогично пункту (b) перекодировать все файлы витрины в соответствующую кодировку.  
 
  
<br>  
+
<br><font color="#4f81bd"><font face="Cambria, serif">'''Опциональные действия:'''</font></font>  
  
#Чтобы загрузить локальную графику или дистрибутивы на сервер, нужно, чтобы соответствующие параметры “<span lang="en-US">SA</span>_<span lang="en-US">USE</span>_<span lang="en-US">LOCAL</span>_<span lang="en-US">IMG</span>_<span lang="en-US">STORAGE</span>” и “<span lang="en-US">SA</span>_<span lang="en-US">USE</span>_<span lang="en-US">LOCAL</span>_<span lang="en-US">DISTRIB</span>_<span lang="en-US">STORAGE</span>” конфигурационного файла имели значение “<span lang="en-US">true</span>”. После этого нужно зайти на администраторскую страницу витрины, перейти на вкладки “<span lang="en-US">Images</span>” и “<span lang="en-US">Distrib</span> <span lang="en-US">Storage</span>” соответственно, затем нажать на кнопку “<span lang="en-US">Reload</span> <span lang="en-US">Now</span>”.  
+
#Чтобы сменить кодировку витрины, необходимо:<br>
 +
#В файле “config.inc.php” изменить значение константы “<span lang="en-US">SA</span>_<span lang="en-US">CODEPAGE</span>” на название необходимой кодировки; значение по умолчанию – “<span lang="en-US">windows</span>-1251”.
 +
#Необходимо перекодировать в соответствующую кодировку файлы шаблонов, они находятся в папках “<span lang="en-US">var</span>/<span lang="en-US">ru</span>/_<span lang="en-US">templates</span>/*/”; * - любая папка в этом каталоге.
 +
#Код витрины задокументирован, поэтому смена кодировки затронет эти комментарии, в связи с этим необходимо аналогично пункту (b) перекодировать все файлы витрины в соответствующую кодировку.<br>
 +
#Чтобы загрузить локальную графику или дистрибутивы на сервер, нужно, чтобы соответствующие параметры “<span lang="en-US">SA</span>_<span lang="en-US">USE</span>_<span lang="en-US">LOCAL</span>_<span lang="en-US">IMG</span>_<span lang="en-US">STORAGE</span>” и “<span lang="en-US">SA</span>_<span lang="en-US">USE</span>_<span lang="en-US">LOCAL</span>_<span lang="en-US">DISTRIB</span>_<span lang="en-US">STORAGE</span>” конфигурационного файла имели значение “<span lang="en-US">true</span>”. После этого нужно зайти на администраторскую страницу витрины, перейти на вкладки “<span lang="en-US">Images</span>” и “<span lang="en-US">Distrib</span> <span lang="en-US">Storage</span>” соответственно, затем нажать на кнопку “<span lang="en-US">Reload</span> <span lang="en-US">Now</span>”.
  
<br> Кроме этого, обновлять графику, дистрибутивы и данные об игрых соответственно можно также используя кронтаб. Для этого в его конфигурации нужно прописать следующие строки:  
+
<br>Кроме этого, обновлять графику, дистрибутивы и данные об игрых соответственно можно также используя кронтаб. Для этого в его конфигурации нужно прописать следующие строки:  
  
 
25 2,9 * * * .../<span lang="en-US">alawar</span>-<span lang="en-US">vitrina</span>-<span lang="en-US">example</span>/<span lang="en-US">admin</span>/<span lang="en-US">reload</span>-<span lang="en-US">images</span>.<span lang="en-US">php</span>  
 
25 2,9 * * * .../<span lang="en-US">alawar</span>-<span lang="en-US">vitrina</span>-<span lang="en-US">example</span>/<span lang="en-US">admin</span>/<span lang="en-US">reload</span>-<span lang="en-US">images</span>.<span lang="en-US">php</span>  
Строка 405: Строка 353:
 
45 5,7 * * * .../alawar-vitrina-example/admin/reload-xml.php  
 
45 5,7 * * * .../alawar-vitrina-example/admin/reload-xml.php  
  
<br>  
+
<br>
  
 
Также сервер витрины должен удовлетворять определенным требованиям, если производится кеширование дистрибутивов и графики.  
 
Также сервер витрины должен удовлетворять определенным требованиям, если производится кеширование дистрибутивов и графики.  
  
<br>  
+
<br>
  
<br>  
+
<br>
  
 
<font color="#365f91"><font face="Cambria, serif"><font size="4">'''Приложение 1.'''</font></font></font>  
 
<font color="#365f91"><font face="Cambria, serif"><font size="4">'''Приложение 1.'''</font></font></font>  
  
<font color="#4f81bd"><font face="Cambria, serif"><font size="3" style="font-size: 13pt;">'''Описание форматов данных'''</font></font></font>  
+
<font color="#4f81bd"><font face="Cambria, serif"><font style="font-size: 13pt" size="3">'''Описание форматов данных'''</font></font></font>  
 +
 
  
#
 
  
 
Описание формата данных игр.  
 
Описание формата данных игр.  
  
<br> Тег в <span lang="en-US">xml</span> дан относительно <span lang="en-US">ALAWAR</span>_<span lang="en-US">EXPORT</span>/<span lang="en-US">Languages</span>/<span lang="en-US">Language</span>/<span lang="en-US">Catalogs</span>/<span lang="en-US">Catalog</span>@”<span lang="en-US">casualpcgames</span>”/<span lang="en-US">Items</span>/<span lang="en-US">Item</span>  
+
<br>Тег в <span lang="en-US">xml</span> дан относительно <span lang="en-US">ALAWAR</span>_<span lang="en-US">EXPORT</span>/<span lang="en-US">Languages</span>/<span lang="en-US">Language</span>/<span lang="en-US">Catalogs</span>/<span lang="en-US">Catalog</span>@”<span lang="en-US">casualpcgames</span>”/<span lang="en-US">Items</span>/<span lang="en-US">Item</span>  
  
 
Таблица 2. Форматы данных  
 
Таблица 2. Форматы данных  
  
{| cellspacing="0" cellpadding="7" border="1" width="638"
+
{| border="1" cellspacing="0" cellpadding="7" width="638"
|- valign="TOP"
+
|- valign="top"
| width="90" height="25" |  
+
| height="25" width="90" |  
Название элемента описания игры  
+
Название элемента описания игры
  
 
| width="327" |  
 
| width="327" |  
Тег в <span lang="en-US">xml</span>  
+
Тег в <span lang="en-US">xml</span>
  
 
| width="177" |  
 
| width="177" |  
Метод выборки из объекта игры  
+
Метод выборки из объекта игры
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Имя  
+
Имя
  
 
| width="327" |  
 
| width="327" |  
Name  
+
Name
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;name  
+
$game-&gt;name
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Символьный код  
+
Символьный код
  
 
| width="327" |  
 
| width="327" |  
Properties<span lang="en-US">/Property@SymbolCode</span>  
+
Properties<span lang="en-US">/Property@SymbolCode</span>
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getProperty('SymbolCode')  
+
$game-&gt;getProperty('SymbolCode')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Дата выхода игры  
+
Дата выхода игры
  
 
| width="327" |  
 
| width="327" |  
Properties<span lang="en-US">/Property@ReleaseDate</span>  
+
Properties<span lang="en-US">/Property@ReleaseDate</span>
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getProperty(' ReleaseDate')  
+
$game-&gt;getProperty(' ReleaseDate')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Описание игры длиной 45 символов  
+
Описание игры длиной 45 символов
  
 
| width="327" |  
 
| width="327" |  
Properties<span lang="en-US">/Property@Description45</span>  
+
Properties<span lang="en-US">/Property@Description45</span>
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getProperty(' <span lang="en-US">Description45</span>')  
+
$game-&gt;getProperty(' <span lang="en-US">Description45</span>')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="5" |  
+
| height="5" width="90" |  
Описание игры длиной 80 символов  
+
Описание игры длиной 80 символов
  
 
| width="327" |  
 
| width="327" |  
Properties<span lang="en-US">/Property@Description80</span>  
+
Properties<span lang="en-US">/Property@Description80</span>
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getProperty(' <span lang="en-US">Description80</span>')  
+
$game-&gt;getProperty(' <span lang="en-US">Description80</span>')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Описание игры длиной 450 символов  
+
Описание игры длиной 450 символов
  
 
| width="327" |  
 
| width="327" |  
Properties<span lang="en-US">/Property@Description450</span>  
+
Properties<span lang="en-US">/Property@Description450</span>
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getProperty(' <span lang="en-US">Description450</span>')  
+
$game-&gt;getProperty(' <span lang="en-US">Description450</span>')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Описание игры длиной 2000 символов  
+
Описание игры длиной 2000 символов
  
 
| width="327" |  
 
| width="327" |  
Properties<span lang="en-US">/Property@Description2000</span>  
+
Properties<span lang="en-US">/Property@Description2000</span>
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getProperty(' <span lang="en-US">Description2000</span>')  
+
$game-&gt;getProperty(' <span lang="en-US">Description2000</span>')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Ссылка на покупку игры  
+
Ссылка на покупку игры
  
 
| width="327" |  
 
| width="327" |  
Properties<span lang="en-US">/Property@OrderUrl</span>  
+
Properties<span lang="en-US">/Property@OrderUrl</span>
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getProperty(' <span lang="en-US">OrderUrl</span>')  
+
$game-&gt;getProperty(' <span lang="en-US">OrderUrl</span>')
  
 
|-
 
|-
| width="622" valign="TOP" height="6" colspan="3" |  
+
| height="6" valign="top" width="622" colspan="3" |  
<span lang="en-US">Images (</span>иконки для игр<span lang="en-US">)</span>  
+
<span lang="en-US">Images (</span>иконки для игр<span lang="en-US">)</span>
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Иконка размера 44<span lang="en-US">x</span>44 на белом фоне (icon44x44)  
+
Иконка размера 44<span lang="en-US">x</span>44 на белом фоне (icon44x44)
  
 
| width="327" |  
 
| width="327" |  
Images/Image@icon44x44  
+
Images/Image@icon44x44
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getImage('<span lang="en-US">icon44x44</span>')  
+
$game-&gt;getImage('<span lang="en-US">icon44x44</span>')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="5" |  
+
| height="5" width="90" |  
Иконка размером 44<span lang="en-US">x</span>44 с фоном игры (icon44x44<span lang="en-US">bg</span>)  
+
Иконка размером 44<span lang="en-US">x</span>44 с фоном игры (icon44x44<span lang="en-US">bg</span>)
  
 
| width="327" |  
 
| width="327" |  
Images/Image@icon44x44bg  
+
Images/Image@icon44x44bg
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getImage('<span lang="en-US">icon44x44bg</span>')  
+
$game-&gt;getImage('<span lang="en-US">icon44x44bg</span>')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Иконка размером 100<span lang="en-US">x</span>100 на белом фоне (icon100x100)  
+
Иконка размером 100<span lang="en-US">x</span>100 на белом фоне (icon100x100)
  
 
| width="327" |  
 
| width="327" |  
Images/Image@icon100x100  
+
Images/Image@icon100x100
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getImage('<span lang="en-US">icon100x100</span>')  
+
$game-&gt;getImage('<span lang="en-US">icon100x100</span>')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Иконка размером 100<span lang="en-US">x</span>100 с фоном игры (icon100x100<span lang="en-US">bg</span>)  
+
Иконка размером 100<span lang="en-US">x</span>100 с фоном игры (icon100x100<span lang="en-US">bg</span>)
  
 
| width="327" |  
 
| width="327" |  
Images/Image@icon100x100bg  
+
Images/Image@icon100x100bg
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getImage('<span lang="en-US">icon100x100bg</span>')  
+
$game-&gt;getImage('<span lang="en-US">icon100x100bg</span>')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Логотип игры размером 190<span lang="en-US">x</span>140 игры (<span lang="en-US">logo</span>190x140)  
+
Логотип игры размером 190<span lang="en-US">x</span>140 игры (<span lang="en-US">logo</span>190x140)
  
 
| width="327" |  
 
| width="327" |  
Images/Image@logo190x140  
+
Images/Image@logo190x140
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getImage('logo190x140')  
+
$game-&gt;getImage('logo190x140')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="5" |  
+
| height="5" width="90" |  
Рисунок размером 586x152 (banner586x152)  
+
Рисунок размером 586x152 (banner586x152)
  
 
| width="327" |  
 
| width="327" |  
Images/Image@banner586x152  
+
Images/Image@banner586x152
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getImage('<span lang="en-US">banner586x152</span>')  
+
$game-&gt;getImage('<span lang="en-US">banner586x152</span>')
  
 
|-
 
|-
| width="622" valign="TOP" height="6" colspan="3" |  
+
| height="6" valign="top" width="622" colspan="3" |  
<span lang="en-US">Screenshot (</span>Скриншоты<span lang="en-US">)</span>  
+
<span lang="en-US">Screenshot (</span>Скриншоты<span lang="en-US">)</span>
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
<span lang="en-US">URL </span>иконки скриншота (<span lang="en-US">small)</span>  
+
<span lang="en-US">URL </span>иконки скриншота (<span lang="en-US">small)</span>
  
 
| width="327" |  
 
| width="327" |  
<br>  
+
<br>
  
 
| width="177" |  
 
| width="177" |  
$Screenshots[$<span lang="en-US">i</span>]['<span lang="en-US">small</span>']['Url']  
+
$Screenshots[$<span lang="en-US">i</span>]['<span lang="en-US">small</span>']['Url']
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Ширина<span lang="en-US"> </span>иконки скриншота (<span lang="en-US">small)</span>  
+
Ширина<span lang="en-US"> </span>иконки скриншота (<span lang="en-US">small)</span>
  
 
| width="327" |  
 
| width="327" |  
<br>  
+
<br>
  
 
| width="177" |  
 
| width="177" |  
$Screenshots[$<span lang="en-US">i</span>]['<span lang="en-US">small</span>']['<span lang="en-US">Width</span>']  
+
$Screenshots[$<span lang="en-US">i</span>]['<span lang="en-US">small</span>']['<span lang="en-US">Width</span>']
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Высота<span lang="en-US"> </span>иконки скриншота (<span lang="en-US">small)</span>  
+
Высота<span lang="en-US"> </span>иконки скриншота (<span lang="en-US">small)</span>
  
 
| width="327" |  
 
| width="327" |  
<br>  
+
<br>
  
 
| width="177" |  
 
| width="177" |  
$Screenshots[$<span lang="en-US">i</span>]['<span lang="en-US">small</span>']['<span lang="en-US">Height</span>']  
+
$Screenshots[$<span lang="en-US">i</span>]['<span lang="en-US">small</span>']['<span lang="en-US">Height</span>']
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
<span lang="en-US">URL </span>скриншота (<span lang="en-US">big</span>)  
+
<span lang="en-US">URL </span>скриншота (<span lang="en-US">big</span>)
  
 
| width="327" |  
 
| width="327" |  
<br>  
+
<br>
  
 
| width="177" |  
 
| width="177" |  
$Screenshots[$<span lang="en-US">i</span>]['big']['Url']  
+
$Screenshots[$<span lang="en-US">i</span>]['big']['Url']
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Ширина<span lang="en-US"> </span>скриншота (<span lang="en-US">big)</span>  
+
Ширина<span lang="en-US"> </span>скриншота (<span lang="en-US">big)</span>
  
 
| width="327" |  
 
| width="327" |  
<br>  
+
<br>
  
 
| width="177" |  
 
| width="177" |  
$Screenshots[$<span lang="en-US">i</span>]['big']['<span lang="en-US">Width</span>']  
+
$Screenshots[$<span lang="en-US">i</span>]['big']['<span lang="en-US">Width</span>']
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Высота скриншота (<span lang="en-US">big)</span>  
+
Высота скриншота (<span lang="en-US">big)</span>
  
 
| width="327" |  
 
| width="327" |  
<br>  
+
<br>
  
 
| width="177" |  
 
| width="177" |  
$Screenshots[$<span lang="en-US">i</span>]['big']['<span lang="en-US">Height</span>']  
+
$Screenshots[$<span lang="en-US">i</span>]['big']['<span lang="en-US">Height</span>']
  
 
|-
 
|-
| width="622" valign="TOP" height="5" colspan="3" |  
+
| height="5" valign="top" width="622" colspan="3" |  
<span lang="en-US">Files</span> (Дистрибутив игры)  
+
<span lang="en-US">Files</span> (Дистрибутив игры)
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Ссылка на скачиваемый дистрибутив (<span lang="en-US">distrib</span>)  
+
Ссылка на скачиваемый дистрибутив (<span lang="en-US">distrib</span>)
  
 
| width="327" |  
 
| width="327" |  
Files/File@distrib  
+
Files/File@distrib
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getDownloadFileUrl()  
+
$game-&gt;getDownloadFileUrl()
  
 
|-
 
|-
| width="622" valign="TOP" height="6" colspan="3" |  
+
| height="6" valign="top" width="622" colspan="3" |  
<span lang="en-US">RelatedItem</span> (Элементы связанные с данным)  
+
<span lang="en-US">RelatedItem</span> (Элементы связанные с данным)
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Массив объектов игр, связанных с данным  
+
Массив объектов игр, связанных с данным
  
 
| width="327" |  
 
| width="327" |  
<span lang="en-US">RelatedItems/RelatedItemCatalog@onlinegames/RelatedItem</span>  
+
<span lang="en-US">RelatedItems/RelatedItemCatalog@onlinegames/RelatedItem</span>
  
 
| width="177" |  
 
| width="177" |  
$game-&gt;getRelatedItems('onlinegames')  
+
$game-&gt;getRelatedItems('onlinegames')
  
 
|-
 
|-
| width="622" valign="TOP" height="6" colspan="3" |  
+
| height="6" valign="top" width="622" colspan="3" |  
 
<span lang="en-US">Onlinegames</span> (онлайновые флеш-игры)  
 
<span lang="en-US">Onlinegames</span> (онлайновые флеш-игры)  
  
 
Тег в <span lang="en-US">xml</span> дан относительно <span lang="en-US">ALAWAR</span>_<span lang="en-US">EXPORT</span>/<span lang="en-US">Languages</span>/<span lang="en-US">Language</span>/<span lang="en-US">Catalogs</span>/<span lang="en-US">Catalog</span>@”<span lang="en-US">onlinegames</span>”/<span lang="en-US">Items</span>/<span lang="en-US">Item</span>  
 
Тег в <span lang="en-US">xml</span> дан относительно <span lang="en-US">ALAWAR</span>_<span lang="en-US">EXPORT</span>/<span lang="en-US">Languages</span>/<span lang="en-US">Language</span>/<span lang="en-US">Catalogs</span>/<span lang="en-US">Catalog</span>@”<span lang="en-US">onlinegames</span>”/<span lang="en-US">Items</span>/<span lang="en-US">Item</span>  
  
<br>  
+
<br>
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
<span lang="en-US">URL </span>онлайн<span lang="en-US">-</span>игры  
+
<span lang="en-US">URL </span>онлайн<span lang="en-US">-</span>игры
  
 
| width="327" |  
 
| width="327" |  
Properties<span lang="en-US">/Property@PageUrl</span>  
+
Properties<span lang="en-US">/Property@PageUrl</span>
  
 
| width="177" |  
 
| width="177" |  
$<span lang="en-US">oG</span>ame-&gt;getProperty('<span lang="en-US">PageUrl</span> ')  
+
$<span lang="en-US">oG</span>ame-&gt;getProperty('<span lang="en-US">PageUrl</span> ')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Рекомендуемая ширина окна с онлайн-игрой  
+
Рекомендуемая ширина окна с онлайн-игрой
  
 
| width="327" |  
 
| width="327" |  
Properties<span lang="en-US">/Property@Width</span>  
+
Properties<span lang="en-US">/Property@Width</span>
  
 
| width="177" |  
 
| width="177" |  
$<span lang="en-US">oG</span>ame-&gt;getProperty(' Width')  
+
$<span lang="en-US">oG</span>ame-&gt;getProperty(' Width')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Рекомендуемая высота окна с онлайн-игрой  
+
Рекомендуемая высота окна с онлайн-игрой
  
 
| width="327" |  
 
| width="327" |  
Properties<span lang="en-US">/Property@Height</span>  
+
Properties<span lang="en-US">/Property@Height</span>
  
 
| width="177" |  
 
| width="177" |  
$<span lang="en-US">oG</span>ame-&gt;getProperty('Height ')  
+
$<span lang="en-US">oG</span>ame-&gt;getProperty('Height ')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Ширина <span lang="en-US">swf</span>-файла с игрой  
+
Ширина <span lang="en-US">swf</span>-файла с игрой
  
 
| width="327" |  
 
| width="327" |  
Properties<span lang="en-US">/Property@swfWidth</span>  
+
Properties<span lang="en-US">/Property@swfWidth</span>
  
 
| width="177" |  
 
| width="177" |  
$<span lang="en-US">oG</span>game-&gt;getProperty('SwfWidth ')  
+
$<span lang="en-US">oG</span>game-&gt;getProperty('SwfWidth ')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="6" |  
+
| height="6" width="90" |  
Высота <span lang="en-US">swf</span>-файла с игрой  
+
Высота <span lang="en-US">swf</span>-файла с игрой
  
 
| width="327" |  
 
| width="327" |  
Properties<span lang="en-US">/Property@swfHeight</span>  
+
Properties<span lang="en-US">/Property@swfHeight</span>
  
 
| width="177" |  
 
| width="177" |  
$<span lang="en-US">oG</span>ame-&gt;getProperty(' Swf<span lang="en-US">Height</span>')  
+
$<span lang="en-US">oG</span>ame-&gt;getProperty(' Swf<span lang="en-US">Height</span>')
  
|- valign="TOP"
+
|- valign="top"
| width="90" height="5" |  
+
| height="5" width="90" |  
<span lang="en-US">HTML</span>-код тега <span lang="en-US">embed</span> для вставки игры на страницу  
+
<span lang="en-US">HTML</span>-код тега <span lang="en-US">embed</span> для вставки игры на страницу
  
 
| width="327" |  
 
| width="327" |  
Properties<span lang="en-US">/Property@Embed</span>  
+
Properties<span lang="en-US">/Property@Embed</span>
  
 
| width="177" |  
 
| width="177" |  
$<span lang="en-US">oG</span>ame-&gt;getProperty('<span lang="en-US">Embed</span> ')  
+
$<span lang="en-US">oG</span>ame-&gt;getProperty('<span lang="en-US">Embed</span> ')
  
 
|}
 
|}
  
<font color="#4f81bd"><font face="Cambria, serif"><font size="3" style="font-size: 13pt;">'''Описание формата данных жанров'''</font></font></font>  
+
<font color="#4f81bd"><font face="Cambria, serif"><font style="font-size: 13pt" size="3">'''Описание формата данных жанров'''</font></font></font>  
  
 
Данные жанров игр имеют следующий формат:  
 
Данные жанров игр имеют следующий формат:  
  
<font face="Courier New, monospace"><font size="2" style="font-size: 9pt;"><span lang="en-US">array</span>(</font></font>  
+
<font face="Courier New, monospace"><font style="font-size: 9pt" size="2"><span lang="en-US">array</span>(</font></font>  
  
<font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">'<span lang="en-US">name</span>' =&gt; 'имя-жанра',</font></font>  
+
<font face="Courier New, monospace"><font style="font-size: 9pt" size="2">'<span lang="en-US">name</span>' =&gt; 'имя-жанра',</font></font>  
  
<font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">'<span lang="en-US">code</span>' =&gt; 'код-жанра',</font></font>  
+
<font face="Courier New, monospace"><font style="font-size: 9pt" size="2">'<span lang="en-US">code</span>' =&gt; 'код-жанра',</font></font>  
  
<font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">'<span lang="en-US">action</span>' =&gt; '<span lang="en-US">genre</span>', // служебная информация для формирования <span lang="en-US">URI</span> к странице жанра</font></font>  
+
<font face="Courier New, monospace"><font style="font-size: 9pt" size="2">'<span lang="en-US">action</span>' =&gt; '<span lang="en-US">genre</span>', // служебная информация для формирования <span lang="en-US">URI</span> к странице жанра</font></font>  
  
<font face="Courier New, monospace"><font size="2" style="font-size: 9pt;">);</font></font>  
+
<font face="Courier New, monospace"><font style="font-size: 9pt" size="2">);</font></font>  
  
 
<font color="#365f91"><font face="Cambria, serif"><font size="4">'''Приложение 2. Дополнительная информация по эксплуатации витрины'''</font></font></font>  
 
<font color="#365f91"><font face="Cambria, serif"><font size="4">'''Приложение 2. Дополнительная информация по эксплуатации витрины'''</font></font></font>  
  
<font color="#4f81bd"><font face="Cambria, serif"><font size="3" style="font-size: 13pt;">'''Описание основных значений конфигурации витрины'''</font></font></font>  
+
<font color="#4f81bd"><font face="Cambria, serif"><font style="font-size: 13pt" size="3">'''Описание основных значений конфигурации витрины'''</font></font></font>  
  
 
Таблица 3. Описание основных значений конфигурации витрины.  
 
Таблица 3. Описание основных значений конфигурации витрины.  
  
{| cellspacing="0" cellpadding="7" border="1" width="632"
+
{| border="1" cellspacing="0" cellpadding="7" width="632"
|- valign="TOP"
+
|- valign="top"
 
| width="208" |  
 
| width="208" |  
Константа <span lang="en-US">SA</span>_<span lang="en-US">CODEPAGE</span>  
+
Константа <span lang="en-US">SA</span>_<span lang="en-US">CODEPAGE</span>
  
 
| width="394" |  
 
| width="394" |  
Кодировка витрины (Пример: “<span lang="en-US">windows</span>-1251”, “<span lang="en-US">urf</span>-8”, “<span lang="en-US">koi</span>8-<span lang="en-US">r</span>”); Рекомендуемое значение – <span lang="en-US">windows</span>1251.  
+
Кодировка витрины (Пример: “<span lang="en-US">windows</span>-1251”, “<span lang="en-US">urf</span>-8”, “<span lang="en-US">koi</span>8-<span lang="en-US">r</span>”); Рекомендуемое значение – <span lang="en-US">windows</span>1251.
  
|- valign="TOP"
+
|- valign="top"
 
| width="208" |  
 
| width="208" |  
Константа SA_CACHE_LIFETIME  
+
Константа SA_CACHE_LIFETIME
  
 
| width="394" |  
 
| width="394" |  
Задает время жизни данных об играх, значение указывается в секундах; по умолчанию – 86400 .Данная константа задает период обновления данных об играх с сервера <span lang="en-US">Alawar</span> <span lang="en-US">Entertainment</span>, <span lang="en-US">Inc</span>.  
+
Задает время жизни данных об играх, значение указывается в секундах; по умолчанию – 86400 .Данная константа задает период обновления данных об играх с сервера <span lang="en-US">Alawar</span> <span lang="en-US">Entertainment</span>, <span lang="en-US">Inc</span>.
  
|- valign="TOP"
+
|- valign="top"
 
| width="208" |  
 
| width="208" |  
Константа<span lang="en-US"> SA_USE_LOCAL_IMG_STORAGE</span>  
+
Константа<span lang="en-US"> SA_USE_LOCAL_IMG_STORAGE</span>
  
 
| width="394" |  
 
| width="394" |  
Если на витрине используется локальная графика для игр, то значение параметра должно быть “<span lang="en-US">true</span>”; значение по умолчанию – “<span lang="en-US">false</span>”.  
+
Если на витрине используется локальная графика для игр, то значение параметра должно быть “<span lang="en-US">true</span>”; значение по умолчанию – “<span lang="en-US">false</span>”.
  
|- valign="TOP"
+
|- valign="top"
 
| width="208" |  
 
| width="208" |  
Константа<span lang="en-US">
+
Константа<span lang="en-US"> SA_USE_LOCAL_DISTRIB_STORAGE</span>
SA_USE_LOCAL_DISTRIB_STORAGE</span>  
 
  
 
| width="394" |  
 
| width="394" |  
Если на витрине используются локальные дистрибутивы игр, то значение параметра должно быть “<span lang="en-US">true</span>”; значение по умолчанию – “<span lang="en-US">false</span>”.  
+
Если на витрине используются локальные дистрибутивы игр, то значение параметра должно быть “<span lang="en-US">true</span>”; значение по умолчанию – “<span lang="en-US">false</span>”.
  
|- valign="TOP"
+
|- valign="top"
 
| width="208" |  
 
| width="208" |  
Константа<span lang="en-US"> SA_HTML_CACHE_LIFETIME</span>  
+
Константа<span lang="en-US"> SA_HTML_CACHE_LIFETIME</span>
  
 
| width="394" |  
 
| width="394" |  
Время жизни кеша страниц витрины, значение указывается в секундах; по умолчанию – 86400 секунд. Данная константа задает период обновления <span lang="en-US">html</span>-кода страниц витрины на сервере партнера.  
+
Время жизни кеша страниц витрины, значение указывается в секундах; по умолчанию – 86400 секунд. Данная константа задает период обновления <span lang="en-US">html</span>-кода страниц витрины на сервере партнера.
  
|- valign="TOP"
+
|- valign="top"
 
| width="208" |  
 
| width="208" |  
Константа SA_DEFAULT_LANGUAGE  
+
Константа SA_DEFAULT_LANGUAGE
  
 
| width="394" |  
 
| width="394" |  
 
Должна соответствовать рынку:  
 
Должна соответствовать рынку:  
  
Русский рынок: (ru).  
+
Русский рынок: (ru).
  
|- valign="TOP"
+
|- valign="top"
 
| width="208" |  
 
| width="208" |  
Константа SA_DEFAULT_CATALOG  
+
Константа SA_DEFAULT_CATALOG
  
 
| width="394" |  
 
| width="394" |  
Строка 821: Строка 768:
 
Данная константа задает раздел витрины по умолчанию.  
 
Данная константа задает раздел витрины по умолчанию.  
  
<br>  
+
<br>
  
|- valign="TOP"
+
|- valign="top"
 
| width="208" |  
 
| width="208" |  
Константа <span lang="en-US">SA_ADMIN_LOGIN</span>  
+
Константа <span lang="en-US">SA_ADMIN_LOGIN</span>
  
 
| width="394" |  
 
| width="394" |  
Задается логин для входа в административную зону витрины  
+
Задается логин для входа в административную зону витрины
  
|- valign="TOP"
+
|- valign="top"
 
| width="208" |  
 
| width="208" |  
Константа <span lang="en-US">SA_ADMIN_PASSWORD</span>  
+
Константа <span lang="en-US">SA_ADMIN_PASSWORD</span>
  
 
| width="394" |  
 
| width="394" |  
Задается пароль для входа в административную зону витрины  
+
Задается пароль для входа в административную зону витрины
  
 
|}
 
|}
  
<br>  
+
<br>
  
<font color="#4f81bd"><font face="Cambria, serif"><font size="3" style="font-size: 13pt;">'''Параметры кеширования данных на витрине'''</font></font></font>  
+
<font color="#4f81bd"><font face="Cambria, serif"><font style="font-size: 13pt" size="3">'''Параметры кеширования данных на витрине'''</font></font></font>  
  
 
При эксплуатации витрины необходимо помнить следующие моменты:  
 
При эксплуатации витрины необходимо помнить следующие моменты:  
  
#Витрина в соответствии с конфигурационным файлом (константа SA_CACHE_LIFETIME) обновляет данные по играм с сервера <span lang="en-US">Alawar</span>. Рекомендуемый интервал обновления 86400секунд.  
+
#Витрина в соответствии с конфигурационным файлом (константа SA_CACHE_LIFETIME) обновляет данные по играм с сервера <span lang="en-US">Alawar</span>. Рекомендуемый интервал обновления 86400секунд.
 
+
#Витрина в процессе работы создает <span lang="en-US">html</span>-кеш страниц витрины для повышения производительности работы (константа <span lang="en-US">SA</span>_<span lang="en-US">HTML</span>_<span lang="en-US">CACHE</span>_<span lang="en-US">LIFETIME</span> конфигурационного файла). Это позволяет ускорить загрузку страниц витрины.
#Витрина в процессе работы создает <span lang="en-US">html</span>-кеш страниц витрины для повышения производительности работы (константа <span lang="en-US">SA</span>_<span lang="en-US">HTML</span>_<span lang="en-US">CACHE</span>_<span lang="en-US">LIFETIME</span> конфигурационного файла). Это позволяет ускорить загрузку страниц витрины.  
+
#Очистку кеша витрины (отображения актуального контента) необходимо проводить следующим образом:
 
 
#Очистку кеша витрины (отображения актуального контента) необходимо проводить следующим образом:  
 
  
<br> Вариант 1 (более осторожный и долгий):  
+
<br>Вариант 1 (более осторожный и долгий):  
  
 
Выставить в файле <span lang="en-US">config</span>.<span lang="en-US">inc</span>.<span lang="en-US">php</span> значение константы «<span lang="en-US">SA</span>_<span lang="en-US">HTML</span>_<span lang="en-US">CACHE</span>_<span lang="en-US">LIFETIME</span>» в 0. После этого перегрузить необходимые страницы витрины.  
 
Выставить в файле <span lang="en-US">config</span>.<span lang="en-US">inc</span>.<span lang="en-US">php</span> значение константы «<span lang="en-US">SA</span>_<span lang="en-US">HTML</span>_<span lang="en-US">CACHE</span>_<span lang="en-US">LIFETIME</span>» в 0. После этого перегрузить необходимые страницы витрины.  
Строка 863: Строка 808:
 
Базовая витрина - это веб-приложение, написанное на PHP, которое устанавливается на сервер. Непосредственная работа с ним производится через веб-браузер - Internet Explorer, Mozilla или др. Для успешной работы нужно, чтобы и сервер, и клиент удовлетворяли определенным требованиям.  
 
Базовая витрина - это веб-приложение, написанное на PHP, которое устанавливается на сервер. Непосредственная работа с ним производится через веб-браузер - Internet Explorer, Mozilla или др. Для успешной работы нужно, чтобы и сервер, и клиент удовлетворяли определенным требованиям.  
  
<font color="#4f81bd"><font face="Cambria, serif"><font size="3" style="font-size: 13pt;">'''Требования для сервера:'''</font></font></font>  
+
<font color="#4f81bd"><font face="Cambria, serif"><font style="font-size: 13pt" size="3">'''Требования для сервера:'''</font></font></font>  
 +
 
 +
*Операционная система: Unix (Linux), Windows
  
*Операционная система: Unix (Linux), Windows
+
*Веб-сервер: Apache
  
*Веб-сервер: Apache  
+
*Версия<span lang="en-US"> </span>PHP может быть и как модуль Apache и в режиме CGI.
  
*Версия<span lang="en-US">
+
PHP: PHP4 &gt;= 4.3.0 or PHP5.  
PHP: PHP4 &gt;= 4.3.0 or PHP5. </span>PHP может быть и как модуль Apache и в режиме CGI.  
 
  
*Опция Safe mode должна быть выставлена в "Off".  
+
*Опция Safe mode должна быть выставлена в "Off".
  
<br> Рекомендуется (не обязательно) для веб-сервера также установить:  
+
<br>Рекомендуется (не обязательно) для веб-сервера также установить:  
  
*<span lang="en-US">Apache</span> с модулями <span lang="en-US">mod</span>_<span lang="en-US">rewrite</span> (для формирования <span lang="en-US">SEF</span>-путей); <span lang="en-US">gd</span> <span lang="en-US">module</span> (для корректной работы <span lang="en-US">captcha</span>).  
+
*<span lang="en-US">Apache</span> с модулями <span lang="en-US">mod</span>_<span lang="en-US">rewrite</span> (для формирования <span lang="en-US">SEF</span>-путей); <span lang="en-US">gd</span> <span lang="en-US">module</span> (для корректной работы <span lang="en-US">captcha</span>).
  
<br> <font color="#4f81bd"><font face="Cambria, serif"><font size="3" style="font-size: 13pt;">'''Требования для клиента:'''</font></font></font>  
+
<br><font color="#4f81bd"><font face="Cambria, serif"><font style="font-size: 13pt" size="3">'''Требования для клиента:'''</font></font></font>  
  
*Рекомендуемые: браузер Mozilla Firefox для любой операционной системы, Internet Explorer 7+ для Windows  
+
*Рекомендуемые: браузер Mozilla Firefox для любой операционной системы, Internet Explorer 7+ для Windows
  
*Required: любой графический браузер для любой ОС (Netscape, IE, Opera, Konqueror для Windows, Unix, Mac)  
+
*Required: любой графический браузер для любой ОС (Netscape, IE, Opera, Konqueror для Windows, Unix, Mac)
  
*Hardware: достаточно современный компьютер  
+
*Hardware: достаточно современный компьютер
  
<br> <font color="#4f81bd"><font face="Cambria, serif"><font size="3" style="font-size: 13pt;">'''Замечание по поводу использования памяти:'''</font></font></font>  
+
<br><font color="#4f81bd"><font face="Cambria, serif"><font style="font-size: 13pt" size="3">'''Замечание по поводу использования памяти:'''</font></font></font>  
  
 
Сейчас в Базовой витрине есть части, которые требуют больше 128 Мб памяти,&nbsp; сконфигурированные в php.ini по умолчанию. Во многих случаях это не является проблемой, так как ограничение используется далеко не всегда.  
 
Сейчас в Базовой витрине есть части, которые требуют больше 128 Мб памяти,&nbsp; сконфигурированные в php.ini по умолчанию. Во многих случаях это не является проблемой, так как ограничение используется далеко не всегда.  
  
 
<br>
 
<br>

Версия 15:05, 4 мая 2010

Работа с экземпляром партнерских витрин

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

Содержание

  1. Определения, используемые в данном документе
  2. Введение: что это такое, для чего нужно, как это работает, примеры готовых витрин, FAQ
  3. Интеграция шаблона витрины
  4. Развертывание готовой XML-витрины на сервере партнера
  5. Приложение 1. Описание форматов данных
    1. Описание формата данных игр
    2. Описание формата данных жанров
  6. Приложение 2. Дополнительная информация по эксплуатации витрины
    1. Описание основных значений конфигурации витрины
    2. Параметры кеширования данных на витрине



Определения

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

Партнерская программа Alawar – набор услуг Alawar Entertainment, Inc. по предоставлению развлекательного игрового контента любым веб-ресурсам.

Витрина – сайт или раздел сайта участника Партнерской программы, предоставляющий информацию о продуктах компании Alawar Entertainment, Inc.

Шаблон витрины – неделимый набор файлов, включающий в себя графические материалы, стили и php-файлы, отображающие контент витрины. (Ссылка на архив с шаблоном витрины).

Скрипт витрины (ядро витрины, движок витрины) – программный скрипт, реализующий работу витрины на сервере партнера. Распространяется через Партнерскую программу Alawar.

XML-витрина – разновидность скрипта витрины компании Alawar Entertainment, Inc. Данные об играх на витрину загружаются из XML-файла. Далее по тексту «Витрина».

Рекламные блоки – это блоки небольшого размера, с описанием небольшого количества новых, хитовых или других игр. Эти блоки вставляются в другие разделы партнерского сайта и являются входными точками на партнерскую витрину. Примеры (http://www.klerk.ru/humour/)

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


Введение

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

Игры распространяются по условно-бесплатной (shareware) лицензии. Пользователь имеет право бесплатно поиграть в любую скачанную игру, после чего ему будет предложено приобрести ключ и активировать полную версию. Приобрести ключ можно через SMS, банковский перевод, электронную карту, электронные деньги и пр.

Правила участия в Партнерской программе находятся здесь:
http://partner.alawar.ru/partners_gs.php
Ответы на часто задаваемые вопросы по Партнерской программе можно найти здесь:
http://partner.alawar.ru/faq.php

Партнерская программа предоставляет ряд возможностей по интеграции контента, такие как xml-витрина, javascript-витрина, распространение флеш-игр и др. Более подробная информация представлена на официальном сайте Партнерской программы:
http://partner.alawar.ru/vitr/vconfig/


Интеграция шаблона витрины

Интеграция шаблона витрины – это добавление набора файлов шаблона витрины для изменения ее внешнего вида.

Вы можете воспользоваться одним из двух предложенных вариантов интеграции шаблона – использовать готовый шаблон из Партнерской зоны или создать собственный шаблон.

Начало работы

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

  1. Следует переименовать файл “config.inc.php.templates” на “config.inc.php” в корне витрины.
  2. Указать свой PID (идентификатор партнера), для этого нужно изменить файл config.inc.php в корне витрины:
    define( 'PARTNER_ID', XXXX );
    где XXXX - идентификатор партнера в Партнерской программе.
  3. Выставить кодировку, в которой будет отображаться витрина:
    define('SA_CODEPAGE', XXXX);
    где XXXX – любое из значений 'windows-1251' или ' utf-8'.
    Файлы шаблона витрин должны быть в выбранной кодировке.


Использование готового шаблона

Для внедрения на сайт готового шаблона вам необходимо сделать следующее:

  1. Распаковать архив в папку «…/alawar-vitrina-example/var/ru/_templates/».
  2. Скопировать архив шаблона из Партнерской зоны (ссылка).
  3. Включить использование выбранного шаблона в административной зоне витрины. На главной странице административной зоны в выпадающем списке «Название шаблона» нужно выбрать необходимый шаблон и сохранить изменения, нажав кнопку «Submit».


Создание нового шаблона

Для создания нового шаблона вам необходимо сделать следующее:

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

Файлы шаблонов составляют следующую структуру:

Пути указываются относительно папки, в которой находятся файлы шаблонов: …/alawar-vitrina-example/var/ru/_templates/default_tpl/

  • /default/base.php – точка входа на витрину. В этом файле могут быть размещены «хедер» и «футер» Партнерского сайта, должен быть включен файл шаблона «main.php» (см. ниже), интерфейс отображения скриншотов к играм.
  • /default/main.php – содержит меню жанров игр, выносные блоки с «хитовыми» и «новыми» играми, включение файлов-шаблонов со списками «хитовых», «новых» игр, по жанрам, со страницей игры. Также может содержать подключение страницы поиска, отправки сообщений в техподдержку и др.
  • /casualpcgames/game_list.php – содержит списки игр.
  • /casualpcgames/game.php – содержит страницу игры.
  • /casualpcgames/404.php – содержит сообщение, что данная страница не может быть отображена.
  • /casualpcgames/notexist.php – содержит сообщение о том, что по такому адресу страницы не существует.
  • /onlinegames/game_list.php – может содержать список онлайновых флеш-игр.
  • /default/search.php – в этом файле может находиться список игр, найденный в результате поиска.
  • /default/support.php – здесь может находиться код формы техподдержки.
  • /default/advert_block.php – может содержать рекламные блоки с «хитовыми», «новыми» и другими играми.
  • - минимальный набор шаблонов, присутствие которых необходимо для работы витрины.

По шагам:

  1. Берем архив ядра базовой витрины и распаковываем в отдельную папку.
  2. Из архива с эскизом витрины копируем файлы картинок и стилей в папку шаблона (Пример: …/alawar-vitrina-example/var/ru/_templates/default_tpl/).
  3. Установки в основном файле конфигурации. В корне дистрибутива витрины открываем файл config.inc.php.templates:


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

При разработке нового шаблона витрины рекомендуется отключать кеширование страниц витрины. Для этого выставляем значение свойства «SA_HTML_CACHE_LIFETIME» в 0.

  1. Создаем папки и пустые php-файлы шаблонов. В эти файлы копируем фрагменты html-кода, предоставленного в эскизе витрины. Разбиение html-кода можно делать, следуя рекомендациям, указанным в описании структуры файлов шаблона витрины.
  2. Далее необходимо заменить названия игр, ссылки на страницу с игрой, ссылки на скачиваемый дистрибутив, пути и размеры графических материалов и др. на соответствующие переменные, константы и методы, с помощью которых можно отобразить необходимые данные. Подробнее о переменных и методах можно узнать в таблице основных операций и таблице формата данных.
  3. При создании нового шаблона следует обратить внимание на следующие моменты:
  • Пункты меню жанров могут быть активными и неактивными, в зависимости от параметров «cat», «act» и «code», передаваемых на витрину. Поэтому необходимо на каждый пункт меню навешивать соответствующие условия на активность.
  • На странице с игрой внизу также можно отображать список игр того же жанра, к которому относится сама игра.




Формат данных указан в Приложении 1.

Документация кода витрины предоставлена по данной ссылке.

Для быстрой интеграции шаблона предлагаем вам ознакомиться с основными операциями.

Основные операции, которые могут вам потребоваться при разработке нового шаблона:

Таблица 1. Основные операции при создании шаблона витрины

Название операции

Код и результат реализации

Создание модели


Получение списка жанров

$genres= $model->createGenreMenu();


Результат:Массив с информацией по жанрам.

Каждый элемент имеет следующие поля:


array(

'name' => 'имя-жанра',

'code' => 'код-жанра',

'action' => 'genre', // служебная информация для формированияuriк странице жанра

);

Получение списка хитовых игр

$iTopGames = $model->getTopGames();

$_temp = $iTopGames->getItems();

$topGames = $_temp->getArray();


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


Пример объекта:

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) "Бизнес-симулятор крестьянского хозяйства."

["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" } } }

Получение списка новых игр

$iNewGames = $model->getNewGames();

$_temp = $iNewGames->getItems();

$newGames = $_temp->getArray();


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


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

Получение списка игр определенного жанра

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

$_temp = $iGames->getItems();

$games = $_temp->getArray();


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


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

Вывод информации по игре

$game->getProperty('Description45');

или

$game->getProperty('Description80');

или

$game->getProperty('Description450');

или

$game->getProperty('Description2000');


Результат: Строка с описанием игры размером до указанной величины.

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

Подготовка раздела с флеш-играми

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

В адресной строке должен присутствовать параметр «cat», равный «onlinegames». В этом случае автоматически инициализируется массив $games с объектами онлайн-игр.

Иначе нужно создавать отдельную модель с онлайновыми флеш-играми. Пример:

$onlineModel = $showroom->CreateModel('ru','onlinegames');

$iTopGames = $onlineModel->getTopGames();

$_temp = $iTopGames->getItems();

$oGames = $_temp->getArray();


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

В разделе простых игр получение онлайн-аналога простой игры

$onlineGames = $game->getRelatedItems('onlinegames');

$keys = array_keys( $onlineGames );

$key = $keys[0];

$onlineModel = $showroom->CreateModel('ru', 'onlinegames');

$iGames = $onlineModel->getAllGames();

$oGame = $iGames->getItem( $key );

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

В разделе онлайн-игр получение простой игры - аналога онлайн-игры

$pcGames = $game->getRelatedItems('casualpcgames');

$keys = array_keys( $pcGames );

$key = $keys[0];

$casualpcModel = $showroom->CreateModel('ru', 'casualpcgames');

$iGames = $casualpcModel->getAllGames();

$pcGame = $iGames->getItem( $key );

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


Создание рекламных блоков с играми

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


Развертывание готовой XML-витрины на сервере партнера

Для развертывания витрины необходимо иметь скрипт витрины и сервер, удовлетворяющий требованиям (Подробнее в Приложении 3).

Необходимые действия:

  1. Файлы витрины выкладываются на сервер в нужную папку.
  2. Права доступа на папки var и все содержащиеся в ней подпапки должны быть выставлены в 775 или в 777 в зависимости от настроек сервера (желательно 777).
  3. Нужно проверить значения параметров «PARTNER_ID», «SA_CODEPAGE», «SA_USE_LOCAL_IMG_STORAGE» и «SA_USE_LOCAL_DISTRIB_STORAGE», содержащихся в конфигурационном файле “config.inc.php”, он находится в корневой папке витрины. Описание данного файла смотрите ниже.
  4. Нужно зайти в административную зону витрины (Пример: http://alawar-vitrina-example/admin/index.php). Для этого нужно ввести логин и пароль (по умолчанию login:vitr; password:pass), эти значения задаются в конфигурационном файле, мы настоятельно рекомендуем сменить стандартный логин и пароль на более сложные значения, чтобы обезопасить работу административной зоны витрины. В административной зоне витрины необходимо произвести первоначальную загрузку данных об играх (на вкладке “Cache” нужно нажать кнопку “Reload Now”).
  5. Витрина готова к эксплуатации.


Опциональные действия:

  1. Чтобы сменить кодировку витрины, необходимо:
  2. В файле “config.inc.php” изменить значение константы “SA_CODEPAGE” на название необходимой кодировки; значение по умолчанию – “windows-1251”.
  3. Необходимо перекодировать в соответствующую кодировку файлы шаблонов, они находятся в папках “var/ru/_templates/*/”; * - любая папка в этом каталоге.
  4. Код витрины задокументирован, поэтому смена кодировки затронет эти комментарии, в связи с этим необходимо аналогично пункту (b) перекодировать все файлы витрины в соответствующую кодировку.
  5. Чтобы загрузить локальную графику или дистрибутивы на сервер, нужно, чтобы соответствующие параметры “SA_USE_LOCAL_IMG_STORAGE” и “SA_USE_LOCAL_DISTRIB_STORAGE” конфигурационного файла имели значение “true”. После этого нужно зайти на администраторскую страницу витрины, перейти на вкладки “Images” и “Distrib Storage” соответственно, затем нажать на кнопку “Reload Now”.


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

25 2,9 * * * .../alawar-vitrina-example/admin/reload-images.php

35 4,8 * * * .../alawar-vitrina-example/admin/reload-distribs.php

45 5,7 * * * .../alawar-vitrina-example/admin/reload-xml.php


Также сервер витрины должен удовлетворять определенным требованиям, если производится кеширование дистрибутивов и графики.



Приложение 1.

Описание форматов данных


Описание формата данных игр.


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

Таблица 2. Форматы данных

Название элемента описания игры

Тег в xml

Метод выборки из объекта игры

Имя

Name

$game->name

Символьный код

Properties/Property@SymbolCode

$game->getProperty('SymbolCode')

Дата выхода игры

Properties/Property@ReleaseDate

$game->getProperty(' ReleaseDate')

Описание игры длиной 45 символов

Properties/Property@Description45

$game->getProperty(' Description45')

Описание игры длиной 80 символов

Properties/Property@Description80

$game->getProperty(' Description80')

Описание игры длиной 450 символов

Properties/Property@Description450

$game->getProperty(' Description450')

Описание игры длиной 2000 символов

Properties/Property@Description2000

$game->getProperty(' Description2000')

Ссылка на покупку игры

Properties/Property@OrderUrl

$game->getProperty(' OrderUrl')

Images (иконки для игр)

Иконка размера 44x44 на белом фоне (icon44x44)

Images/Image@icon44x44

$game->getImage('icon44x44')

Иконка размером 44x44 с фоном игры (icon44x44bg)

Images/Image@icon44x44bg

$game->getImage('icon44x44bg')

Иконка размером 100x100 на белом фоне (icon100x100)

Images/Image@icon100x100

$game->getImage('icon100x100')

Иконка размером 100x100 с фоном игры (icon100x100bg)

Images/Image@icon100x100bg

$game->getImage('icon100x100bg')

Логотип игры размером 190x140 игры (logo190x140)

Images/Image@logo190x140

$game->getImage('logo190x140')

Рисунок размером 586x152 (banner586x152)

Images/Image@banner586x152

$game->getImage('banner586x152')

Screenshot (Скриншоты)

URL иконки скриншота (small)


$Screenshots[$i]['small']['Url']

Ширина иконки скриншота (small)


$Screenshots[$i]['small']['Width']

Высота иконки скриншота (small)


$Screenshots[$i]['small']['Height']

URL скриншота (big)


$Screenshots[$i]['big']['Url']

Ширина скриншота (big)


$Screenshots[$i]['big']['Width']

Высота скриншота (big)


$Screenshots[$i]['big']['Height']

Files (Дистрибутив игры)

Ссылка на скачиваемый дистрибутив (distrib)

Files/File@distrib

$game->getDownloadFileUrl()

RelatedItem (Элементы связанные с данным)

Массив объектов игр, связанных с данным

RelatedItems/RelatedItemCatalog@onlinegames/RelatedItem

$game->getRelatedItems('onlinegames')

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

Тег в xml дан относительно ALAWAR_EXPORT/Languages/Language/Catalogs/Catalog@”onlinegames”/Items/Item


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

Properties/Property@PageUrl

$oGame->getProperty('PageUrl ')

Рекомендуемая ширина окна с онлайн-игрой

Properties/Property@Width

$oGame->getProperty(' Width')

Рекомендуемая высота окна с онлайн-игрой

Properties/Property@Height

$oGame->getProperty('Height ')

Ширина swf-файла с игрой

Properties/Property@swfWidth

$oGgame->getProperty('SwfWidth ')

Высота swf-файла с игрой

Properties/Property@swfHeight

$oGame->getProperty(' SwfHeight')

HTML-код тега embed для вставки игры на страницу

Properties/Property@Embed

$oGame->getProperty('Embed ')

Описание формата данных жанров

Данные жанров игр имеют следующий формат:

array(

'name' => 'имя-жанра',

'code' => 'код-жанра',

'action' => 'genre', // служебная информация для формирования URI к странице жанра

);

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

Описание основных значений конфигурации витрины

Таблица 3. Описание основных значений конфигурации витрины.

Константа SA_CODEPAGE

Кодировка витрины (Пример: “windows-1251”, “urf-8”, “koi8-r”); Рекомендуемое значение – windows1251.

Константа SA_CACHE_LIFETIME

Задает время жизни данных об играх, значение указывается в секундах; по умолчанию – 86400 .Данная константа задает период обновления данных об играх с сервера Alawar Entertainment, 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).

Константа SA_DEFAULT_CATALOG

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

Простые казуальные игры - (casualpcgames).

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

Данная константа задает раздел витрины по умолчанию.


Константа SA_ADMIN_LOGIN

Задается логин для входа в административную зону витрины

Константа SA_ADMIN_PASSWORD

Задается пароль для входа в административную зону витрины


Параметры кеширования данных на витрине

При эксплуатации витрины необходимо помнить следующие моменты:

  1. Витрина в соответствии с конфигурационным файлом (константа SA_CACHE_LIFETIME) обновляет данные по играм с сервера Alawar. Рекомендуемый интервал обновления 86400секунд.
  2. Витрина в процессе работы создает html-кеш страниц витрины для повышения производительности работы (константа SA_HTML_CACHE_LIFETIME конфигурационного файла). Это позволяет ускорить загрузку страниц витрины.
  3. Очистку кеша витрины (отображения актуального контента) необходимо проводить следующим образом:


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

Выставить в файле config.inc.php значение константы «SA_HTML_CACHE_LIFETIME» в 0. После этого перегрузить необходимые страницы витрины.

Вариант 2 (Радикальный):

Необходимо удалить все файлы из папки «…/alawar-vitrina-example/var/cache/pages/».

Приложение 3. Системные требования

Базовая витрина - это веб-приложение, написанное на PHP, которое устанавливается на сервер. Непосредственная работа с ним производится через веб-браузер - Internet Explorer, Mozilla или др. Для успешной работы нужно, чтобы и сервер, и клиент удовлетворяли определенным требованиям.

Требования для сервера:

  • Операционная система: Unix (Linux), Windows
  • Веб-сервер: Apache
  • Версия PHP может быть и как модуль Apache и в режиме CGI.

PHP: PHP4 >= 4.3.0 or PHP5.

  • Опция Safe mode должна быть выставлена в "Off".


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

  • Apache с модулями mod_rewrite (для формирования SEF-путей); gd module (для корректной работы captcha).


Требования для клиента:

  • Рекомендуемые: браузер Mozilla Firefox для любой операционной системы, Internet Explorer 7+ для Windows
  • Required: любой графический браузер для любой ОС (Netscape, IE, Opera, Konqueror для Windows, Unix, Mac)
  • Hardware: достаточно современный компьютер


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

Сейчас в Базовой витрине есть части, которые требуют больше 128 Мб памяти,  сконфигурированные в php.ini по умолчанию. Во многих случаях это не является проблемой, так как ограничение используется далеко не всегда.