XF 2.3 xenForo 2.3.10 Release Edition 2.3.10

XenForo 2.3.10 теперь доступен для скачивания. Мы рекомендуем всем пользователям, работающим с предыдущими версиями XenForo 2.3, обновиться до данной версии, чтобы повысить стабильность и безопасность работы форума.

Помимо обычных исправлений ошибок, XenForo 2.3.10 включает критическое исправление безопасности, включающее потенциальный сохраненный вектор XSS в структурированных текстовых упоминаниях (в основном в устаревшем контенте сообщений профиля).

Что нового в XenForo 2.3.10
Инструменты управления фразами
Уже много лет компания использовала внутренний инструмент, помогавший нам следить за использованием фраз при разработке новых функций. Этот инструмент сканирует кодовую базу на предмет строковых значений в шаблонах, которые потенциально требуют перевода в фразы, а также ищет определённые строки в PHP-коде, которые тоже можно преобразовать в фразы.

В версии XenForo 2.3.10 мы наконец доработали этот инструмент и превратили его в команды командной строки.

Фразировщик шаблонов и модификаций шаблонов
Вот полное руководство по команде. Команда xf-dev:template-modification-phraser практически аналогична ей:
Допустим, вы завершили работу над своим дополнением и теперь хотите изменить весь ваш жёстко закодированный текст на фразы. Просто запустите команду с параметром --addon, и ваша разработка будет проверяться на наличие строк, которые выглядят как подлежащие переводу в фразы:



Вы получите список изменений шаблон за шаблоном (если не используете параметр --template), и сможете выбрать все, некоторые или ни одно из предложенных изменений для применения.

Если обнаружится фразируемый текст, который уже существует как фраза, вам предложат использовать именно её, например:

Иногда вам потребуется добавить ограничители при написании текста в шаблоне, чтобы явно определить начало и конец фразируемого текста. Это часто бывает необходимо, когда ваш текст занимает несколько строк или содержит HTML.

Например, если ваш шаблон содержит следующий фрагмент:
И вы хотите убедиться, что вся эта строка правильно переведётся в фразу, оберните её следующим образом:

Обратите внимание, что переменная интерполяция работает и в данном примере!

Фразировщик файлов
Фразировщик файлов действует почти так же. Вот страница справки:
Основное отличие заключается в том, что фразируемый текст в файлах необходимо заключить в двойные тильды ~~ для преобразования в фразу:

Поиск неиспользуемых фраз
Со временем вы можете накопить фразы в своём дополнении, которые станут ненужными после рефакторинга кода. Для этого случая тоже предусмотрена команда. Вот справка по ней:
Мы давно не запускали её в самой среде XenForo , однако если вы выполните её на собственном дополнении и передадите параметр --delete-all, вы сможете удалить не используемые фразы после подтверждения:

Установка навыков искусственного интеллекта для XenForo
При работе с любым фреймворком, особенно коммерчески лицензированными, такими как XenForo, взаимодействие с искусственным интеллектом может быть… интересным. Хотя ситуация значительно улучшилась благодаря развитию агентов искусственного интеллекта, вероятность столкнуться с ошибочными представлениями или случайными ошибками всё ещё довольно высока.

Решение проблемы состоит в наличии подробной документации, которая сможет направлять агента искусственного интеллекта и служить точкой отсчёта для объяснения определённых паттернов, лучших практик, доступных команд и общих способов выполнения задач.

Безусловно, вы можете написать всю документацию самостоятельно. Вы можете создать файл CLAUDE.md (или AGENTS.md для всех остальных), который обеспечит чёткое направление действий. Вы также можете разработать собственные «навыки», чтобы помочь агенту выполнять конкретные задачи. Но начиная с XenForo 2.3.10 вам больше не придётся это делать

Мы разработали новую команду xf-dev:install-ai-agents, которая автоматически установит мощный набор инструкций для выбранного вами агента искусственного интеллекта и сохранит их в соответствующих местах. К сожалению, существуют разные соглашения относительно наименования файлов в зависимости от используемого инструмента, и данная команда учитывает это различие.
Запуск команды без параметров создаст файлы, совместимые с большинством моделей и агентов, отличных от Claude, например ChatGPT Codex или Open Code. Если вы работаете исключительно с моделью Claude, добавьте параметр --only-claude. Или, если вы переключаетесь между разными инструментами, воспользуйтесь опцией --with-claude.

Все агенты получают примерно одинаковые файлы, различия касаются лишь местоположения сохранения и наименований самих файлов. Например, по умолчанию вы получите файл AGENTS.md вместо файла CLAUDE.md.

Я не буду подробно останавливаться на всём содержимом этих файлов, но структура выглядит примерно так:

CLAUDE.md / AGENTS.md

Это краткий обзор фреймворка, включая расположение ключевых файлов и основные паттерны, о которых агент должен заранее знать. Затем объясняются ряд навыков и их предназначение, подробнее об этом ниже.

xf-shared-policy

Здесь изложены общие правила разработки, касающиеся обеих сторон процесса, включая разработку ядра и дополнений. Объясняются такие вещи, как система вывода результатов разработки, команды xf-make и общие принципы, помогающие агентам оставаться в рамках заданного курса.

xf-core-dev

Эта секция не особо актуальна для большинства пользователей, но представляет собой сборник полезных общепринятых соглашений для основной разработки, используемых командой XenForo.

xf-addon-dev

Здесь объясняется, как узнать правильный идентификатор дополнения, понимание нумерации версий, отказ от ручного редактирования XML-файлов и другие справочные материалы, непосредственно относящиеся к разработке дополнений.

xf-scaffold-make

Этот навык описывает использование команд xf-make более детально и даёт общее представление о рекомендациях касательно генерации артефактов разработки.

xf-template-phrase

Здесь описано, как работают шаблоны и фразы, включая краткую ссылку на семантику языка, применяемую в синтаксисе шаблонов XenForo.

Совокупно эти навыки делают работу с агентами искусственного интеллекта и XenForo гораздо стабильнее и предсказуемее. Однако помните, что результаты могут варьироваться, и иногда даже самый умный агент может ошибаться или сбиваться с пути. Я настоятельно рекомендую внимательно проверять каждую строку кода, написанного агентом, и понимать, что именно происходит!