Home

>

Tools

>

Payload CMS

>

Releases

>

Release 1.8.4-canary.2

Payload CMS Release: Release 1.8.4-canary.2

Pre Release

Tag Name: v1.8.4-canary.2

Release Date: 6/1/2023

Payload CMS LogoPayload CMS

Payload CMS is a modern, self-hosted headless content management system built with TypeScript, Node.js, and MongoDB. It's designed specifically for developers who want full control over their content management system while maintaining a powerful admin interface for content editors.

TL;DR

PayloadCMS v1.8.4-canary.2 brings important bug fixes and improvements to enhance the developer experience. This release addresses issues with global schemas, code field options, locale popup display, and polymorphic list drawers. It also adds Bulgarian language support and improves typing for the sendMail function. These changes improve stability and usability for both developers and content editors working with PayloadCMS.

Highlight of the Release

    • Added Bulgarian language translation support
    • Fixed search functionality in polymorphic list drawers using the correct useAsTitle field
    • Resolved locale popup overflow issues for better UI experience
    • Added timestamps to global schemas for improved tracking
    • Fixed mongoose connection issues
    • Improved code field configuration with support for editorOptions

Migration Guide

No migration is required for this release as it primarily contains bug fixes and minor enhancements. All changes should be backward compatible with previous v1.8.x versions.

If you're using the code field with custom editor options, you can now properly configure them as the Joi schema has been fixed to allow editorOptions.

Upgrade Recommendations

This canary release is recommended for developers who:

  1. Need the specific bug fixes included, especially if you're experiencing issues with global schemas, code field options, locale popups, or polymorphic list drawer searches
  2. Want to test the new Bulgarian language support
  3. Are affected by mongoose connection issues

As this is a canary release (v1.8.4-canary.2), it's primarily intended for testing purposes. Production environments should wait for the stable v1.8.4 release unless you specifically need these fixes.

Bug Fixes

Global Schema Timestamps

Fixed an issue where global schemas were missing timestamps. This addition ensures that global schemas now properly track creation and update times, bringing them in line with collection schemas.

Code Field Editor Options

Resolved an issue with the code field Joi schema that was preventing the use of editorOptions. Developers can now properly configure code editor options for a more customized editing experience.

Locale Popup Overflow

Fixed a UI issue where the locale popup would overflow its container, causing display problems. The CSS for the locale selector has been refined for a better user experience.

Polymorphic List Drawers Search

Fixed search functionality in polymorphic list drawers to correctly use the specified useAsTitle field (#2710). This ensures that searches in these drawers return the expected results.

Mongoose Connection

Resolved issues with mongoose connections that could cause problems with database connectivity.

Payload Dependency Inception

Removed a circular dependency issue where payload was depending on itself, creating a "dependency inception" problem. This fix results in a cleaner dependency tree and more predictable behavior.

SendMail Function Typing

Improved TypeScript typing for the sendMail function, providing better type safety and developer experience when working with email functionality.

Test Environment Improvements

Fixed tests by ensuring proper URL handling in the logger and allowing custom MongoDB URLs during testing.

New Features

Bulgarian Language Support

This release adds Bulgarian language translation to PayloadCMS, expanding the platform's internationalization capabilities. This addition makes the admin interface more accessible to Bulgarian-speaking users and demonstrates PayloadCMS's commitment to supporting a diverse user base.

Improved File Size Display

The upload collection list view now formats file sizes in KB, providing a more readable and user-friendly display of file information.

Security Updates

No specific security fixes were included in this release.

Performance Improvements

Dependency Optimization

The removal of payload dependency inception (#2717) not only fixes a bug but also optimizes the dependency tree, potentially improving load times and reducing package size.

Improved Search Performance

The fix for polymorphic list drawer searches ensures that queries are performed on the correct useAsTitle field, which can improve search performance and accuracy in the admin UI.

Impact Summary

This release focuses on bug fixes and quality-of-life improvements for PayloadCMS users. The fixes address several UI issues, typing problems, and configuration limitations that were affecting the developer and content editor experience.

The addition of Bulgarian language support expands PayloadCMS's internationalization capabilities, making it more accessible to a wider audience. The improvements to global schemas, code field configuration, and search functionality in polymorphic list drawers enhance the platform's usability and flexibility.

For developers, the typing improvements and dependency fixes provide a more stable and predictable development environment. Content editors will benefit from the UI fixes and improved search functionality.

While this is a canary release and primarily intended for testing, the changes are focused on stability and usability rather than introducing potentially breaking changes, making it a relatively safe update for those who need the specific fixes included.

Full Release Notes

1.8.4-canary.2 (2023-06-01)

Bug Fixes

  • adds timestamps to global schemas (#2738) (0986282)
  • adjusts code field joi schema to allow editorOptions (ed136fb)
  • fix locale popup overflow (#2737) (8ee9724)
  • fix tests by hard-coding the URL in the logger (2697974)
  • mongoose connection (#2754) (69b97bb)
  • removes payload dependency inception (#2717) (6125b66)
  • searches on correct useAsTitle field in polymorphic list drawers #2710 (9ec2a40)
  • typing of sendMail function (e3ff4c4)

Features

Statistics:

File Changed31
Line Additions700
Line Deletions744
Line Changes1,444
Total Commits22

User Affected:

  • Fixed typing of sendMail function for better TypeScript support
  • Code field now properly supports editorOptions configuration
  • Resolved mongoose connection issues
  • Removed payload dependency inception for cleaner dependency tree
  • Improved test environment with better URL handling

Contributors:

AlessioGrjacobsfletchJarrodMFleschdenolfejmikrutjessrynkarPatrikKozakDanRibbensNikolaGanchev