Modx content: How to Add Content in MODx?

Типы содержимого в CMS MODX

На этом уроке рассмотрим, для чего нужен тип содержимого в MODX Revolution, а также то, на что он влияет. Кроме этого познакомимся с тем, как указывать ресурсу тип содержимого, как редактировать существующие типы и создавать новые.

Что такое тип содержимого

В MODX Revolution тип содержимого определяет то, какой контент содержит ресурс. Другими словами, тип содержимого — это то, что MODX будет отправлять в строчке заголовка «Content-Type». Тип содержимого в MODX Revolution можно сопоставлять с расширением файла. Это означает то, что парсер MODX, если включены дружественные URL, будет добавлять расширение, соответствующее содержимому ресурса, после псевдонима.

Узнать тип контента ресурса можно в поле «Тип содержимого», которое находиться на вкладке «Настройки».

А узнать какие есть типы содержимого и связанные с ним расширения можно на странице «Типы содержимого». Открыть данную страницу можно через главное меню админки: Сайт -> Типы содержимого.

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

Например, ресурс с псевдонимом «mytest» и типом контента «css» (расширение файла «.css») будет отображаться так:


mytest.css

Т.е. расширение ресурса в MODX зависит от типа. Это возможность позволяет создавать из ресурсов различные типы файлов.

Изменения типа содержимого ресурса

По умолчанию ресурс имеет тип содержимого «HTML». При необходимости тип содержимого ресурса можно изменить. Осуществляется это посредством раскрывающего списка «Тип содержимого», расположенного на вкладке «Настройки».

После изменения типа содержимого необходимо нажать на кнопку «Сохранить». Это действие обновит поля ресурса в базе данных и автоматически ассоциирует данный ресурс с выбранным типом содержимого.

Создание нового типа содержимого

Для создания нового типа содержимого необходимо сначала открыть страницу «Типы содержимого» (Сайт -> Типы содержимого). После этого нажать на кнопку «Новый тип содержимого». В результате этого действия появится диалоговое окно «Новый тип содержимого».

Это окно содержит следующие поля:

  • имя — это имя типа содержимого (т.е. это значение, которое будет отображаться в раскрывающем списке «Тип содержимого» на странице редактирования ресурса).
  • MIME тип — это тип данных, который должен быть указан в соответствии со стандартом передачи данных в сети Интернет. Этот тип «говорит» браузеру, что это за ресурс (что он содержит). Список MIME-типов можно, например, посмотреть здесь.
  • расширение файла — определяет то, какое окончание будет иметь псевдоним ресурса. Задавать расширение необходимо с указанием точки. Например, .doc.
  • двоичный – это опция указывает на то, относиться ли содержимое файла к text/ascii (текстовому) или binary (двоичному).
  • описание — необязательное поле, в котором можно поместить дополнительную информацию об этом содержимом.

Например, создадим тип содержимого CSV:

После заполнения полей, нажмём на кнопку «Сохранить» и новый тип контента (CSV) будет отображён в таблице.

Как убрать расширение у HTML документа

Многие веб-разработчики настраивают свои сайты так, чтобы страницы с HTML-содержимым не имели расширение .html.

В MODX это осуществляется следующим образом:

  1. Открыть окно «Типы содержимого» (Сайт->Типы содержимого).
  2. В этом окне найти строчку, описывающее содержимое HTML, нажать на неё правой кнопкой мыши и выбрать в открывшемся контекстном меню пункт «Редактировать».
  3. Убрать (стереть) все символы из поля расширения и нажать на кнопку «Сохранить».

После этого страницы (ресурсы) имеющие тип содержимого HTML будут выводиться без расширения. Это происходит, потому что у этого типа содержимого нет расширения (пустая строка).

Элементы контента — Создание сайта на MODX Revolution

Элементы контента (обычно называемые просто «элементы») в MODX означают именно то, что и предполагает их название : они являются объектами MODX, которые создают, управляют, задают формат, организуют и/или содержат контент. Понятие «элементы контента» является достаточно гибким и по мере развития MODX появляются новые элементы, а иногда элементами становятся поля ресурсов. Иногда элементы могут потерять этот статус и могут быть переквалифицированы во что-нибудь еще. Возможно лучшим рабочим определением элемента контента будет следующее : «объект, который расположен в дереве элементов слева в панели управлния MODX». Ниже мы опишем элементы, которые существуют в настоящее время : шаблоны, tv-параметры, чанки, сниппеты, плагины и категории. Необходимо, однако, иметь в виду, что в вашей версии MODX вы можете не найти некоторых из них.

Шаблоны

Большинство компаний имеют стандартные фирменные бланки, которые они используют при отправке писем. Это придает всем письмам схожий вид и сокращает время, которое понадобилось бы в ином случае для написания имени компании, адреса и т.д. Шаблон в MODX выполняет аналогичную функцию. Он содержит основную информацию, которая появляется в ряде различных веб страниц. Он обычно содержит базовые (X)HTML элементы веб страницы (DOCTYPE, <head>, <body> и т.д.), а также, например, баннер в верхней части страницы и «подвал» (footer) внизу страницы. Он может также содержать другие объекты MODX, как мы это увидим далее.

Подобно фирменному бланку шаблон будет видимо содержать заголовок и «подвал» сайта, которые будут появляться на каждой странице, которая использует этот шаблон. В отличие от фирменного бланка, однако, шаблон MODX может содержать также другие объекты MODX. Он может содержать, например, заголовок и меню. Эти элементы могут изменяться на каждой странице, но они всегда будут находиться в одном и том же месте и будут иметь тот же стиль для каждой страницы, которая использует этот шаблон.

Когда MODX получает от браузера запрос на просмотр веб страницы, она находит соответствующий ресурс (обычно документ), а затем проверяет какой шаблон используется для этого ресурса. Шаблон содержит код (X)HTML и теги MODX. MODX осуществляет доступ к шаблону в базе данных и начинает наполнять его подходящим контентом (путем замены тегов MODX) в качестве первого шага для подготовки веб страницы к передаче веб браузеру.

Начинающие пользователи MODX иногда создают больше шаблонов, чем это требуется, поскольку они не до конца понимают насколько гибкими могут быть эти шаблоны. Некоторые сайты на MODX (но не все) могут использовать один единственный шаблон не смотря на то, что на разные страницы могут выглядеть по-разному. Более детально мы разберем шаблоны далее.

TV параметры

Термин «TV параметры» (или переменные шаблона) не всегда использовался так, как сейчас. Поля ресурсов, о которых мы говорили выше, (заголовок, заголовок меню, аннотация и прочие) ранее назывались переменными шаблона даже в официальной документации MODX. В настоящее время эти элементы следует называть «поля ресурсов». TV параметры  всегда создаются пользователями, которым нужны дополнительные поля ресурсов.

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

pagetitle и createdon. Однако, что если вы также захотите также показать астрологический знак автора? Вам потребуется другое поле ресурса. К счастью вы можете легко добавить TV параметр, назвав его, например, «Sign», чтобы он содержал эту информацию (подробнее об этом далее). Теперь когда кто-то будет редактировать документ в панели управления MODX, он увидит дополнительное поле, помеченное «Sign» и служащее для ввода астрологического знака посетителя.

TV параметры — очень гибкий механизм, позволяющий хранить много различных объектов, таких как текст, изображения, код (X)HTML, даты, содержимое каталогов и т.д. Фактически мы можем легко представить наш TV параметр «Sign» в виде выпадающего списка из двенадцати астрологических знаков или в виде двенадцати радио кнопок. В MODX такие вещи делать очень легко и мы далее разберем это подробнее.

Вы можете спросить, как содержимое TV параметра попадает на веб страницу. Наиболее простым способом является поместить его в тег ресурса (resource tag) в шаблоне, связанном с этим документом. Тег ресурса выглядит подобно этому : . Как TV параметры, так и поля ресурсов могут отображаться, используя теги ресурсов. Следующий код можно использовать для отображения на странице заголовка, даты, и знака зодиака :

 

<p> Заголовок : [[*pagetitle]]<br/>
Дата создания : [[*createdon]]<br/>
Знак зодиака : [[*sign]]<br/>

 

TV параметры являются мощным и иногда недостаточно используемым элементом MODX. С их помощью можно загружать строки текста, они могут также содержать другие объекты, которые вы захотите разместить на веб странице, такие как выпадающие списки, даты и даже содержимое других документов сайта. Более детально использование TV параметров мы рассмотрим далее.

В приведенном ниже видео наглядно показан процесс создания и использования tv-параметра в MODX Revolution. Здась используется tv -параметр типа «изображение/картинка» для ресурса (страницы сайта).

Чанки

Чанк в MODX представляет собой просто повторяемую часть контента. Ключевым моментом, который необходимо помнить относительно чанков, является то, что они не могут содержать PHP код (это работа для сниппетов). Многие чанки являются просто кусками содержимого, включающего в себя  код (X)HTML, которое вы хотите разместить на различных страницах. Баннер вверху страницы, «подвал» страницы или футер внизу страницы и меню часто содержатся в чанках. Таким образом, если вы отредактируете один чанк, изменения могут быть  внесены на многих страницах, где он используется.

Чанки специального назначения, называемые чанками Tpl, используются как мини-шаблоны. Они обычно содержат текст и теги плейсхолдеров (подробнее о плейсхолдерах далее) и используются для форматирования выводимых данных. Вот простой пример, который может быть использован для отображения имени президента и вице-президента компании :

<h4> Руководство компании : </h4>
<p> Президент : [[+president]]</p>
<p> Вице-президент : [[+vice-president]]</p>

Обычно значения для тегов плейсхолдеров устанавливаются при помощи кода в соответствующем сниппете и соответствующие имена появятся после обработки чанка.

Чанки Tpl также используются для веб форм и в качестве мини-шаблонов для вывода стандартных дополнений.

Содержимое чанка может встраиваться в страницу различными способами. Наиболее обычным способом является использование для этого тега чанка в шаблоне или поле содержимого документа. Тег чанка выглядит вот так : [[$Имя чанка ]]. Мы рассмотрим некоторые другие методы встраивания содержимого чанка позже.

Сниппеты

Сниппет это просто исполняемый код PHP.  Если ваши посетители сайта могут вставлять содержимое (например, комментарии в блоге), которое немедленно появляется на сайте, что может случиться, если злонамеренный посетитель вставит в комментарий PHP код, который стирает содержимое жесткого диска?  На незащищенном сайте, когда кто-либо посетит страницу с подобным комментарием, могут быть неприятности. В MODX, однако, ничего подобного произойти не может, поскольку PHP код удаляется со страницы. Для того, чтобы выполнить код на странице, он должен быть сниппетом.

Далее на страницу вставляется код сниппета, иногда называемый вызовом сниппета). Тег сниппета выглядит следующим образом :

[[Имя сниппета]]

или

[[Имя сниппета? &firstName=`John` &lastName=`Doe`]]

Во втором примере &firstName и &lastName  представляют собой просто элементы информации, называемые свойствами сниппета (ранее назывались параметрами), которые мы хотим передать вызываемому сниппету. То, что содержится в сниппете, заменит тег сниппета на странице, передаваемой браузеру для отображения.

 

Важно : отметим, что значения свойств сниппета заключены в обратные одинарные кавычки, а не обычные кавычки. Это позволяет вам использовать обыкновенные одинарные и двойные кавычки в свойствах сниппета. Обратные одинарные кавычки обычно расположены на клавиатуре вверху слева, ниже знака ~

Использование обычных одинарных или двойных кавычек для указания в них свойств сниппета является распространенной ошибкой неопытных пользователей MODX. В этом случае ваш сниппет просто не будет работать. Другой обычной ошибкой является пропуск знака вопроса после имени сниппета или знака амперсанда перед каждым свойством сниппета, а также неверное написание имени сниппета или свойства сниппета (имена чувствительны к регистру, поэтому будьте внимательны). Еще одна ошибка может возникать при работе с редактором в панели управления, подобным TinyMCE. Этот редактор может заменять амперсанд в ваших тегах сниппета на «

&amp;» каждый раз, когда вы сохраняете свою работу. Для того, чтобы исправить это, нажмите в редакторе кнопку «HTML» и исправьте &amp; или &amp;&amp; на отдельный символ амперсанда внутри тегов сниппета.

 

Не смотря на то, что мы часто помещаем пробелы вокруг знака равенства в коде PHP для повышения удобочитаемости, мы не делаем этого для тегов сниппетов, поскольку это может помешать правильной работе парсера в некоторых старых версиях MODX Evolution.

Далее мы детально рассмотрим сниппеты и теги сниппетов. Если вы не знаете PHP, вы не сможете создавать или редактировать сниппеты, но тем не менее вам все равно нужно будет знать как работают сниппеты и как работать со свойствами сниппетов.

Некоторые начинающие пользователи MODX совершенно не знают PHP и не собираются его изучать. Некоторые из них способны создавть очень сложные сайты на MODX без использования кода PHP. Многие другие, однако, постепенно изучают PHP по мере использования MODX и начинают писать свои собственные сниппеты и плагины.

Плагины

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

В движке MODX имеется ряд «контрольных точек» (называемых системными событиями), которые позволяют вам выполнять практически любые операции при наступлении этих системных событий. По мере выполнения MODX своей работы она периодически «включает» какое-то системное событие из целого ряда имеющихся. Имеются, например, системные события, которые запускаются непосредственно перед обработкой страницы в браузере, непосредственно после того, как зарегистрированный пользователь ввел логин и пароль или перед сохранением документа или пользователя в панели управления. Каждое системное событие имеет имя и плагины MODX могут отслеживать определенное системное событие и выполнять соответствующие действия при его наступлении.

Таким образом, плагин представляет собой код на PHP, который обрабатывает определенное системное событие. Когда это системное событие наступает, то выполняется код плагина. Например, плагин может дать вам доступ к содержимому документа непосредственно перед обработкой его для создания веб страницы путем отслеживания наступления события OnWebPagePrerender. Вы можете перевести содержимое документа, выделить ключевые слова, удалить HTML комментарии, преобразовать некоторые элементы в гиперссылки и т. д.

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

Прелесть плагинов заключается в том, что они позволяют добавить дополнительные возможности по обработке данных без необходимости вмешиваться в работу ядра MODX. Это означает, что обновление версий MODX не повлияет на созданный вами плагин. Таким образом, благодаря многим способам расширения возможностей MODX вы можете делать практически все,  что только можно вообразить, без необходимости изменения кода ядра MODX.

Категории

Категории в основном представляют собой метки, которые вы можете применять к элементам, чтобы помочь их организовать и управлять доступом к ним. Когда вы создаете или редактируете сниппет, плагин, чанк, шаблон или TV-параметр, вы можете присвоить им существующую категорию или создать новую. Когда элемент отображается в панели администратора, он появится под присвоенным ему именем категории.

В MODX Revolution вы можете присваивать элементам категории путем перетаскивания их в нужную папку категории в нижней части дерева элементов.

Отметим, что элементы, включенные в определенную категорию, не будут отображаться в разделе «Категории» (Category). Вместо этого они будут отображаться в папке категорий в соответствующих разделах. Например, сниппет, добавленный в категорию MyCategory, появится в дереве элементов в папке MyCategory, которая находится в разделе «Сниппеты».

Вы можете иметь столько категорий, сколько хотите и вы можете иметь категории в категориях. Вы, например, можете иметь категорию MyChunks, чтобы хранить созданные вами чанки отдельно от чанков, используемых различными компонентами MODX. Если вы создадите много чанков, то в категории MyChunks можно создать подкатегории.

После помещения элемента в определенную категорию вы можете спрятать их или управлять тем, что пользователи могут делать с ними путем создания в панели управления «Категории Доступа к Элементам » (Element Category Access).

Если вы не используете категорий для управления доступом к элементам, они располагаются так, как вам удобно для того, чтобы находить и редактировать их. Использование категорий совершенно необязательно. Некоторые не используют их совсем. Другие, особенно те, у кого сложные сайты, используют множество категорий. Как и многое в MODX, это дело вашего выбора.

Назад Вперёд

ContentBlocks • modmore.com

ContentBlocks — это мощный менеджер контента для MODX, позволяющий редакторам создавать модульный контент из нескольких столбцов.

Купи сейчас или попробовать бесплатно

  • Меньшие блоки для большего контроля

    Принцип Modular Content означает, что вы разбиваете свой контент на более мелкие части контента, которые можно использовать или анализировать по отдельности. Таким образом, вместо одного блока контента вы можете установить заголовок, изображение и текстовое описание.

    У каждого из этих небольших блоков контента есть собственный шаблон, так что вы можете делать удивительные вещи с их значениями. Возможно, вы хотите автоматически изменить размер изображения или добавить фильтр или добавить интерактивную привязку к каждому заголовку. Небо это предел!

  • Несколько столбцов содержимого

    При желании ContentBlocks позволяет определять макеты, состоящие из нескольких столбцов. Каждый столбец может содержать блоки контента, и вы сами решаете, как он будет отображаться в HTML. Это прекрасно работает с сетками CSS, такими как Foundation, Bootstrap или Skeleton, но вы также можете использовать его со своим собственным CSS.

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

  • Шаблон от Сложности

    Большинство редакторов не так технически подкованы, как люди, разрабатывающие сайт. Это может усложнить редактирование контента, когда редактору необходимо запоминать определенные шаги в редакторе форматированного текста, чтобы получить определенный результат. Создавая шаблоны для небольших блоков контента, можно легко реализовать даже сложные требования к разметке.

  • Разработчикам это тоже нравится!

    Наши клиенты говорят нам, что после работы с ContentBlocks трудно вернуться к тому, как сайты создавались раньше. Мощные шаблоны, простота настройки и настройки, а также функции импорта и экспорта XML, позволяющие повторно использовать ваши любимые блоки в новых проектах, делают его мечтой разработчиков. И, конечно же, наша служба поддержки поддержит вас, когда вам нужно будет подтолкнуть вас в правильном направлении.


Наши клиенты

Love ContentBlocks для своей гибкости , простота использования и способность интегрировать с их существующими процессами и Инструменты


Джеймс Бургун

Hatio Date University

.

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

Выпуск 1.0 был великолепен, я не могу дождаться, чтобы увидеть, что будет в будущем от Марка и команды modmore! И хотя сам продукт является первоклассным, их быстрое и внимательное обслуживание клиентов и поддержка повышают ценность покупки.

 

Shawn Himmelberger

Himmelberger Design

Оглядываясь назад на историю MODX, мы увидим Evo , затем Revo до блоков контента и Revo после блоков контента . Каждый проект, который мы делаем, будет использовать его. Сделка в два раза дороже.

 

Jörg Lippmann

Frischnetz

ContentBlocks предлагает пользователю удобные строительные блоки для создания сложных областей содержимого всего несколькими щелчками мыши. Его легко настроить или настроить дизайнеру, и еще проще использовать клиенту/редактору. Он идеально и интуитивно работает с современными адаптивными сеточными системами и гарантирует, что вы получите чистый HTML-код.


звезда звезда звезда звезда звезда
Характеристики и функции продукта

звезда звезда звезда звезда звезда
Документация и поддержка

звезда звезда звезда звезда полузвездаполузвезда
Рентабельность

Читать все проверенные отзывы о ContentBlocks »


ContentBlocks превращает поле содержимого в

мощное полотно . В комплекте гибкие типы контента вы можете создавать иммерсивные целевые страницы и сложные дизайны, без редактирования какого-либо кода редактором .


Взгляните на , что предлагает ContentBlocks.

Новости о ContentBlocks

Отказ от ответственности: просмотр цен не в евро

В настоящее время вы просматриваете цены в валюте, отличной от евро. Обратите внимание, что эти цены являются оценочными , основанными на данных Open Exchange Rates.

Хотя мы предлагаем этот конвертер валют, надеясь, что наши пользователи сочтут его удобным, все покупки совершаются в евро , а окончательная взимаемая сумма может варьироваться в зависимости от платежной системы, дня, времени суток и ряда других факторов, не связанных с модом. еще контроль. Нет никаких гарантий на точность и мод больше , ни Open Exchange Rates не могут нести ответственность за ошибки.

×

Направляющие Боба | MODX CMS

Система управления контентом MODX

MODX — это система управления контентом, которая помогает создавать превосходные веб-сайты. У MODX есть два ключевых преимущества. Во-первых, это упрощает обслуживание веб-сайтов для вас и других лиц, которых вы назначаете администраторами. Во-вторых, как только вы привыкнете к этому, он позволяет создавать очень сложные веб-сайты за очень короткое время. Вещи, которые заняли бы много строк кода для вас, чтобы сделать это самостоятельно, часто можно выполнить с помощью одной или двух строк в MODX. Конечно, есть много других преимуществ также, но мы вернемся к ним позже.

Почему MODX?

Существуют и другие системы управления контентом, которые позволяют быстро создать веб-сайт и легко его поддерживать, но они имеют тенденцию ограничивать вас во многих отношениях. Работая с такой CMS, вы можете почувствовать себя связанным изолентой. МОДКС, с другой стороны, является гибким и открытым. Вы можете легко расширить его практически в любом направлении и создать именно веб-сайт, который вы хотите, без компромиссов. По этой причине MODX часто называют «средой управления контентом». а не «система управления контентом». Из-за мощности и гибкости MODX это может быть немного трудно начать, но как только вы освоите его, он будет удивительно прост в использовании.

Лучшей причиной для использования MODX является полная свобода, которую он дает вам при разработке вашего веб-сайта. Шаблон MODX это просто код HTML с необязательными тегами MODX. MODX заменит теги тем, что они представляют. Ты не необходимо использовать любые теги, и нет никаких правил относительно того, как организован шаблон. Любой контент, который вы которые вы хотите отобразить на странице, можно разместить в любом месте шаблона. Где он появится и как он будет выглядеть, будет регулироваться только по правилам CSS, которые вы создаете для него. MODX никоим образом не будет вмешиваться в этот процесс, за исключением того, что на странице нет необработанного PHP-кода. Весь PHP-код должен быть размещен в сниппетах или плагинах. Это делает сайт более безопасно и помогает отделить контент от презентации.

Возможно, вам не терпится установить MODX, но сначала вы, возможно, захотите узнать, как работает MODX и какие функции потребуют от вас хотите установить его в первую очередь. Если вы хотите сразу же приступить к делу, вы можете перейти к разделу «Установка». MODX, чтобы установить MODX и начать играть.

Как работает MODX?

Как и многие другие системы управления контентом, MODX хранит данные для ваших веб-страниц в базе данных. Когда пользователь посещает одну из ваших страниц, MODX обращается к базе данных, получает информацию, собирает ее и отправляет в браузер пользователя для отображения. Это все происходит за кадром. Многие пользователи MODX создают сайты, даже не имея дело с база данных или процесс сохранения и извлечения информации. Однако, чтобы действительно заставить MODX петь, вам в конечном итоге хотите узнать, как работают некоторые закулисные процессы.

Расширением фреймворка MODX являются, среди прочего, Шаблоны , Фрагменты , Чанки , Переменные шаблона и Плагины . Они намного проще, чем могут показаться, и мы мы доберемся до них через минуту, но сначала немного о MODX Manager .

Начало работы

MODX Manager — это место, где вы работаете над своим веб-сайтом. Одна из замечательных особенностей MODX заключается в том, что вы может работать на вашем сайте из любого места, где есть подключение к Интернету. Менеджер — это инструмент, хранящийся на вашем сайте, и, как только вы войдите в систему, вы можете добавлять контент, редактировать существующий контент и выполнять практически любую задачу, которую вы могли бы выполнять дома. Все, что вы потребность находится в диспетчере, поэтому единственное, что вам нужно на компьютере, с которого вы подключаетесь, — это веб-браузер. Если Менеджер в местоположении по умолчанию (вы можете переименовать его, и это сделает ваш сайт более безопасным), вы можете связаться с Менеджером, введите следующий URL-адрес в адресную строку браузера:

 https://yoursite. com/manager 

В Manager вы можете редактировать свои страницы в текстовом HTML-редакторе с расширенным форматированием или, если хотите, вы можете редактировать необработанный html каждой страницы. Вы можете загружать изображения, контролировать, кто может просматривать и/или редактировать каждую страницу, добавлять новые страницы, реорганизуйте свое меню, создайте пользователей и многое, многое другое. Перейти к Получение Начал с MODX , чтобы узнать больше о MODX и использовании MODX Manager . Если вы новичок в MODX, однако, рекомендуется закончить чтение этой страницы, прежде чем переходить по ссылке «Начало работы».

В В следующих разделах мы рассмотрим два основных строительных блока для веб-страницы MODX: Ресурсы и элементы

Ресурсы

Ресурсы (сокращение от веб-ресурсов) — это строки данных в базе данных MODX, которые обычно содержат информацию о конкретная веб-страница. Ресурсы Modx являются документами, хотя веб-ссылки, символические ссылки и статические ресурсы также являются документами. ресурсы, но это более сложная тема, поэтому мы пока ее пропустим и сосредоточимся на документах. Большую часть времени в MODX, когда вы видите слово «ресурс», оно относится к документу и представляет информацию для одной веб-страницы.

Документы

Веб-страница в MODX — это готовый продукт, который MODX отправляет в браузер пользователя при запросе этой страницы. А MODX Документ , с другой стороны, является сердцем этой веб-страницы и содержит отображаемый контент. только на этой странице (как абзац, который вы сейчас читаете), а также различные фрагменты информации об этом Ресурс (например, кто его создал, когда он последний раз редактировался и т. д.). В MODX документы классифицируются как веб-ресурсы. (Ресурсы для краткости). Шаблоны, фрагменты, фрагменты, переменные шаблона и плагины классифицируются как элементы контента. (Элементы для краткости) — о них чуть позже.

Поскольку MODX выполняет предварительную обработку запросов для страниц, он может проделывать множество трюков со страницей до того, как она будет отправлена ​​на сервер. браузер, например вставка меню, хлебных крошек, последних сообщений в блогах или новостей; показ случайной фотографии; заполнение стандартный заголовок, логотип или нижний колонтитул; и добавление шаблонного контента в различные места на странице.

Когда вы создаете документ в MODX Manager , вы можете указать, хотите ли вы, чтобы он отображался на веб-сайт или оставаться скрытым, отображаться в меню (или нет), как он будет упоминаться в любом меню, где он будет размещен в меню, кто может его видеть, кто может его редактировать, даты, когда вы хотите, чтобы оно появлялось и исчезало с сайта, и другие подробности о странице. Многие из этих атрибутов страницы являются необязательными, поэтому, если вы просто хотите создать страницу и позволить все видят это, вы можете игнорировать большинство этих настроек и просто ввести содержимое страницы. Перейдите сюда, чтобы узнать больше о создании и редактировании MODX 9.0135 Документы .

Элементы

Элементы контента MODX (почти всегда называемые просто «Элементами») включают шаблонов , Чанки , Фрагменты , Плагины и Переменные шаблона . В следующих разделах мы дадим краткий обзор этих элементов. В конце каждого раздела есть ссылка на страницу с более подробной информацией об элементе.

Шаблоны

А Шаблон в MODX — это просто место для размещения того, что вы хотите, на каждой странице или подмножестве страниц. Как правило, шаблон будет содержать баннер, который идет вверху каждой страницы, нижний колонтитул, который идет внизу меню для всего сайта или его части, а также любой другой контент, который должен отображаться на каждой странице, использующей Шаблон. У вас может быть сколько угодно шаблонов, но многие сайты используют только один, чтобы все страницы имеют одинаковый внешний вид, планировку и стиль. Иногда люди создают специальные шаблоны для таких вещей, как загрузка страниц, страницы, страницы фотогалереи и т. д. У вас также может быть специальный шаблон для домашней страницы, хотя во многих случаях это необязательно.

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

 [[*контент]]
 

Вы также можете поместить некоторую другую информацию из документа в шаблон, если хотите, например, заголовок , longtitle , дата публикации , автор и т.д. Это ресурс поля , которые вы вводите при создании документа в менеджере MODX. Они хранятся вместе с документом в базе данных. Вы даже можете создавать настраиваемые поля ресурсов под названием Переменные шаблона 9.0136 для хранения доп. информацию, относящуюся к Документу, и разместить ее также в Шаблоне.

Например, на этой странице Шаблон содержит заголовок страницы (то, что вы видите в самом верху окна браузера). Он генерируется из имени сайта Настройки системы и из заголовка этого Документ: («Система управления контентом MODX»). Шаблон также содержит теги, относящиеся к верхнему и нижнему колонтитулу, и основной заголовок, который вы видите в верхней части страницы, который генерируется автоматически из документа длинное название . Содержимое документа — это только подзаголовки и абзацы текста на странице.

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

 [[*длинное название]]
 

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

 [[*id]] 

Вы можете перейти по этой ссылке для получения дополнительной информации о полях ресурсов и как их использовать.

Кусочки

Что делать, если у вас есть контент, который вы хотите разместить на многих страницах, но не на всех, и вы хотите разместить его в разных местах на разные страницы? Вот где Чанки приходят. Чанк — это просто фрагмент текста или HTML-код, который вы можете разместить в любом месте на любой странице. Он может содержать текст, изображения, ссылки, сниппеты, JavaScript или все остальное, что может быть на веб-странице. Вы создаете блок в MODX Manager и просто поместите ссылку на него на любую страницу в том месте, где вы хотите, чтобы он отображался.

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

 

Это будет отображаться там, где я захочу.

Затем, всякий раз, когда вы хотите, чтобы этот текст отображался на странице, вы просто помещаете тег фрагмента в там, где вы хотите:

 [[$MyChunk]] 

Фрагменты можно размещать в верхних и нижних колонтитулах, шаблонах или в содержимом документа. Перейдите на страницу MODX Chunks для получения дополнительной информации. Чанки могут содержать сниппеты, но не придется.

Фрагменты

Что делать, если вы хотите иметь динамический контент на странице? Возможно, вы хотели бы прочитать список файлов из определенного директории, отсортировать их по алфавиту и разместить на странице в виде ссылок. Файлы всегда добавляются в каталог, так что вы не можете просто создать список файлов и поместить его на страницу (ну, вы могли бы, но тогда вам пришлось бы редактировать страницу каждый раз, когда кто-то загружал новый файл). Вы бы предпочли динамически генерировать список файлов из фактического содержимого каталога. Таким образом, он всегда будет в актуальном состоянии. Для этого вы должны написать немного PHP-кода для чтения каталог и распечатайте HTML-код для списка, поместите этот код в Фрагмент и просто поставьте ссылка на фрагмент на странице, где вы хотите, чтобы список файлов отображался со строкой, подобной следующий:

 [[MyFileListSnippet]] 

Если вам нужно сообщить вашему фрагменту что-то о том, как работать, вы можете добавить свойства в Тег фрагмента , например:

 [[MyFileListSnippet? &sortOrder=`по возрастанию` &fileDirectory=`assets/mydir/`]] 

Амперсанды обозначают Свойства MODX в теге. Свойства — это просто фрагменты информации, которые могут быть отправлены на Snippet . Свойства могут быть необязательными или обязательными. Эти двое рассказывают Фрагмент о том, что вы хотите отсортировать по возрастанию и что файлы для отображения находятся в «assets/mydir» каталог. В PHP-коде сниппета к ним можно получить доступ как к обычным переменным PHP ( $ sortOrder и $fileDirectory ).

Многие сниппеты также позволяют свойств tpl , которые обычно содержат имена фрагментов Tpl, используемых для форматировать и оформлять вывод сниппета. Это позволяет указать другой фрагмент Tpl для фрагмента, который будет использоваться вместо по умолчанию.

Перейдите сюда, чтобы узнать больше о свойствах сниппета .

Если вы не знаете PHP, не отчаивайтесь. MODX уже имеет ряд встроенных сниппетов, которые могут делать многое из того, что вы хочу. Сообщество разработчиков MODX постоянно создает новые сниппеты. Навигатор Фрагмент кода создает меню, подобное тому, что показано вверху этой страницы. Фрагмент хлебной крошки создает навигационные линии в виде хлебных крошек. Фрагмент getResources В Revolution вы можете управлять образами галереи с несколькими различными дополнениями Галерея . Фрагмент кода SPForm создает простая контактная форма, подобная той, что находится на странице «Контакты» на этом сайте.

Сниппет FormIt создает более сложные формы, которые можно использовать для регистрации пользователей, сбора данных и хранить данные в базе данных MODX. Задачи, которые на обычном веб-сайте заняли бы много строк кода, очень часто могут быть делается с помощью одного тега Snippet в MODX.

Чтобы узнать больше о сниппетах, вы можете посетить страницу сниппетов.

Фрагмент или фрагмент — что использовать?

Чанки и Фрагменты используются для вставки контента на веб-страницу. Для новых пользователей это может быть запутанным, чтобы выяснить, какой из них использовать, когда. Однако есть довольно простое эмпирическое правило, позволяющее сделать это решение. Если вы хотите вставить фрагмент контента на несколько веб-страниц, контент не содержит кода PHP, и вы не хотите помещать этот контент в шаблон, вам нужен фрагмент. Например, вам может понадобиться заявление об отказе от ответственности пользователи, что вы не будете нести ответственность за ущерб, причиненный в результате следования советам на странице. Вы не хотите этого в Шаблон, потому что он не будет отображаться на каждой странице, и он будет отображаться в разных местах на разных страницах. Кусок идеально подходит для этого. Если вы передумали о том, как сформулировать заявление об отказе от ответственности, вы можете просто отредактировать фрагмент и текст. будет меняться на каждой странице, содержащей этот фрагмент.

Чанки не могут содержать PHP-код, только HTML и обычные элементы, которые вы размещаете на веб-странице MODX. Чанки могут содержать flash графика, JavaScript, изображения, таблицы, абзацы текста, теги фрагментов и все остальное, что вы поместите в стандартный MODX. веб-страница. Когда вы создаете чанк, вы можете разместить тег чанка следующим образом:

 [[$MyChunk]] 

Когда MODX видит тег чанка, он просто получает содержимое чанка и вставляет его туда, где он нашел Тег куска. Чанки обычно загружаются быстрее, чем сниппеты, потому что MODX не нужно так много работать, чтобы интерпретировать их.

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

Перейдите к разделу Создание и использование блоков, чтобы узнать больше о блоках.

С другой стороны, Snippet предназначен для тех случаев, когда вы хотите динамический вместо статический содержание. Он может содержать код PHP или код Javascript (или оба), и он создает контент «на лету», который будет вставлен на страницу. Выпадающее меню в верхней части этой страницы создано встроенный MODX Wayfinder Snippet. Вывод выглядит немного по-разному на каждой странице. Навигатор Сниппет использует PHP-код, чтобы выяснить, где вы находитесь на сайте, и генерирует соответствующий HTML-код для вывода. Перейти к Создание и использование сниппетов, чтобы узнать больше.

Ссылки

Вам часто потребуется поместить ссылку на страницу, которая ссылается на другой документ на вашем сайте. MODX делает это действительно легко, предоставив тег ссылки . Везде, где вам нужен URL-адрес страницы MODX на вашем сайте, просто поместите тег ссылки, как показано ниже, где ## — это номер идентификатора ресурса, указанный в круглых скобках рядом с именем документа в дерево слева от левой стороны MODX Manager :

 [[~##]] 

Таким образом, в необработанном HTML ссылка на документ 12 будет выглядеть так:

 [[~12]] 

Если вы используете редактор форматированного текста (например, TinyMCE) для редактирования своей страницы, вы также можете выделить ссылку текст (в этом случай «Моя другая страница»), щелкните значок гиперссылки (обычно это перевернутая восьмерка, ссылка или знак бесконечности) и введите:

 [[~12]] 

для URL-адреса. Код ссылки будет вставлен автоматически. Обратите внимание, что значок гиперссылки не будет активен до тех пор, пока Вы выделяете какой-то текст.

Плагины

Плагины — еще одна сложная тема, и, опять же, многие пользователи MODX никогда не создадут их. Плагины используются для прерывания обработки движка MODX и добавления пользовательских функций. Есть количество хуков в движке MODX, которые позволяют выполнять практически любые операции в ключевых точках обработка. Например, вы можете получить доступ к содержимому документа непосредственно перед его отображением в виде веб-страницы. Ты можно перевести, выделить ключевые слова, превратить некоторые элементы в гиперссылки и т. д. Вы можете делать все, что угодно, вы можете писать код за. Вы также можете обрабатывать документы до их сохранения, обрабатывать информацию о пользователе в процессе регистрации. в или сделать любое количество других преобразований. Прелесть плагинов в том, что они позволяют вам выполнять индивидуальную обработку. место без взлома ядра MODX, чтобы на вашу работу не повлияло обновление до более новых версий MODX.

Перейдите сюда для получения дополнительной информации о плагинах.

Переменные шаблона (TV)

Переменная шаблона (TV) — это просто дополнительное поле ресурса, которое вы создаете сами. Хотя вы видите Шаблон Переменные и вводите их значения при редактировании Ресурса, фактически они относятся к Шаблонам. Когда вы редактируете определенного ресурса, вы увидите переменные шаблона, прикрепленные к шаблону, используемому ресурсом. Телевизор может иметь разные значения для каждого ресурса и телевизора могут содержать теги для других элементов MODX.

Значение переменной шаблона может отображаться на веб-странице со следующим тегом:

 [[*TvName]] 

MODX заменит тег значением именованного ТВ для текущей страницы.

Здесь мы только немного коснулись переменных шаблона.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *