[Tickets] Версия 1.4.0-beta - Настройки секции

Новая большая бета Tickets с серьёзными изменениями. Сначала планировалось только исправить старые ошибки, но в итоге вышла глубинная переделка логики создания и обновления тикетов.

Главная новость: у секций тикетов появились собственные настройки, которые влияют на дочерние документы:

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

Соответственно, изменились и системные настройки: - Настройки умолчаний переехали из системных в секцию:

• tickets.disable_jevix_default - отключить Jevix
• tickets.process_tags_default - включить обработку тегов MODX
• tickets.ticket_show_in_tree_default - показывать тикет в дереве ресурсов
• Удалена настройка tickets.ticket_hidemenu_force, теперь вы можете указать значение по умолчанию в настройках секции, но оно не будет переопределять значение потомка. То есть, у созданного тикета будет заранее проставлена (или нет) галочка, но вы можете её изменить.
• Удалена tickets.ticket_isfolder_force - теперь в ней нет надобности, так как вы сами указываете формирование URI, а значит, можете указать и косую в окончании адреса.
• Удалены tickets.ticket_id_as_alias и tickets.section_id_as_alias. Первая настройка была нужна для формирования URI, которым вы теперь управляете вручную, а вторая существовала просто за компанию. Вряд ли у кто-то будет обзывать секции по id, а если сильно хочется - это можно сделать плагином.

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

Формирование URI тикета

Эта новая мега настройка позволяет вам задать правила для uri дочерних тикетов. Работает она просто: в поле uri прописывается полный адрес, и ставится флажок uri_override, чтобы его использовать.

Вам доступны следующие переменные в схеме: - %id - идентификатор тикета

• %alias - псевдоним, который был указан или сгенерирован из pagetitle
• %ext - расширение типа документа, указанное в настройках MODX. По умолчанию - .html.
• %y - год даты публикации тикета
• %m - месяц
• %d - день

Для формирования uri дата сначала берется из pub_date, если там пусто - то из publishedon, а потом уже из createdon - если документ не публикуется. В принципе, вы можете теперь указывать адреса как у Articles - %y/%m/%d/%alias/, но я не советую этого делать. Почему?

Очень просто: тикеты могут переносится из одной секции в другую и менять URI. Если вы хотите, чтобы при этой смене ваши посетители не получали 404, а редиректились на новый адрес автоматически, нужно использовать такие схемы: - %id/ - tickets/15/ - формат uri на моём сайте.

• %id-%alias%ext - tickets/15-myticket.html - по умолчанию для новых установок.
• %y-%m-%d-%alias-%id - tickets/14-03-17-myticket-15 - для извращенцев =)

В общем, не должно быть типа вложенных директорий (то есть косых /) и должен быть указан %id. При этом у всех секций должна быть одинаковая схема URI, тогда при переносе документа, плагин Tickets возьмет схему от старой секции, вычленит из неё id тикета, сгененериует новый адрес и отправит пользователя на него.

Кстати говоря, вот случаи, когда URI тикета будет автоматичеки перегениерирован: - Изменение поля parent, то есть - перенос тикета в другую секцию

• Изменение alias тикета. Если в схеме нет %alias, то изменения адреса не будет. Изменение названия тикета на фронтенде не меняет существующий uri.
• Снятие с публикации тикета отключает uri и uri_override. А публикация генерирует uri заново.
• При пустом uri и активированном uri_override, uri будет также сгенерирован заново.

Эти случаи прописаны прямо в метод Ticket::save(), поэтому будет работать даже при сортировке тикетов в админке. Перетянули документ в другого родителя - адрес изменился. Указана правильная схема с %id - юзер будет отправлен на новый адрес.

Другие изменения

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

У объектов Ticket и TicketsSection можно использовать метод getProperties, для получения настроек чекции и тикета. Если это новый объект и у него еще нет сохранённых настроек - вернутся "по умолчанию", которые и будут сохранены.

[#74] Исправлена работа панели тикета в новых версиях MODX и Firefox. Убраны кнопки "Опубликовать" и "Снять с публикации" - вместо них стандартный чекбокс. Это сделано для того, чтобы при изменении статуса документа автоматически менялся и uri. Если тикет снимается с публикации, то uri сразу прячется и наоборот.

[#72] Исправлена ошибка с затиранием ТВшек. Теперь при обновлении тикета с фронтенда получаются все его ТВ и добавляются в запрос.

[#64] Отключение у тикета обработки полей сниппетом Jevix влияет и на introtext.

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

Заключение

Изменений очень много и они весьма серьёзные. Поэтому версия beta и работоспособность не гарантируется совсем. Переписан весь процесс создани тикета, генерации адреса и назначения его свойств, так что обновление может привнести каки-то уязвимости или проблемы.

В общем, нужно протестировать, и желательно не на рабочих сайтах - у нас есть http://tefile.modx.pro. В репозитории сейчас лежит последняя стабильная 1.3.0 и новая 1.4.0. Сначала ставится 1.3, а потом вы можете обновиться - по желанию.

Жду ваших отзывов и замечаний.