====== Шаг9. Работа с заказами ======

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

Администратор должен иметь возможность:
  * просмотреть все заказы, 
  * просмотреть только заказы с определенным статусом (новый, в обработке, выполненный)
  * просмотреть информацию по заказу
  * сменить статус заказа

===== Просмотр и изменение статусов заказов администраторами =====



==== Шаблон admin_order/display.html ====

При помощи этого шаблона мы будет выводить список заказов. Страница будет также содержать небольшую форму, которая позволит указать статус заказов, которые нужно отобразить. Для вывода списка заказов, мы будем использовать статический find()-метод Order :: findForAdmin(), который мы добавим чуть позже. В принпипе, аналогичную задачу мы решали при выводе списка товаров на фронтальной части для покупателей с возможностью поиска и фильтрации.

Файл shop/template/admin_order/display.html:
<code xml>
<core:set title='Orders'/>
<core:WRAP file="admin_page.html" as="content">

<active_record:fetch using='src/model/Order' find='for_admin' target="orders" navigator='pager' order='date=DESC'/>

<p/><b>Filter orders:</b>
<form method="GET" id='filter_form' runat='server'>

<?php
$template->setChildDatasource('status_options_source', Order :: getStatusOptions());
?>

  <select:options_source id='status_options_source' target='status' default_value='0' default_name='Show all'/>
Filter : <select id='status' name='status' runat='server'></select>
  <input type='submit' name='filter' value="Filter" class='button'/><br/>
</form>

<core:include file='pager.html'/>

<list:list id="orders">
<table cellpadding="0" cellspacing="0" class='list'>
  <thead>
  <tr>
    <th>Date</th>
    <th>Status</th>
    <th>Summ</th>
    <th>Actions</th>
  </tr>
  </thead>
  <list:item>
  <tr class='{$Parity}'>
   <td><route_url params="action:details,id:{$id}">{$date|date:"F j, Y, G:i"}</route_url></td>
   <td>{$status_name}</td>
   <td>${$summ|number:2, '.'}</td>
   <td>
     <route_url params="action:delete,id:{$id}">Delete</route_url>
   </td>
  </tr>
  </list:item>
</table>
</list:list>
</core:wrap>
</code>

Обратите внимание вот на эти две строки:
<code php>
<?php
$template->setChildDatasource('status_options_source', Order :: getStatusOptions());
?>

<select:options_source id='status_options_source' target='status' default_value='0' default_name='Show all'/>
</code>

При помощи php-вставки мы передаем набор данных в тег [[limb3:ru:packages:wact:tags:form_tags:select_options_source_tag|<select:options_source>]]. Этот тег используется для заполнения списка опций тега <select>.

При помощи выражения {$date|date:"F j, Y, G:i"} мы вывели дату оформления заказа. Примененный фильтр [[limb3:ru:packages:wact:filters:core_filters:date_filter|date]] позволил явно указать формат вывода даты.

Также стоит отметить использование выражения {$status_name} - для вывода значения будет использован метод getStatusName(). С подобной практикой мы уже сталкивались при реализации отображения содержимого корзины.


==== Изменения в классе Order ====

Добавим метод findForAdmin() в класс Order.

Файл shop/src/model/Order.class.php:
<code php>
<?php
class Order extends lmbActiveRecord
{
  [...]
  static function findForAdmin()
  {
    $toolkit = lmbToolkit :: instance();
    $status = $toolkit->getRequest()->get('status');

    if(!$status)
      return lmbActiveRecord :: find('Order');
    else
      return lmbActiveRecord :: find('Order', 'status = ' . (int)$status);
  }
  [...]
}
?>
</code>

Нам также потребуется метод Order :: getStatusOptions(), который будет возвращать список статусов, которые доступны для заказов.

<code php>
<?php
class Order extends lmbActiveRecord
{
  [...]
  function getStatusOptions()
  {
    return array(self :: STATUS_NEW => 'New',
                 self :: STATUS_PROCESSED => 'Processed',
                 self :: STATUS_FINISHED => 'Delivered');
  }
  [...]
}
?>
</code>






==== Шаблон admin_order/details.html ====

При помощи этого шаблона мы будем отображать содержимое конкретного заказа, а также дадим администраторам возможность устанавливать новый статус заказа:

Файл shop/template/admin_order/details.html:
<code xml>
<core:set title='Single order'/>
<core:WRAP file="admin_page.html" as="content">

<active_record:fetch using='src/model/Order' target="order" first='true'>
 <fetch:param record_id='{$#request.id}'/>
</active_record:fetch>

<core:datasource id="order">
<h2>Items</h2>
<list:list from='lines'>
<table cellpadding="0" cellspacing="0" class='list'>
  <thead>
  <tr>
    <th>Title</th>
    <th>Price</th>
    <th>Quantity</th>
    <th>Summ</th>
  </tr>
  </thead>
  <list:item>
  <tr class='{$Parity}'>
   <td>{$product.title}</td>
   <td>${$price|number:2, '.'}</td>
   <td>{$quantity}</td>
   <td>${$summ|number:2, '.'}</td>
  </tr>
  </list:item>
</table>
</list:list>

<h2>Order status</h2>
Status : {$status_name}<br/>
Address : {$address}<br/>

<h2>Set other order status</h2>
<form id='form_status' name='form_status' method='post' runat='server'>
  <select:options_source from='^status_options' target='status'  default_value='0' default_name='------'/>
  Status : <select id='status' name='status' runat='server'></select>
  <br/>
  <input type='submit' class='button' name='set_status' value="Set new status" class='button'/><br/>
</form>

<h2>Customer</h2>
Name : {$user.name}<br/>
Email : <a href='mailto:{$user.email}'>{$user.email}</a><br/>
Login : {$user.login}<br/>

</core:datasource>
</core:wrap>
</code>

Посмотрите, как мы вывели список позиций заказа. Мы использования атрибут **from** тега <list:list>. Запись вида <list:list from='lines'> приводит к вызову метода get('lines') объекта Order, который вернет коллекцию (dataset) из связанных с заказом OrderLine. 

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

Обратите внимание на то, как мы заполнили список доступных статусов в данном случае - мы использовали атрибут from со значением "^status_options":
<code xml>
<select:options_source from='^status_options' target='status'  default_value='0' default_name='------'/>
Status : <select id='status' name='status' runat='server'></select>
</code>

Почему именно так? <form> тег является контейнером данных, поэтому нам необходимо было использовать модификатор видимости на "1-уровень выше", а status_options приведет к вызову getStatusOptions() у объекта класса Order, который был загружен при помощи тега <active_record:fetch> и передан в тег <core:datasource>.



==== Контроллер AdminOrderController ====

<code php>
<?php
lmb_require('src/model/Order.class.php');

class AdminOrderController extends lmbController
{
  function doDisplay()
  {
    $this->setFormDatasource($this->request, 'filter_form');
  }

  function doDelete()
  {
    try
    {
      lmbActiveRecord :: delete('Order', 'id = ' .  $this->request->getInteger('id'));
      $this->redirect();
    }
    catch(lmbARException $e)
    {
      $this->flashError('Wrond Order ID');
      $this->redirect(array('controller' => 'admin'));
      return;
    }
  }

  function doDetails()
  {
    if(!$this->request->hasPost())
      return;

    try
    {
      $order = new Order($this->request->getInteger('id'));
    }
    catch(lmbARException $e)
    {
      $this->flashError('Wrond Order ID');
      $this->redirect(array('controller' => 'admin'));
      return;
    }

    $status = $this->request->get('status');
    $this->flashMessage('Order status was changed');
    $order->setStatus($status);
    $order->save();
  }
}
?>
</code>

Надеемся, что все в данном классе для вас уже знакомо и пояснений не требует.

===== Предварительные итоги =====

Покажем внешний вид страницы списка заказов в панеле управления:

{{{limb3:ru:tutorials:shop:orders.png|}}}

и страницы конкретного заказа:

{{{limb3:ru:tutorials:shop:single_order.png|}}}

===== Просмотр заказов покупателями =====

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

Для этого мы добавим 2 шаблона profile/orders.html и profile/show_order.html и добавим метод doShowOrder(), где мы будем проверять, имеет ли пользователь право просматривать определенный заказ.



==== Шаблон profile/orders.html ====

Файл shop/template/profile/orders.html:
<code xml>
<core:set title='Your orders'/>
<core:wrap file="page.html" in="content">

<list:list from='#user.orders'>
<table cellpadding="0" cellspacing="0" class='list'>
  <thead>
  <tr>
    <th>#</th>
    <th>Date</th>
    <th>Summ</th>
    <th>Status</th>
  </tr>
  </thead>
  <list:item>
  <tr class='{$Parity}'>
   <route_url_set field='order_url' params='action:show_order,id:{$id}'/>
   <td><a href='{$order_url}'>{$id}</a></td>
   <td><a href='{$order_url}'>{$date|date:"F j, Y, G:i"}</a></td>
   <td>${$summ|number:2, '.'}</td>
   <td>{$status_name}</td>
  </tr>
  </list:item>
</table>
<list:default>
 You made no orders in our shop yet.
</list:default>
</list:list>
</core:wrap>
</code>

Так как объект пользователя всегда доступен в корневом контейнере данных шаблона, мы можем получить список его заказов при помощи конструкции from='#user.orders'. Помните, мы добавили в класс User связь с заказами один-ко-многим под названием orders. Именно это и позволяет нам использовать подобную конструкцию прямо в шаблоне.

==== Шаблон profile/show_order.html ====

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

Файл shop/template/profile/show_order.html:
<code xml>
<core:set title='Order details'/>
<core:wrap file="page.html" in="content">

<list:list from='#order.lines'>
<table cellpadding="0" cellspacing="0" class='list'>
  <thead>
  <tr>
    <th>Title</th>
    <th>Price</th>
    <th>Quantity</th>
    <th>Summ</th>
  </tr>
  </thead>
  <list:item>
  <tr class='{$Parity}'>
   <td>{$product.title}</td>
   <td>${$price|number:2, '.'}</td>
   <td>{$quantity}</td>
   <td>${$summ|number:2, '.'}</td>
  </tr>
  </list:item>
</table>
</list:list>
</core:wrap>
</code>

Конструкция <list:list from='#order.lines'> заберет из корневого контейнера данных переменную order, которую мы поставим в шаблоне из контроллера чуть ниже, затем из order возьмет переменную lines. lines - это коллекция позиций заказа.



==== Изменения в контроллере ProfileController ====

Добавим в ProfileController метод doShowOrder(), который будет загружать указанный заказ и проверять право доступа текущего пользователя к заказу:

<code php>
<?php
class ProfileController extends lmbController
{
  [...]
  function doShowOrder()
  {
    try
    {
      $order = new Order($this->request->getInteger('id'));

      if(!$order->belongsToUser($this->toolkit->getUser()))
      {
        $this->flashError('You can see only your orders!');
        $this->redirect('/');
      }

      $this->view->set('order', $order);
    }
    catch(lmbARException $e)
    {
      $this->flashError('Can\'t load order!');
      $this->redirect('/');
    }
  }

  [...]
}
?>
</code>

==== Изменения в классе Order ====

Теперь необходимо только добавить метод Order :: belongsToUser().

<code php>
class Order extends lmbActiveRecord
{
  [...]
  function belongsToUser($user)
  {
    return ($this->getUserId() == $user->getId());
  }
  [...]
}
</code>

===== Далее =====

Пока это все, о чем мы хотели рассказать Вам о Limb3 в рамках данного примера.

У нас есть для Ваc еще один шаг: [[step10|Шаг10. Рекомендации по дальнейшему изучению]].