Создание настроек сайта - История изменений

Olga: /* Вывод настроек в шаблоне */

2020-11-05T20:10:01Z

Вывод настроек в шаблоне

Olga: /* Edit-in-place для настроек */

2020-11-05T15:21:39Z

Edit-in-place для настроек

Olga в 15:21, 5 ноября 2020

2020-11-05T15:21:12Z

Olga: /* Edit-in-place для настроек */

2020-11-03T13:02:13Z

Edit-in-place для настроек

Olga: /* Edit-in-place для настроек */

2020-11-03T13:01:14Z

Edit-in-place для настроек

Olga: /* Вывод настроек в шаблоне */

2020-11-02T10:21:43Z

Вывод настроек в шаблоне

Olga: /* Вывод настроек в шаблоне */

2020-11-02T10:20:58Z

Вывод настроек в шаблоне

Olga: /* Вывод настроек в шаблоне */

2020-11-02T10:17:40Z

Вывод настроек в шаблоне

Olga: /* Вывод настроек в шаблоне */

2020-11-02T09:24:30Z

Вывод настроек в шаблоне

Olga: /* Вывод настроек в шаблоне */

2020-10-31T15:54:53Z

Вывод настроек в шаблоне

@@ Строка 25: / Строка 25: @@
 И тут мы сталкиваемся с очередной засадой UMI CMS. Казалось бы, каждому сайту должен соответствовать какой-то один набор настроек. Но в интерфейсе видим, что этих наборов можно создать сколько угодно. '''Господа разработчики''', может, стоило бы для упрощения ограничить эти возможности? Кто-то вообще использует больше одного набора настроек для конкретной языковой версии сайта? Было бы шикарно получать настройки прямо в массиве $variables, как вы считаете?
-Зато есть повод поупражняться с API системы. Один из способов получить настройки - использовать заданный нами идентификатор настроек, в данном случае 'demo':
+Зато есть повод поупражняться с API системы. Один из способов получить настройки - использовать название настроек, в данном случае 'demo':
 <syntaxhighlight lang="php">
@@ Строка 34: / Строка 34: @@
 Здесь мы использовали метод getIdByName('...') модуля umiSettings для получения id настроек по названию (это именно название, не идентификатор), а потом получили сам объект настроек при помощи метода getObjectById().
-Добавим этот код в самое начало common.phtml. К счастью, в настройках разных языковых версий можно задавать один и тот же идентификатор, а то было бы совсем грустно. В общем, получилось. Если добавить на страницу <?= $settings->copyright ?>, то увидим копирайт, который ввели.
+Добавим этот код в самое начало common.phtml. К счастью, в настройках разных языковых версий можно задавать одно и то же название, а то было бы совсем грустно. В общем, получилось. Если добавить на страницу <?= $settings->copyright ?>, то увидим копирайт, который ввели.
 Теперь попробуем другой путь, ведь мы не фанаты делать кучу настроек:

@@ Строка 157: / Строка 157: @@
 Теперь осталось добавить возможность изменять эти поля прямо на сайте. В принципе, ничего сложного:
-<syntaxhighlight lang="php">
+<syntaxhighlight lang="html">
 <img umi:object-id="<?= $logo->getId() ?>" umi:field-name="logo" src="/<?= $logo->getFilePath() ?>" title="<?= $logo->getTitle() ?>" alt="<?= $logo->getAlt() ?>">
 </syntaxhighlight>

@@ Строка 27: / Строка 27: @@
 Зато есть повод поупражняться с API системы. Один из способов получить настройки - использовать заданный нами идентификатор настроек, в данном случае 'demo':
-<pre>
+<syntaxhighlight lang="php">
 $settings = $this->getObjectById($this->macros('umiSettings', 'getIdByName', 'demo']));
 var_dump($settings);
-</pre>
+</syntaxhighlight>
 Здесь мы использовали метод getIdByName('...') модуля umiSettings для получения id настроек по названию (это именно название, не идентификатор), а потом получили сам объект настроек при помощи метода getObjectById().
@@ Строка 38: / Строка 38: @@
 Теперь попробуем другой путь, ведь мы не фанаты делать кучу настроек:
-<pre>
+<syntaxhighlight lang="php">
 $set = new selector('objects');
 $set->types('object-type')->name('umiSettings', 'settings');
@@ Строка 46: / Строка 46: @@
 $settings = $set->result();
 var_dump($settings);
-</pre>
+</syntaxhighlight>
 В этом коде был использован самый мощный класс ядра UMI - selector. Он подробно описан в документации. Чего в документации нет, так это - что подставлять в качестве 'object-type'. Но в админке есть где посмотреть: 'Шаблоны данных' - 'Настройки модуля' (ссылка справа вверху). Для начала лучше в этих настройках ничего не менять, но в качестве справочника - бесценно!
@@ Строка 54: / Строка 54: @@
 UMI CMS в конце каждой страницы выдает время её формирования, что очень удобно. Легко убедиться, что второй способ на 0.001 секунды быстрее, помимо прочих его преимуществ. Конечно, неплохо бы проверить, что хоть какие-то настройки нашлись. Кроме этого, хотелось бы получить настройки в самом начале, а использовать их в произвольных фрагментах нашего шаблона. В результате модифицируем код common.phtml как-то так:
-<pre>
+<syntaxhighlight lang="php">
 <?php
 $set = new selector('objects');
@@ Строка 79: / Строка 79: @@
 </body>
 </html>
-</pre>
+</syntaxhighlight>
 Копирайт мы собирались использовать в подвале сайта, поэтому пишем в footer.phtml:
-<pre>
+<syntaxhighlight lang="php">
      <footer>
          <div class="container">
@@ Строка 90: / Строка 90: @@
          </div>
      </footer>
-</pre>
+</syntaxhighlight>
 Проверяем результат - всё получилось! Теперь надо разобраться с логотипом. Добавляем <?php var_dump($variables['settings']->logo); ?> в файл header.phtml, и видим, что это объект. Причем - ещё одна засада UMI CMS - все свойства без исключения protected!!! Зато в нем есть все, что нам нужно. Итак, изучаем документацию по классам umiFile и umiImageFile, и новый header.phtml будет выглядеть примерно так:
-<pre>
+<syntaxhighlight lang="php">
 <?php
 $pageId = isset($variables['pageId'])?$variables['pageId']:0;
@@ Строка 149: / Строка 149: @@
          </nav>
      </header>
-</pre>
+</syntaxhighlight>
 Почему перед адресом изображения стоит '/'? Потому что getFilePath() зачем-то перед адресом ставит точку, хоть адрес возвращает абсолютный. Загадка. В качестве alt и title пробуем получить значения, которые должны были задать в админке при заливке файла. Но поскольку ничего не задали, они будут пустые. А вообще, по-хорошему, надо добавить в настройки еще одно поле - название компании, и выводить именно его.
@@ Строка 157: / Строка 157: @@
 Теперь осталось добавить возможность изменять эти поля прямо на сайте. В принципе, ничего сложного:
-<pre>
+<syntaxhighlight lang="php">
 <img umi:object-id="<?= $logo->getId() ?>" umi:field-name="logo" src="/<?= $logo->getFilePath() ?>" title="<?= $logo->getTitle() ?>" alt="<?= $logo->getAlt() ?>">
-</pre>
+</syntaxhighlight>
 Это для логотипа, а для копирайта:
-<pre>
+<syntaxhighlight lang="php">
      <span umi:object-id="<?= $logo->getId() ?>" umi:field-name="logo" umi:empty="<?= $this->translate('empty_copyright') ?>">
 <?= $variables['settings']->copyright ?>
      </span> <?= date("Y") ?>
-</pre>
+</syntaxhighlight>
 Заметим, что псевдо-атрибуты для id контентных страниц и объектов отличаются, если для полей страниц мы использовали атрибут umi:element-id, то для полей объектов приходится писать umi:object-id. Это отражение внутреннего деления UMI CMS на страницы контента и объекты, за работу с которыми отвечают разные методы.

@@ Строка 169: / Строка 169: @@
 </pre>
-Заметим, что псевдо-атрибуты для id контентных страниц и объектов отличаются, если для страниц мы использовали атрибут umi:element-id, то для объектов приходится писать umi:object-id. Это отражение внутреннего деления UMI CMS на страницы контента и объекты, за работу с которыми отвечают разные методы.
+Заметим, что псевдо-атрибуты для id контентных страниц и объектов отличаются, если для полей страниц мы использовали атрибут umi:element-id, то для полей объектов приходится писать umi:object-id. Это отражение внутреннего деления UMI CMS на страницы контента и объекты, за работу с которыми отвечают разные методы.
 Также пришлось добавить дополнительный <nowiki><span></nowiki>, чтобы копирайт был в отдельном контейнере.

@@ Строка 169: / Строка 169: @@
 </pre>
-Пришлось добавить дополнительный <nowiki><span></nowiki>, чтобы копирайт был в отдельном контейнере.
+Заметим, что псевдо-атрибуты для id контентных страниц и объектов отличаются, если для страниц мы использовали атрибут umi:element-id, то для объектов приходится писать umi:object-id. Это отражение внутреннего деления UMI CMS на страницы контента и объекты, за работу с которыми отвечают разные методы.
 == Другие модули системы ==
 Пока нам для сайта хватало модуля content, немного использовали umiSettings. Однако полезных модулей гораздо больше, и пора наконец [[Другие модули системы|добавить на сайт раздел Новости]].

@@ Строка 121: / Строка 121: @@
 ?>
                      <li class="nav-item dropdown <?=$active?'active':''?>">
-                         <a class="nav-link dropdown-toggle" href="<?= $item['@link'] ?>" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"><?= $item['@name'] ?></a>
+                         <a class="nav-link dropdown-toggle" href="<?= $item['link'] ?>" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false"><?= $item['name'] ?></a>
                          <div class="dropdown-menu" aria-labelledby="navbarDropdown">
 <?php

@@ Строка 114: / Строка 114: @@
                  <ul class="navbar-nav mr-auto">
 <?php
-     foreach ($menuTree['void:lines'] as $item) {
+     foreach ($menuTree['lines'] as $item) {
          $dropdown = !empty($item['items']['nodes:item']);
          $active = !empty($item['attribute:status']);
-         if (isset($item['@link']) && isset($item['@name'])) {
+         if (isset($item['link']) && isset($item['name'])) {
              if ($dropdown) {
 ?>
@@ Строка 124: / Строка 124: @@
                          <div class="dropdown-menu" aria-labelledby="navbarDropdown">
 <?php
-                 foreach ($item['items']['nodes:item'] as $sub) {
+                 foreach ($item['items']['item'] as $sub) {
-                     if (isset($sub['@link']) && isset($sub['@name'])) {
+                     if (isset($sub['link']) && isset($sub['name'])) {
 ?>
-                             <a class="dropdown-item" href="<?= $sub['@link'] ?>"><?= $sub['@name'] ?></a>
+                             <a class="dropdown-item" href="<?= $sub['link'] ?>"><?= $sub['name'] ?></a>
 <?php
+                     }
@@ Строка 138: / Строка 138: @@
 ?>
                      <li class="nav-item  <?=$active?'active':''?>">
-                         <a class="nav-link" href="<?= $item['@link'] ?>"><?= $item['@name'] ?></a>
+                         <a class="nav-link" href="<?= $item['link'] ?>"><?= $item['name'] ?></a>
                      </li>
 <?php

@@ Строка 41: / Строка 41: @@
 $set = new selector('objects');
 $set->types('object-type')->name('umiSettings', 'settings');
-$set->where('domain_id')->equals($variables['@domain-id']);
+$set->where('domain_id')->equals($variables['domain-id']);
-$set->where('lang_id')->equals($variables['@lang-id']);
+$set->where('lang_id')->equals($variables['lang-id']);
 $set->limit(0, 1);
 $settings = $set->result();
@@ Строка 58: / Строка 58: @@
 $set = new selector('objects');
 $set->types('object-type')->name('umiSettings', 'settings');
-$set->where('domain_id')->equals($variables['@domain-id']);
+$set->where('domain_id')->equals($variables['domain-id']);
-$set->where('lang_id')->equals($variables['@lang-id']);
+$set->where('lang_id')->equals($variables['lang-id']);
 $set->limit(0, 1);
 $variables['settings'] = array_shift($set->result());
@@ Строка 96: / Строка 96: @@
 <pre>
 <?php
-$pageId = isset($variables['@pageId'])?$variables['@pageId']:0;
+$pageId = isset($variables['pageId'])?$variables['pageId']:0;
 $menuTree = $this->macros('content', 'menu', [0, 2, 0, true, $pageId]);
 $logo = $variables['settings']->logo;