CamperManagement – это дополнение (аддон) для управления парком транспортных средств для MODX Revolution, разработано и протестировано в 2.1.0-rc3 Марком Хамстра (Mark Hamstra). Представляет бекэнд менеджмент-модуль, а также универсальные сниппеты для настраиваемого, интегрированного опыта взаимодействия во фронтэнде сайта, как и следовало ожидать в рамках MODX.
CamperManagement был создан для конкретного сайта, что обуславливает специфическую терминологии и аспекты, которые могут использоваться. К счастью, сочетая гибкость MODX и некоторые настройки, встроенные в аддон, Вы можете много что изменить своими силами, даже не имея опыта разработчика. Эта страница даст вам представление о том, как это сделать.
Изменение компонентной терминологии и полей
Аддон использует такие термины, как "Campers", "Brands" и т.д. Все они стали переводимыми в процессе разработки, и Вы можете воспользоваться преимуществами Lexicon Management (в главном меню системы), чтобы изменить термины в компоненте. В версии 1.0 изменять можно 82 строки, от "CamperManagement" до " Car " и сообщений об ошибках.
В этом примере мы изменим название компонента ("CamperManagement") и ярлыки нескольких полей, чтобы привести его в соответствие с контекстом Earth Moving Equipment (землеройной техники).
Первый взгляд на использование LexiconManagement
Сначала мы должны перейти к пространству имени (namespace)"campermanagement". Когда Вы зайдете в Lexicon Management, Вы увидите выпадающий список, в котором по умолчанию выбрано "core ". Откройте и выберите campermanagement один.
У каждой строки есть имя (также называемое ключом - key), которое вызывается из кода для отображения определенного текста. Эти имена обычно узнаваемы и содержат смысл. Кнопка "Back to Overview " (на странице кемпер-списка в правом верхнем углу) имеет ключ "campermgmt.button.backtooverview", а "Options" имеет ключ "campermgmt.tab.options". Если Вы не можете найти то, что Вам нужно, просто введите искомый текст в окне поиска, в правой части экрана.
Изменение некоторых строк (Strings)
Мы изменим название аддона на "Used Equipment Management ". Этот тайтл отображается в строке "campermgmt". Просто сделайте два клика под “value” и введите свое значение.
Если Вы захотите обновить грид (кнопка обновления находится внизу), Вы увидите, что теперь текст отображается зеленым цветом, и появилась дата " Last modifed on " (дата последних изменений).
В Lexicon Management хорошо то, что Ваши корректировки сохраняются в базе данных. Это значит, что даже если вы обновите аддон или сам MODX, словарь новых определений должен сохранятся и не утериваться в процессе. Изменение лексических файлов, которые поставляются вместе с компонентом, отбрасываются при обновлении.
Теперь Вы можете обрадоваться и проверить результат, но сначала необходимо очистить кэш. Словари кэшируется по умолчанию, поэтому необходимо обновление кэша, чтобы что-то появилось. Таким образом, выполните действие “Site > Clear Cache”, а затем обновите страницу Вашего компонента. Если вы что-либо изменить в меню (ключ campermgmt или campermgmt.description), Вам также придется произвести обновление и там – похоже, что обычное обновление кэша не обязательно приводит к обновлению ключей. Просто удалите файл в core/cache/menu/mgr/menus/, который будет обновлен при следующем запуске обновления страницы.
Теперь Вы можете пойти дальше и изменить другие строки. Если у Вас нет поля "Plate", но доступно поле "Capacity", Вы можете заменить словарь "Place" на " Capacity", чтобы изменить это в компоненте. Фактическое имя поля для настройки фронт-энда не изменится (останется ), но все равно никто не обращает на это внимания после разработки.
Имена статусов
Вы также можете использовать разные имена для различных статусов через изменение лексикона строк – от campermgmt.status0 до campermgmt.status5.
Настраиваемые кнопки в верхней части грида Campers
Вы можете добавить одну кнопку в верхней части кемперс-грида с помощью системных настроек, а через Lexicon management можно изменить значение кнопки.
Создайте новую настройку с помощью системной настройки ключа campermanagement.overview. Для целей организации, установите его в пространство имен campermanagement. Его значение должно быть валидным ID ресурса (как и фронт-энд ресурса).
Теперь войдите в управление словарем и измените строку campermgmt.overview на то значение, которое Вы бы хотели, чтобы отображалось на кнопке.
Когда пользователь нажмет кнопку, будет совершаться перенаправление на указанный ресурс, так что Вы, вероятно, захотите сделать этот ресурс интересным для пользователя. Оригинальная идея этой кнопки – создание печатаемого обзора имеющихся в наличии транспортных средств, поэтому для того, чтобы создать таблицу с подробной информацией, используется сниппет cmCampers в этом сниппете. Как только пользователь зарегистрируется при просмотре страницы, Вы можете сохранить ее неопубликованной, чтобы предотвратить попадание на нее посетителей сайта.
Пример, который Вы могли бы использовать: