Kirby CDN integration
Before you start
- Before you take any steps please back up your files and database.
- In the following we are going to integrate a CDN service using its CDN domain 12345.r.cdnsun.net. Please refer to Services/How-To for your CDN domain.
- If you are going to integate a CDN service also on https:// pages then you must use CDN domain with SSL enabled.
- If your website embeds custom fonts then please first enable CORS for them.
- Before you take any steps please make sure that your CDN domain is ready-to-use here.
Create CDN Static service
Please refer to Creating a CDN Static service for more details.
Enable CDN in Kirby
Download the Kirby CDN Plugin from its GitHub page.
You can use the following git command:
git clone https://github.com/getkirby-plugins/cdn-plugin.gitThis will create a directory cdn-plugin and clone the Kirby CDN plugin git repository from GitHub to that directory.
- Create a directory site/plugins/cdn in your Kirby document root.
- Copy all files from the cdn-plugin directory to the site/plugins/cdn directory.
Add your CDN domain to the Kirby configuration file site/config/config.php:
c::set('cdn.assets', 'http://12345.r.cdnsun.net'); c::set('cdn.content', 'http://12345.r.cdnsun.net'); c::set('cdn.thumbs', 'http://12345.r.cdnsun.net');
- That's all.
- Don't see your CDN domain in source code of your web pages? If your website is using any cache plug-in/mechanism then you might want to clear/flush its cache.
- Having troubles with custom fonts? Please refer to Using custom fonts with CDN - setting CORS for more details.
- Still having troubles? Check your CDN URLs in our CDN content check or please refer to Debugging a CDN service for more hints.