Skip to content

Commit a9fe428

Browse files
authored
v1.0.0 release
1 parent 41eff7f commit a9fe428

20 files changed

Lines changed: 429 additions & 965 deletions

File tree

CHANGELOG.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# Changelog
2+
3+
## 1.0.0 (September 19, 2024)
4+
5+
We are happy to announce the release of CKEditor 5 Official Integration v1.0.0.
6+
7+
### Release highlights
8+
9+
This release introduces compatibility between the CKEditor 5 Official Integration plugin and Strapi 5. Since Strapi 5 is currently in its Release Candidate (RC) phase (as of September 19th), we are providing an updated version of the plugin to allow early testing and ensure seamless integration with the upcoming Strapi 5 release.
10+
11+
For users who continue to work with Strapi 4, the plugin remains available in version 0.x.x (with 0.1.0 being the latest as of September 19th). This ensures full support for Strapi 4 environments.
12+
13+
### BREAKING CHANGES ℹ️
14+
15+
* **CKEditor 5 integration now uses CDN instead of npm**. In version 1.0.0, we've transitioned from npm packages to loading CKEditor 5 via the CKEditor CDN. As the editor will now be loaded from an external origin, you'll need to update your Content Security Policy (CSP) to include https://cdn.ckeditor.com in the `script-src` directive. Please see the updated installation instructions in the `README.md` for further details.

LICENSE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ Copyright (c) 2022-2024, [CKSource Holding sp. z o.o.](http://cksource.com) All
55

66
Inspired by https://github.com/nshenderov/strapi-plugin-ckeditor, copyright nshenderov.
77

8-
Licensed under the terms of [MIT License](https://opensource.org/licenses/MIT).
8+
The plugin "CKEditor 5 - Official Integration for Strapi" is licensed the terms of the [MIT License](https://opensource.org/licenses/MIT). Please note that [CKEditor 5 itself is licensed under GPL v2+](https://ckeditor.com/legal/ckeditor-oss-license/?utm_campaign=strapi-integration&utm_source=ck-github&utm_medium=referral) or a [commercial license](https://ckeditor.com/pricing/?utm_campaign=strapi-integration&utm_source=ck-github&utm_medium=referral).
99

1010
Trademarks
1111
----------

README.md

Lines changed: 64 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,11 @@
1-
# CKEditor 5 custom field for Strapi
1+
# CKEditor 5 - Official Integration for Strapi
22

33
<img src="https://user-images.githubusercontent.com/156149/192792402-4bb1e040-6f8c-49be-af90-fd35fd3a4c66.png" alt="CKEditor 5 used inside Strapi. Article form consisting of a title, excerpt text, and content">
44

5-
This package provides a custom field for Strapi that lets you use and configure CKEditor in no time.
5+
> [!IMPORTANT]
6+
> Starting from version 1.0.0, the CKEditor 5 custom field plugin is compatible with Strapi 5 and can’t be used in Strapi 4.4+. We decided to maintain integrations for both Strapi versions to ensure that you can still use our custom field before migrating to Strapi 5. Below is the [compatibility table](#compatibility) showing which plugin version should be used with your Strapi version.
7+
8+
This package provides a custom field for Strapi 5 that lets you use and configure CKEditor in no time.
69

710
Custom fields are supported since Strapi 4.4+ and offer powerful API to create highly customizable fields.
811

@@ -33,7 +36,26 @@ With `yarn`:
3336
yarn add @ckeditor/strapi-plugin-ckeditor
3437
```
3538

36-
Then run build:
39+
Then, add the Content Security Policy configuration to allow loading CKEditor 5 from https://cdn.ckeditor.com origin, by adding the rule to `config/middlewares.ts` in your Strapi project root:
40+
41+
```js
42+
export default [
43+
// ...
44+
{
45+
name: 'strapi::security',
46+
config: {
47+
contentSecurityPolicy: {
48+
useDefaults: true,
49+
directives: {
50+
'script-src': ['https://cdn.ckeditor.com']
51+
},
52+
},
53+
},
54+
},
55+
// ...
56+
```
57+
58+
Finally run build:
3759

3860
```bash
3961
npm run build
@@ -100,3 +122,42 @@ Rebuild the project and start the server:
100122
yarn build
101123
yarn develop
102124
```
125+
126+
## <a id="compatibility"></a>🧩 Compatibility with Strapi versions
127+
128+
Starting from version 1.0.0, the CKEditor 5 custom field plugin is compatible with Strapi 5 and can't be used in Strapi 4.4+. We decided to maintain integrations for both Strapi versions to make sure that you still be able to use our custom field before migrating to Strapi 5. Below, you can find the compatibility table that shows which plugin version should be used with your Strapi version.
129+
130+
<table>
131+
<thead>
132+
<tr>
133+
<th>
134+
Plugin version
135+
</th>
136+
<th>
137+
Strapi version
138+
</th>
139+
</tr>
140+
</thead>
141+
<tbody>
142+
<tr>
143+
<td>
144+
1.x.x
145+
</td>
146+
<td>
147+
≥ 5.0.0
148+
</td>
149+
</tr>
150+
<tr>
151+
<td>
152+
0.x.x
153+
</td>
154+
<td>
155+
≥ 4.4
156+
</td>
157+
</tr>
158+
</tbody>
159+
</table>
160+
161+
## <a id="licensing"></a>⚖️ Licensing
162+
163+
The plugin "CKEditor 5 - Official Integration for Strapi" is licensed under MIT. Please note that [CKEditor 5 itself is licensed under GPL v2+](https://ckeditor.com/legal/ckeditor-oss-license/?utm_campaign=strapi-integration&utm_source=ck-github&utm_medium=referral) or a [commercial license](https://ckeditor.com/pricing/?utm_campaign=strapi-integration&utm_source=ck-github&utm_medium=referral).

0 commit comments

Comments
 (0)