Скачать или смотреть How to Set Cacheable Static Assets in your Kentico Xperience 13 .NET Core Site

Learn how to properly configure cache-control for static assets in a Kentico Xperience 13 .NET Core application, ensuring smooth operation and improved performance.
---
This video is based on the question https://stackoverflow.com/q/66891092/ asked by the user 'piemanji' ( https://stackoverflow.com/u/13184047/ ) and on the answer https://stackoverflow.com/a/66898686/ provided by the user 'jurajo' ( https://stackoverflow.com/u/1984571/ ) at 'Stack Overflow' website. Thanks to these great users and Stackexchange community for their contributions.

Visit these links for original content and any more details, such as alternate solutions, latest updates/developments on topic, comments, revision history etc. For example, the original title of the Question was: Set static assets as cacheable in Kentico Xperience 13 .NET Core site

Also, Content (except music) licensed under CC BY-SA https://meta.stackexchange.com/help/l...
The original Question post is licensed under the 'CC BY-SA 4.0' ( https://creativecommons.org/licenses/... ) license, and the original Answer post is licensed under the 'CC BY-SA 4.0' ( https://creativecommons.org/licenses/... ) license.

If anything seems off to you, please feel free to write me at vlogize [AT] gmail [DOT] com.
---
Setting Cacheable Static Assets in Kentico Xperience 13 .NET Core

When working with Kentico Xperience 13 on a .NET Core site, one common challenge is configuring static assets to be cacheable. This is essential for enhancing performance and speeding up load times for your web application. However, correctly implementing this can lead to issues, such as your page builder and form builder scripts and styles failing to load. In this guide, I will guide you through the steps to set cache-control for static assets seamlessly.

The Problem: Static Assets Not Loading

A user reported that when they attempted to set cache-control headers for static files in their Kentico Xperience 13 application, they faced unexpected 404 errors for files that began with the paths /Kentico or /_content. Here's a quick overview of the setup causing the issues:

The initial solution included a middleware for handling static files but resulted in crucial scripts and styles failing to load, leading to broken features in the site.

Attempts to adjust the load order or options did not resolve the issue.

The Solution: Proper Middleware Configuration

To resolve the issue of static assets not loading while also setting cache-control headers, you can take one of the following approaches:

Option 1: Configure Cache-Control in Middleware

You can create a middleware that sets cache-control headers for your static files while ensuring that the static files required by Kentico Xperience are still accessible.

Here’s how you can do it in your Startup.cs file:

[[See Video to Reveal this Text or Code Snippet]]

Option 2: Set Cache-Control via Services Configuration

Alternatively, if you want to apply cache-control to the default app.UseStaticFiles() configuration without creating a custom middleware, you can set it up in the ConfigureServices method in your Startup.cs. Here’s how:

[[See Video to Reveal this Text or Code Snippet]]

Key Points to Remember

Order Matters: The order in which you call middleware can affect how your application functions. Always place app.UseKentico() after static file configurations.

Static File Options: Ensure that your StaticFileOptions correctly specifies the paths where your assets are located.

Cache-Control Value: The cache-control header value used here is set to cache static assets for a year, which is indicated by max-age={60 * 60 * 24 * 365}.

Conclusion

By following this guide, you can efficiently enable caching for your static assets in Kentico Xperience 13 without encountering issues that disrupt the loading of essential components. Understanding how to configure middleware settings properly is crucial in ensuring that your application runs smoothly while enhancing performance through effective caching strategies.

Feel free to reach out if you have any further questions or need assistance with your Kentico Xperience setup!