moox
1.0.0
Добро пожаловать в проект Moox. Это Monorepo и устанавливаемое приложение Laravel для разработки наших плагинов Filament, также известных как пакеты Laravel. Мы находимся на ранней стадии разработки, но уже есть несколько плагинов, которые могут оказаться полезными:
Некоторые из них находятся в продуктивном использовании, но еще не задокументированы:
Все остальные пакеты находятся в стадии активной разработки:
И есть еще кое-что НЕ в этом репо:
Приложение разработки Laravel в корневой папке Moox Monorepo предназначено для мгновенной разработки с помощью Laravel Herd, Laravel Valet, Laravel Sail или Laragon.
# Create a .env file and adjust to your needs
cp .env.example .env
# Don't forget to create the database according .env
# Install via Composer
composer install
# Migrate and seed
php artisan migrate:fresh --seed
# Use Vite (for Laravel Sail on Windows: do it in Ubuntu, not inside the Sail container)
npm install
npm run devДополнительные вещи:
# You can create a user then
php artisan make:filament-user
# You can use the custom composer.json
cp _custom/composer.json-example _custom/composer.json
# Run Sail (alternatively start Herd,Laragon or Valet)
./vendor/bin/sail up
# Rebuild the sail config if needed
./vendor/bin/sail down --rmi all -v
php artisan sail:install
# Remove broken symlinks if needed
# switching from Laragon to Sail for example
rm -Rf vendor/mooxphpАдминистратор Moox теперь доступен по адресу /moox, например https://moox.test/moox.
Чтобы установить Moox Press, вам понадобится WordPress, работающий в /public/wp (или другом подкаталоге, настроенном в .env).
Чтобы установить новую версию WordPress, мы предоставляем команду artisan, поставляемую с пакетом Moox Press:
php artisan mooxpress:wpinstallКоманда нуждается в некоторой оптимизации и работает в Windows только «половину».
Наше Монорепо готово быть двойным агентом:
Это достигается за счет поддержки пользовательских пакетов в приложении для разработки нашего Monorepo. Звучит интересно? Прочтите на _custom/README.md.
npm run build перед фиксацией, поскольку для автоматических тестов на GitHub требуется работающий Vite-манифест.php artisan migrate --database=sqlite чтобы отразить изменения в тестовой базе данных.main — текущая стабильная версия, защищенная ветками, автоматически фиксирующая все пакеты, развернутая в lifeature/... пожалуйста, добавьте префикс ко всем ветвям функций, создавайте запросы на включение непосредственно в основнуюИспользуйте ветки, посвященные проблемам, с префиксом Feature/ (например, Feature/38-Welcome-View) для автоматизированных тестов и анализа кода.
Ваши сообщения о коммитах будут объединены в Changelog.md, то есть станут частью документации. Пожалуйста, убедитесь, что вы
Wip[Core]: Feature register assets wip #123Fix[All]: Update all packages Close #321Feat[Monorepo]: Update dev app Close #22Bump![ChartComponents]: Major UpdatesFeat![PackageBuilder]: This will become a major release #23Узнайте больше об обычных коммитах.
Создайте PR для main . Используйте обычные коммиты, как описано выше.
Мы используем семантическое управление версиями, написанное как 1.2.3 для
Посетите Semver.org для получения дополнительной информации.
В настоящее время это делается вручную, в разработке находится функция автоматического выпуска.
Мы тестируем Moox, используя:
Пожалуйста, убедитесь, что вы используете те же инструменты в VS Code (наш пакет расширений VS Code охватывает это) или выполняете проверки вручную, прежде чем переходить к ветке разработки:
composer analyse или ./vendor/bin/phpstan analyse , для пакетов ../../vendor/bin/phpstan analysecomposer test или ./vendor/bin/pest для пакетов ../../vendor/bin/pestcomposer test-coverage или ./vendor/bin/pest --coverage , для пакетов ../../vendor/bin/pest --coveragecomposer format или ./vendor/bin/pint для пакетов ../../vendor/bin/pint Заголовки и сортировку в AdminPanel можно настроить в конфигурациях пакетов, но это сортировка по умолчанию, которая сохраняет все на месте:
- Dashboard
- Main - 1000
- Expiry - 1100
- Notifications - 1800
- Content - 2000
- Posts - 2100
- Pages - 2200
- Media - 2300
- Categories - 2400
- Tags - 2500
- Comments - 2600
- Custom - 3000
- ...
- Meta - 4000
- Wp Meta...
- Custom - 5000
- ...
- Users - 6000
- App users - 6010 (Moox Users, Moox Press Users 6015)
- Site users - 6020
- Customers - 6030
- Registrations - 6100
- Roles - 6200
- Permissions - 6201
- Devices - 6300
- Sessions - 6400
- Login-Links - 6500
- Password-Tokens - 6600
- Passkeys - 6700
- System - 7000
- Audit - 7500
- Options (Press) - 7900
- Jobs - 8000
- Job manager - 8001
- ...
- Tools - 9000
- Sync - 9500
- Backup - 9800
- Builder - 9990
Moox делают эти милые люди и боты...
Альф Дроллингер ? ? ?️ | Азиз Гасым ?️ | КимСпир ?️ | Weblate (бот) ? | Муокс-бот ? | Рейнхольд Джесси | ФМорлок ? ? |
Сэм Бола ? | Ким Спир ?️ | Ларавел Шифт ? | микагрич | Сомоджи Золтан | Игорь Клаусс | Грег Р.Г. |
Аллан Нордхой ? | Яна Брот | Майло Ивир ? | Мика | Все участники ? | Фрик Ван дер Хертен ? | отремонтировать [бот] ? |
github-actions[бот] ? | зависимыйбот[бот] ? | Микачу | Симмон | Калпеш Махида | Роулин | Марк ван ден Брук |
Себастьян Де Дейн | Питер Форрет | Этторе Аталан ? | п-пол | Салх |
Эта таблица создается ботом All Contributors. Чтобы добавить участников, используйте следующую команду в любом комментарии к проблеме или PR:
@all-contributors please add @github-user for code
Обычно мы используем «код» и «перевод», но на AllContributers.org перечислены и другие возможные типы. Пожалуйста, делайте только один запрос за раз, так как мы столкнемся с конфликтами слияния, если вы попытаетесь добавить нескольких участников без объединения PR между ними.
Мы приветствуем каждый вклад! Было бы здорово, если бы вы:
Moox переводится с помощью Weblate. Конечно, вы также можете напрямую редактировать файлы перевода в пакетах, но использование полнофункциональной платформы перевода, такой как Weblate, может быть более удобным.
Moox — бесплатное программное обеспечение с открытым исходным кодом, лицензированное по лицензии MIT.
Некоторые проекты, от которых мы зависим, выпущены под другой лицензией. Мы делаем все возможное, чтобы эти лицензии допускали как частное, так и коммерческое использование и не налагали никаких ограничений.
Если вы заметили какие-либо проблемы с лицензированием Moox или какой-либо зависимостью, напишите нам по адресу [email protected].
Как упоминалось выше, мы используем автоматизированные проверки кода и аудит безопасности, чтобы гарантировать, что наш код не содержит уязвимостей безопасности.
Прочтите нашу Политику безопасности, чтобы узнать больше о безопасности или сообщить о потенциальной уязвимости. Пожалуйста, НЕ используйте систему отслеживания проблем для сообщения о проблемах, связанных с безопасностью.
