Настройка modx: Урок 2. Первоначальная настройка MODX Revolution

Содержание

Урок 2. Первоначальная настройка MODX Revolution

 

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

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


Первое, что нужно сделать, это избавиться от ошибки настройки системы «Каталог ядра в открытом доступе», если такое сообщение появляется. Исправляем согласно инструкции сообщения, то есть переименовываем файл ht.access, расположенный в папке core, дав ему название .htaccess.

Сделать это можно либо через FTP-клиент, либо через файловый менеджер панели управления хостинга, либо с помощью файл-менеджера административной части MODX (вкладка «

Файлы» в левой части окна).

Если вы переместили папку core за корневую директорию, установив MODX при помощи расширенного пакета, третий способ вам не поможет.

Обновив окно, убедитесь, что сообщение пропало.


Дальнейшие настройки производятся в окне «Системные настройки и события». Чтобы открыть окно настроек, следует подвести курсор мыши к значку шестеренки в правом верхнем углу админ-панели и выбрать первый же пункт «Системные настройки».

 

Системных настроек в Revo огромное количество

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

 

Значок «+» в левой части названия настройки откроет подсказку  о том, для чего данный пункт предназначен. А в поле «Значение» меняются сами параметры каждой настройки. Их, в зависимости от типа настройки, вводят или вручную, или выбирают из списка.

 

Основные параметры системы, которые обычно редактируются непосредственно после установки MODX

Раздел «Сайт»

  • Название сайта: нужное нам наименование проекта, произвольная форма
  • Сообщение о недоступности сайта: текст, который будет отображаться в режиме отключенного (неопубликованного) сайта, произвольная форма
  • Публиковать по умолчанию: будет ли новый документ доступен для просмотра посетителями сразу после создания и сохранения, на ваш выбор, варианты Да/Нет

Раздел «Система и сервер»

  • Отображение RSS-канала «Новости MODX»: отключаем (Нет)
  • Отображение RSS-канала «Уведомления безопасности MODX»: отключаем (Нет)

Раздел «Панель управления»

  • Показывать текст подсказки рядом с полем
    : описание пунктов меню, полезно только при знакомстве с системой, в дальнейшем можно отключать, варианты Да/Нет
  • Формат даты в панели управления: можно сменить на наш, родной, d-m-Y
  • Первый день недели: ставим 1, мы же не Стругацкие

Раздел «Дружественные URL» – режим ЧПУ

  • Транслитерация псевдонимов: russian (для включения транслитерации дополнительно требуется установить дополнение translit)
  • Суффикс контейнера: Очищаем
  • Использовать дружественные URL: Да
  • Строгий режим дружественных URL: Да
  • Проверять на дублирование URI во всех контекстах: Да

Включив на сайте ЧПУ (режим дружественныу URL), переименуйте дополнительно ht.access в корне сайта в .htaccess, иначе при попытке перехода на страницы, отличные от главной, получите ошибку 404.

Подтверждение изменений или сохранение параметров не требуется, все происходит автоматически.

Можно дополнительно посетить раздел «Типы содержимого» (пункт меню «Содержимое») и очистить поле «Расширение файла» в параметре HTML. Теперь адрес страниц станет без расширения, то есть http://адрес_Сайта/about вместо http://адрес_Сайта/about.html.


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

 


Ненавязчивая благодарность проекту


Оптимальная настройка MODX Revolution

Автор Алексей На чтение 6 мин Просмотров 5к. Опубликовано Обновлено

В предыдущей статье мы произвели установили дополнения. Сегодня мы произведем основные настройки MODX Revo.

Русификация MODX

На всякий случай решил написать, о том как русифицировать modx revo (сменить язык админки), чтобы названия настроек не отличались от моих, если ваша админка на другом языке.

Для того чтобы русифицировать modx, перейдите во вкладку «System Settings«.

Далее выбираем категорию настроек — «Lexicon and Language» и меняем следующие значения:

Language — cultureKey — ru

Front-end Editor Language — fe_editor_lang — ru

Manager HTML and XML Language Attribute — manager_lang_attribute — ru

Manager Language — manager_language — ru

В принципе все) Разлогиниваетесь из админки и снова зайдите в нее.

Настройка modx revolution после установки

Заходим в админку MODX и переходим на панель настроек «Системные настройки».

Здесь можно фильтровать настройки, относящиеся к тому или иному компоненту системы MODX, а также настройки, относящиеся к одному и тому же компоненту, но сгруппированные по категориям в зависимости от выполняемой функции.

Идем по порядку (по категориям).

Настраиваем (правим) следующие параметры для ядра (core).

Авторизация и безопасность

Разрешить пользователям использовать один адрес электронной почты — allow_multiple_emails — нет

Адрес электронной почты — emailsender — указываем рабочий email (в последующем будем привязывать к нему формы).

Кеширование пропускаем

Визуальный редактор

Редактор — which_editor — TinyMCE RTE (он сам должен поставиться если вы его установили)

Редактор для элементов — which_element_editor — Ace (он тоже сам должен поставиться если вы его установили)

Файловая система

Максимальный размер загрузки — upload_maxsize — 629145600 или какой вам нужно (я установил данный параметр в 600 МБ для возможности загружать видео файлы).

Дружественные URL

Пока что пропускаем, по их настройке будет отдельная статья: Настройка ЧПУ MODX (откроется в новом окне).

Шлюз пропускаем.

Словарь и язык 

Язык текстового редактора во фронтенде сайта — fe_editor_lang — ru

Локаль — locale — ru_RU.utf8

Почта — здесь вы можете настроить отправку почты через SMTP, пока пропускаем.

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

Источник файлов по умолчанию — default_media_source стоит 1, но рекомендую создать новый источник файлов и указать его)

Первый день недели — manager_week_start — 1

Понедельник в России.

Разместить TV ниже контента — tvs_below_content — Да

Дополнительные пользовательские поля для страниц будут располагаться ниже поля ввода основного контента. Если опция сейчас не понятна, то в дальнейшем разберётесь. Опция просто для удобства интерфейса админки. Мне удобнее так — но не всегда.

Поле для названия узла в дереве ресурсов — resource_tree_node_name — menutitle

Делается для того, чтобы названия ресурсов в дереве с лева были покороче.

Поле для подсказки для узла в дереве ресурсов. — resource_tree_node_tooltip — alias

Делается для того, чтобы можно было понять, какой у ресурса адрес

Показывать экран приветствия — welcome_screen — нет

Прокси, сессии и куки пропускаем.

Сайт

Шаблон по умолчанию — default_template — ставим наиболее часто используемый шаблон (пока их еще не создавали, но создадим)

Скрыть из меню по умолчанию — hidemenu_default — Да

У вновь создаваемых ресурсов (страниц) по умолчанию будет снята галочка «Отображать в меню». В любой момент её можно будет включить. Но зачем лишний раз снимать галочку, ведь не все создаваемые в дальнейшем страницы сайта будут отображаться в меню. Установив опцию в «Да» вам в дальнейшем не нужно будет совершать лишних действий.

Схема URL — link_tag_scheme — full. Будут генерится полные пути до ресурсов.

Публиковать по умолчанию — publish_default — Да

Та же история, что и с предыдущей опцией, только наоборот. При создании страницы уже будет стоять отметка «Опубликовать». Если ресурс не опубликован, то он будет недоступен посетителям сайта. Но мы же создаём публичные страницы – так ведь?

Название сайта — site_name — введите название сайта, доступное в дальнейшем для вставки плэйсхолдером [[++site_name]]. Любое название, например, Строительная компания ООО «Рога и копыта».

Сообщение о недоступности сайта — site_unavailable_message — Сайт находится на техническом обслуживании. Пожалуйста, зайдите чуть позже.

Можете написать всё, что угодно. Надпись будет отображаться всем, кто зайдёт на сайт во время его технического обслуживания. Для перевода сайта на техническое обслуживание служит отдельная опция.

В Страница ошибки 404 «Документ не найден» — error_pageСтраница «Сайт не доступен» site_unavailable_page и Страница ошибки 403 «Доступ запрещен» unauthorized_page стоят единицы (т.е. переадресовывается все на главную страницу, рекомендую создать для этих ошибок отдельные страницы и назначить их в настройках)

Статические элементы — тех кто работает с файлами можете настроить.

Система и сервер

Отображение RSS-канала «Новости MODX» — feed_modx_news_enabled — Нет

Отображение RSS-канала «Уведомления безопасности MODX» — feed_modx_security_enabled — Нет

Устаревшие функции в журнале ошибок — log_deprecated — Нет.

Тип сервера — server_protocol — https (если у вас установлен ssl сертификат, если его нет, то идем дальше)

Дополнительные настройки, для тех кто устанавливал пакеты из моего урока.

Системные настройки основных дополнений

phpThumb (если он установлен — настраивали в уроке по закалке),

Идем в раздел mixedimage и в Транслитерация файлов (mixedimage.translit) ставим Да.

Чтобы загружаемые к ресурсам картинки транслитерировались.

Затем идем в раздел tickets и в Считать просмотры страниц гостями (tickets.count_guests) ставим Да.

Идем в раздел admintools и в Включить авторизацию через email (admintools_email_authorization) ставим Да (если вы работаете на сервере — повышаем безопасность), так же я обычно ставлю Тема (admintools_theme) — dark.

Раздел pdotools — здесь вы можете включить Fenom шаблонизатор (он быстрее встроенного), для этого установите настройки:

  • pdotools_fenom_default: да,
  • pdotools_fenom_modx: да,
  • pdotools_fenom_parser: да,
  • pdotools_fenom_php: да,
  • pdotools_fenom_save_on_errors — да.

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

В следующем уроке мы настроим ЧПУ MODX.

Понравилась статья? Можно поблагодарить автора: отправив ему донат на

YooMoney

или

Qiwi

. Либо поделившись статьей ☟

Базовая настройка MODX Revo 2.3

Начиная с лета 2014 года админпанель MODX Revo претерпела значительные изменения с выходом версии MODX 2.3. Спустя год вышла новая минорная версия —

MODX 2.4, во внешнем виде админпанель её была изменена не сильно в сравнении с 2.3, интерфейс остался привычным. А если сравнивать эти 2 версии с их предшественницей — MODX 2.2, то следует отметить, что одним из наиболее заметных отличий стало изменение внешнего вида верхнего меню и его переразбиение на разделы, в том числе изменение перевода некоторых пунктов. Движок стал мощнее, админпанель функциональней. Давайте ознакомимся с тем, какие пакеты устанавливать на чистый новый сайт. И где теперь расположены важные пункты меню для первичной настройки сайта на движке MODX Revolution 2.3 и выше.

Основные пункты меню для настройки MODX Revo

Установка новых приложений (пакетов, готовых модулей) находится в верхнем левом меню: Приложения > Установщик.

Порядок установки пакетов и настройки системы

Давайте рассмотрим порядок установки пакетов и настройки системы. Прежде всего нам понадобится включить автоматическую генерацию псевдонимов (alias) для ресурсов — латинское название страницы сайта, которое будет использоваться для формирования адреса страницы.

Дружественные URL сайта

MODX Revo поддерживает дружественные URL (для них используется поле псевдоним/alias у ресурса). Чтобы их активировать, надо убедиться, что применяется файл .htaccess. Файл по умолчанию уже настроен на обработку дуружественных URL. Надо только его активировать простым переименованием ht.access в .htaccess. Потом надо установить пакет translit, он позволит стандартному механизму автогенерации псевдонимов в MODX транслитилировать в латиницу русские заголовки/pagetitle ресурсов.

После установки пакета translit надо его активировать в настройках системы. Пример системных настроек для корректной работы человекопонятных URL приведен ниже:

Настройки системы находятся в верхнем правом меню, под иконкой колёсика.

Редакторы текста и кода

Для подсветки синтаксиса сниппетов и чанков лучше всего использовать дополнение Ace к MODX, подробнее о том, почему этот плагин выгоднее своих конкурентов описано в предыдущей статье по настройке MODX Revolution версии 2.2. В качестве визуального редактора для содержимого ресурсов достаточно удобно работать с

TinyMCE. У данного WYSIWYG редактора есть ряд ограничений (к примеру, он вычещает теги noindex), однако в большинстве проектов это не критично.

Пакеты pdoTools

pdoTools — без этого дополнения трудно представить современный сайт на MODX. В нем содержатся сниппеты для вывода ресурсов по заданному html-образцу (pdoResources, pdoPage), сниппет для генерации меню — pdoMenu, сниппет для генерации хлебных крошек — pdoCrumbs. И конечно fastField для быстрого доступа к значениям дополнительных полей и переменным глобальных массивов PHP — $_GET, $_POST, $_REQUEST, $_SERVER, $_FILES, $_COOKIE, $_SESSION.

Полезные дополнения

Итого резюмирую пакеты, перечисленные выше,  общий список:

 

Без этих пакетов можно обойтись, но мы рекомендуем их все-таки использовать (мы используем их всегда):

  • Frontbar — для залогиненных админов вставляет панель на фронтенде с полезными кнопками (к примеру, перейти к редактированию текущей страницы-ресурса). Для активации надо вставить некэшируемый сниппет !Frontbar после открывающегося тега <body>. От его вставки может ломаться верстка — но это только для залогиненных админов. В режиме браузера «Инкогнито» всегда можно посмотреть, как выглядит сайт без этой панели.
  • UpgradeMODX — создает виджет на главной в адинпанели и отображает текущую версию MODX, если она не последняя — предлагает обновиться
  • modDevTools — позволяет искать по коду чанков и шаблонов
  • MIGX — табличный тип ввода для дополнительных полей
  • FormIt — плагин для оптравики писем
  • AjaxForm — плагин, чтобы использовать FormIt через Ajax
  • pThumb — корректно кадрирует изображения и читабельно именует кэшируемую графику
  • MinifyX — незаменим при работе с less файлами и не только для этих целей
  • Inherit Template — устанавливает шаблон для дочерних элементов
  • versionX — версионирование ресурсов и всех элементов (шаблонов, чанков, сниппетов, etc)
  • autoRedirector — удобный плагин для создания редиректов. Автоматически создает редирект, если у ресурса был изменен псевдоним

Если на сайте нужно организовать поиск — рекомендую использовать SimpleSearch.

Количество просмотров: 286

Поделиться в соцсетях:

Настройка ЧПУ и htaccess для MODX Revolution

Частая ошибка! Для правильного отображения ссылок в head сайта нужно прописать базовый URL примерно вот так:


  
<base href="http://site_name.ru" />    
  

Настройки сайта для формирования ЧПУ

  1. Заходим в Системные настройки (System settings) и выбираем Friendly URLs в фильтре слева.

  2. Ставим «Нет» в автоматическую генерацию ЧПУ (Automatic alias — No) и «Да» в использовать ЧПУ (friendly_urls — Yes), «Да» в Использовать ЧПУ в путях псевдонимов (use_alias_path — Yes)

  3. Для автоматической генерации псевдонимов (Алиасов) из русского (или другого языка) в псевдоним, состоящих из латинских букв, устанавливаем дополнение Translit http://modx.com/extras/package/translit

  4. Скачиваем из гитхаба последнюю версию .htaccess для MODx Revolution по этой ссылке

  5. Переименовываем в .htaccess данный файл и заливаем на хостинг в корневую папку. Предварительно нужно внести в этот файл некоторые изменения (см. ниже).

.htaccess для MODX Revolution

Что такое .htaccess — говоря по-простому, то это файл, который содержит набор правил переименования запросов (URL) к вашему сайту.

На что стоит обратить внимание в данном файле:

  1. Если ваша MODx директория находится в public_html, то правило.

    
          
    <IfModule mod_rewrite.c>
    Options +FollowSymlinks
    RewriteEngine On
    RewriteBase /
    </IfModule>
          
        

    Оставляем без изменения, если используете поддиректорию subdirectory, то правило будет выглядеть так.(.*)$ index.php?q=$1 [L,QSA]

  2. Далее в файле .htaccess взятом с гитхаба (см. ссылку выше) идут дополнительные настройки-правила (для файлов разных типов, сроков изменения и т.д.), особенности использования которых можете узнать по ссылкам в комментариях. Я использую этот файл как есть, без дальнейших изменений.

Использование кеша браузера

Чтобы браузер сохранял уже загружаемые ресурсы (JS, изображения, вебшрифты) нужно в htaccess файле указать время хранения этих файлов. Вставьте в ваш .htaccess следующий код:


  
<IfModule mod_expires.c>
  ExpiresActive on

# Perhaps better to whitelist expires rules? Perhaps.
  ExpiresDefault                          "access plus 1 month"

# cache.appcache needs re-requests in FF 3.6 (thx Remy ~Introducing HTML5)
  ExpiresByType text/cache-manifest       "access plus 0 seconds"

# your document html 
  ExpiresByType text/html                 "access plus 0 seconds"
  
# data
  ExpiresByType text/xml                  "access plus 0 seconds"
  ExpiresByType application/xml           "access plus 0 seconds"
  ExpiresByType application/json          "access plus 0 seconds"

# rss feed
  ExpiresByType application/rss+xml       "access plus 1 hour"

# favicon (cannot be renamed)
  ExpiresByType image/x-icon              "access plus 1 week" 

# media: images, video, audio
  ExpiresByType image/gif                 "access plus 1 month"
  ExpiresByType image/png                 "access plus 1 month"
  ExpiresByType image/jpg                 "access plus 1 month"
  ExpiresByType image/jpeg                "access plus 1 month"
  ExpiresByType video/ogg                 "access plus 1 month"
  ExpiresByType audio/ogg                 "access plus 1 month"
  ExpiresByType video/mp4                 "access plus 1 month"
  ExpiresByType video/webm                "access plus 1 month"
  
# webfonts
  ExpiresByType font/truetype             "access plus 1 month"
  ExpiresByType font/opentype             "access plus 1 month"
  ExpiresByType font/woff                 "access plus 1 month"
  ExpiresByType image/svg+xml             "access plus 1 month"
  ExpiresByType application/vnd.ms-fontobject "access plus 1 month"
    
# css and javascript
  ExpiresByType text/css                  "access plus 2 months"
  ExpiresByType application/javascript    "access plus 2 months"
  ExpiresByType text/javascript           "access plus 2 months"

</IfModule>
  

Файл ROBOTS.TXT

Хотя это и не являлось темой этого урока, решил всё же разместить здесь содержимое файла robots.txt для MODx Revolution. Файл содержит правила для поисковых роботов.

Этот файл запрещает (разрешает) индексирование-посещение поисковыми роботами файлов из указаных в нём директорий.

Содержимое моего robots.txt:


  
User-agent: *
Disallow: /manager/
Disallow: /assets/components/
Disallow: /core/
Disallow: /mgr/
Disallow: /connectors/
Disallow: /index.php
Disallow: *?
Host: site_name.ru
Sitemap: http://site_name.ru/sitemap.xml
  

Не забудьте поменять site_name.ru на название своего основного хоста.

Голосов: 871 | Просмотров: 5843

MODX https настраиваем сайт на работу по защищенному протоколу

Если вы решили настроить сайт на правильную работу по безопасному протоколу https, то необходимо провести некоторые настройки системы и файла «.htaccess». Для начала перейдем в системные настройки Modx, для более удобного поиска — в фильтре параметров вводим «http», затем найденный параметр заменяем с «http» на «https».

Теперь снова обращаемся к фильтру системных настроек и вводим «link_tag_scheme», данная настройка Modx отвечает за схему генерации URL тега .

В найденном параметре согласно стандартным настройкам Modx Revolution должно стоять значение «-1» (URL-адрес является относительным к site_url). Вместо значения по умолчанию мы прописываем значение «1», что будет сообщать системе, что ссылки на сайте должны генерироваться с защищенным протоколом https.

Настройка .htaccess для Modx Revolution

После первых двух настроек системы сайт уже начнет работу по защищенному протоколу, но страницы сайта будут доступны и по обычному протоколу — с http. Чтобы сайт был доступен исключительно по безопасному протоколу https — нам нужно настроить автоматический редирект, при помощи файла «.htaccess».

Переходим через панель управления сайтом или FTP-клиент в корневую папку сайта, далее открываем для редактирования файл «.htaccess» и убираем символы комментирования со следующих строчек:

Прописываем вместо домена «example-domain-please-change.com» адрес своего сайта и не забываем указать вместо «http» защищенный протокол «https».

Теперь у нас настроен автоматический редирект с домена с www на домен без www.

Над данными строками необходимо добавить следующие строки для редиректа, которые будут перенаправлять страницы сайта с адреса http на аналогичный адрес, но с добавлением https.

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

Варианты настройки https протокола для разных хостинг-компаний

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

Вариант 2

Вариант 3

Вариант 4

Не забывайте вместо «domain.com» прописывать ваш домен.

Вариант 5

Вариант 6

Вариант 7

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

Также следует отметить, что на некоторые хостинги предлагают временные бесплатные SSL сертификаты «Let’s Encrypt», которые позволяют настроить на вашем сайте https. Данный сертификат вполне подойдет большинству сайтов, если же на сайте присутствует онлайн-оплата — то предпочтение все-таки следует отдавать платным SSL сертификатам, которые имеют более «авторитетные» подписи.


Поделиться в соц. сетях:

Базовая настройка и установка пакетов Modx Revolution

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

Название сайта и другие настройки

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

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

Очевидно, что нужно поменять имя сайта на нужное нам. Настройки сайта и другие настройки в менеджере находятся в выпадающей панели System название System Settings.

На этой странице показаны все системные настройки стандартного набора MODX Revolution. Здесь вы можете увидеть очень большое количество количество настроек, даже вы можете создавать собственные настройки. Мы рассмотрим лишь некоторые из настроек.

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

В выпадающем меню фильтра Filter by Area можно выбрать нужные нам настройки. Выберите в списке Site, чтобы отфильтровались настройки сайта.

Отредактируем имя сайта сделав в поле имени двойной клик для того, чтобы отредоктировать его. Удалим текущее название сайта и вставим свое имя «Изучение MODX Revolution». После окончания редактирования имени сайта нажмитеВВОД и спустя некоторое время после обновления страница отобразит новое имя сайта.

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

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

Установка дополнений

Другая вещь, с которой необходимо ознакомится в MODX Revolution это то, как устанавливаются дополнения.

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

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

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

Откроется станица, на которой будут показаны последние и наиболее популярные дополнения справа и браузер дополнений (пакетов) слева.

Как вы видите, доступные дополнения, которые вы можете загрузить на ваш сайт, делятся на 5 категорий:

  • MODX Addons (адонны)– это функциональные куски, которые не являются частью ядра MODX, такие как галереи, построители меню, теговые сниппеты и другое. Они не изменяют ядро, а просто добавляют функциональность.
  • Core Extensions (расширения ядра) – это дополнения к самому ядру, которые изменяют работу MODX. Они изменяют работу частей ядра.
  • FrontEnd Templates (шаблоны фронт-энда)– это готовые к использованию шаблоны сайта сделанные в виде пакетов для быстрой установки. Если вы хотите построить/установить свой собственный шаблон можете воспользоватся этими и изменять их как угодно.
  • Manager Templates (шаблоны админки) – это backend шаблоны для изменения вида вашего менедзжера, это повлияет только на внешний вид, но не на функции вашего менеджера.
  • Site Packages (пакеты сайта) – это уже построенные полные сайты, которые вы можете установить и исследовать. Это просто отличный способ установить демо MODX сайт и увидеть как он работает. Демо сайт может быть также отличным материалом для изучения инструментов, так как вы можете в нем посмотреть как реализованная та или иная функциональность.

Не бойтесь изучить самостоятельно все эти категории и исследовать доступные пакеты. Во время написания этого урока наиболее богатой на пакеты была категория MODX Addons и именно в ней мы будем брать используемые в дальнейшем пакеты.

Устанавливается адонн/дополнение/пакет очень просто. Например, мы хотим установить текстовый редактор rich text editor (RTE), все что нам нужно сделать — это нажать на папке MODX Addons, развернуть ее, найти в списке и нажать на Text Editors, далее просто выбрать из списка необходимый нам редактор.

 

Вы можете узнать подробнее о пакете нажав Details или нажимайте сразу на Download для загрузки. После успешной загрузки дополнения, кнопка Download меняется на Downloaded. Вы можете загрузить еще парочку необходимых пакетов, далее нажимаете внизу кнопку Finish

 

Она выводит вас обратно в менеджер пакетов, где вы можете теперь установить необходимые загруженые дополнения для дальнейшего использования.

 

Установщик попросит вас согласится с лицензией и далее установит пакет, далее нажимаете ОК, если не появилось сообщений об ошибках или проблемах и возвращаемся на страницу управления пакетами, которая покажет эти пакеты как установленные. Как видно у нас появилась кнопка Uninstall для деинсталяции. Дополнительно под списком плагинов видно только что установленный новый адонн.

 

Все просто. Правда?

Короткая заметка для пользователей XAMPP, если у вас появились проблемы при установке дополнений, проверте включен ли параметр cURL в вашей установке XAMPP.

Выводы.

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

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

MODX + miniShop2. Установка и настройка модуля Инитпро|касса. Инитпро арнеда

В данной инструкции описаны процессы установки и настройки модуля Инитпро|касса в CMS-системе MODX, а также просмотра статуса платежей в системе.

Установка модуля Инитпро|касса в CMS-системе MODX

Модуль Инитпро|касса работает в паре с пакетом miniShop. Если данный пакет не установлен, то перед установкой модуля Инитпро|касса система самостоятельно потребует установки пакета miniShop.


  1. Авторизуйтесь в кабинете администратора MODX. Выберите пункт Пакеты в панели управления. 

  2. В появившемся списке выберите Установщик.

  3. Откроется раздел Управление пакетами.
  4. Нажмите на стрелку рядом с кнопкой Загрузить дополнения.

  5. Откроется дополнительное меню по управлению пакетами.
  6. Выберите пункт Загрузить пакет.

  7. В появившемся окне нажмите кнопку Выберите файл(ы).

  8. Выберите файл initprokassa-1.0.0-pl.transport.zip.

  9. Выбранный файл отобразится в окне. Нажмите кнопку Загрузить.

  10. Если в процессе загрузки пакета не возникло ошибок, на экране отобразится сообщение об успешной загрузке.

  11. Нажмите кнопку Закрыть.
  12. В таблице Пакеты появится новая запись – initprokassa. Статус пакета Не установлен.

  13. Нажмите кнопку Установить.

  14. Далее нажмите кнопку Продолжить.

  15. Начнется установка пакета. По окончании установки нажмите кнопку Ок.

Настройка модуля Инитпро|касса в CMS-системе MODX

  1. Нажмите на иконку .

  2. В появившемся списке выберите пункт Системные настройки.

  3. В поле Поиск по ключу… введите initpro.

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

    Где найти данные параметры, вы можете просмотреть в инструкции Настройка интеграции с интернет-магазином.

  • Система налогообложения. Укажите цифру, которая соответствует вашей системе налогообложения: 0 — ОСН; 1 — УСН доход; 2 — УСН доход-расход; 3 — ЕНВД; 4 — ЕСН; 5 — Патент.

    Внимание: убедитесь, что СНО, выбранная в CMS-системе MODX, является одной из СНО, выбранных при регистрации ККТ в личном кабинете Инитпро | касса! Как посмотреть текущие настройки СНО в личном кабинете Инитпро | касса можно узнать в инструкции Карточка кассы.

Просмотр статуса платежей

  1. Нажмите на пункт Пакеты в панели управления.

  2. В появившемся меню выберите пункт ИНИТПРО Касса.

  3. В данной таблице отображается статус фискализации платежа. Принцип работы модуля заключается в том, что как только происходит смена статуса заказа на Оплачен —  в данной таблице появляется запись о платеже со статусом фискализации Pending. Это значит, что  был отправлен запрос на фискализацию платежа в системe Инитпро|касса. 

  4. Как только данные по заказу появляются в системе Инитпро|касса, формируется чек, который записывается на фискальный накопитель кассового аппарата и отправляется ОФД. Список полученных чеков и их статусы отображаются в разделе Интернет-магазины во вкладке Полученные чеки.

Примечание: в личном кабинете Инитпро | касса укажите URL страницы для отправки ответа о пробитии чека: http://САЙТ_ВАШЕГО_МАГАЗИНА/initpro-kassa-report. Протокол передачи данных («http» и «https») в ссылке для отправки ответа о пробитии чека зависит от сайта вашего магазина. Данная ссылка действительна только для системы CMS MODX. Подробнее о данной надстройке можно прочитать в инструкции Настройка интеграции с интернет-магазином. 

 

Создание системных настроек в Modx

Вы можете изменить поведение Modx CMS или предоставить общесистемное значение, добавив Системную настройку . Например, предположим, что вы хотите сослаться на описание настройки системы, например глобального шаблона, который вы можете использовать для своего конкретного веб-сайта Modx. Вы можете быстро добавить новую настройку системы, добавить описание, а затем ссылаться на пользовательскую настройку системы позже на своих веб-страницах.Если вам требуется дополнительная информация о системных настройках, перейдите к Изменение системных настроек в Modx , чтобы получить список областей / групп настроек и информацию о том, как изменить эти настройки. В следующей статье объясняется, как добавить системные настройки с помощью интерфейса панели управления Modx Administrator.

  1. Войдите в Администратор панели управления Modx
  2. Наведите указатель мыши на строку меню в верхней части страницы, где она обозначена SYSTEM . Нажмите НАСТРОЙКИ СИСТЕМЫ , когда появится раскрывающееся меню.
  3. В верхнем левом разделе НАСТРОЙКИ СИСТЕМЫ нажмите кнопку СОЗДАТЬ НОВУЮ НАСТРОЙКУ . Вы увидите следующую форму:

    ПРИМЕЧАНИЕ: Все системные настройки относятся к тегу [[++ key]] . Для этого параметра используется ключевое поле, поэтому убедитесь, что это имя уникально.

  4. Заполните поле KEY уникальным именем.
  5. В поле FIELD TYPE щелкните стрелку вверх-вниз, чтобы открыть раскрывающееся меню.Выберите тип поля, который наилучшим образом соответствует значению, которое должен представлять параметр. Например, если ЗНАЧЕНИЕ создаваемой вами настройки системы является описанием, выберите ТЕКСТАРА , чтобы написать подробное описание. Если это ответ Да / Нет , выберите вариант « Да / Нет » в раскрывающемся меню.
  6. Щелкните поле NAME и введите имя создаваемого вами параметра. Это используется для идентификации параметра в списке системных настроек.
  7. Щелкните поле DESCRIPTION и введите краткое описание настройки. Это отображается в списке системных настроек при нажатии на знак «+» рядом со списком системных настроек.
  8. Щелкните поле Area Lexicon Entry и назовите область для создаваемой настройки. Это поле обычно совпадает с определениями области, уже установленными в Системных настройках. Для получения полного списка списков областей по умолчанию для системных настроек перейдите к Изменение системных настроек в Modx .Если ваши настройки не совпадают ни с одной из областей, дайте ей уникальное имя, и она будет отображаться как отдельная область, когда настройки перечислены.
  9. Щелкните поле VALUE и введите значение для параметра, который вы создаете.
  10. Щелкните SAVE , чтобы сохранить свои записи. На этом создание настроек системы завершено!


Обратите внимание, что для поля NAMESPACE было оставлено значение по умолчанию CORE .Это настройка для установки Modx по умолчанию, которую вы изменяете, и ее не следует изменять, если вы не работаете с настройками для другого пространства имен. Пространства имен могут включать шаблоны или компоненты, которые вы установили в Modx.

На следующих снимках экрана показан пример настройки теста, на которую можно ссылаться в Modx с помощью системного тега, и ее появление в списке системных настроек после добавления:

Как настроить и использовать MIGX TV для MODX

Так что же такое MIGX TV?

Одним из недостатков переменных шаблона является невозможность добавить более одного набора.Они отлично подходят для добавления календарной даты или фонового изображения заголовка, но не могут создать слайдер изображения, поскольку телевизор не может быть воспроизведен. Здесь на помощь приходит MIGX: MIGX означает MultiItemsGridtv и является «типом ввода настраиваемой переменной шаблона (TV) для объединения нескольких телевизоров в один телевизор». Единственная проблема в том, что официальная документация может быть трудна для понимания начинающими разработчиками. В этой статье будет предпринята попытка улучшить официальную документацию MIGX, чтобы показать, насколько мощным и простым он является.

О чем будет рассказано в этой статье?

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

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

Для начала вам необходимо установить MIGX с помощью диспетчера пакетов, который находится в разделе «Дополнительно»> «Установщик», найдите MIGX и загрузите верхний элемент. Вернитесь в диспетчер пакетов и установите Extra, нажав зеленую кнопку «Установить».

Если вы следуете официальной документации, вы можете пропустить шаг 2, так как на момент написания текущая версия выпуска — 2.12.0.

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

  • Изображение
  • Заголовок (замещающий текст)
  • Описание
  • URL (гиперссылка на изображение)
Создание TV

Первое, что нам нужно сделать, это создать новую переменную шаблона (TV) на вкладке Elements и назвать ее как-нибудь подходящим и ленивым… «Слайдер» будет работать. Затем на вкладке «Параметры ввода» выберите «migx» в раскрывающемся списке «Тип ввода» и предоставьте телевизору доступ к BaseTemplate (или любому другому шаблону, который вы используете).

Шагов:

  1. Создать новый телевизор с именем Slider
  2. Установите Тип ввода на migx с помощью раскрывающегося меню
  3. Предоставьте телевизору доступ к вашему шаблону, установив флажок рядом с шаблоном на вкладке Доступ к шаблону
  4. Сохраните шаблон, нажав зеленую кнопку «Сохранить» в правом верхнем углу экрана.

Создание конфигурации MIGX TV

После сохранения Slider TV необходимо создать конфигурацию MIGX.В официальной документации показано, как передать код JSON, необходимый для этого шага. К счастью, вам не нужно ничего вручную кодировать, поскольку MIGX поставляется со своей собственной страницей Custom Manager Page, которая записывает для нас JSON. Перейдите в Дополнительно> Migx и щелкните вторую вкладку под названием MIGX.

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

Шаги :

  1. Нажмите кнопку «Добавить»
  2. Напишите «Слайд» в поле ввода подписи. Вы можете игнорировать поле «Отображать над вкладками» на данный момент, так как это не относится к данному руководству.
  3. Нажмите кнопку «Добавить элемент» под заголовком «Поля».

Создание полей конфигурации

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

Повторяемые шаги:

  1. имя поля : т.е. slider_image
  2. Подпись : т.е. изображение (читаемое человеком)
  3. Вход TV : (для простоты должно соответствовать имени поля) slide_image
  4. Тип входного ТВ : изображение (см. Документацию по типам входных переменных шаблонов) — строчные буквы
  5. Нажмите Готово

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

Имя поля Подпись Вход ТВ Тип входа ТВ
slider_image Изображение slider_image изображение
slider_title Заголовок slider_title текст
slider_desc Desc slider_desc Richtext
slider_link Ссылка slider_link URL

(Примечание: для правильной работы richtext у вас должен быть установлен редактор WYSIWYG, например Redactor)

Когда вы закончите, у вас должна появиться таблица, показывающая ваши недавно созданные поля. Теперь нажмите «Готово» в правом нижнем углу всплывающего окна.Затем нам нужно добавить столбцы, чтобы мы могли предварительно просмотреть слайд в ресурсе. Щелкните вкладку «Столбцы» (рядом с вкладками форм вверху) и нажмите «Добавить элемент».

Вот где удобно записать (или хотя бы использовать запоминающуюся систему именования) поля, которые вы создали на предыдущем шаге. Во-первых, присвойте столбцу соответствующий заголовок, например Image, затем введите поле, к которому относится этот столбец, например, slide_image, укажите ширину столбца, то есть 40 (width определяет ширину столбца таблицы в%), и, наконец, установите для sortable значение Yes (необязательно, но мы всегда устанавливаем для первого столбца значение «Да»).После того, как вы заполните этот раздел, вы можете либо щелкнуть Готово, либо открыть вкладку Renderer. Вкладка рендерера позволяет вам настроить способ представления данных в ресурсе, поэтому, если вы хотите, чтобы ваше изображение slide_image появилось, выберите this.renderImage в раскрывающемся списке, в противном случае он просто выведет путь к вашему изображению.

Повторяемые шаги:

  1. Заголовок : присвоить столбцу заголовок
  2. Поле : введите поле, к которому относится этот столбец, т.е.е. slide_title
  3. Ширина столбца : значение от 1 до 100, попробуйте оставить целые числа от 20 до 80
  4. Сортируемый : необязательно, если первый элемент можно сортировать, остальные не могут быть
  5. Renderer : необязательно, используется только для визуализации значения поля в ресурсе, то есть для показа изображения слайда вместо пути к изображению

Когда вы закончите добавлять в свои столбцы, нажмите Готово, чтобы сохранить и выйти из ТВ.

Добавление конфигурации MIGX

После выполнения вышеуказанных шагов наша конфигурация MIGX будет доступна в таблице управления MIGX.Теперь нам нужно получить конфигурационный JSON, чтобы мы могли добавить его в Slider TV, который мы создали в начале этой статьи. Щелкните правой кнопкой мыши строку конфигурации, чтобы вызвать контекстное меню, затем нажмите «Экспорт / импорт», это откроет всплывающее окно, содержащее ваш JSON. Щелкните внутри текстового поля, выберите все содержимое cmd + a и скопируйте cmd + c , затем щелкните Готово.

Сортировка по JSON

Теперь у вас есть JSON, который нужно скопировать и вставить в нужные поля.Самый простой способ выполнить следующую часть — вставить скопированный вами JSON в редактор кода.

Откройте Slider TV на вкладке элементов, затем щелкните Параметры ввода, скопируйте в текстовое поле вкладок формы и вставьте весь код JSON между «вкладками формы»: квадратные скобки [] . Сделайте то же самое для текстового поля Grid Columns ниже, скопируйте и вставьте все содержимое между «столбцами»: квадратных скобок [] .

Вот полный код JSON, который вам нужно вставить:

Вкладки форм:

 [
    {
      "MIGX_id": 4,
      "caption": "Слайд",
      "print_before_tabs": "0",
      "поля": [
        {
          "MIGX_id": 7,
          "field": "slider_image",
          "caption": "Изображение",
          "описание":"",
          "description_is_code": "0",
          "inputTV": "slider_image",
          "inputTVtype": "изображение",
          "Проверка":"",
          "конфиги": "",
          "Restrictive_condition": "",
          "отображать":"",
          "sourceFrom": "config",
          "источники": "",
          "inputOptionValues": "",
          "дефолт":"",
          "useDefaultIfEmpty": "0",
          "pos": 1
        },
        {
          "MIGX_id": 8,
          "field": "slider_title",
          "caption": "Заголовок",
          "описание":"",
          "description_is_code": "0",
          "inputTV": "slider_title",
          "inputTVtype": "текст",
          "Проверка":"",
          "конфиги": "",
          "Restrictive_condition": "",
          "отображать":"",
          "sourceFrom": "config",
          "источники": "",
          "inputOptionValues": "",
          "дефолт":"",
          "useDefaultIfEmpty": "0",
          "pos": 2
        },
        {
          "MIGX_id": 9,
          "поле": "slider_desc",
          "caption": "Описание",
          "описание":"",
          "description_is_code": "0",
          "inputTV": "slider_desc",
          "inputTVtype": "richtext",
          "Проверка":"",
          "конфиги": "",
          "Restrictive_condition": "",
          "отображать":"",
          "sourceFrom": "config",
          "источники": "",
          "inputOptionValues": "",
          "дефолт":"",
          "useDefaultIfEmpty": "0",
          "pos": 3
        },
        {
          "MIGX_id": 10,
          "field": "slider_link",
          "caption": "Ссылка",
          "описание":"",
          "description_is_code": "0",
          "inputTV": "slider_link",
          "inputTVtype": "url",
          "Проверка":"",
          "конфиги": "",
          "Restrictive_condition": "",
          "отображать":"",
          "sourceFrom": "config",
          "источники": "",
          "inputOptionValues": "",
          "дефолт":"",
          "useDefaultIfEmpty": "0",
          "pos": 4
        }
      ],
      "pos": 1
    }
  ]
 

Столбцы сетки:

 [
    {
      "MIGX_id": 1,
      "заглавное изображение",
      "dataIndex": "slider_image",
      «ширина»: 40,
      "sortable": "false",
      "show_in_grid": 1,
      "customrenderer": "",
      "рендерер": "это.renderImage ",
      "clickaction": "",
      "selectorconfig": "",
      "renderchunktpl": "",
      "renderoptions": "",
      "редактор":""
    },
    {
      "MIGX_id": 2,
      "header": "Заголовок",
      "dataIndex": "slider_title",
      «ширина»: 20,
      "sortable": "false",
      "show_in_grid": 1,
      "customrenderer": "",
      "рендерер": "",
      "clickaction": "",
      "selectorconfig": "",
      "renderchunktpl": "",
      "renderoptions": "",
      "редактор":""
    },
    {
      "MIGX_id": 3,
      "header": "Описание",
      "dataIndex": "slider_desc",
      «ширина»: 80,
      "sortable": "false",
      "show_in_grid": 1,
      "customrenderer": "",
      "рендерер": "",
      "clickaction": "",
      "selectorconfig": "",
      "renderchunktpl": "",
      "renderoptions": "",
      "редактор":""
    },
    {
      "MIGX_id": 4,
      "header": "Ссылка",
      "dataIndex": "slider_link",
      «ширина»: 30,
      "sortable": "false",
      "show_in_grid": 1,
      "customrenderer": "",
      "рендерер": "",
      "clickaction": "",
      "selectorconfig": "",
      "renderchunktpl": "",
      "renderoptions": "",
      "редактор":""
    }
  ]
 

Еще одно последнее дополнение, которое мы хотели бы сделать, это настроить кнопку «Добавить элемент», для этого введите значение в поле «Добавить элемент». Замена: input, т.е.е. Добавить новый слайд.

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


Добавление слайдов

Непростая часть закончилась! С этого момента все будет немного проще. Теперь ваш следующий шаг — открыть ресурс, который будет содержать ваш слайдер изображений. Для нас это наш домашний ресурс, поскольку он использует шаблон baseTemplate, который использует наш Slider TV. Когда вы откроете свой ресурс и перейдете на вкладку Template Variables, вы увидите, что ваш Slider TV готов к заполнению контентом.Чтобы добавить новый слайд, нажмите кнопку «Добавить новый слайд», появится окно, содержащее поля, которые мы создали выше. Продолжайте и заполните форму, затем нажмите Готово, когда закончите. Сделайте это столько раз, сколько хотите, чтобы добавить больше слайдов, для этого урока мы добавили еще два слайда.

Повторяемые шаги:

  1. Щелкните Добавить новый слайд, чтобы открыть модальное окно ТВ
  2. Заполнить поля формы
  3. Нажмите Готово, чтобы сохранить
  4. Промойте и повторите (СОВЕТ: вы можете щелкнуть правой кнопкой мыши по вновь созданному слайду и продублировать его, это вызовет модальное окно с уже заполненными данными, может значительно облегчить жизнь.)
  5. ВСЕГДА СОХРАНИТЬ — Нажмите зеленую кнопку в правом верхнем углу, чтобы сохранить ресурс

Отображение слайдов на вашем ресурсе

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

Мы используем фрагмент под названием getImageList для отображения наших слайдов во внешнем интерфейсе, добавляем следующие детали во фрагмент:

 [[getImageList?
 & tvname = `Slider` // Название нашего телевизора
 & tpl = `slider_chunk` // Имя чанка, содержащего ваш код
]]
 

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

 
    [[getImageList? & tvname = `Slider` & tpl = `@ КОД: & lt; li & gt; & lt; img src = "[[+ slider_image]]" / & gt; & lt; h4 & gt; & lt; a href = "[[+ slider_link]]" & gt; [[+ slider_title]] & lt; / a & gt; & lt; / h4 & gt; & lt; p & gt; [[+ slider_desc]] & lt; / p & gt; & lt; / li & gt; `]]

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

Теперь вы должны увидеть свои слайды на своей веб-странице.

Заключение

Если вы освоите этот метод, создание новых телевизоров MIGX станет абсолютно легким делом, вам больше не нужно беспокоиться о форматировании кода JSON, использовании правильных названий клавиш и т. Д. Этот метод также открывает другие области MIGX extra для вас. исследовать, мы использовали лишь небольшой процент при создании слайдера изображений, MIGX может справиться с гораздо большим! Просто найдите время, чтобы ошибаться! Расстраивайтесь из-за того, что что-то не работает, и учитесь на своих ошибках.Надеюсь, вам нравится использовать MODX так же, как и мне.


Фото rawpixel на Unsplash

Руководств Боба | Создание настроек MODX

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


Пользовательские настройки

Вы, вероятно, уже использовали стандартные системные настройки, которые поставляются с MODX — такие как site_start и friendly_urls .Возможно, вы даже создали параметры контекста, параметры группы пользователей или параметры пользователя, которые переопределяют параметры, расположенные ниже в списке приоритетов. Однако факт в том, что вы можете создавать свои собственные настройки для хранения любых значений, которые должны быть доступны на сайте. Это может быть система, контекст, группа пользователей или пользовательские настройки, в зависимости от ваших потребностей. Вы можете использовать параметр, например, чтобы позволить пользователям выбрать файл CSS для использования на сайте или показать разным пользователям разные фрагменты.

В этой статье мы рассмотрим, как создавать настройки.В следующем мы рассмотрим некоторые практические применения настроек.


Как добраться

Вот путь к Менеджеру, который вы выберете для создания различных пользовательских настроек:

  • Системные настройки — Система (значок шестеренки) -> Системные настройки -> Кнопка «Создать новую настройку»
  • Настройки контекста — Система -> Контексты -> щелкните правой кнопкой мыши Контекст -> Обновить контекст -> вкладка Настройки контекста -> Создать новую кнопку
  • Настройки группы пользователей — Система -> Списки контроля доступа -> вкладка Пользовательские группы -> щелкните правой кнопкой мыши группу -> Обновить группу пользователей -> вкладка Настройки -> Создать новую кнопку
  • Настройки пользователя — Управление -> Пользователи -> щелкните пользователя правой кнопкой мыши -> Обновить пользователя -> вкладка Настройки -> Создать новую кнопку

Настройка полей формы

Ключ

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

Имя

Это название настройки на простом языке. Это произвольно и используется только при создании или обновлении настройки в Менеджере. Имя для параметра site_start , например «Начало сайта».

В более ранних версиях MODX нет поля имени, и если вы пропустили основную версию MODX при обновлении (например,грамм. 2.3.0, 2.4.0, 2.5.0), это поле может отсутствовать в вашей базе данных. См. Эту статью для получения дополнительной информации.

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

Описание

Примечания к назначению и использованию настройки. Как и Имя, это поле будет отображаться только в Диспетчере. Если вам это нужно только на одном языке, вы можете просто ввести его в поле «Описание».Однако если вам нужно представить описание на нескольких языках, это немного сложно. Мы рассмотрим способ этого в следующей статье. На данный момент используйте setting_ , плюс ключ, плюс _desc в поле Описание. Например, для параметра с именем page_count вы должны поместить это в поле «Описание»: setting_page_count_desc .

Тип поля

Как и свойства элемента, настройки имеют несколько различных типов ввода, хотя список отличается от тех, которые доступны для свойств (и он намного длиннее).Это верно для всех четырех типов настроек. MODX может ограничивать количество символов, которые вы можете ввести для значений некоторых типов полей, но поле value в таблице настроек в базе данных будет содержать 65 535 символов, поэтому вероятность его заполнения мала. Вот типы полей:

  • Текстовое поле — Одна строка текста
  • Textarea — То же, что TextField, но с большим пространством
  • Да / Нет — представляет раскрывающееся меню с вариантами Да и Нет.Фактически сохраняется 1 (да) и 0 (нет)
  • Пароль — То же, что и TextField, но все символы отображаются в виде звездочек. Значение хранится в виде обычного текста в базе данных
  • .
  • Категория — представляет раскрывающееся меню всех категорий на сайте. Фактически сохраняется идентификатор выбранной категории
  • Charset — представляет длинный список наборов символов. В базе данных хранится сокращенный код кодировки.Например, если вы выберете Unicode (UTF-8) — utf-8, поле значения будет содержать UTF-8
  • Страна — представляет длинный список стран. Сохраняется сокращенный код страны, например, США для США
  • .
  • Контекст — выводит список контекстов на сайте. Сохраняется контекстный ключ (например, web или mgr
  • Пространство имен — перечисляет пространства имен на сайте. Сохранено то же, что и выбрано: имя пространства имен
  • Шаблон — Список шаблонов на сайте.Сохраняется идентификатор выбранного шаблона
  • .
  • Пользователь — Список всех пользователей сайта. Сохраняется идентификатор пользователя
  • Группа пользователей — Список всех групп пользователей на сайте. Сохраняется идентификатор группы пользователей
  • .
  • Язык — Представляет список кодов языков (например, en), что хранится, это то, что показано
  • Источник — Список всех медиа-источников на сайте. Сохраняется идентификатор медиаисточника
  • .
  • Тема диспетчера — Список всех тем диспетчера.То, что хранится, такое же, как показано на рисунке
  • .

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

Пространство имен

Пространство имен, с которым связан этот параметр. Если вы будете создавать одну или несколько пользовательских настроек, неплохо было бы создать собственное пространство имен, чтобы их было легче найти. Если вы этого не сделаете, ваш параметр будет привязан к пространству имен core .Это пространство имен предназначено для встроенных настроек MODX, так что ваше собственное там не место. Чтобы создать пространство имен, перейдите в раздел «Система» (значок шестеренки) -> пространства имен -> кнопка «Создать». Обычно имена пространств имен пишутся строчными буквами и не содержат ничего, кроме букв (без пробелов, дефисов или подчеркиваний).

Когда вы создаете пространство имен, форма запросит у вас имя, которое требуется (это первичный ключ для пространства имен). Он также запросит Core Path и Assets Path. Это необязательно, но если вы хотите интернационализировать имя, описание и / или имя области настройки, вам нужно будет ввести Core Path.Следующее используйте точно так, как написано. Не ставьте косую черту после {core_path} : и не забывайте завершающую косую черту в правом конце. Чтобы начать работу в следующей статье, мы будем использовать mysettings в качестве имени пространства имен.

{core_path} components / mysettings /
 

Пока мы здесь, мы также должны добавить путь к активам на случай, если он понадобится нам позже:

{assets_path} components / mysettings /
 

После того, как вы создали свое пространство имен, поместите его имя в поле «Пространство имен» при создании любых новых пользовательских настроек.

Чтобы найти свои настройки в сетке (например, сетке Системных настроек), щелкните раскрывающийся список «Фильтр по пространству имен» и начните вводить имя вашего пространства имен. Когда появится имя заливки, щелкните по нему, и вы увидите только настройки в вашем пространстве имен.

Запись в лексиконе зоны

Это поле является необязательным, и его название немного сбивает с толку. Вы можете использовать его для названия области, в которой будет организована настройка. Если у вас всего одна или две настройки, вы можете оставить это поле пустым.Однако, если у вас много настроек, вам будет проще организовать их по нескольким областям.

Если вам нужны только названия областей на одном языке, просто введите их в это поле.

Если вам нужно интернационализировать имена областей, см. Следующую статью, где мы обсудим, как это сделать. А пока просто введите короткое слово, описывающее местность. Это будет ключом к лексикону. В следующей статье мы рассмотрим, как создать строку словаря для этого ключа.

значение

Вы можете подумать, что это поле содержит исходное значение параметра, а в базе данных оно есть. Однако в форме, если есть раскрывающийся список для значения, в поле отображается строка из списка, например «Unicode (UTF-8) — utf-8». Когда вы используете тег для получения значения, тег будет заменен тем, что хранится в базе данных. В данном случае это UTF-8. См. Список типов полей выше для получения дополнительной информации о том, что хранится в базе данных для каждого типа.


Завершение

Создание собственных настроек может показаться сложным, но это не так плохо, как кажется. Как только вы сделаете несколько, это будет очень просто. Почти все пользовательские настройки — это либо текстовое поле, либо настройки «Да / Нет». Я также должен упомянуть, что если у вас есть настройки, которые необходимо часто изменять (либо встроенные настройки MODX, либо собственные настройки), неплохо иметь отличное дополнение ClientConfig от Марка Хамстры, которое обеспечивает приятный интерфейс для установки их значений. .


Скоро

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


Ищете качественный хостинг с поддержкой MODX? По состоянию на май 2016 г. Bob’s Guides размещается на хостинге A2. (Более подробная информация в поле ниже.)



Настройки

— Фред

Наборы опций

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

Глобальные настройки

Следующее управление индивидуальными настройками и группировкой для элемента на странице, управляемой Фредом.

пульт

Установите значение true , чтобы запросы XHR отображали элемент через парсеры Twig и MODX. При изменении настроек элемента также выполняется повторный рендеринг как с помощью парсера Twig, так и MODX. Это означает, что вы можете иметь динамический контент, который ссылается на другие страницы в пределах страницы Fred, используя фрагменты MODX.По умолчанию: false .

Кэш

Вывод

Это кэширует вывод элемента в статический HTML, если установлено значение true и когда предыдущий глобальный параметр remote также установлен на true .

mediaSource

Имя медиаисточника для использования в Finder. Несколько имен можно передавать через запятую , .

imageMediaSource

Имя источника мультимедиа для использования в полях изображения. Несколько имен можно передавать через запятую , .Этот параметр переопределяет mediaSource .

Панель инструментов

Плагины Включить

Список подключаемых модулей панели инструментов для включения элементов.

Панель инструментов

Плагины Исключить

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

Настройки

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

Параметры настроек

Следующие свойства применяются ко всем настройкам, независимо от типов ниже:

  • name — Имя настройки, может использоваться как переменная Twig
  • label — Метка настройки, отображаемая на панели настроек элемента
  • значение — значение по умолчанию
  • тип — Тип настройки, см. Следующий раздел

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

Доступные типы настроек

Следующие типы настроек используются для настройки элементов в Fred.

текст
  • Однострочный HTML-код элемент
  • Может иметь любое текстовое значение
текстовое поле
  • Многострочный HTML