Open Source документация для MODX Revolution
Хочу представить вам новый проект по ведению открытой документации для MODX Revolution.
Зачем?
Затем, что система далеко не новая, а нормальной русскоязычной документации до сих пор нет. Всё, что есть, разбросано по разным сообществам и блогам, которых несколько десятков, и любой начинающий пользователь бегает туда-сюда, задавая вопросы.
Официальная документация на русском не ведётся. Не знаю, как сейчас, но год назад у них просто не сохранялась кириллица.
Почему не сделать это на сайте n или z?
Потому, что у этих сайтов есть хозяева, у них нужно просить логиныпароли и нет никакой гарантии, что завтра сайт не пропадёт, оставив ваш вклад в кэше гугла.
Например, я пробовал писать про свои дополнения на официальном сайте, а потом они его переделали, и мой логин пароль больше не подходит. Просто зарегистрироваться нельзя — нужно получать их через письмо в поддержку. Конечно, повторно это делать нет желания.
К тому же, сообщество MODX не может похвастаться сплоченностью, и основных разработчиков просто не собрать в одном месте, чтобы они что-то там написали.
И что ты предлагаешь?
Очень просто — нужно вести документацию в GitHub, в общеизвестном формате Markdown.
Такая система гарантирует нам:
- Сохранность всех текстов. Каждый человек может скопировать репозиторий и разместить у себя.
- История изменений. Все правки как на ладони, видно кто и что написал.
- Независимость. Вы можете писать о любой теме, касающейся MODX, на любом языке. И вам не нужно просить для этого доступ — достаточно иметь аккаунт на GitHub.
Идея не новая, и подсмотрел я её у проекта daux.io. Это PHP скрипт, который генерирует сайт по готовым файлам markdown.
Он очень простой, и позволяет запустить свой сайт с документацией, не обладая вообще никакими навыками, на любом хостинге. Однако, на мой взгляд, у него есть несколько недостатков (которые являются продолжением достоинств).
Например, я вовсе не уверен, что динамическая генерация сайта по файлам, без кэширования, будет хорошо работать на нескольких тысячах страниц. Таже, там нет поиска, нет управления адресами страниц, удобного переключения между языковыми версиями, и еще по мелочи.
Так что, для показа нашей документации я использовал любимую систему — MODX.
Как работает?
Это обычный сайт на MODX, построенный с использованием стандартных дополнений, но все его страницы импортируются из файлов.
Это даёт:
- Кэширование. Все документы будут загружаться из кэша, и не нужно каждый раз шерстить все файлы документации.
- Управление url документов — их можно перемещать и не терять при этом переходы из поисковиков.
- Возможность организовать поиск на сайте.
- Удобная работа с языковыми версиями. Их может быть сколько угодно.
Вёрстку я набросал на Bootstrap 3, чтобы было удобно читать с телефонов и планшетов. Для работы используются:
- pdoTools — вывод соседних документов, всех меню и хлебных крошек.
- mSearch3 — морфологический поиск.
- DateAgo — приятное форматировние дат
- yTranslit — генерация url страниц через переводы Яндекс.
- MinifyX — склейка и сжатие скриптов и стилей, для быстрой загрузки страниц.
- Markdown — новый сниппет для вывода текстов в этом формате. Написал специально для этого проекта.
Еще раз напоминаю, что эта документация никому не принадлежит. Я сделал свою версию сайта для её вывода, а вы можете склонировать репозиторий и запустить его на том же daux.io — структура директорий и файлов совместима.
Цель проекта, дать наконец то инструмент сообществу, чтобы собрать всю информацию в одном месте, и дружно ей пользоваться. Присоединяйтесь!
Ссылки
Репозиторий документации на Gitub.
Сайт с выводом этой документации.
Готовый сниппет Markdown.
Наш репозиторий с дополнениями, на которых работает сайт.
Планы на будущее: разработка простенького API, для интеграции текстов на другие сайты и (возможно) сокращалка url.
Автор: bezumkin
Источник
MODX Docs | MODX Docs
Обзор
MODX Revolution (Revo) — это простая в использовании система управления контентом (CMS) и Application Framework, объединенные в одно целое. Несмотря на безграничные возможности, которые предоставляет вам MODX, мы думаем, что работать с ним будет просто и понятно. На каждом этапе MODX стремится предоставить полную свободу.
В дополнение к этому сайту документации, MODX сообщество энергичное и всегда готовое помочь. Продолжайте задавать вопросы — вы будете приятно удивлены отзывчивостью пользователей MODX.
Кроме того, есть доверенные, опытные MODX Профессионалы с кем вы можете взаимодействовать, чтобы выполнить работу. MODX также имеет коммерческую поддержку при поддержке поставщика варианты, поэтому независимо от ваших потребностей и требований — вы можете быть удовлетворены.
С чего начать
Этот сайт документации является подробным справочником по всем вопросам MODX, но есть также руководства и учебные пособия, которые помогут вам быстро и легко начать работу. Основные моменты включают в себя:
Если у вас есть вопрос об этом сайте документации, вы хотите помочь улучшить его, посмотреть источник документации и приложение на GitHub. Новые участники приветствуются!
MODX Revolution
Revolution — флагманская CMS и прикладная среда MODX, которую с любовью называют «Revo». Если вы новичок в MODX, начните с нее.
Быстрые ссылки
Другие ресурсы
Дополнения
Дополнения MODX расширяют основные функциональные возможности программного обеспечения MODX. Другие CMS называют их «плагинами» или «модулями». Многие дополнения разработаны основной командой MODX, а другие сторонними разработчиками. Хотя это ни в коем случае не исчерпывающая ссылка, большинство самых популярных дополнений документированы здесь.
xPDO
xPDO — это объектно-реляционный мост (ORB), который поддерживает MODX. Если вы знаете, что это значит, или вы любите приключения, то для вас следующее:
Быстрые ссылки
Другие ресурсы
Справочник участника
Любишь MODX? Узнайте, как принять участие в сообществе и внести свой вклад в проект с открытым исходным кодом.
А как насчет MODX Evolution?
Evolution — это классическая кодовая база MODX — оригинальная версия, выпущенная в 2005 году. По состоянию на апрель 2017 года Официально Evolution — это отдельный проект, уже не под крылом MODX. Это означает, что у Evolution есть собственное руководство, процессы и сообщество.
Всю информацию о Evolution, включая документацию и дополнительные материалы, можно найти по адресу evo.im.
Защищаем MODX Revolution / Habr
Привет, друзья!
Немало статей написано и переписано о том, как защитить MODX, но в этой статье я опишу не только стандартные рекомендации по защите инстанса MODX Revolution (далее я буду писать просто MODX, потому что ветка MODX Evolution — это тупиковая ветвь «эволюции» являющаяся рудиментом не заслуживающим внимания современных разработчиков), но и некоторые новые методы «заметания следов».
Итак, начнем самого важного.
Существует две разновидности установщика MODX — это Traditional и Advanced.
Какая между ними разница?
Traditional — это простой вариант установки на любой хостинг соответствующий рекомендациям для установки MODX, где ядро устанавливается прямо в корень публичной папки сайта. Незатейливые «сайтоклёпы» ставят версию Tradtiional, не закрывают директории от просмотра и в итоге всё содержимое сайта, в т.ч. служебных директорий, попадает в индекс поисковиков. Не станем фантазировать на тему, к чему это может привести. Здесь всё понятно.
Advanced — версия для парней, которые, как минимум «смотрели кино про нидзей». Этот вид установщика позволяет разместить ядро MODX вне публичной папки, спрятав его от посягательств злоумышленников. Для серьезных проектов это рекомендуемый вариант, но лично я его использую всегда.
Защита ядра
Защитить ядро можно двумя способами:
1. На нормальном хостинге — вынести ядро из публичной папки и можно его не переименовывать и не настраивать .htaccess лежащий в этом каталоге (на VDS не стоит забывать о настройке прав доступа пользователя, от которого запускается Apache).
2. На дурацком хостинге — переименовать каталог ядра воспользовавшись, например, генератором паролей (без спецсимволов, конечно же — только буквы и цифры) И во время установки указать физический путь к каталогу ядра. Именно поэтому лучше использовать Advanced установщик.
Защита служебных каталогов
Не секрет, что кроме каталога ядра, другие служебные каталоги должны остаться в публичной папке сервера.
Что нам сделать для защиты от попыток взлома через коннекторы и попыток проникнуть в админку? Стандартные наименования каталога коннекторов /connectors, а для админки — /manager, и это палево.
Во время установки вам будет предложено изменить эти названия. В этом нам поможет, правильно, — генератор паролей и, как ни странно, в случае с админкой собственная голова. Название каталога админки лучше сделать человекопонятным, но не /admin, конечно же 🙂
Возможно, вы захотите спросить: Почему мы не прячем /assets?
И, возможно, я отвечу: А зачем? Все картинки и скрипты лежат в /assets, а в коде страницы есть все ссылки на картинки и скрипты 🙂
Защита таблиц БД
Во время установки, в настройках БД, по умолчанию предлагается префикс таблиц «modx_». Так дело не пойдет. И вновь нам поможет генератор паролей (Помнишь, товарищ? Только из букв и цифр!). Меняем стандартный префикс на кракозябры, в конце которых ставим нижнее подчеркивание. Например, «IU1xbp4_».
Защита от определения CMS
Сервисы автоматического определения CMS сайтов, конечно, не в курсе, что MODX — это CMF, но это не мешает им определить, что контентом на сайте рулит именно MODX. Казалось бы, мы уже спрятали всё что надо. А вот и нет.
Первым делом, при установке MODX Revolution необходимо отключить чекбокс «X-Powered-By», который включен по умолчанию (на картинке ниже). Это необходимо для того, чтобы MODX не «палился», отправляя в заголовках информацию о том, что сайт сделан на MODX.
Если сайт уже установлен, то проверить этот параметр можно в системных настройках по адресу: домен_вашего.сайта/manager/?a=system/settings
И в поле «Поиск по ключу» ввести «send_poweredby_header» или просто «header» и нажать Enter на клавиатуре. Значение «send_poweredby_header» должно быть установлено как «Нет».
Также не лишним будет скрыть файлы конфигурации.
Для примера, возьмем первую ссылку из приведенного выше списка поиска Google, и попробуем открыть файл настроек config.core.php, или, не смотря на то, что на этом сайте уже закрыт листинг каталогов, по ссылке «www.vvhotel.ru/core/config/config.inc.php», сайт отдает результат исполнения файла .php, а это значит что каждый из этих файлов существует и даже по первому из них можно предположить, что сайт на MODX.
Скрыть этот файл можно при помощи .htaccess, дописав:
<IfModule mod_rewrite.c>
RewriteCond %{REQUEST_URI} ^(.*)config.core.php$
RewriteRule ^(.*)$ [R=404]
</IfModule>
Кое-что ещё
Кроме описанных приёмов, можно применить небольшую хитрость, чтобы увести возможных злоумышленников по ложному следу. Некоторые «попсовые» CMS добавляли метатэги с указанием названия CMS:
<meta name="generator" content="WordPress x.x.x" />
Можно смело добавить в свой код такой тэг, и создать фэйковую стандартную страницу входа в админку указанной версии имитируемой CMS.
Автоопределялки будут интерпретировать наш MODX как WordPress, а если хулиганы захотят залезть в админку, то будут долго и нудно пытаться подобрать отмычки от простого замка к сканеру сетчатки глаза ( это метафора 🙂 ).
А что, если сайт уже установлен?
В час наименьшей нагрузки, переименуйте все указанные каталоги (/core, если позволяет хостинг, лучше вынести из паблика).
Смените префикс существующих, с помощью phpMyAdmin:
- в левой части phpMyAdmin кликаете на название нужной базы;
- в основной области появится список всех таблиц, внизу которого надо отметить чекбокс «Отметить все»;
- справа от чекбокса комбобокс «С отмеченными:» в котором надо выбрать «Заменить префикс таблицы»;
- в новом окне указать старый префикс и новый префикс, на который надо заменить старый.
Затем, если у вас Traditional, но вы хотите заменить на Advanced, то поверх содержимого /core (или как вы его по-новому назвали) надо записать содержимое каталога /core из архива Advanced установщика, а в корень сайта поместить /setup.
Проверить права и доступ (на каталоги 755, на файлы 644).
Запустить процесс установки.
Во время установки вам надо будет указать физический путь до каталога ядра.
ВАЖНО выбрать вариант установки «Расширенное обновление (с настройкой параметров базы данных)», потому что после ввода данных БД, появится диалог переименования каталогов.
Можно, конечно, было залезть в config.inc.php и отредактировать всё там. Но зачем что-то делать, если этого можно не делать? 🙂
На этом всё. Если информация из этой статьи окажется Вам полезной — супер. Если захотите что-то спросить, добавить или просто поумничать — вэлкам в коменты!
Шаблоны MODX Revolution
Что же представляет собой шаблон?
Шаблон заключает HTML-теги разметки, которые характеризуют размещение и наружный вид вашего сайта и особые теги MODx которые обозначат размещение всевозможных блоков и динамических объектов. В то время когда документ запрашивается, MODx грузит документ в шаблон и все особые поля в шаблоне сменяет на соответствующие значения из документа, перед отправкой странички браузеру пользователя.Имеется возможность вообразить, что шаблон это строение, а ресурс это человек. У человека может быть не один дом, однако в один момент времени он имеет возможность проживать лишь в одном доме.Ресурсу можно определить лишь один шаблон. Но, ресурсу может изменить шаблон, как человек имеет возможность перебраться из дома в дом когда пожелает. Шаблон схож с домом, в свою очередь модифицирует отражение страницы. Шаблон обычно располагает шапкой, подвалом или же навигационным полем, сайдбар и т.д.Применение
Для организации шаблона перейдите на вкладку элементы, нажмите правой кнопочкой на шаблоны. Изберите новейший шаблон и введите ваш HTML код в поле «Код шаблона». Вы сможете скопировать и вставить код расположенный далее, что бы начать с обычного шаблона.<html>
<head>
<title>[[*pagetitle]]</title>
<meta name="description" content="
<code>[[*description]]</code>
"/>
</head>
<body>
<h2>
<code>[[*longtitle]]</code>
</h2>
Page ID:
<code> [[*id]]</code>
IntroText (Summary):
<code>[[*introtext]]</code>
MenuTitle:
<code>[[*menutitle]]</code>
<hr/>
<code>[[*content]]</code>
</body>
</html>Непременно запишите тег
<code> [[*content]] </code>данный тег извещает MODx выводить в него ресурс.
По умолчанию MODx сохраняет шаблон в базе данных, в случае если у вас MODx до 2.2.x это лишь ваша опция. В версиях MODx от 2.2.x предусмотрена возможность избрать где хранить шаблоны: в базе данных или же в статичных ресурсах применяя медиа источник.
Не забываете, что сделанный шаблон не применяется для ресурсов автоматом, вы обязаны поменять каждый ресурс, показав какой шаблон применять. Данное отличие от многочисленных систем управления веб-сайтом, где один шаблон применяется для многочисленных или же всех страниц. Любая страничка MODx располагает одним шаблоном, который она применяет для вывода ресурсов. Когда вы сформируете более одного шаблона, вы можете менять всякий ресурс и избирать шаблон для него из перечня «Шаблон» в опциях ресурса. Шаблон имеет возможность заключать любые таги, в том числе переменные шаблона, чанки, сниппеты, и прочие.
Применение полей ресурса в шаблоне
Как вы увидели выше в нашем шаблоне, отдельные поля ресурса можно прибавить в шаблон, применяя синтаксис [*Имя поля]]. Перечень различных полей ресурсов можно посмотреть здесь. Например, в случае если нужно представить заголовок странички ресурса в теге<title>
<code>[[*pagetitle]]</code>
</title>У вас есть возможность разместить содержимое текущего ресурса используя тег content
<body>
<code>[[*content]]</code>
</body>Данные теги смотрятся как обыкновенные теги MODx, однако к ним можно применить выходные фильтры. Например, вы желаете продемонстрировать поле introtext справа в навигационной части, однако убрать все html теги из него и представить лишь начальные 400 символов. Дальше данный тег примет вот такой вид:
<code><div></code><code><code>[[*introtext:stripTags:ellipsis=`400`]]</code></code><code></div></code>
Переменные шаблона в шаблоне
В случае если шаблон сравнить с домом, то все переменные шаблона(TV) представляются, как комнаты в этом доме. Вы можете располагать бесконечной численностью TV в шаблоне, это как прибавить дополнительную комнату к дому.Переменные шаблона дают возможность вам прибавлять любые поля для любого ресурса в шаблоне.Допустим вы решили добавить поле ‘photo’ в ресурс в котором используется шаблон «Страничка биографии». Элементарно — сделайте TV, дайте ему название ‘bioPhoto’, определите тип изображение и дайте его вашему шаблону «Biography Pages». Вы сможете увидеть данный TV во всяком ресурсе, у которого определен шаблон «Страничка биографии». В контенте укажите вашу переменную шаблона ‘bioPhoto’ с похожим синтаксисом к примеру как у полей ресурса.
<code>[[*bioPhoto]]</code>Важно! Переменные шаблона обязаны быть назначены для шаблонов в которых применяются. Определенное значение для шаблона, TV’s для ресурса можно скорректировать там же где редактируется ресурс. В случае если вы не видите снова созданный TV в вашем ресурсе, удостоверьтесь что вы определили TV для этого шаблона.
Перейти в раздел MODX шаблоны
Установка MODX Revolution на хостинг
Установка MODx Revolution 2.x
В первую очередь, необходимо скачать MODx Revolution 2.x. У вас есть возможность сскачать прямо с сайта разработчика.
«Traditional» или «Advanced»?
Открыв страничку загрузки, вы сможете увидеть 2 варианта «Traditional» и «Advanced». Какому же отдать предпочтение?
Traditional является скомпилированным пакетом из репозитория Git. Вам остается лишь элементарно распаковать файлы на выбраный сервер и выполнить все шаги руководства по установке. Основная масса пользователей традиционно используют именно данную версию.
Advanced является пакетом по размеру практически в два раза менее, нежели «Traditional», так как содержимое «ядра» заархивировано. MODx Setup распаковывает данный пакет в ходе инсталляции. Данный вариант советуется применять лишь в том случае, в случае если вы намереваетесь смешать каталоги с ядром, управлением и коннекторами (connectors), и в случае если вы располагаете SSH-доступ и понимаете, как скорректировать права доступа к папкам. В случае если вы избираете данный вариант, перейдите к разделу «Advanced Installation».
Примечание: Так как я избрал вариант Traditional, в следующем изложении речь пойдет лишь о данном варианте. В случае если вас интересуют остальные — почитайте оригинальную документацию.
Подготавливаем базу
Так как MODx функционирует с использованием базы данных MySQL, накануне установки необходимо создать базу. При данном нужно выяснить такие данные:
• название сервера баз данных (выяснить у хостинг-провайдера)
• название базы
• логин юзера для доступа к базе
• пароль юзера
Загружаем дистрибутив не сервер
После подготовки базы, закачивайте дистрибутив на сервер хостера. При данном лучше закачивать непосредственно в виде архива, хоть данное возможно лишь в том случае, в случае если вы затем сможете разархивировать дистрибутив там. Мой хостер (mchost.ru) дает право закачать zip-архив и автоматом расположить его на хостинге, что я и проделал.
В случае если подобная возможность отсутствует, то доведется развернуть архив на локальном компьютере и закачать его посредством FTP. Разница значимая, так как объем архива 8,25 Мегабайта, а уже в развернутом виде он занимает целых 21,27 МБ.
Перед тем как перейти к этапу инсталляции, необходимо еще проконтролировать, что на каталогам core/cache/ и core/config/ дано право записи. Вот сейчас, как будто бы все готово и имеется возможность приступить непосредственно к установки.
Административная панелью
После щелка по кнопочке «Войти», вам будет предложен ввод имени и пароля админа сайта.
Далее вы попадаете в админ. панель MODx. Прочитайте (в случае если владеете английским), далее закрываем данное окно и видим, и перед нами предстает, админ. панель в ее изначальном состоянии.
Примечание: Далее для того чтобы попасть в панель управления, вам нужно ввести в адресной строчке браузера http://ваш_сайт/manager/ и перед вами предстанет также форма ввода имени и пароля пользователя.
Инжиниринговая компания ЗАО «Троник» http://tronic-cleanrooms.ru/ предлагает услуги проектирования и строительство производственных комплексов для различных областей микроэлектроники.
Установка базового пакета
Начало установки
MODx Revolution скачан, и перед тем как начать установку, прочитайте Советы к серверу, а равным образом удостоверьтесь в том, что папки /core/cache и core/config являются доступными для записи. В случае если в ходе установки появились трудности, просьба прочитайте Проблемы при установке.
Для старта установки перейдите по адресу ‘http://вашсайт/setup’.
На 1 страничке вам порекомендуют сделать выбор языка. Жмите далее 
Параметры установки
Далее, вы увидите страничку с Параметрами установки
Вам будет доступен вариант лишь новейшей установки. В случае если вам нужно поменять права доступа для вашего вебсервера, у вас есть возможность сделать это в текстовых полях. Основная масса серверов прекрасно работает с правами по умолчанию. Жмите дальше для продолжения.
Настройка базы данных
В этом месте вам нужно заполнить данные о вашей базе данных.
Добавьте имя вашей базы данных, а так же URL где находится ваша база. Для основной массы пользователей это localhost.
В свою очередь, вы можете изменить префикс таблиц. Это префикс таблиц,их MODX применяет для собственных переменных. Замена префикса таблицы может понадобиться, в случае если вы намереваетесь в одной базе данных хранить данные многих сайтов на MODx.
Когда завершите жмите на ссылочку Проверить соединение с сервером баз данных и показать перечень доступных сопоставлений. Если возникли какие-нибудь ошибки, вы увидите их внизу. В случае если предстанут ошибки, удостоверьтесь, что вы верно ввели имя пользователя базы данных или же пароль. Вполне вероятно названный вами пользователь не располагает правом создавать базу данных, тогда нужно создать ее вручную.
MySQL Notes
В случае если у вас MySQL сервер располагает не стандартным портом, вы сможете назначить его «my.database.com;port=3307», прибавляя к IP адресу или же имени хоста ;port= .
В случае если MySql сервер не располагает поддержкой сети, то вы сможете применять имя соккета «;unix_socket=MySQL»
Microsoft SQL Server Notes
Поддержка Microsoft SQL Server предусмотрена с версии MODx Revolution 2.1
В зависимости от конфигурации сети вашего SQL сервера, нужно указать последующие настройки:
• Named pipe: (local)/SQLEXPRESS
• Tcp/ip: 127.0.0.1,2301 (IP, port)
Вследствие этого PDO драйвер вашего сервера будет функционировать и вы не уведите ошибку когда нажмете Проверить соединение с сервером баз данных и показать перечень доступных сопоставлений. В случае если данное все таки приключалось это говорит о том, что у вас имеются затруднения с соединением с базой данных, аутентификацией или же выбором базы данных. В последствии проверки и исправления всех данных жмите Назад, для того чтобы возвратиться на предшествующую страничку и затем Далее, что бы возвратиться на страничку настроек базы данных.
Параметры кодировки и сравнения
После этого внизу выплывет последующее окно — выбор кодировки и сравнения базы данных. 
В основной массе случаев вы можете сохранить эти значения по умолчанию. Но, в случае если вами нужно изменить их, удостоверьтесь, что параметр сравнения совместим с кодировкой. Для продолжения установки жмите Создание и проверка выборки из базы данных Microsoft SQL Server Notes.
Заполняем форму, необходимую для создания системного администратора. MODx советует не использовать имя администратора ‘admin’. Это известное имя администратора и применяется традиционно для взлома системы хакерами.
Далее вводите e-mail администратора, а затем пароль. Жмем Далее
Проверка системы перед установкой
В MODx будет выведено окно в котором будут отображены все результатами проверки вашей системы перед установкой. В случае если проверка не была закончена, удостоверьтесь, что ваша система отвечает условиям Рекомендаций к серверу и нужные директории располагают правом на запись. После успешного прохождения проверки, нажимайте Установить.
В случае если перед вами предстанет пустой экран или же процесс установки не пойдет после нажатия на Установить, опробуйте следующее:
1. Удостоверьтесь что директории /core/packges, /core/import и /core/export располагают правом на запись
2. Удостоверьтесь что в файле опций PHP php.ini выставлены следующие значения memory_limit 128M и max_execution_time 120
3. Создайте пустой файл /core/config/config.inc.php и удостоверьтесь, что у него выставлены права на запись. НЕ СТИТ КОПИРовать config.inc.tpl, создайте пустой файл.
4. Создайте тему на форуме с вашей проблемой, указав настройки вашего сервера и данные об установке и вам непременно помогут.
Отчет после завершения установки
MODx сообщит вам в случае если появились какие нибудь ошибки под час установки и даст вам право переустановки, что бы исправить данные ошибки. После успешной установки, нажимайте. Далее и вам нужно будет произвести заключительную настройку.
MODx советует удостовериться, что папка setup удалена для защиты вашего интернет-сайт от пробы запуска установщика сторонними вы можете проделать это поставив галочку в чекбоксе.
Теперь же вам осталось нажать на Вход и будет открыто окошко входа в систему админа. Установка благополучно закончена!
Инновационная компания Promate http://promate-rus.com/ в России предлагает огромный ассортимент аксессуаров для планшетов, мобильных телефоново, автомобилей и мотоциклов.
Установка расширенного пакета
Из этой инструкции вы узнаете несколько деталей касающихся установки дистрибутива MODx Advanced. Мы советуем ставить этот дистрибутив, в случае если:
Вы намереваетесь переименовать папки manager/ или же connectors/ или же переместить папку core/;
У Вас имеется доступ к серверу по SSH или же вы просто можете переместить и сформировать папки на вашем сервере с правами на запись.
Накануне установки прочитайте Советы к серверу.
Подготовка установки
После скачивания дистрибутива MODx Revolution Advanced, вам необходимо закачать его на сервер и распаковать. У вас есть две папки core/ и setup/. Теперь, в случае если вы намереваетесь переместить папку core/, проделайте это сейчас. В случае если вы не намереваетесь этого делать, откройте браузер и введите в адресной строчке ‘http://ваш_сайт/setup/’ далее перейдите в раздел Установка контекста, данной инструкции.
Переименование и перемещение core
MODx Revolution предоставляет вам право переименовать или же переместить папку core/ для более высокого уровня защиты вашей системы.
Если вы хотите переименовать или переместить папки core/, MODx советует проделать это до установки. Попросту переименуйте или же переместите core и setup сначала вам будет предложено ввести новое размещение папки core
Впишите в текстовое поле полный адрес новейшего расположения папки core. В случае если MODx может отыскать core, вы продолжите стандартную установку. В случае если MODx не сумеете отыскать директорию, проверьте что вы ввели адрес верно и что определили права на чтение и файлы папки core/cache доступными для записи.
MODx имеет возможность спросить вас сделать файл setup/includes/core.config.php доступным для записи. Это необходимо для изменения месторасположения core, и вы сможете это сделать до установки.
Конфигурационный ключ вебсайта
Сейчас MODx спросит у вас избрать язык. После того как вы это сделаете, покажется окошко приветствия MODx, а ниже вопрос желаете ли вы изменить конфигурационный ключ MODx. Это даст возможность вам запускать несколько веб- сайтов с общим ядром, для любого сайта нужно будет определить его уникальный конфигурационный ключ.
Что бы изменить его, элементарно кликните мышкой на ссылку нажмите здесь в предложении изменить конфигурационный ключ, и вам будет предложено окошко для ввода.
Укажите собственный уникальный конфигурационный ключ и нажимайте Далее.
Расширенные опции
Сейчас вам будут презентованы настройки как при Базовой установке, однако появятся 2 дополнительных пункта. Станет доступен пункт Новая установка, а это именно то, что нам и необходимо.
Далее будут текстовые поля в которые нужно ввести прав доступа для новых файлов и папок которые будет создавать MODx во время установке. Права по умолчанию отлично работают, однако в случае если имеются лимитирования сервера, вы можете изменить права 0775/0664 соответственно.
Далее вы уведите 2 опции избираемые чекбоксом:
Они выделяются серым цветом во время новой установке. (Если начнете обновление, советуем не отмечать их). Жмите Далее.
Подключение к базе данных
В этом месте вы заполняете необходимую информацию о вашей базе данных.
Добавляете имя вашей базы данных и URL где находится ваша база. Для основной массы пользователей это localhost.
В свою очередь, у вас есть возможность изменить префикс таблиц. Данный префикс таблиц, использует MODX для собственных переменных. Это понадобится в случае если вы желаете в одной базе данных сохранять информацию многих сайтов на MODx.
Когда завершите жмите на ссылочку Проверить соединение с сервером баз данных. Если появятся какие нибудь ошибки, вы заметите их ниже. В случае если возникнут ошибки, удостоверьтесь, что вы верно ввели имя пользователя базы данных и пароль.
В свою очередь в случае если пользователь определенный вами не располагает правами создавать базу данных, то сделайте ее вручную.
MySQL Notes
В случае если у вас MySQL сервер обладает не стандартным порт, вы можете назначить его «my.database.com;port=3307», прибавляя к IP адресу либо имени хоста ;port= .
В случае если MySql сервер не поддерживает сеть, то вы можете применять имя соккета «;unix_socket=MySQL»
Microsoft SQL Server Notes
Поддержка Microsoft SQL Server предусмотрена с версии MODx Revolution 2.1
В зависимости от конфигурации сети вашего SQL сервера, нужно определить следующие опции:
Named pipe: (local)/SQLEXPRESS
Tcp/ip: 127.0.0.1,2301 (IP, port)
Вследствие этого PDO драйвер вашего сервера будет работать и не будет ошибки когда нажмете Проверить соединение с сервером баз данных. В случае если это все таки приключалось это говорит о том, что у вас имеются осложнения соединения с базой данных, аутентификацией или же выбором базы данных. Когда исправите все ошибки жмите Назад, для того чтобы возвратиться на предшествующую страничку и затем Далее, для того, что бы вернуться на страничку опций подключения к базе данных.
Характеристики кодировки и сравнения
После данного внизу покажется следующее окошко выбора кодировки и сравнения базы данных.
В основной массе ситуаций вы сможете оставить значения по умолчанию. Но, в случае если вам нужно изменить их удостоверьтесь, что параметр сопоставления полностью совпадает с кодировкой. Что бы продолжить установку жмите Создание и испытание выборки из базы данных.
Создаем администратора
Заполняйте в данной форме данные, нужные для создания администратора системы. MODx не советует применять имя администратора ‘admin’. Это слишком распространенное имя администратора и применяется для взлома системы.
После ввода имени вводите e-mail админа и пароль. Что бы продолжить установку жмите Далее.
Устанавливаем контекст
Дальше нужно ввести новые имена для папок connectors/, manager/ и корневой директории. Изменяйте лишь те параметры которые вам нужно.
Нужно менять оба параметра — путь к контексту и URL контекста
В случае если вы поменяли параметры контекста которые относятся к административной части, то для входа в панель управления MODx вам нужно будет вводить адрес вида ‘http://вашсайт/новый_URL_административной_части’
Проверяем систему перед установкой
Традиционно MODx выведет окошко с итогами проверки вашей системы перед установкой. В случае если проверка не пройдет, удостоверьтесь, что ваша система отвечает всем требованиям Рекомендаций к серверу и нужные директории располагают правом на запись.
Далее когда все будет уже готово и вы благополучно пройдете проверку, нажмите Установить.
В случае если у вас появится пустой экран или же процесс установки не пойдет после нажатия на Установить, проконтролируйте следующее:
1. Удостоверьтесь что директории /core/peckeges, /core/import и /core/export располагают правом на запись
2. Удостоверьтесь что в файле опций PHP php.ini выставлены параметры memory_limit 128M и max_execution_time 120
3. Создайте пустой файл /core/config/config.inc.php и удостоверьтесь, что у него выставлены права на запись. НЕ копируйте config.inc.tpl! Создайте пустой файл
4. Создайте на форуме тему с вашей проблемой прикрепив опции вашего сервера и данные об установке и вам несомненно помогут..
MODx проинформирует вам в случае если появились какие нибудь погрешности под час установки и даст вам право переустановки, что бы поправить данные ошибки.
Когда установка благополучно закончится, нажмите далее и вам нужно будет произвести заключительную настройку.
MODx советует удостовериться, что папка setup удалена что бы защитить ваш сайт от пробы запуска установщика сторонними, вы можете это проделать, поставив галочку в чекбоксе.
Далее вам осталось нажать на Вход и перед вам будет открыто окошко входа в систему администратора. Установка благополучно и полностью закончена!
Урок 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
Автор Алексей На чтение 5 мин. Опубликовано
Последнее изменение поста: 23 октября 2018 в 19:18
В предыдущей статье мы изучили переменные шаблона и сниппеты. Сегодня мы начнем наполнять контентом наш сайт, а конкретно изучим документы modx revo. Как уже ранее упоминалось в статье основные определения modx, документ в МОДХ — это конкретный тип ресурса, который может быть контейнером для четырех видов ресурсов: документов, web-ссылок, статических ресурсов и символических ссылок (в большинстве случаев это обычная веб-страница). Рассмотрим процесс создания и редактирования документов и разделов сайта.
Создание страниц и разделов сайта на MODx Revolution.
Для того чтобы создать страницу или раздел, необходимо дереве элементов на вкладке Ресурсы нажать на значек «Новый документ»:
Откроется страница для редактирования ресурса, которая имеет 3 вкладки: Документ, Настройки, Группы ресурсов. Рассмотрим каждую из вкладок.
Вкладка документ.
Здесь необходимо заполнить следующие поля:
Заголовок – данное поле обязательно для заполнения. Текст с этого поля обычно вставляют в тег title исходного кода страницы — <h2>[[*pagetitle]]</h2>.
Расширенный заголовок – необязательное поле, в котором можно прописать более длинный и информативный заголовок, который в последующем можно будет выводить при помощи тега на страницах сайта — [[*longtitle]].
Описание — необязательное поле, но очень рекомендую его заполнять, т.к. текст с этого поля вставляется в тег description (полезно для SEO) — [[*description]].
Аннотация — необязательное поле. Для страниц его заполнять не нужно, но если вы создаете новость, статью или товар, то заполнить просто необходимо — [[*introtext]].
Шаблон – здесь вам необходимо указать шаблон, который будет использован при формировании данной страницы.
Псевдоним — Это часть URLадреса страницы, при условии, что вы используете ЧПУ (Человеко-Понятные- URLадреса) и включили функцию Friendly URL смотрите статью настройка ЧПУ modx. Например созданный вами ресурс, допустим страница о компании с псевдонимом ‘about‘ и расширением ‘html‘ будет доступен по ссылке ‘http://my-site/about.html‘, в случае данный ресурс не является контейнером — [[*alias]].
Пункт меню — краткий заголовок ресурса в меню — [[*menutitle]].
Атрибуты ссылки – здесь вы можете добавлять атрибуты к ссылкам в меню, к примеру если добавить target=»_blank» то ссылка будет открываться в новом окне, rel=»nofollow» – то яндекс не будет учитывать данную страницу и т.п. думаю суть вы поняли — [[*link_attributes]].
Не показывать в меню – Если чек бокс на против данной опции, то данный ресурс не будет показываться в большинстве сниппетов меню и навигации — [[*hidemenu]].
Опубликован – Данный параметр определяет, будет ли показан данный ресурс посетителям сайта (если чек бокс не установлен, то данный ресурс сохраняется как черновик и не выводится на сайте) — [[*published]].
Содержимое ресурса – Здесь добавляется контент данного ресурса — [[*content]].
По сути если вы создаете обычную страницу сайта, то в остальные вкладки вам заходить не обязательно, просто пропишите заголовок, заполните содержимое ресурса, выберете используемый шаблон, поставьте галочку на против опубликован и сохраните документ, после чего можете посмотреть на сайте что у вас получилось.
После заполнения данной вкладки у вас должно получиться примерно так:
Вкладка Настройки.
Родительский ресурс – Здесь при необходимости вы можете указать ID родителя
Вкладки Тип ресурса и Местонахождение содержимого – в 99% случаях оставляете значение по умолчанию.
Позиция в меню – проставляется автоматом
Опубликован – после сохранения ресурса, здесь отображается дата публикации ресурса.
Дата публикации – при помощи данного пункта вы можете запланировать публикацию, к примеру, чтобы данная страница опубликовалась не сразу же, а к примеру через неделю.
Дата отмены публикации — при помощи данного пункта вы можете запланировать отмену публикации ресурса.
Контейнер – если вы поставите галочку на против данного пункта, то документ превратится в рубрику (категорию).
Доступен для поиска – разрешает или запрещает поиск в содержимом ресурса, так же может использоваться в сниппетах.
Использовать HTML-редактор – включает или отключает HTML-редактор
Заморозить URI – если отметите данный пункт, то появится дополнительное поле, к котором вы сможете прописать какой либо URL и он при любом редактировании будет оставаться неизменным.
Кэшируемый – если данный пункт отмечен, то ресурса будет сохранен к кэш после первого обращения к нему.
Очистить кэш – очищает кеш при сохранении ресурса.
Удалён – отменяет публикацию ресурса.
Вкладка Группы ресурсов.
Здесь вы можете выбрать, к каким группам принадлежит ресурс. К примеру вы не хотите чтобы данную страницу могли просматривать только зарегистрированные пользователи, тогда вам нужно будет создать 2 группы, для авторизованных и не авторизованных пользователей и указать на против данных групп параметр доступа.
Вот как то так) Идем далее.
Редактирование страниц сайта.
Для того, чтобы отредактировать ранее созданные страницы, нужно в дереве ресурсов найти необходимую страницу и кликнуть по ней левой клавишей мышки на либо вы можете кликнуть правой по данной странице правой кнопкой мыши и затем в контекстное меню выбрать «редактировать».
Удаление страниц сайта.
Удалить страницу можно также при помощи вышеупомянутого контекстного меню выбрав, пункт «Удалить», либо же при редактировании страницы вы можете нажать одноименную кнопку.
После этого в дереве ресурсов модх заголовок данного документа окрасится в другой цвет и станет перечеркнут. Но это, еще не окончательное удаление, а по большому счету просто отмена публикации.
Чтобы полностью удалить ненужный ресурс, то вам потребуется кликнуть по кнопке «Очистить корзину».
На сегодня все, создайте все основные страницы и категории, далее мы сделаем статическое меню динамическим при помощи PdoMenu.
Если информация данной статьи была для вас полезной, пожалуйста ставьте лайки и подписывайтесь на обновления блога, чтобы не пропускать выход новых статей.