Рекомендую спочатку ознайомитися з системою синтаксису тегів Revolution перед тим, як ми почнемо.
Установка необхідних доповнень
Для початку необхідно завантажити та встановити деякі доповнення, які ми будемо використовувати в нашому блозі. Нижче наведено список найбільш часто використовуваних додатків для створення блогу:
Необхідні доповнення MODX Revolution для створення блогу:
Створення шаблону блогу
Для початку потрібен шаблон для нашого блогу. Цей урок має на увазі, що у вас вже є базовий шаблон для всіх сторінок вашого сайту. Ми будемо посилатися на такий шаблон надалі як на 'BaseTemplate'.
Давайте створимо ще один шаблон 'BlogPostTemplate'. Вміст буде виглядати так:
Давайте досліджуємо даний шаблон. Запам'ятайте, ви можете змінювати будь-який з елементів, змінювати параметри і їх розміщення. Це всього лише базова структура - якщо ви, наприклад, хочете, щоб внизу були теги - просто передвінте їх туди. MODX не обмежує вас в цьому.
Шапка і Підвал блогу
По-перше, зверніть увагу на два чанка: "pageHeader" і "pageFooter". Етм чанкі містять мої загальні HTML теги, які я поклав в підвал і шапку мого сайту, тому я можу їх використовувати у моєму сайті в різних шаблонах. Тобто, якщо вам потрібно змінити вміст шапки або підвалу, то ви можете поміняти вміст тільки одного чанка і автоматично пройдуть зміни у всіх шаблонах. Після цього я дам назву Ресурсу і зроблю посилання на цю ж сторінку.
інформація поста
Перша частина бере поле Ресурсу publishedon, форматує і приводить його в нормальний вигляд.
Другою частиною ми далі відображаємо список тегів для цього запису блогу. Зверніть увагу як ми посилаємося на змінну шаблону "tags" - ми її ще не створили, але не хвилюйтеся - потім ми вставимо її як реквізит сниппета 'tolinks'. Сніппет tolinks йде разом з доповненням tagLister і переводить окремі теги в посилання. Це означає, що наші теги стають розмітки! Ми визначили Ресурс 1 як 'target' або наша домашня сторінка. Якщо ваш блог знаходиться на іншій сторінці, то поміняйте для нього ID.
вміст поста
Далі, що потрібно визначити в обох Quip і Quip Reply виклики - реквізит 'closeAfter'. Це говорить Quip автоматічесткі закрити коментірованіе на тих потоках, на яких пройшло 30 днів з часу створення потоку (коли ми завантажували його).
У нашому виклику QuipReply, ми хочемо повідомляємо Quip, що модерувати всі пости і модератори наших постів задані в групі Moderators User Group.
Є ще багато інших Quip налаштувань, які ми можемо поміняти, але залишимо це на майбутнє, кому интерестно, то можете знайти опис цих налаштувань в Quip docs.
установка Тегів
Отже, ми встановили і налаштували шаблон, тепер потрібно встановити змінну шаблону 'tags', яку ми будемо використовувати для нашої системи тегів.
Давайте створення змінну шаблону 'tags' і дамо їй опис як "Теги поточного Ресурсу через кому". Переконаємося, що вона має доступ до шаблону 'BlogPostTemplate', створеному нами раніше.
Ну ось! Тепер ми можемо додавати теги до будь-якого посту, який ми створили, просто редагуючи свій Ресурс і додаючи туди теги через кому.
створення розділів
У цьому уроці ми створимо два розділи: "Personal" і "Technology". Давайте створимо 2 Ресурсу в корені вашого сайту і визначимо їх як контейнери - 'containers'. Визначимо їх псевдоніми (аліаси) як 'personal' і 'technology', таким чином записи блогу будуть мати розумне відображення.
Тут ми обговоримо, що наші розділи мають ID 34 і 35.
Нижче вихова getResourcesTag, ми вставляємо наші посилання на пагінацію (проставлення сторінок), так як за замовчуванням getResourcesTag показує тільки 10 постів на сторінку.
Для відображення нумерації з російськими словами для першої (Перша) і останньої (Остання) сторінок додаємо два параметра з шаблонами в виклик getResourcesTag
Таким чином наш виклик буде виглядати так:
Налаштування чанка blogPost
У цьому виклику у нас також є реквізит з ім'ям 'tpl', який ми встановили в 'blogPost'. Це наш чанк, який показує кожен результат для списків постів нашого блогу. Він повинен містити наступний код:
Зверніть увагу tolinks використовує параметр keyTag = `tag`, а не key як зазначено в документації
Відмінно! Ми почали з клікабельно посилання до посту і змістом ресурсу pagetitle як назвою. Далі ми встановили частина 'posted by' і список тегів (схожі дії ми робили в нашому шаблоні BlogPostTemplate).
Далі, ми покажемо уривок з контенту, який ми зберігаємо в полі 'introtext' контенту.
Установка і настройка домашньої сторінки вашого блогу
На головній сторінці нашого блогу, яка у нас міститься в Ресурсі ID 1 - початок нашого сайту - у нас йде це:
Це дозволяє нам показувати всі пости з двох розділів, які ми зробили, в ресурсах 34 і 35. Це також дозволяє нам фільтрувати за тегами (так як наші виклики 'tolinks' і 'tagLister' мають target рівну 1 (це ID ресурсу). Іншими словами, розмістивши тут виклик getResourcesTag у нас автоматично з'являться теги.
Ви можете легко зробити це з іншої сторінки з якої ваш сайт починається (або ID 1) - просто убедідесь в тому, що змінили параметр 'target' в ваших викликах сніпетів tagLister і tolinks.
Додавання постів
Дуже добре, тепер все налаштовано і ми готові додавати пости.
Структура сторінки в середині розділів
Перед тим як почнемо, важливо відзначити, що структура ваших постів в середині розділу залежить цілком від вас. Можете додати контейнер року і місяця Resources, щоб розміщувати там пости або просто постити в середині розділу. Все залежить від вас.
Якщо ви хочете зробити субконтейнерів дати / року, переконайтеся, що у них проставлені чекбокси «Приховати від меню», таким чином вони не з'являться при викликах getResources.
Пам'ятайте про те, що не важливо яку структуру ви робите під розділами, це не вплине на вашу навігацію - Archivist подбає про все. Він визначить якими буду URL ваших постів.
Додавання нового поста
Нарешті, коли ви все зробите, переконайтеся в тому, що ви визначили теги вашого поста в тільки що зроблених змінних шаблону 'tags'!
Установка і настройка Архівів
Відмінно - тепер у нас є перший запис в блозі! І ви можете добратися до неї через розділи. Тепер, напевно, ви захочете мати можливість переглядати старі записи вашого блогу. Для цього нам знадобиться 'Archvist'.
Створення ресурсу Архіви
Давайте розмістимо ресурс в корені і назвемо його "Archives 'і дамо йому псевдонім (алиас) -' archives '. В середині контенту вставте цей код:
Виглядає знайомо? Все це дуже схоже з тегом getResourcesTag, описаному вище на сторінці розділів. Зараз getPage обгорнутий в сниппет getArchives і повідомляє про те, що ми хочемо взяти записи в Ресурсах 34 і 35 (наша сторінки Розділів). Ми встановимо результат в заповнювач з ім'ям 'archives', на який пошлемося пізніше.
Потім, нижче після цього, ми додамо кілька наповнювачів, які показують поточні місяць і рік. І в самому кінці ми встановимо пагінацію. Відмінно! Ми це все зробили. Наш Ресурс Resource, для створення посилань на нього, має ID = 30.
Установка віджета Archivist
Дуже добре, тепер ми маємо Ресурс, щоб мати доступ до старих записів, але вам ще потрібно згенерувати місяці для записів. Це насправді дуже просто: де-небудь на вашому сайті (скажімо в підвалі) вставте цей шматок коду:
Таким чином сниппет Archivist генерує помісячний список ваших записів (ви можете додати будь-які інші функції, з цією метою загляньте в документацію). Ми говоримо про те, що хочемо, щоб ці посилання вели до нашого Ресурсу Archives (30) і брали тільки записи в Ресурсах 34 і 35 (ресурси розділів).
Установка додаткових функцій
Додавання групи модераторів
Раніше в нашому виклику QuipReply, ми визначили нашу групу moderatorGroup 'Модератори'. Давайте просунемося далі і створимо групу користувачів.
Натисніть Security -> Access Controls і створіть нову групу користувачів і назв її 'Moderators'. Додайте будь-якого користувача в групу (включаючи себе!) І дайте йому будь-яку посаду (роль).
Далі, Ви повинні зайти на вкладку Context Access (Доступ до вмісту). Додайте ACL (ряд доступу до вмісту) який дає цій групі користувачів доступ до 'mgr' вмісту в с мінімальної роллю члена - Member (9999) і політикою доступу 'QuipModeratorPolicy'.
Збережіть вашу призначену для користувача групу і все! Вам може знадобиться оновити сесію (Security -> Flush Sessions) і перелогінітся, щоб оновити ваші права, про решту подбає Quip.
Додавання міні-"Останні записи"
Ще можна встановити віджет "Останні записи" де-небудь на вашому сайті і не бійтеся - це дуже просто.
Спочатку потрібно встановити наступний виклик в місці, де ви хочете, щоб ваш віджет з'явився:
Бум! Останні записи відображаються у вас на сайті:
Тепер створіть чанк з назвою 'latestCommentTpl':
Ви можете звернутися до документації сниппета для більш точного конфігурування.
Додавання міні-"Часто використовуються наразі"
Ця частина просто до очуменія проста; за вас все зробить tagLister. Просто помістіть його, де вам зручно:
tagLister перевірить змінні шаблону 'tags' і створить посилання на мету (в нашому випадку, Ресурс з ID 1) з 10 найбільш часто використовуваними тегами. Є ще купа налаштувань конфігурації. але ми залишимо все як є.
висновок
Отже ми встановили і налаштували наш блог. Він буде мати приблизно такий вигляд в дереві ресурсів:
Знову підкреслюю те, що можна додати ще дуже багато функцій до нашого блогу. Цей урок є просто точкою старту, відчувайте себе вільно в налаштуванні вашого блогу, додайте потрібну функціональність. Великим плюсом MODX є те, що можна налаштовувати як завгодно, розширювати функціональність будь-якого вашого рішення: включаючи блог!