====== Пакет CMS ======
Основная функции пакета - разработка административного web-интерфейса приложения. Помимо этого пакет предоставляет возможности по созданию и выводу страниц и текстовых блоков.
====== Установка ======
Пакет базируется на функционале WEB_APP, и представляет из себя набор моделей, контроллеров, шаблонов и сервисов. Самый простой способ создать приложение - воспользоваться утилитой limb.php: <code bash> limb project_create </code>

Для ручного создания приложения на базе пакета CMS воспользуйтесь [[limb3:ru:cms:cms_manual_setup|инструкцией]].

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

Текст страницы вписывает в шаблон template/document/item.phtlm, который может быть перекрыт в вашем приложении.
====== Текстовые блоки ======
Текстовые блоки представляют из себя куски текста, которые можно редактировать из административного интерфейса, а потом легко вставлять в любое место вашего сайта.

Блоки объявляются в конфигурационном файле **text_blocks.conf.php**:
<code=php>
<?php
$conf = array(
  'footer' => array('title' => 'Подвал Сайта',
                    'content' => '<p>Подвал</p>'),
);
</code>

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

Получить содержимое блоков можно следующим образом:
<code=php>
echo lmbCmsTextBlock::getRawContent('footer');
</code>
====== Расширение административного интерфейса ======
 :!: Для автоматической генерации административного интерфейса вы можете воспользоваться пакетом [[limb3:ru:packages:constructor|CONSTRUCTOR]]

 :!: Все контроллеры, имена которых начинаются с **admin** считаются частью административного интерфейса, и проверяют пользователя на "залогиненность" (см. lmbCmsAccessPolicyFilter)

Разберем на примере добавления новостей на сайт:

==== Схема базы ====
Для начала создадим таблицу **news**:

<code=sql>
CREATE TABLE  `skel`.`news` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `title` varchar(255) NOT NULL DEFAULT '',
  `content` longtext NOT NULL,
  `ctime` int(11) NOT NULL,
  PRIMARY KEY (`id`)
);
</code>

==== Создание модели и контроллера ====
Для создания контроллеров, типичных для CRUD'ов, удобнее всего воспользоваться классом lmbAdminObjectController, в качестве базового. Для этого сначала создадим модель (файл /src/model/News.class.php):
<code=php>
<?php
lmb_require('limb/active_record/src/lmbActiveRecord.class.php');

class News extends lmbActiveRecord {}
</code>
и контроллер (файл /src/controller/AdminNewsController.class.php)
<code=php>
<?php
lmb_require('limb/cms/src/controller/lmbAdminObjectController.class.php');
lmb_require('src/model/News.class.php');

class AdminNewsController extends lmbAdminObjectController
{
  protected $_object_class_name = 'News';
}
</code>
==== Создание шаблонов ====
Добавим шаблоны для отображения списка новостей (файл template/admin_news/display.phtml):
<code=php>
{{wrap with="admin_page_layout.phtml" into="content_zone"}}
    <div id="header">
      <h1>Новости</h1>
      <div class="header_actions">
        <a href='{{route_url params="controller:admin_news,action:create"/}}' title="Добавить элемент" class='thickbox'><img src='/shared/cms/images/icons/page_white_add.png'/> Добавить новость</a>
      </div>
    </div>

    <div id="body">
      {{list using='{$#items}' parity='{$parity}'}}
      {{include file="_admin_object/actions.phtml"/}}
      <div class="list">
        <table>
          <tr>
            <th>#ID</th><th>Заголовок</th><th>Дата</th><th>Действия</th>
          </tr>
          {{list:item}}
            <tr class='{$parity}'>
              <td>#{$item.id}</td><td>{$item.title}</td><td>{$item.ctime|date:'Y'}</td>
              <td class='actions'>
                {{apply template="object_action_edit" item="{$item}" icon="page_white_edit" /}}
                {{apply template="object_action_delete" item="{$item}" icon="page_white_delete" /}}
              </td>
            </tr>
            {{/list:item}}          
          </table>
        </div>
      {{/list}}
    </div>
{{/wrap}}
</code>
, шаблон формы (файл template/admin_news/include/form_fields.phtml)
<code php>
{{include file='_admin/form_errors.phtml'/}}
<div class='tabs'>

  <ul>
    <li id='properties'><a href="#">Свойства</a></li>
  </ul>
  
  <div id="tab_properties">
    <dl class="required field">
      <dt><label for="title">Заголовок:</label></dt>
      <dd>{{input type="text" name="title" id="title" title="Заголовок"/}}</dd>
    </dl>
    <dl class="field">
      <dt>{{label for="content"}}Текст:{{/label}}</dt>
      <dd>{{textarea name="content" id="content" title="Текст"/}}</dd>
    </dl>
  </div>
  
</div>
{{include file='_admin/form_buttons.phtml'/}}
</code>

, шаблоны для создания и редактирования новости (файлы template/admin_news/create.phtml и template/admin_news/edit.phtml)
<code php>
{{wrap with="admin_modal_page_layout.phtml"}}
  {{into slot='content_zone'}}
    {{form id='object_form' name='user_form' method='post' enctype="multipart/form-data"}}
      <h1>Добавление новости</h1>
      {{include file='admin_news/include/form_fields.phtml'/}}
    {{/form}}
  {{/into}}
{{/wrap}}
</code>
<code php>
{{wrap with="admin_modal_page_layout.phtml" into="content_zone"}}
  <h1>Редактирование записи {$#item.title}</h1>
  {{form id='object_form' name='object_form' method='post' enctype="multipart/form-data"}}
    {{include file='admin_news/include/form_fields.phtml'/}}
  {{/form}}
{{/wrap}}
</code>

==== Добавление пункта в меню ====
Для того, чтобы расширить стандартное меню необходимо добавить необходимую опцию в navigation-конфиг. Для этого создадим в нашем проекте файл navigation.conf.php, со следующим содержимым:
<code php>
<?php
require_once('limb/cms/settings/navigation.conf.php');

$conf[lmbCmsUserRoles::ADMIN][0]['children'][] = array(
    'title' => 'Новости',
    'url' => '/admin_news',
    'icon' => '/shared/cms/images/icons/page.png',
  );
</code>