Publii CMS v0.46.3: New Features, Enhancements, and Bug Fixes

We’re excited to announce the release of Publii CMS version 0.46.3 (build 17008), which includes a range of new features, improvements, and bug fixes to further enhance user experience and site functionality. This update builds upon the changes introduced in version 0.46.2 and addresses key user feedback, making Publii an even more efficient and versatile platform for static site generation.

Internal Site Description

To enhance organization and usability within the Publii app, we’ve introduced a new Site Description (Internal) field in the site settings. This additional textarea allows users to input a site description for internal reference only.

The entered description will appear in the Publii interface on the site selection screen beneath the site’s name. This makes it easier to identify and manage multiple sites within the app, especially when working on numerous projects.

This feature is particularly useful for users managing multiple sites. It provides a quick way to differentiate projects without affecting the site’s public-facing metadata.

This feature was added in response to a user request on GitHub (Issue #1831), highlighting the need to organize sites within Publii’s interface better.

Display Slugs Across All Listing Views

We’ve expanded the functionality of the slug display option to provide better transparency and control over URL structures in the Publii app. Previously, users could enable slugs on post and page listings by toggling the Show slugs on the post/page listings option in the App Settings.

With this update, the option Show slugs across all listing views has been renamed and now includes slugs for tags, author listing pages, and posts and pages. This enhancement ensures consistent visibility of slugs across all relevant listing views, making site management more intuitive and organized.

Support for Partials in Subdirectories

This update introduces support for Handlebars partials located in subdirectories. This enables developers to better organize their templates and maintain cleaner project structures.

Example:

theme/
|
├── assets/
|
├── partials/
│   ├── header/
│   │   ├── logo.hbs
│   │   ├── navigation.hbs
│   │   └── search.hbs
│   ├── footer/
│   │   ├── copyright.hbs
│   │   ├── links.hbs
│   │   └── social.hbs
│   ├── blog/
│   │   ├── post-meta.hbs
│   │   ├── post-excerpt.hbs
│   │   └── post-tags.hbs
│   └── shared/
│       ├── pagination.hbs
│       └── notifications.hbs
│
└── index.hbs
└── config.json
└── post.hbs
└── page.hbs

In your templates, you can reference partials using their subdirectory paths: 

{{> header/logo }}
{{> shared/breadcrumbs }}
{{> footer/social }}

This improvement was implemented in response to community feedback, as requested in a GitHub Discussion (#1785). 

App Notifications in Iframe Plugins

Iframe plugins now support app notifications, making it easier for users to stay informed about changes and updates while working within iframe-enabled plugins. This improvement applies to plugins like the Language File Editor, where real-time notifications can streamline workflows by providing immediate feedback on actions or changes.

Additionally, iframe plugins now better detect system color scheme changes. Previously, switching between dark and light modes required restarting the Publii app for the changes to take effect. With this update, color scheme adjustments are applied in real time.

Bug Fixes

We've also addressed several bugs to improve stability and performance:

• Fixed Bulk Actions on Listing Views: Resolved an issue where bulk actions did not function correctly on listing views.
• Fixed Detection of Internal Links: Improved the handling of internal links by adding support for single quotes (') in URLs containing #INTERNAL_LINK#. This ensures proper parsing, even when used within JavaScript. The update also resolves issues with links such as file/author, which previously required specific handling due to their non-numeric nature. It eliminates the need to search for the attribute's closing quotation or apostrophe (ref. GitHub Discussion).
• Fixed og:url and Canonical Generation: Resolved an issue where the og:url meta tag and canonical links included an extra slash (//) in the URL under specific configurations.  (ref. GitHub Discussion).
• Fixed Upload Control in Repeater with Tabs Display: Resolved an issue where images uploaded via the Repeater field with settingsDisplay: "tabs" were saved in the wrong directory, and the preview remained empty. The upload and preview now work correctly regardless of the display setting (ref. GitHub Issue).
• Fixed Issues with Missing Directories: Implemented recursive directory creation in fs.mkdirSync where appropriate, resolving an issue where adding featured images failed if the /input/media/posts folder did not exist. The folder is now created automatically, ensuring seamless functionality even when cloning the project from a repository (ref. GitHub Issue).
• Fixed Issues with Uploading .htpasswd Files: Resolved an issue where .htpasswd files placed in the Tools/File Manager/root directory were not uploaded during FTP deployment. These files are now included in the deployment process alongside .htaccess (ref. GitHub Issue).

Final Thoughts

Publii CMS v0.46.3 represents another step forward in our commitment to improving functionality, addressing user concerns, and introducing features that make managing static sites more intuitive and flexible.

As always, we welcome your feedback in the community forum to help us shape the future of Publii. Stay tuned for more updates and enhancements, and thank you for being a part of the Publii journey!

We look forward to seeing the fantastic static websites you create with this latest release.

Download Publii