[MIGX] - Большой и страшный. Знакомство.

Зачем?

Что это?

Привет Evoлюционерам, это Multitv только функционала тут гораздо больше.

1. Многим она не нужна и вряд-ли понадобится (MIGX DB например)
2. Будет освещено в следующих уроках (Если поддержите данный урок)

Начало

Первый TV с типом MIGX

• Фотография
• ФИО
• Тип работы
• Текст отзыва

Вкладка Settings

• Name — Название конфигурации (Его нужно будет указать при создании самого TV). Пишем: reviews
• Category — Выбор категории (Нужно в тех случаях если у вас конфигураций непомерно много), с его помощью можно фильтровать конфигурации. Пропускаем
• Add new Category — Если нужной категории нет или их нет вовсе, то в это поле вводится название. Пропускаем
• Замена «Добавить элемент» — текст кнопки которая будет добавлять новый элемент. Пишем: Добавить отзыв
  
• Disable Add Items — Если включить, то не будет возможности добавлять новые элементы. (Нужно для случаев, когда вы уже вводите необходимое количество элементов/данных и хотите оставить возможность их только редактировать). Пропускаем
• Add Items directly — Если включить, то элемент буден создан без открытия модального окна. Пропускаем
• Form Caption — Заголовок формы (тут кстати обрабатываются MODX теги). Если например написать: Отзывы на странице [[*pagetitle]], то мы при создании отзыва будем видеть такую картину
  
  
• Window Title — Заголовок модального окна создания/редактирования. Пишем: Добавить/редактировать отзыв
  
  
• max MIGX records — Лимит количества элементов. Тут надеюсь всё понятно, если оставить пустым, то не будет ограничений по количеству
• Add new MIGX records at — Тут 2 выбора: bottom и top В зависимости от которого новые элементы, а в нашем случае отзывы будут добавляться в конец или в начало, но не переживайте, ведь сортировать элементы мы будем иметь возможность всегда, перетаскиванием.

Вкладка Formtabs

• Fields — Список вкладок. См. ниже
• Остальные поля Multiple Formtabs — Их мы затронем в другом уроке

• Caption — Название вкладки. Можно оставить пустым, ведь если вкладка будет одна, то она все равно не будет выводиться, поля вкладки будут выводиться, но сама вкладка нет. Но если у вас в одном элементе (в нашем случае отзыве) много полей, то имеет смысл разделять их по разным вкладкам для удобства ввода данных
• Fields — Поля вкладки. Ну вот мы и дошли до того момента, когда мы уже будем создавать поля для ввода данных

• Field — настройки поля
  
  • Fieldname — название/ключ в массиве (по аналогии с обычным TV)
  • Caption — название/подпись поля (по аналогии с обычным TV)
  • Description — Описание поля. Выводится рядом с полем (по аналогии с обычным TV)
  • Input TV — название TV (будут применены конфигурации данного TV).
    
    

    Не советую использовать данный метод, так как сталкивался с тем что у проектов созданы несколько TV и они просто висят в Базе Данных как сущности и не используются, зачастую из-за нужды в использовании источника файлов отличным от системного

    Далее покажу как не плодить TV
    
    
  • Input TV type — Тип поля/tv. Тут указывается тип поля, а если быть точнее, то тип TV, можно указывать все типы TV, даже migx, если оставить пустым, то мы получим простое текстовое поле
    
    

    В следующих уроках рассмотрим вложенные MIGX

    
    
  • Configs — Конфигурация данного поля в JSON-массиве. Для разных типов полей есть разные свойства, поэтому переходим по ссылке и изучаем документацию, там всё расписано
  • Display — Показывать или нет данное поле
    
    
• Mediasources — настройки источника файлов для данного поля
  
  
  • source From — Где указан источник файлов.
  • Sources — Список пар привязок: контекст (ресурса) -> источник-файлов (Если в source From указано: config).
    
    
• Input Options — настройки вводимых данных данного поля
  
  
  • Input Option Values — Возможные значения (по аналогии с обычным TV)
  • Default Value — Значение по умолчанию (по аналогии с обычным TV)

1. Fieldname: — image
   
   
   • Caption: — Фотография
   • Input TV type: — image
   • source From: — config
   • Sources: — Context: web, Source: (id - источника файлов отличным от системного)
     
     
2. Fieldname: — name
   
   
   • Caption: — Ф.И.О.
     
     
3. Fieldname: — type
   
   
   • Caption: — Тип работы
     
     
4. Fieldname: — text
   
   
   • Caption: — Текст отзыва
   • Input TV type: — textarea или richtext на свой вкус

Вкладка Columns

• Вкладка «Column»
  
  
  • Header — Текст/заголовок столбца
  • Field — Название/ключ поля которое было создано нами в предыдущих шагах
  • Column width — Ширина столбца (вводится непонятным для меня виде, но скажу, что принимает целые числа, прицелитесь и приспособитесь методом проб)
  • Sortable — Сортируем или нет
  • Show in Grid — Показывать в таблице или нет
    
    
• Вкладка «Renderer»
  
  
  • Renderer — Как будет выводиться/отображаться. Ведь одно дело вывести текст, а когда нужно будет например выводить картинку тут уже просто ссылку на него выводить было бы нелепо
    
    
• Вкладка «Cell Editor»
  
  
  • Editor — Прямое редактирование (так сказать: directly) без модального окна. Тут уж 2 варианта: this.textEditor и this.listboxEditor. Первым можно редактировать обычный текст, а вторым поля с типом listbox

1. Header: — Фотография
   
   
   • Field: — image
   • Renderer: — this.renderImage
     
     
2. Header: — Ф.И.О.
   
   
   • Field: — name
   • Editor: — this.textEditor
     
     
3. Header: — Тип работы
   
   
   • Field: — type
   • Editor: — this.textEditor
     
     
4. Header: — Текст отзыва
   
   
   • Field: — text
   • Editor: — this.textEditor и если в настройках поля указали richtext, то данное поле нужно оставить пустым
     
     

Вывод данных

[[getImageList?
&tvname=`reviews`
]]

Array
(
    [MIGX_id] => 2
    [image] => files/avatars/3.png
    [name] => Алексей Гумелев
    [type] => Ремонт квартиры
    [text] => Спасибо компании “Название компании”! Делали ремонт в однокомнатной квартиры 42 кв.м в новостройке в жилом комплексе Новое Пушкино. Квартира предназначена для дочери. У молодежи свои требования. Ремонт хороший, все сделано, как было оговорено, хотя мы находились в другом городе. Она осталась довольна. Ремонт закончили в срок. Бригада работала без предоплаты. Выплаты шли по факту выполненных работ. Хочу поблагодарить фирму за проявленную заботу, понимание и советы по выбору материалов. Рекомендую. Работа была окончена летом 2016.
    [_alt] => 0
    [_first] => 1
    [_last] => 
    [idx] => 1
    [property.tvname] => reviews
)
Array
(
    [MIGX_id] => 3
    [image] => files/avatars/1.png
    [name] => Мария Петровна
    [type] => Ремонт квартиры
    [text] => Хочу написать наш отзыв о компании "Название компании". Вначале было много сомнений. Доверять ли мастерам? Мало ли что? Люди  разные бывают.  Зря волновалась! Результат отличный. Ребята очень внимательные и порядочные. Сделали ремонт в квартире на "Ура!" Кирилл мастер своего дела. Я очень довольна результатом! Цены не завышены как у других.Рада, что обратилась именно к Вам. 
    [_alt] => 1
    [_first] => 
    [_last] => 
    [idx] => 2
    [property.tvname] => reviews
)
Array
(
    [MIGX_id] => 4
    [image] => files/avatars/2.png
    [name] => Инна Макаревич
    [type] => Ремонт квартиры
    [text] => "Название компании" делали нам ремонт в начале 2016 года!  Двушка в новостройке. Цена у них фиксирована - ни копейки не добирали. На каждом этапе фотоотчеты, что нам очень понравилось. Кирилл на связи всегда! Все работы выполнены на совесть! Все убрали за собой. Молодцы, команда!
    [_alt] => 0
    [_first] => 
    [_last] => 1
    [idx] => 3
    [property.tvname] => reviews
)

• MIGX_id — уникальный идентификатор элемента
• image, name, type, text — наши поля которые мы с вами создали
  
  

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

  
  
• _alt — Четный (1) или нечетный (0) элемент
• _first — Является, ли элемент первым
• _last — Является, ли элемент последним
• idx — Индекс элемента начиная с 1
• property.tvname — Название TV

{$_modx->resource.reviews| fromJSON | print}

Array
(
    [0] => Array
        (
            [MIGX_id] => 2
            [image] => avatars/3.png
            [name] => Алексей Гумелев
            [type] => Ремонт квартиры
            [text] => Спасибо компании “Название компании”! Делали ремонт в однокомнатной квартиры 42 кв.м в новостройке в жилом комплексе Новое Пушкино. Квартира предназначена для дочери. У молодежи свои требования. Ремонт хороший, все сделано, как было оговорено, хотя мы находились в другом городе. Она осталась довольна. Ремонт закончили в срок. Бригада работала без предоплаты. Выплаты шли по факту выполненных работ. Хочу поблагодарить фирму за проявленную заботу, понимание и советы по выбору материалов. Рекомендую. Работа была окончена летом 2016.
        )

    [1] => Array
        (
            [MIGX_id] => 3
            [image] => avatars/1.png
            [name] => Мария Петровна
            [type] => Ремонт квартиры
            [text] => Хочу написать наш отзыв о компании "Название компании". Вначале было много сомнений. Доверять ли мастерам? Мало ли что? Люди  разные бывают.  Зря волновалась! Результат отличный. Ребята очень внимательные и порядочные. Сделали ремонт в квартире на "Ура!" Кирилл мастер своего дела. Я очень довольна результатом! Цены не завышены как у других.Рада, что обратилась именно к Вам. 
        )

    [2] => Array
        (
            [MIGX_id] => 4
            [image] => avatars/2.png
            [name] => Инна Макаревич
            [type] => Ремонт квартиры
            [text] => "Название компании" делали нам ремонт в начале 2016 года!  Двушка в новостройке. Цена у них фиксирована - ни копейки не добирали. На каждом этапе фотоотчеты, что нам очень понравилось. Кирилл на связи всегда! Все работы выполнены на совесть! Все убрали за собой. Молодцы, команда!
        )

)

[[getImageList?
&tvname=`reviews`
&tpl=`myChunk`
]]

// myChunk

<div class="review">
    <img class="image" src="[[+image]]">
    <span class="name">[[+name]]</span>
    <span class="type">[[+type]]</span>
    <p class="text">[[+text]]</p>
</div>

{var $reviews = $_modx->resource.reviews| fromJSON}
{if $reviews}
{foreach $reviews as $i}
<div class="review">
    <img class="image" src="files/{$i.image}">        // Дописываем путь к источнику файлов вручную
    <span class="name">{$i.name}</span>
    <span class="type">{$i.type}</span>
    <p class="text">{$i.text}</p>
</div>
{/foreach}
{/if}

Итог

Не везде где его можно использовать он хорош, но он хорош тем, что он везде может быть использован