From 8b258f6b6074eacddb42040aa2329efa81785483 Mon Sep 17 00:00:00 2001 From: Andrey <0test@mail.ru> Date: Tue, 3 Apr 2018 00:02:41 +0300 Subject: [PATCH] 1 --- ...20\277\320\265\321\202\320\276\320\262.md" | 68 ++++++++----------- 1 file changed, 30 insertions(+), 38 deletions(-) diff --git "a/ru/02_\320\237\320\276\320\273\321\214\320\267\320\276\320\262\320\260\321\202\320\265\320\273\321\216/03_\320\240\320\260\320\261\320\276\321\202\320\260_\321\201_\321\201\320\270\321\201\321\202\320\265\320\274\320\276\320\271/30_\320\230\321\201\320\277\320\276\320\273\321\214\320\267\320\276\320\262\320\260\320\275\320\270\320\265_\321\201\320\275\320\270\320\277\320\277\320\265\321\202\320\276\320\262.md" "b/ru/02_\320\237\320\276\320\273\321\214\320\267\320\276\320\262\320\260\321\202\320\265\320\273\321\216/03_\320\240\320\260\320\261\320\276\321\202\320\260_\321\201_\321\201\320\270\321\201\321\202\320\265\320\274\320\276\320\271/30_\320\230\321\201\320\277\320\276\320\273\321\214\320\267\320\276\320\262\320\260\320\275\320\270\320\265_\321\201\320\275\320\270\320\277\320\277\320\265\321\202\320\276\320\262.md" index 3ca4dd2b..1bbb8669 100644 --- "a/ru/02_\320\237\320\276\320\273\321\214\320\267\320\276\320\262\320\260\321\202\320\265\320\273\321\216/03_\320\240\320\260\320\261\320\276\321\202\320\260_\321\201_\321\201\320\270\321\201\321\202\320\265\320\274\320\276\320\271/30_\320\230\321\201\320\277\320\276\320\273\321\214\320\267\320\276\320\262\320\260\320\275\320\270\320\265_\321\201\320\275\320\270\320\277\320\277\320\265\321\202\320\276\320\262.md" +++ "b/ru/02_\320\237\320\276\320\273\321\214\320\267\320\276\320\262\320\260\321\202\320\265\320\273\321\216/03_\320\240\320\260\320\261\320\276\321\202\320\260_\321\201_\321\201\320\270\321\201\321\202\320\265\320\274\320\276\320\271/30_\320\230\321\201\320\277\320\276\320\273\321\214\320\267\320\276\320\262\320\260\320\275\320\270\320\265_\321\201\320\275\320\270\320\277\320\277\320\265\321\202\320\276\320\262.md" @@ -1,53 +1,45 @@ Сниппеты являются одной из самых полезных функций системы Evolution. -Сниппеты добавляют функциональность вашему сайту и делают обновления меню сайта устаревшими. +Сниппеты используются вывода динамически меняющегося содержимого - меню, комментариев, новостных лент, блогов или любого другого функционала, который возможен на языке php в связке с API системы Evolution. -В этом документе обсуждается использование сниппетов. Чтобы узнать больше о том, как создавать Сниппеты и как они работают, см. Документацию к сниппетам. +В этом документе обсуждается использование сниппетов. Чтобы узнать больше о том, как создавать сниппеты и как они работают, см. раздел для разработчиков. -Установка сниппетов -Сниппеты являются битами кода для выполнения некоторых динамических действий, таких как извлечение данных из базы данных или чтение из значений SESSION или cookie. Они обеспечивают возможность отделить «бизнес-логику» от макета и презентации вашей веб-страницы. +## Коротко о сниппетах ## -Код Сниппета хранится в базе данных, но иногда есть вспомогательные файлы, которые должны функционировать особенно сложным Сниппетом. Сниппет действует как интерфейс между Evo и вспомогательными файлами. Сниппет WebLogin - это пример Сниппета с несколькими вспомогательными файлами. Эти файлы хранятся в их собственной папке в папке / assets / snippets вашей установки Evo, например / assets / snippets / weblogin /. Сниппет, который стоит отдельно, как и большинство сниппетов, вообще не загружается в файловую систему вашего сайта. +Код сниппета, как правило, хранится в базе данных. Иногда у сниппета есть вспомогательные файлы. В таком случае, сниппет действует как интерфейс между Evo и вспомогательными файлами. -Во время установки Evo был предложен список дополнительных сниппетов, которые будут автоматически установлены. Если вы решили установить их, эти Сниппеты уже готовы для использования в ваших шаблонах или документах. +Сниппет, у которого таких файлов нет, вообще не загружается в файловую систему сайта. -Чтобы установить новый Сниппет, войдите в интерфейс администратора и перейдите в раздел Управление ресурсами и откройте вкладку «Снипеты». Нажмите ссылку «Новый Сниппет», чтобы открыть форму. Скопируйте / вставьте код из источника вашего Сниппета, обычно текстовый файл, который вы открываете в текстовом редакторе, в текстовое поле, укажите ему имя и краткое описание. Вы можете назвать Сниппет всего, что вам нравится, просто помните, что имя, которое вы ему даете, - это то, как вам нужно будет называть его позже в вашем шаблоне или источнике документа. +Во время установки Evolution вы можете увидеть список часто используемых сниппетов, которые будут установлены на сайт. Советуем изучить их внимательнее - это базовые сниппеты, которые покрывают массу возможностей вашего сайта. -При загрузке любых вспомогательных файлов, которые могут иметь Сниппеты, обычно помещать их в папку с исходным именем Сниппета в нижнем регистре, например / assets / snippets / weblogin. +## Установка сниппетов ## -Использование Сниппета меню -В нашем шаблоне пока есть некоторые персонализированные Сниппеты информации и некоторый контент. Но эта боковая панель все еще пуста. Нам нужно разместить там меню навигации. +- Установка из репозитория. +Зайтите в "Модули" - "Управление пакетами", выберите нужный вам сниппет и нажмите на кнопку "Установить". +- Установка вручную. +Чтобы установить новый сниппет, войдите в интерфейс администратора, перейдите в раздел "Элементы", выберите пункт "Сниппеты". Нажмите ссылку «Новый Сниппет», чтобы открыть форму. Вставьте код вашего сниппета, укажите ему имя и краткое описание. -Теперь это можно сделать двумя способами. Мы могли бы запрограммировать меню вручную. +Вы можете назвать сниппет так, как вам нравится, просто помните, что имя, которое вы ему даете, - это то, как вам нужно будет называть его позже в вашем шаблоне. -1 -2 -3 - Главная страница - Новости - О нас -С этим подходом существует ряд проблем. Во-первых, вы должны знать идентификатор документа страниц, на которые вы ссылаетесь. Во-вторых, что, если вы хотите использовать URL-адреса поисковой системы? Теперь вам нужно знать псевдоним каждой страницы, на которую вы ссылаетесь, а также то, как ваш сайт настроен для обработки этой функции. И, наконец, представьте, что вам нужно редактировать меню каждый раз, когда вы добавляете страницу или две ... или двадцать! +При загрузке любых вспомогательных файлов, которые могут иметь сниппеты, их обычно помещают в папку с исходным именем сниппета в нижнем регистре, например /assets/snippets/DocLister. -Здесь появляются Сниппеты Evo. Существует множество доступных для создания сниппетов меню для создания любого типа меню, которое вам нравится. Вероятно, лучшим типом являются те, которые генерируют простые неупорядоченные списки, поскольку они позволяют максимально гибко контролировать их внешний вид и поведение с помощью CSS. +## Использование сниппетов ## +Допустим, мы хотим в шаблоне вывести динамически создаваемое меню. Используем для этого сниппет под названием DLMenu. +``` + [!DLMenu? + &parents=`3` + &sortBy=`id` + &outerTpl=`@CODE: ` + &rowTpl=`@CODE:
  • [+title+]
    • ` + !] +``` +Как вы можете заметить, в сниппет передаются параметры. Как правило, описание этих параметров доступно в документации того сниппета, который вы используете. В данном случае мы указываем DLMenu откуда брать документы для меню (&parents=`3`), как их сортировать (&sortBy=`id`) и каким образом выводить результат работы - outerTpl и rowTpl. -Сниппеты меню получают список документов из базы данных, начиная с папки, указанной в тегах Сниппета в качестве корневого меню. Давайте добавим меню в наш шаблон и посмотрим, как это работает. +## Настройка вызова сниппетов ## +Вызов сниппета может быть двух видов: [[SnippetName]] или [! SnippetName!]. -1 -2 -3 -4 -