Структура сайта: различия между версиями

Материал из Wiki from ADT Web Solutions
Перейти к навигации Перейти к поиску
(Новая страница: «На нашем сайте есть шаблон, но нет ни одной страницы. Пора создать несколько. В списке мод...»)
 
 
(не показано 26 промежуточных версий этого же участника)
Строка 1: Строка 1:
 +
== Добавление главной и внутренних страниц ==
 +
 
На нашем сайте есть шаблон, но нет ни одной страницы. Пора создать несколько. В списке модулей выбираем раздел "Структура" и видим корневую папку нашего домена:
 
На нашем сайте есть шаблон, но нет ни одной страницы. Пора создать несколько. В списке модулей выбираем раздел "Структура" и видим корневую папку нашего домена:
[[Файл:Screenshot 11 UMI CMS - Структура сайта.png|обрамить]]
+
 
 +
[[Файл:Screenshot 11 UMI CMS - Структура сайта.png|обрамить|без]]
 +
 
 +
Ставим галочку рядом с доменом и нажимаем пиктограмму с плюсом в меню над ним:
 +
 
 +
[[Файл:Screenshot 2020-10-29 UMI CMS - Добавление страницы.png|обрамить|без]]
 +
 
 +
Не забываем поставить галочку "Страница по умолчанию" в группе "Дополнительные параметры", потому что это будет наша главная страница. Поле "Псевдостатический адрес" заполняется автоматически, но можно изменить. Это поле в дальнейшем будет частью URL страницы для всех, кроме главной.
 +
 
 +
Добавим еще несколько страниц, уже не главных, для чего опять отмечаем галочкой наш домен и нажимаем плюс. В результате получаем:
 +
 
 +
[[Файл:Screenshot 2020-10-29 UMI CMS - Структура сайта.png|обрамить|без]]
 +
 
 +
Псевдостатические адреса у страниц page1 и page2 соответственно. Мы можем посмотреть каждую из страниц http://umi.example.com/page1/ и увидим то единственное, что выдает наш шаблон - "It works!".
 +
 
 +
== Отображение на странице её содержимого ==
 +
 
 +
Продолжаем эксперименты с шаблоном. Изменяем код шаблона следующим образом:
 +
 
 +
<syntaxhighlight lang="php">
 +
<h1>It works!</h1><syntaxhighlight lang="php">
 +
<?php
 +
var_dump($variables);
 +
?>
 +
</syntaxhighlight>
 +
 
 +
И видим много интересного. В массиве содержится информация о пользователе, о элементах запроса, есть заголовок страницы, но не все поля доступны в виде элементов массива $variables. Страница целиком представлена как объект $variables['full:page']. Поэтому пишем:
 +
 
 +
<syntaxhighlight lang="php">
 +
<?php
 +
$page = $variables['full:page'];
 +
?>
 +
<h1><?= $page->h1 ?></h1>
 +
<p><?= $page->content ?></p>
 +
</syntaxhighlight>
 +
 
 +
И вот наконец-то по ссылке http://umi.example.com/page1/ мы видим то, что ввели при создании страницы:
 +
 
 +
[[Файл:Screenshot 2020-10-29 Screenshot.png|обрамить|без]]
 +
 
 +
== Немного "причесать" массив $variables ==
 +
 
 +
Поскольку UMI CMS была установлена без шаблона, то файл конфигурации не был настроен на PHP-шаблонизатор, поэтому и видим всякие 'full:page' и '@name' в качестве ключей в массиве. Можно так и тащить их по всему коду, а можно создать в папке шаблона (у нас default) файл config.ini и вставить в него 4 строчки:
 +
 
 +
<pre>
 +
[system]
 +
use-php-template-data-cleaning = "1"
 +
return-array-from-macros-execution = "1"
 +
collapse-array-only-with-useless-key-in-data-cleaner = "1"
 +
</pre>
 +
 
 +
После этого можно будет получить более красивые ключи массива $varianles, например, $varianles['page'], это легко увидеть, вернув var_dump($varianles) в начало common.phtml.
 +
 
 +
== Некоторые секретные возможности UMI CMS ==
 +
 
 +
Попробуем вместо ссылки http://umi.example.com/page1/ ввести http://umi.example.com/page1/.json - круто? Это возможность, которую мы получаем прямо из коробки. Нам нет нужды делать для сайта какой-то HTML, мы можем весь сайт сделать на JS при помощи соответствующих AJAX-запросов! Или аналогичным образом сделать мобильное приложение.
 +
 
 +
Заметим, что получаемая информация вообще не зависит от нашего шаблона. Это json-массив, формируемый методом content модуля content, аналогичный тому, что передается в шаблон в массиве $variables.
 +
 
 +
К слову, ссылка http://umi.example.com/page1/.xml тоже работает. Кому что больше подходит.
 +
 
 +
Не все модули отдают контент подобным образом, но все - при помощи модуля udata, ссылка будет выглядеть примерно так http://umi.example.com/udata://news/lastlist/7/.json (где 7 - это id ленты новостей, на других сайтах может быть другой).
 +
 
 +
== Что дальше? ==
 +
 
 +
На этом можно было бы и закончить, но конечно, этого пока недостаточно для нормального сайта, поэтому перейдем к [[Создание "правильного" шаблона для сайта|созданию "нормального" шаблона]].

Текущая версия на 18:12, 5 ноября 2020

Добавление главной и внутренних страниц

На нашем сайте есть шаблон, но нет ни одной страницы. Пора создать несколько. В списке модулей выбираем раздел "Структура" и видим корневую папку нашего домена:

Screenshot 11 UMI CMS - Структура сайта.png

Ставим галочку рядом с доменом и нажимаем пиктограмму с плюсом в меню над ним:

Screenshot 2020-10-29 UMI CMS - Добавление страницы.png

Не забываем поставить галочку "Страница по умолчанию" в группе "Дополнительные параметры", потому что это будет наша главная страница. Поле "Псевдостатический адрес" заполняется автоматически, но можно изменить. Это поле в дальнейшем будет частью URL страницы для всех, кроме главной.

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

Screenshot 2020-10-29 UMI CMS - Структура сайта.png

Псевдостатические адреса у страниц page1 и page2 соответственно. Мы можем посмотреть каждую из страниц http://umi.example.com/page1/ и увидим то единственное, что выдает наш шаблон - "It works!".

Отображение на странице её содержимого

Продолжаем эксперименты с шаблоном. Изменяем код шаблона следующим образом:

<h1>It works!</h1><syntaxhighlight lang="php">
<?php
var_dump($variables);
?>

И видим много интересного. В массиве содержится информация о пользователе, о элементах запроса, есть заголовок страницы, но не все поля доступны в виде элементов массива $variables. Страница целиком представлена как объект $variables['full:page']. Поэтому пишем:

<?php
$page = $variables['full:page'];
?>
<h1><?= $page->h1 ?></h1>
<p><?= $page->content ?></p>

И вот наконец-то по ссылке http://umi.example.com/page1/ мы видим то, что ввели при создании страницы:

Screenshot 2020-10-29 Screenshot.png

Немного "причесать" массив $variables

Поскольку UMI CMS была установлена без шаблона, то файл конфигурации не был настроен на PHP-шаблонизатор, поэтому и видим всякие 'full:page' и '@name' в качестве ключей в массиве. Можно так и тащить их по всему коду, а можно создать в папке шаблона (у нас default) файл config.ini и вставить в него 4 строчки:

[system]
use-php-template-data-cleaning = "1"
return-array-from-macros-execution = "1"
collapse-array-only-with-useless-key-in-data-cleaner = "1"

После этого можно будет получить более красивые ключи массива $varianles, например, $varianles['page'], это легко увидеть, вернув var_dump($varianles) в начало common.phtml.

Некоторые секретные возможности UMI CMS

Попробуем вместо ссылки http://umi.example.com/page1/ ввести http://umi.example.com/page1/.json - круто? Это возможность, которую мы получаем прямо из коробки. Нам нет нужды делать для сайта какой-то HTML, мы можем весь сайт сделать на JS при помощи соответствующих AJAX-запросов! Или аналогичным образом сделать мобильное приложение.

Заметим, что получаемая информация вообще не зависит от нашего шаблона. Это json-массив, формируемый методом content модуля content, аналогичный тому, что передается в шаблон в массиве $variables.

К слову, ссылка http://umi.example.com/page1/.xml тоже работает. Кому что больше подходит.

Не все модули отдают контент подобным образом, но все - при помощи модуля udata, ссылка будет выглядеть примерно так http://umi.example.com/udata://news/lastlist/7/.json (где 7 - это id ленты новостей, на других сайтах может быть другой).

Что дальше?

На этом можно было бы и закончить, но конечно, этого пока недостаточно для нормального сайта, поэтому перейдем к созданию "нормального" шаблона.