Шаблон для главной страницы - История изменений

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

2020-11-05T15:25:08Z

Olga: /* Новости */

2020-11-03T22:16:27Z

Новости

Olga: /* Новости */

2020-11-03T22:14:38Z

Новости

Olga: /* Организация блоков на главной странице */

2020-11-03T14:40:33Z

Организация блоков на главной странице

Olga: /* Вступительный текст */

2020-11-03T14:13:00Z

Вступительный текст

Olga: /* Организация блоков на главной странице */

2020-11-03T14:03:44Z

Организация блоков на главной странице

Olga: /* Организация блоков на главной странице */

2020-11-03T14:01:10Z

Организация блоков на главной странице

Olga: /* Организация блоков на главной странице */

2020-11-03T13:45:07Z

Организация блоков на главной странице

Olga в 13:19, 3 ноября 2020

2020-11-03T13:19:09Z

Olga: /* Добавление блоков */

2020-11-03T12:54:01Z

Добавление блоков

@@ Строка 3: / Строка 3: @@
 Вообще-то очень просто. В массиве $variables есть элемент 'is-default', который мы можем проверить. И если он true, то подтягиваем шаблон главной. Если нет - страницы нужного модуля. Вставим эту проверку в файл main.phtml:
-<pre>
+<syntaxhighlight lang="php">
      <main>
 <?php
@@ Строка 10: / Строка 10: @@
 ?>
      </main>
-</pre>
+</syntaxhighlight>
 В объекте $variables['page'] тоже есть такое свойство, но получить его невозможно. Оно, конечно, private. Всегда будет false.
@@ Строка 16: / Строка 16: @@
 И надо создать в папке php фрагмент шаблона content/home/index.phtml, который подключаем. Для начала пусть будет просто контентная страница:
-<pre>
+<syntaxhighlight lang="php">
 <?php
 $page = $variables['page'];
@@ Строка 32: / Строка 32: @@
              </div>
          </section>
-</pre>
+</syntaxhighlight>
 == Добавление блоков ==
@@ Строка 50: / Строка 50: @@
 Чтобы не тащить простыню кода, разделим content/home/index.phtml на фрагменты по блокам:
-<pre>
+<syntaxhighlight lang="php">
 <?php
 echo $this->render($variables, "content/home/intro");
@@ Строка 56: / Строка 56: @@
 echo $this->render($variables, "content/home/contacts");
 ?>
-</pre>
+</syntaxhighlight>
 === Вводный текст ===
@@ Строка 62: / Строка 62: @@
 Фрагмент content/home/intro.phtml останется аналогом контентной страницы:
-<pre>
+<syntaxhighlight lang="php">
 <?php
 $page = $variables['page'];
@@ Строка 78: / Строка 78: @@
              </div>
          </section>
-</pre>
+</syntaxhighlight>
 === Новости ===
@@ Строка 84: / Строка 84: @@
 Фрагмент для новостей content/home/news.phtml:
-<pre>
+<syntaxhighlight lang="php">
 <?php
 $newsListSettings = $variables['settings']->newslist;
@@ Строка 116: / Строка 116: @@
              </div>
          </section>
-</pre>
+</syntaxhighlight>
 === Контакты ===
@@ Строка 122: / Строка 122: @@
 Фрагмент для контактов content/home/contacts.phtml:
-<pre>
+<syntaxhighlight lang="php">
          <section>
              <div class="container">
@@ Строка 150: / Строка 150: @@
              </div>
          </section>
-</pre>
+</syntaxhighlight>
 Не забываем пополнять файлы i18n/i18n.ru.php и i18n/i18n.en.php новыми языковыми константами, которые появляются в шаблонах нашего сайта. Также добавили разметку для Edit-in-place, и теперь можем внести адрес и телефон прямо на "морде" сайта.
@@ Строка 160: / Строка 160: @@
 Кто-то из новых разработчиков задал аналогичный вопрос в группе, получил много ответов, которые его не устроили по причине сложной реализации. Что он сделал после этого? У него была верстка, вся такая из разноцветных блоков. Он в "Шаблонах данных" добавил дочерний шаблон в "Раздел сайта", назвал его "Главная", и добавил туда кучу полей типа HTML-текст с кодом section1, section2 и т.д. После чего скопировал код соответствующих блоков из верстки, и вставил в эти поля. Шаблон главной у него при этом получился, видимо, такой:
-<pre>
+<syntaxhighlight lang="php">
 <?php
 $page = $variables['page'];
@@ Строка 167: / Строка 167: @@
 <?= ($page->section2)?$page->section2:'' ?>
 ...
-</pre>
+</syntaxhighlight>
 А что, так можно было??? Конечно, можно. Но некрасиво, и нельзя поменять блоки местами.
@@ Строка 177: / Строка 177: @@
 Псевдостатические адреса задаём intro, news и contacts соответственно. После чего шаблон главной страницы приобретает вид:
-<pre>
+<syntaxhighlight lang="php">
 <?php
 /**
@@ Строка 214: / Строка 214: @@
+}
 ?>
-</pre>
+</syntaxhighlight>
 Кода получилось немного больше, но в следующей статье исправим этот недостаток. Подключили класс umiHierarchy, выбрали все дочерние страницы, выбрали соответствующие объекты и наполнили массив $blocks. Да, еще добыли путь к корневой папке нашего шаблона, чтобы не задавать статикой. В качестве данных передаём в render() массив $page, куда добавили $variables['settings'], чтобы не потерять настройки. Вообще это лучше делать по-другому, но об этом чуть позже.
@@ Строка 224: / Строка 224: @@
 В метод render() мы уже передаем не $variables, а элемент массива, содержащий данные подраздела. Здесь название массива по-прежнему будет $variables, но содержимое будет уже другим. Поэтому:
-<pre>
+<syntaxhighlight lang="php">
          <section>
              <div class="container">
@@ Строка 237: / Строка 237: @@
              </div>
          </section>
-</pre>
+</syntaxhighlight>
 === Остальные шаблоны ===
@@ Строка 243: / Строка 243: @@
 Все, что нам нужно из остальных подразделов - это заголовки, которые специально до этого были оставлены в виде слов. Поэтому меняем только одну строку:
-<pre>
+<syntaxhighlight lang="php">
                          <h2 umi:element-id="<?= $variables['id'] ?>" umi:field-name="h1" umi:empty="<?= $this->translate('empty_page_name') ?>"><?= $variables['h1'] ?></h2>
-</pre>
+</syntaxhighlight>
 === В чем преимущество? ===

@@ Строка 86: / Строка 86: @@
 <pre>
 <?php
-$newsListEltment = $variables['settings']->newslist;
+$newsListSettings = $variables['settings']->newslist;
-if (!empty($newsListEltment)) $newsPageId = $newsListEltment[0]->id;
+if (!empty($newsListSettings)) $newsPageId = $newsListSettings[0]->id;
 else $newsPageId = false;
 $newsList = $this->macros('news', 'lastlist', [$newsPageId]);

@@ Строка 86: / Строка 86: @@
 <pre>
 <?php
-$newsList = $variables['settings']->newslist;
+$newsListEltment = $variables['settings']->newslist;
-if (!empty($newsList)) $newsPageId = $newsList[0]->id;
+if (!empty($newsListEltment)) $newsPageId = $newsListEltment[0]->id;
 else $newsPageId = false;
 $newsList = $this->macros('news', 'lastlist', [$newsPageId]);

@@ Строка 191: / Строка 191: @@
+  *
   */
-$block = [];
+$blocks = [];
 $hierarchy = umiHierarchy::getInstance();
 $children = $hierarchy->getChildrenTree($variables['pageId'], false, false, 1);
@@ Строка 197: / Строка 197: @@
      $element = $hierarchy->getElement($id);
      if ($element instanceof umiHierarchyElement) {
-         $block[$id]['id'] = $element->id;
+         $blocks[$id]['id'] = $element->id;
-         $block[$id]['name'] = $element->name;
+         $blocks[$id]['name'] = $element->name;
-         $block[$id]['h1'] = $element->h1;
+         $blocks[$id]['h1'] = $element->h1;
-         $block[$id]['altName'] = $element->altName;
+         $blocks[$id]['altName'] = $element->altName;
-         $block[$id]['content'] = $element->content;
+         $blocks[$id]['content'] = $element->content;
+     }
+}
 $resourcesDir = cmsController::getInstance()->getResourcesDirectory();
-foreach ($block as $page) {
+foreach ($blocks as $page) {
      if (isset($page['altName'])) {
          if ($resourcesDir && file_exists($resourcesDir . 'php/content/home/' . $page['altName'] . '.phtml')) echo $this->render($page, 'content/home/' . $page['altName']);
@@ Строка 215: / Строка 216: @@
 </pre>
-Кода получилось немного больше, но в следующей статье исправим этот недостаток. Подключили класс umiHierarchy, выбрали все дочерние страницы, выбрали соответствующие объекты и наполнили массив $block. Да, еще добыли путь к корневой папке нашего шаблона, чтобы не задавать статикой.
+Кода получилось немного больше, но в следующей статье исправим этот недостаток. Подключили класс umiHierarchy, выбрали все дочерние страницы, выбрали соответствующие объекты и наполнили массив $blocks. Да, еще добыли путь к корневой папке нашего шаблона, чтобы не задавать статикой. В качестве данных передаём в render() массив $page, куда добавили $variables['settings'], чтобы не потерять настройки. Вообще это лучше делать по-другому, но об этом чуть позже.
 Теперь надо поменять немного шаблоны блоков, чтобы брать оттуда контент соответствующих подразделов.
@@ Строка 237: / Строка 238: @@
          </section>
 </pre>

← Предыдущая		Версия 14:13, 3 ноября 2020
Строка 220:		Строка 220:

	=== Вступительный текст ===		=== Вступительный текст ===
		+
		+	В метод render() мы уже передаем не $variables, а элемент массива, содержащий данные подраздела. Здесь название массива по-прежнему будет $variables, но содержимое будет уже другим. Поэтому:
		+
		+	<pre>
		+	<section>
		+	<div class="container">
		+	<div class="row">
		+	<div class="col-12">
		+	<h1 umi:element-id="<?= $variables['id'] ?>" umi:field-name="h1" umi:empty="<?= $this->translate('empty_page_name') ?>"><?= $variables['h1'] ?></h1>
		+	</div>
		+	<div class="col-12">
		+	<div umi:element-id="<?= $variables['id'] ?>" umi:field-name="content" umi:empty="<?= $this->translate('empty_page_content') ?>"><?= $variables['content'] ?></div>
		+	</div>
		+	</div>
		+	</div>
		+	</section>
		+	</pre>

← Предыдущая		Версия 14:03, 3 ноября 2020
Строка 216:		Строка 216:

	Кода получилось немного больше, но в следующей статье исправим этот недостаток. Подключили класс umiHierarchy, выбрали все дочерние страницы, выбрали соответствующие объекты и наполнили массив $block. Да, еще добыли путь к корневой папке нашего шаблона, чтобы не задавать статикой.		Кода получилось немного больше, но в следующей статье исправим этот недостаток. Подключили класс umiHierarchy, выбрали все дочерние страницы, выбрали соответствующие объекты и наполнили массив $block. Да, еще добыли путь к корневой папке нашего шаблона, чтобы не задавать статикой.
		+
		+	Теперь надо поменять немного шаблоны блоков, чтобы брать оттуда контент соответствующих подразделов.
		+
		+	=== Вступительный текст ===

← Предыдущая		Версия 13:45, 3 ноября 2020
Строка 170:		Строка 170:

	А что, так можно было??? Конечно, можно. Но некрасиво, и нельзя поменять блоки местами.		А что, так можно было??? Конечно, можно. Но некрасиво, и нельзя поменять блоки местами.
		+
		+	Мне больше нравится другой способ. Создаём в разделе главной страницы несколько подразделов, например, вот так:
		+
		+	[[Файл:Screenshot 22 UMI CMS - Структура сайта.png\|обрамить\|без]]
		+
		+	Псевдостатические адреса задаём intro, news и contacts соответственно. После чего шаблон главной страницы приобретает вид:
		+
		+	<pre>
		+	<?php
		+	/**
		+	* Главная страница:
		+	* - Блок с вступительным текстом
		+	* - Блок "Новости"
		+	* - Блок "Контакты"
		+	* Для удаления блока достаточно снять
		+	* у соответствующего раздела признак "Отображать в меню"
		+	* Для добавления блока надо добавить блок в структуру
		+	* раздела и создать в папке content/home файл шаблона
		+	* с именем как в поле "Псевдостатический адрес"
		+	*
		+	*/
		+	$page = $this->getHomePageBlocks();
		+	$resourcesDir = cmsController::getInstance()->getResourcesDirectory();
		+
		+	foreach ($page as $block) {
		+	if (isset($block['altName'])) {
		+	if ($resourcesDir && file_exists($resourcesDir . 'php/content/home/' . $block['altName'] . '.phtml')) echo $this->render($block, 'content/home/' . $block['altName']);
		+	else echo '<div class="alert alert-danger">Отсутствует шаблон: ', $resourcesDir, 'content/home/', $block['altName'], '.phtml</div>';
		+	}
		+	}
		+	?>
		+	</pre>

← Предыдущая		Версия 13:19, 3 ноября 2020
Строка 153:		Строка 153:

	Не забываем пополнять файлы i18n/i18n.ru.php и i18n/i18n.en.php новыми языковыми константами, которые появляются в шаблонах нашего сайта. Также добавили разметку для Edit-in-place, и теперь можем внести адрес и телефон прямо на "морде" сайта.		Не забываем пополнять файлы i18n/i18n.ru.php и i18n/i18n.en.php новыми языковыми константами, которые появляются в шаблонах нашего сайта. Также добавили разметку для Edit-in-place, и теперь можем внести адрес и телефон прямо на "морде" сайта.
		+
		+	== Организация блоков на главной странице ==
		+
		+	Хотелось бы дать возможность редактору сайта регулировать контент на главной странице, добавлять и убирать блоки, и чтобы все изменения появлялись на сайте автоматически.
		+
		+	Кто-то из новых разработчиков задал аналогичный вопрос в группе, получил много ответов, которые его не устроили по причине сложной реализации. Что он сделал после этого? У него была верстка, вся такая из разноцветных блоков. Он в "Шаблонах данных" добавил дочерний шаблон в "Раздел сайта", назвал его "Главная", и добавил туда кучу полей типа HTML-текст с кодом section1, section2 и т.д. После чего скопировал код соответствующих блоков из верстки, и вставил в эти поля. Шаблон главной у него при этом получился, видимо, такой:
		+
		+	<pre>
		+	<?php
		+	$page = $variables['page'];
		+	?>
		+	<?= ($page->section1)?$page->section1:'' ?>
		+	<?= ($page->section2)?$page->section2:'' ?>
		+	...
		+	</pre>
		+
		+	А что, так можно было??? Конечно, можно. Но некрасиво, и нельзя поменять блоки местами.