Twill 3.1.0

Twill 3.1.0 is a minor release combining the effort of 40 contributors over the past few months! 🎉 This release brings in PHP 8.3 support, enhancements to the form builder, a lot of developer experience improvements, important bug fixes, and more—crafted carefully because we know how crucial stability is for your Twill projects, and ours, too!

Websites and applications #MadeWithTwill are running in production for major companies and institutions like OpenAI, Nike, the New York Times or the Art Institute of Chicago, and we certainly don't want to cause any issues on their platforms when upgrading Twill. For this reason, and because we truly care about our clients and our community, we reviewed each community contributions with a lot of attention and tested them in multiple Twill instances before tagging this release.

Huge thanks to every contributor, new and returning, for making this release possible. Check out the updates and let us know your thoughts. Your input is always welcome and keeps Twill growing and improving.

HOW TO UPDATE

Run composer update in your project and then, run Twill's own update command: php artisan twill:update. This will force update your published Twill assets. If you are versioning them, you can delete the old ones from your repository. If you are using custom Vue components, you should rebuild Twill assets using php artisan twill:build.

Added

• PHP 8.3 support by @antonioribeiro in #2374
• Form builder connected fields support by @joyceverheije in #2323
• Glide image rendering service improvements for remote disks by @ifox in #2422
• Google Analytics 4 support in the dashboard by @lewiswharf in #2288
• Configurable preview breakpoints by @florrie-90 in #2299
• Automatically add active to $translatedAttributes by @driftingly in #2401
• Block component classes support in the BlockEditor blocks array by @joyceverheije in 8778ab7
• Add excludeBlocks option to the BlockEditor fields by @pauldwight in #2409
• Add readOnly support to form builder Input field by @zachgarwood in #2331
• Add searchable support to form builder Select field by @iedex in #2415
• Add max support to form builder InlineRepeater field by @joyceverheije in 4a77386
• Add direction option to Input and Wysiwyg fields by @13twelve in #2295
• Add alignment buttons to TipTap editor by @florrie-90 in #2305
• Add predefined class selection to TipTap link component by @zipavlin in #2336
• Add support for titleInBrowser and adminEditUrl accessors in browsers by @joyceverheije in 02ac019, ab8635f and 160e916
• Add --factory and --seeder to twill:make:module by @driftingly in #2402
• Add Link column type to table builder by @agnonym in #2376
• Add routePrefix support to nested breadcrumbs by @yamaha252 in #2312
• Add DI support for Twill Block getData method by @Afting in #2292
• Allow QuickFilter extension by @joyceverheije in 9c15b01
• Configurable permissions and roles table names by @Keania-Eric in #2350
• Configurable user creation with default role when using OAuth SSO by @joyceverheije in 14f8dd2
• Customizable title column's label by @Phiosss in #2318
• Current request only tertiary nav links support by @joyceverheije in d1c0699
• Multiple nested table columns support in the table builder by @yamaha252 and @joyceverheije in #2314 and 1edbfbb
• Store position and render selected values ordered on multi selects fields by @haringsrob in #2204
• Update migration stub and existing migrations to use anonymous class by @driftingly in #2406

Fixed

• Fix DatePicker date selection by @ifox in 0e75172
• Fix Tiptap Wysiwyg click to focus area by @TimBlanchard in #2418
• Fix custom components registration by @joyceverheije in 7c23333
• Fix position value for blocks in non-default BlockEditor fields by @joyceverheije in #2381
• Fix incorrect order of nested items slug when item is more than 2 levels deep by @pauldwight in #2388
• Fix parseInternalLinks helper issues by @avinash403 in #2338
• Fix to reduce excessive number of queries when using Twill 3 settings by @bonroyage in #2369
• Fix legacy settings in Twill 3 by @joyceverheije in #2417
• Fix user list errors when deleting roles by @antonioribeiro in #2372
• Fix build error with custom icons by @emanueljacob in #2392
• Fix x-position of full height crops being reset at some ratios/screen sizes by @13twelve in #2297
• Fix fields/blocks/repeaters spacings by @ifox in 1a93fe4
• Fix active navigation check when a child module uses the same name as another module by @joyceverheije in f22eb35
• Fix create button alignment in listings by @ifox in 006f478
• Fix duplication when translated media fields are enabled by @petertsoisstuff in #2320
• Fix getCapsuleForModel() for when passing a Model object by @antonioribeiro in #2400
• Fix keepAlive on connected non localized fields by @joyceverheije in b1593c7
• Fix optional feature migrations publication by @Tofandel in #2384
• Fix related table name in migration down method by @droplister in #2290
• Fix scheduled filter label by @droplister in #2291
• Fix type of $forceLocale in translatedInput() by @pvdbroek in #2315
• Fix user role filter when using the standard permissions setup by @ifox in 6e89323
• Fix vselect component to align with design by @ifox in 6e89323
• Fix error when running php artisan migrate:reset by @NuktukDev in #2413
• Allow dashboard modules to wrap onto the next line by @florrie-90 in #2298
• Always include locale in the mediables pivot by @bonroyage in #2368
• Avoid unused data and hooks when using the default role level by @joyceverheije in 5d4060b
• Check user permission when displaying activity log items by @joyceverheije in 3526dca
• Don't load DuskServiceProvider if Dusk doesn't exist by @Tofandel in #2366
• Preserve default vselect value when undefined by @bwat-dev in #2311
• Prevent multi select options from being selected more than once by @florrie-90 in #2296
• Remove block actions in settings blocks by @ifox in 0bc5e75
• Support using a dot as fieldsGroupsFormFieldNameSeparator by @yamaha252 in #2277
• Turn move dropdowns off for settings blocks by @droplister in #2293
• Update migration helper for translations table by @sauron in #2327
• Updated namespace paths from Admin to Twill on custom pages by @pauldwight in #2317
• Use custom model configuration in the relationship morph map by @redelschaap in #2408
• Use pushOnce builtin, remove custom pushonce directive by @mikerockett in #2301
• Use twill.admin_route_name_prefix configuration for all internal routes by @ifox and @raymondtri in #2286

Docs

• Add instructions on how to use the browser field with a custom pivot table by @poncianodiego and @ifox in #2385
• Changed example value to better reflect given example in fields group docs by @Viliasas in #2283
• Fix artisan command by @thecrazybob in #2365
• Fix typo in Building a frontend guide by @driftingly in #2396
• Fix typo in Content - Modules - TableBuilder by @agnonym in #2375
• Fix typo in create page module guide by @colegeissinger in #2367
• Fix wrong property name in nested modules docs by @Viliasas in #2282
• Updates to the docs for nested modules by @pauldwight in #2389

Translations

• Added Slovenian language to translations by @Neoglyph in #2373
• Update Dutch translations by @lindeVW in #2378
• Update German translations by @florianschrottenloher-iu in #2411
• Add all locales with translations to the user locale selector by @ifox in 6e89323
• Configure all locales with translations for date rendering and datepicker configuration by @ifox in eb21fa9

New Contributors

• @pvdbroek made their first contribution in #2315
• @yamaha252 made their first contribution in #2312
• @florrie-90 made their first contribution in #2299
• @petertsoisstuff made their first contribution in #2320
• @Viliasas made their first contribution in #2282
• @Keania-Eric made their first contribution in #2350
• @thecrazybob made their first contribution in #2365
• @colegeissinger made their first contribution in #2367
• @zachgarwood made their first contribution in #2331
• @Neoglyph made their first contribution in #2373
• @Tofandel made their first contribution in #2384
• @emanueljacob made their first contribution in #2392
• @driftingly made their first contribution in #2396
• @lindeVW made their first contribution in #2378
• @poncianodiego made their first contribution in #2385
• @redelschaap made their first contribution in #2408
• @avinash403 made their first contribution in #2338
• @Phiosss made their first contribution in #2318
• @lewiswharf made their first contribution in #2288
• @florianschrottenloher-iu made their first contribution in #2411
• @NuktukDev made their first contribution in #2413
• @Afting made their first contribution in #2292
• @TimBlanchard made their first contribution in #2418

Full Changelog: 3.0.2...3.1.0

Twill 3.0.2

Twill 3.0.2 is a patch release mainly addressing a pain point when rendering nested component-based blocks that were forcing developers to use non-standard views locations or duplicate views. It also continues improving the new form builder and fixes a bunch of issues in the documentation. Thanks to our community members for reporting and helping to address these issues!

Fixed

• Rendering of nested components blocks by @haringsrob in #2243
• Rendering of side form if it only contains fieldsets by @agnonym in #2234
• Title prefix support in component blocks by @haringsrob in #2252
• Icon support in component blocks by @agnonym in #2238
• Columns support for checkboxes and radios in form builder by @bonroyage in #2232
• Options::fromArray argument order by @bonroyage in #2231
• Update package generator stub by @ifox in 78cc5b5

Documentation

• Fix activity log typo by @DanielSpravtsev in #2264
• Fix two misspellings by @skoontastic in #2250
• Fix typo in create modal docs by @lostdesign in #2262
• Update upgrade guide by @undersound in #2251
• Additional explanation on migration for Input field type by @tttogo in #2247
• Closing bracket missing by @kerkness in #2245
• withFieldSets() expects Fieldsets object, not a direct array by @agnonym in #2233
• Fix 'tiwll' typo in docs by @ifox in 715bc6f
• Fix 'Larvel' typo in docs by @ifox in 8db541d
• Fix module make commands signatures addressing PHPStan error in 94733f1

New Contributors

• @skoontastic made their first contribution in #2250
• @DanielSpravtsev made their first contribution in #2264
• @lostdesign made their first contribution in #2262
• @undersound made their first contribution in #2251
• @kerkness made their first contribution in #2245
• @bonroyage made their first contribution in #2232

Full Changelog: 3.0.1...3.0.2

Twill 3.0.1

Fixed

• Fix Blade components resolution (causing an issue with Laravel Jetstream) by @haringsrob in #2223

Improved

• Add mobile nav to all docs site pages by @13twelve in #2224
• Fix WYSIWYG maxlength docs by @tttogo in #2226
• Form Builder docs: provide more explicit directions on Fieldsets by @tttogo in #2227
• Fix docs space coherence for the options by @agnonym in #2228

New Contributors

• @tttogo made their first contribution in #2226

Full Changelog: 3.0.0...3.0.1

Twill 3.0.0

This is the final, stable release for Twill 3.0 🎉

The priorities for Twill 3.0 were clear. As Twill is a developer-focused CMS framework, we wanted to create an even better developer experience and improve our documentation. After 3 alpha releases, 2 beta releases, and 4 release candidates, we're proud to share that Twill 3.0 is now stable. Thanks to all community members that helped us refine it and major kudos to Rob Harings for the herculean effort over the past year!

Read more about this update on the new Twill CMS blog, and explore the updated documentation and guides!

HOW TO UPGRADE

Twill 3.0 offers a seamless upgrade process from Twill 2, using Rector to automate many steps and providing detailed documentation for smoother transitions. Read our upgrade guide.

Do not hesitate to reach out on GitHub or Discord if you have a specific use case or any trouble using Twill 3 with your existing application.

Breaking changes (since RC4)

• Prefix tables with twill_ by @aksiome
• Set tiptap as default WYSIWYG type when using blade components

Added (since RC4)

• Laravel 10 support by @haringsrob
• Add fromArray to options by @aksiome
• Float min, max and step props for numeric input by @iedex
• Add source_path_prefix to Glide ServerFactory by @matteovg7
• Allow using 0 as min or max for numeric input by @iedex

Fixed (since RC4)

• Fix phpdocs by @joyceverheije
• #2044|#1818: Improve repeater cloning. by @haringsrob
• Resolve repeater duplication issue. by @haringsrob
• Prevent erroring when permissions is not able to find disabled capsules by @antonioribeiro
• #2177: Fix renderForBlocks for columns. by @haringsrob
• Fix stretched image in browser field by @joyceverheije
• Fix duplicate action redirect route for nested parent-child modules by @agnonym
• Fix duplicate block duplicate with children by @agnonym
• Fix source edit not updateing the editor (Tiptap) by @iedex
• Fixing mistypes in ru localization by @Quarasique

Improved (since RC4)

• Twill 3.0 docs updates
• Enable resend email only when user is published by @joyceverheije
• #2154: Use scope. by @haringsrob
• 2179: Avoid recreating related items. by @haringsrob
• Update Environment Requirements
• Require kalnoy/nestedset as a non-dev dependency
• Update node version in CI
• Add database table names change to upgrade guide

New Contributors

• @galingong made their first contribution in #1717
• @kylegoines made their first contribution in #1908
• @deckchan made their first contribution in #1971
• @tuanbinhtran made their first contribution in #2012
• @vladimirmartsul made their first contribution in #2071
• @pauldwight made their first contribution in #2107
• @aksiome made their first contribution in #2140
• @iedex made their first contribution in #2188
• @matteovg7 made their first contribution in #2131
• @13twelve made their first contribution in #2187
• @Quarasique made their first contribution in #2208

Full changelog

Twill 2.13.0

Twill 2.13.0 is a minor release mainly adding support for Laravel 10.

Twill 3.0 is now 🎉 stable 🎉, read more about it on the new Twill CMS blog.

HOW TO UPDATE

Run composer update in your project and then, run Twill's own update command: php artisan twill:update. This will force update your published Twill assets. You can delete the old ones from your repository if you are versioning them. If you are using custom Vue components, you should rebuild Twill assets using php artisan twill:build.

Added

• Laravel 10 support by @antonioribeiro in #2155
• Allow disabling automatic navigation on a Capsule package by @antonioribeiro in #2113
• Allow creating blocks and repeaters inside Capsules by @antonioribeiro in #2082
• Singleton - Add support of capsules inside the seed method by @cambad in #2180

Fixed

• Fix nested repeater being duplicated by @brunEdo in #2211
• Fix for VSelect component to use float values by @eudaco in #2024
• #1957: Fix connected fields keepalive. by @haringsrob in #2047
• Backport connected fields. by @haringsrob in #2059
• Missing .env line for disabling S3 storage by @DarthMikke in #2162

Improved

• Update index.md by @alexfraundorf-com in #2055
• Update architecture-concepts.md by @alexfraundorf-com in #2054
• it-IT translation enhancements by @LucaRed in #1929
• it translation: fixes by @LucaRed in #2201

New Contributors

• @eudaco made their first contribution in #2024
• @alexfraundorf-com made their first contribution in #2055
• @DarthMikke made their first contribution in #2162
• @brunEdo made their first contribution in #2211

Full Changelog: 2.12.4...2.13.0

Twill 3.0.0-rc4

3.0.0-rc4

This is the fourth release candidate for Twill 3! We plan that the next release will be the first stable release!

Features

• Block crops can now be defined from block components #2115
• twill:update will now ask to run migrations #2107
• Select::make()->options() now takes a closure as well #2143

Bugfixes

• Fixes various issues related to blocks #2124
• Allows fieldset only forms #2117
• GetFullUrl for link browser now replace language as well #2142
• Fixes return types of forms so they work properly in ide's #2140
• Fixes a bug which would render the wrong form if block name would overlap with internal
  names #2135
• Fixes an issue which caused table actions to no longer work #2129

New Contributors

• @pauldwight made their first contribution in #2107
• @aksiome made their first contribution in #2140

Full Changelog: 3.0.0-rc3...3.0.0-rc4

Twill 3.0.0-rc3

3.0.0-rc3

This is the third release candidate for Twill 3!

Notable changes

• Twill now uses Tiptap wysiwyg editor by default. If you wish to use quill you will need to update fields to use that specifically. #2080

Features

• Twill now uses Tiptap by default, Tiptap has been upgrade to version 2 and now has a link button that also supports browsers. #2080
  • The default config for the editor has been exanded to all features it supports
• The new settings are now translatable #2094
• SkipCreateModal now supports the table builder correctly #2087
• Adds the ability to show user activity on the dashboard #2063

Bugfixes

• Fixed settings accessor when used with nested blocks or repeaters.
• Fixed a check so that the media library button gets disabled correctly.
• Fixes browser endpoints no longer crash when no edit url could be build.
• Various fixes for block components.

Other

• Vue/node has been upgrade to use all of the latest versions #2070

---

Twill 3 brings a lot of improvements in the backend focused on developer experience.

• Minimum php version is now 8.0
• Twill now comes with permissions management
• Tables can now be customised more easily using the table builder
• Forms can be defined from the controller classes or from the views, you choose!
• Improved date handling (everything should be timezone aware)
• Many improvements to the documentation
• Blocks can be nested
• Many other things, check the changelog for more.
• As this is a beta release, bugs are to be expected, please consult the changelog and upgrade guide.

If you encounter issues, please create an issue or contact us on discord.

CHANGELOG
UPGRADE GUIDE

Full Changelog: 3.0.0-rc2...3.0.0-rc3

Twill 3.0.0-rc2

3.0.0-rc2

This is the second release candidate for Twill 3!

Features

• From builder now supports inline fieldsets #2007
• Blocks can now be defined as a blade component php twill:make:componentBlock blockName #2007

Bugfixes

• Fixed an issue where media tags would not save #2051
• Fixed an issue where conditional fields would not unset #2043
• Vselect now properly handles floats #2048
• Repeaters now properly collapse/expand #2037

Docs

• Various docs updated #2052

---

Twill 3 brings a lot of improvements in the backend focused on developer experience.

• Minimum php version is now 8.0
• Twill now comes with permissions management
• Tables can now be customised more easily using the table builder
• Forms can be defined from the controller classes or from the views, you choose!
• Improved date handling (everything should be timezone aware)
• Many improvements to the documentation
• Blocks can be nested
• Many other things, check the changelog for more.
• As this is a beta release, bugs are to be expected, please consult the changelog and upgrade guide.

If you encounter issues, please create an issue or contact us on discord.

CHANGELOG
UPGRADE GUIDE

New Contributors

• @tuanbinhtran made their first contribution in #2012

Full Changelog: 3.0.0-rc1...3.0.0-rc2

Twill 2.12.4

• Revert listAll change as it may conflict with method overrides.

Twill 2.12.3

• Restores Laravel 5.8 support that was removed in 2.12.1