Если вы работаете с MODX и сталкиваетесь с задачей изменения HTML-структуры контента через API, данный пример кода поможет вам переработать элементы HTML, соответствующие определённому шаблону. Рассмотрим детально, как работает скрипт и в каких случаях его можно использовать.
Задача:
Необходимо автоматизировать изменение структуры HTML для всех ресурсов MODX. В данном случае скрипт обрабатывает элементы <li> с классом masonry-brick и адаптирует их к новому дизайну. При этом сохраняются ключевые элементы, такие как заголовок, изображение и ссылка.
Описание работы скрипта
- Инициализация MODX Скрипт начинается с настройки API-режима MODX, подключения index.php и инициализации контекста web:
- Это позволяет взаимодействовать с ресурсами MODX программно.
- Рекурсивная функция Основная логика скрипта сосредоточена в функции updateMasonryBrickStructure. Она обрабатывает ресурсы, заменяя элементы <li> в их содержимом, и рекурсивно вызывает саму себя для дочерних ресурсов.
- Обработка контента Функция использует регулярные выражения для поиска и замены элементов <li>:
Затем через preg_replace_callback данные извлекаются и создаётся новая HTML-структура:
4. Сохранение изменений После обновления содержимого оно сохраняется в ресурсе с помощью:
5. Рекурсия После обработки текущего ресурса функция вызывается для всех его дочерних ресурсов:
6. Отображение прогресса Чтобы отслеживать обработку ресурсов, скрипт отображает прогресс:
Когда использовать этот скрипт?
- Массовое обновление шаблонов HTML. Если требуется адаптировать дизайн сразу для множества ресурсов.
- Автоматизация работы с ресурсами. Ручное редактирование большого количества страниц может занять много времени, а скрипт справляется с задачей за минуты.
- Улучшение пользовательского опыта. Внесение изменений в HTML-код может быть связано с улучшением адаптивности или добавлением новых интерактивных элементов.
Преимущества подхода
- Экономия времени. Ручное редактирование заменяется автоматизированным процессом.
- Гибкость. Регулярные выражения и структура замены легко адаптируются под любые нужды.
- Безопасность. Скрипт сохраняет оригинальные данные и работает с дочерними ресурсами, не нарушая логики MODX.
Советы по использованию
- Создайте резервную копию. Перед запуском скрипта рекомендуется сделать резервную копию базы данных.
- Тестируйте на небольшом наборе данных. Убедитесь, что изменения соответствуют ожиданиям, на нескольких тестовых страницах.
- Логирование. Вывод сообщений в консоль помогает отследить успешность изменений.
Скрипт готов к использованию и может стать полезным инструментом для веб-разработчиков, работающих с MODX. Если у вас возникли вопросы или требуется доработка, оставляйте комментарии!