Skip to content

Commit 0865568

Browse files
4.0.1
1 parent 6f69ec2 commit 0865568

17 files changed

+1985
-1
lines changed

dist/CHANGELOG.md

Lines changed: 215 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,215 @@
1+
# CKEditor 4 Angular Integration Changelog
2+
3+
⚠️️️ **CKEditor 4 (the open source edition) is no longer maintained.** ⚠️
4+
5+
If you would like to keep access to future CKEditor 4 security patches, check the [Extended Support Model](https://ckeditor.com/ckeditor-4-support/), which guarantees **security updates and critical bug fixes until December 2026**. Alternatively, [upgrade to CKEditor 5](https://ckeditor.com/docs/ckeditor5/latest/updating/ckeditor4/migration-from-ckeditor-4.html).
6+
7+
## ckeditor4-angular 4.0.0 / 4.0.1
8+
9+
BREAKING CHANGES:
10+
11+
The v4.0.1 release introduces compatibility with Angular v16+. Please note that this version of Angular no longer supports Internet Explorer 11.
12+
13+
If you want to maintain support for IE11 or haven't upgraded to Angular v16 yet, make sure to use the Angular integration in version 3.3.0.
14+
15+
Other Changes:
16+
17+
* [#242](https://github.com/ckeditor/ckeditor4-angular/issues/242): Updated the minimal version of Angular to `^13.4.0` to ensure compatibility with Angular 16+. Thanks to [Moez Mehri](https://github.com/Mooeeezzzz)!
18+
* Updated default CDN CKEditor 4 dependency to [4.22.1](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-4220--4221).
19+
20+
**Note:** Version 4.0.1 includes a patch for the distribution bundle that fixes missing support for Angular v16+ and should be used instead of v4.0.0 if you target a newer version of Angular.
21+
22+
## ckeditor4-angular 3.3.0
23+
24+
Other Changes:
25+
26+
* Updated default CDN CKEditor 4 dependency to [4.21.0](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-4210).
27+
28+
## ckeditor4-angular 3.2.2
29+
30+
Other Changes:
31+
32+
* Updated default CDN CKEditor 4 dependency to [4.20.2](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-4202).
33+
34+
## ckeditor4-angular 3.2.1
35+
36+
Other Changes:
37+
38+
* Updated default CDN CKEditor 4 dependency to [4.20.1](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-4201).
39+
40+
## ckeditor4-angular 3.2.0
41+
42+
Other Changes:
43+
44+
* Updated default CDN CKEditor 4 dependency to [4.20](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-420).
45+
46+
## ckeditor4-angular 3.1.1
47+
48+
Other Changes:
49+
50+
* Updated default CDN CKEditor 4 dependency to [4.19.1](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-4191).
51+
52+
## ckeditor4-angular 3.1.0
53+
54+
Other Changes:
55+
56+
* Updated default CDN CKEditor 4 dependency to [4.19.0](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-4190).
57+
58+
## ckeditor4-angular 3.0.0
59+
60+
Other Changes:
61+
62+
* Updated default CDN CKEditor 4 dependency to [4.18.0](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-4180).
63+
64+
[Web Spell Checker](https://webspellchecker.com/) ended support for WebSpellChecker Dialog on December 31st, 2021. Therefore, this plugin has been deprecated and removed from the CKEditor 4.18.0 `standard-all` preset.
65+
We strongly encourage everyone to choose one of the other available spellchecking solutions - [Spell Check As You Type (SCAYT)](https://ckeditor.com/cke4/addon/scayt) or [WProofreader](https://ckeditor.com/cke4/addon/wproofreader).
66+
67+
## ckeditor4-angular 2.4.1
68+
69+
Other Changes:
70+
71+
* Updated year and company name in the license headers.
72+
* Updated default CDN CKEditor 4 dependency to [4.17.2](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-4172).
73+
74+
## ckeditor4-angular 2.4.0
75+
76+
New Features:
77+
78+
* [#190](https://github.com/ckeditor/ckeditor4-angular/issues/190): Added support for CKEditor 4 [Delayed Editor Creation](https://ckeditor.com/docs/ckeditor4/latest/features/delayed_creation.html) feature.
79+
80+
## ckeditor4-angular 2.3.0
81+
82+
Other Changes:
83+
84+
* Updated default CDN CKEditor 4 dependency to [4.17.1](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-4171).
85+
86+
## ckeditor4-angular 2.2.2
87+
88+
Other Changes:
89+
90+
* Updated default CDN CKEditor 4 dependency to [4.16.2](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-4162).
91+
92+
## ckeditor4-angular 2.2.1
93+
94+
Fixed Issues:
95+
96+
* [#191](https://github.com/ckeditor/ckeditor4-angular/issues/191): Fixed: Cannot find module `ckeditor4-integrations-common` error after upgrading to `2.2.0`.
97+
98+
Other Changes:
99+
100+
* Updated default CDN CKEditor 4 dependency to [4.16.1](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-4161).
101+
102+
## ckeditor4-angular 2.2.0
103+
104+
New Features:
105+
106+
* [#143](https://github.com/ckeditor/ckeditor4-angular/issues/143): Exposed `namespaceLoaded` event fired when [`CKEDITOR` namespace](https://ckeditor.com/docs/ckeditor4/latest/api/CKEDITOR.html) is loaded, which can be used for its easier customization.
107+
108+
## ckeditor4-angular 2.1.0
109+
110+
Other Changes:
111+
112+
* Updated default CDN CKEditor 4 dependency to [4.16.0](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-416).
113+
* Updated year in license headers.
114+
115+
## ckeditor4-angular 2.0.1
116+
117+
Other Changes:
118+
119+
* Updated default CDN CKEditor 4 dependency to [4.15.1](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-4151).
120+
121+
## ckeditor4-angular 2.0.0
122+
123+
Breaking Changes:
124+
125+
* [#130](https://github.com/ckeditor/ckeditor4-angular/issues/130): `DIVAREA` editor type has been deprecated. Use [Div Editing Area](https://ckeditor.com/cke4/addon/divarea) plugin instead (see [migration guide](https://ckeditor.com/docs/ckeditor4/latest/guide/dev_angular.html#using-the-div-based-editor-type)).
126+
127+
## ckeditor4-angular 1.3.0
128+
129+
Other Changes:
130+
131+
* Updated default CDN CKEditor 4 dependency to [4.15.0](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-415).
132+
* [#98](https://github.com/ckeditor/ckeditor4-angular/issues/98): Updated repository dependencies (no changes in the actual `ckeditor4-angular` package).
133+
* [#128](https://github.com/ckeditor/ckeditor4-angular/issues/128): Improve the stability of `getEditorNamespace()` method.
134+
135+
## ckeditor4-angular 1.2.2
136+
137+
Fixed Issues:
138+
139+
* [#110](https://github.com/ckeditor/ckeditor4-angular/issues/110): Fixed: Integration throws an error when CKEditor 4 component is removed from the DOM before CKEditor 4 is loaded. Thanks to [Benjamin Hugot](https://github.com/bhugot)!
140+
141+
## ckeditor4-angular 1.2.1
142+
143+
Other Changes:
144+
145+
* Updated the default CKEditor 4 CDN dependency to [4.14.1](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-4141).
146+
147+
## ckeditor4-angular 1.2.0
148+
149+
New Features:
150+
151+
* [#7](https://github.com/ckeditor/ckeditor4-angular/issues/7): The CKEditor 4 Angular component now exposes more CKEditor 4 native events. Thanks to [Eduard Zintz](https://github.com/ezintz)! The newly exposed events are:
152+
* [`paste`](https://ckeditor.com/docs/ckeditor4/latest/api/CKEDITOR_editor.html#event-paste)
153+
* [`afterPaste`](https://ckeditor.com/docs/ckeditor4/latest/api/CKEDITOR_editor.html#event-afterPaste)
154+
* [`dragStat`](https://ckeditor.com/docs/ckeditor4/latest/api/CKEDITOR_editor.html#event-dragstart)
155+
* [`dragEnd`](https://ckeditor.com/docs/ckeditor4/latest/api/CKEDITOR_editor.html#event-dragend)
156+
* [`drop`](https://ckeditor.com/docs/ckeditor4/latest/api/CKEDITOR_editor.html#event-drop)
157+
* [`fileUploadRequest`](https://ckeditor.com/docs/ckeditor4/latest/api/CKEDITOR_editor.html#event-fileUploadRequest)
158+
* [`fileUploadResponse`](https://ckeditor.com/docs/ckeditor4/latest/api/CKEDITOR_editor.html#event-fileUploadResponse)
159+
160+
## ckeditor4-angular 1.1.0
161+
162+
Other Changes:
163+
164+
* Updated the default CKEditor 4 CDN dependency to [4.14.0](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-414).
165+
166+
## ckeditor4-angular 1.0.1
167+
168+
Other Changes:
169+
170+
* Updated the default CKEditor 4 CDN dependency to [4.13.1](https://github.com/ckeditor/ckeditor4/blob/master/CHANGES.md#ckeditor-4131).
171+
172+
## ckeditor4-angular 1.0.0
173+
174+
New Features:
175+
176+
* [#6](https://github.com/ckeditor/ckeditor4-angular/issues/6): Added support for classic (iframe-based) editor. Starting from this version classic editor is used by default.
177+
* [#40](https://github.com/ckeditor/ckeditor4-angular/pull/40): Added support for Angular 5.
178+
179+
Fixed Issues:
180+
181+
* [#42](https://github.com/ckeditor/ckeditor4-angular/issues/42): Fixed: The `elementRef` related error is thrown when using Angular 5.
182+
* [#54](https://github.com/ckeditor/ckeditor4-angular/issues/54): Fixed: Two-way data binding does not work when the [Undo](https://ckeditor.com/cke4/addon/undo) plugin is not present.
183+
184+
Other Changes:
185+
186+
* Updated the default CKEditor 4 CDN dependency to [4.13.0](https://github.com/ckeditor/ckeditor4-angular/issues/59).
187+
188+
## ckeditor4-angular 1.0.0-beta.2
189+
190+
Other Changes:
191+
192+
* Updated the default CKEditor 4 CDN dependency to [4.12.1](https://github.com/ckeditor/ckeditor4-angular/commit/2bf8a8c489f2a9ea2f2d9304e2e3d92646dbe89e).
193+
194+
## ckeditor4-angular 1.0.0-beta
195+
196+
Other Changes:
197+
198+
* [#28](https://github.com/ckeditor/ckeditor4-angular/issues/28): Updated package dev dependencies.
199+
200+
## ckeditor4-angular 0.1.2
201+
202+
Other Changes:
203+
204+
* [#20](https://github.com/ckeditor/ckeditor4-angular/issues/20): Added the "Quick Start" section to README file.
205+
* [#10](https://github.com/ckeditor/ckeditor4-angular/issues/10): Updated the LICENSE file with all required dependencies.
206+
207+
## ckeditor4-angular 0.1.1
208+
209+
Other Changes:
210+
211+
* `README.md` file improvements.
212+
213+
## ckeditor4-angular 0.1.0
214+
215+
The first beta release of CKEditor 4 WYSIWYG Editor Angular Integration.

dist/LICENSE.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
Software License Agreement
2+
==========================
3+
4+
**CKEditor 4 WYSIWYG editor Angular component**https://github.com/ckeditor/ckeditor4-angular <br>
5+
Copyright (c) 2003-2023, [CKSource](https://cksource.com/) Holding sp. z o.o. All rights reserved.
6+
7+
Licensed under the terms of any of the following licenses at your
8+
choice:
9+
10+
- GNU General Public License Version 2 or later (the "GPL")
11+
http://www.gnu.org/licenses/gpl.html
12+
13+
- GNU Lesser General Public License Version 2.1 or later (the "LGPL")
14+
http://www.gnu.org/licenses/lgpl.html
15+
16+
- Mozilla Public License Version 1.1 or later (the "MPL")
17+
http://www.mozilla.org/MPL/MPL-1.1.html
18+
19+
Sources of Intellectual Property Included in CKEditor
20+
-----------------------------------------------------
21+
22+
Where not otherwise indicated, all CKEditor content is authored by CKSource engineers and consists of CKSource-owned intellectual property. In some specific instances, CKEditor will incorporate work done by developers outside of CKSource with their express permission.
23+
24+
The following libraries are included in CKEditor 4 component for Angular under the following licenses:
25+
26+
- load-script [MIT](https://github.com/eldargab/load-script#license)
27+
- tslib Copyright (c) 2012-2020 Microsoft [Apache-2.0](https://github.com/Microsoft/tslib/blob/master/LICENSE.txt)
28+
29+
Trademarks
30+
----------
31+
32+
**CKEditor** is a trademark of [CKSource](https://cksource.com/) Holding sp. z o.o. All other brand and product names are trademarks, registered trademarks or service marks of their respective holders.

dist/README.md

Lines changed: 143 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,143 @@
1+
# CKEditor 4 WYSIWYG editor Angular component [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Check%20out%20CKEditor%204%20Angular%20integration&url=https%3A%2F%2Fwww.npmjs.com%2Fpackage%2Fckeditor4-angular)
2+
3+
[![npm version](https://badge.fury.io/js/ckeditor4-angular.svg)](https://www.npmjs.com/package/ckeditor4-angular)
4+
[![GitHub tag](https://img.shields.io/github/tag/ckeditor/ckeditor4-angular.svg)](https://github.com/ckeditor/ckeditor4-angular)
5+
[![Build Status](https://app.travis-ci.com/ckeditor/ckeditor4-angular.svg?branch=master)](https://app.travis-ci.com/ckeditor/ckeditor4-angular)
6+
7+
[![Join newsletter](https://img.shields.io/badge/join-newsletter-00cc99.svg)](http://eepurl.com/c3zRPr)
8+
[![Follow Twitter](https://img.shields.io/badge/follow-twitter-00cc99.svg)](https://twitter.com/ckeditor)
9+
10+
## ⚠️ CKEditor 4: End of Life and Extended Support Model until Dec 2026
11+
12+
CKEditor 4 was launched in 2012 and reached its End of Life (EOL) on June 30, 2023.
13+
14+
A special edition, **[CKEditor 4 LTS](https://ckeditor.com/ckeditor-4-support/)** ("Long Term Support"), is available under commercial terms (["Extended Support Model"](https://ckeditor.com/ckeditor-4-support/)) for anyone looking to **extend the coverage of security updates and critical bug fixes**.
15+
16+
With CKEditor 4 LTS, security updates and critical bug fixes are guaranteed until December 2026.
17+
18+
## About this package
19+
20+
Official [CKEditor 4](https://ckeditor.com/ckeditor-4/) WYSIWYG editor component for Angular.
21+
22+
We are looking forward to your feedback! You can report any issues, ideas or feature requests on the [integration issues page](https://github.com/ckeditor/ckeditor4-angular/issues/new).
23+
24+
![CKEditor 4 screenshot](https://c.cksource.com/a/1/img/npm/ckeditor4.png)
25+
26+
## Usage
27+
28+
In order to create an editor instance in Angular, install the `ckeditor4-angular` npm package as a dependency of your project:
29+
30+
```bash
31+
npm install --save ckeditor4-angular
32+
```
33+
34+
After installing, import `CKEditorModule` to your application:
35+
36+
```js
37+
import { CKEditorModule } from 'ckeditor4-angular';
38+
39+
@NgModule( {
40+
imports: [
41+
...
42+
CKEditorModule,
43+
...
44+
],
45+
46+
} )
47+
```
48+
49+
You can now use the `<ckeditor>` tag in the component template to include the rich text editor:
50+
51+
```html
52+
<ckeditor data="<p>Hello, world!</p>"></ckeditor>
53+
```
54+
55+
The `data` attribute used in the example above is responsible for setting the editor’s data.
56+
57+
## Documentation and examples
58+
59+
See the [CKEditor 4 Angular Integration](https://ckeditor.com/docs/ckeditor4/latest/guide/dev_angular.html) article and [Angular examples](https://ckeditor.com/docs/ckeditor4/latest/examples/angular.html) in the [CKEditor 4 documentation](https://ckeditor.com/docs/ckeditor4/latest/).
60+
61+
## Browser support
62+
63+
The CKEditor 4 Angular component works with all the [supported browsers](https://ckeditor.com/docs/ckeditor4/latest/guide/dev_browsers.html#officially-supported-browsers) except for Internet Explorer 8-10.
64+
65+
## Supported Angular versions
66+
67+
The integration can be used together with Angular at version 5.0.0 and higher. It is an implication of Angular metadata produced for this package by the Angular builder. Note that the `package.json` used in the main repository isn't published on NPM (the production one is present in `src/ckeditor/package.json`), so there are only a few peer dependencies:
68+
69+
* `@angular/core` >= 5.0.0
70+
* `@angular/common` >= 5.0.0
71+
* `@angular/forms` >= 5.0.0
72+
73+
required by this package.
74+
75+
## Contributing
76+
77+
Here is how you can contribute to the development of the component. Any feedback and help will be most appreciated!
78+
79+
### Reporting issues and feature requests
80+
81+
All issues and feature requests should be reported in the [issues section](https://github.com/ckeditor/ckeditor4-angular/issues/new) of the official GitHub repository for the CKEditor 4 Angular integration.
82+
83+
### Development
84+
85+
Clone the [CKEditor 4 Angular integration repository](https://github.com/ckeditor/ckeditor4-angular).
86+
87+
Once you have cloned it, install dependencies by running:
88+
89+
```bash
90+
npm install
91+
```
92+
93+
#### The structure of the repository
94+
95+
This repository contains the following code:
96+
97+
* `./src/ckeditor` contains the CKEditor component,
98+
* `./src/app` is a demo application using the component.
99+
100+
#### Development server
101+
102+
Run `ng serve` to start the development server. Navigate to `http://localhost:4200/`. The app will automatically reload if you change any of the source files.
103+
104+
#### Building samples
105+
106+
Run `ng build` to build the samples. The build artifacts will be stored in the `samples/` directory.
107+
108+
#### Running unit tests
109+
110+
Run `npm test` to execute unit tests via [Karma](https://karma-runner.github.io).
111+
112+
There are two options available to alternate the testing process:
113+
114+
* `url` / `u` - pass custom URL to Karma, for example custom CKEditor 4 build.
115+
* `watch` / `w` - tell Karma to watch for changes.
116+
117+
For example:
118+
119+
```
120+
npm run test -- -u http://localhost:5000/ckeditor.js -w
121+
```
122+
123+
#### Running end-to-end tests
124+
125+
Run `ng e2e` to execute the end-to-end tests via [Protractor](https://www.protractortest.org/).
126+
127+
#### Publishing
128+
129+
To build and publish the package, run `npm run publish`.
130+
131+
You can also manually build the package with `npm run build-package` which will be stored in `dist/`. Then you can publish it with `npm publish dist/`.
132+
133+
## License
134+
135+
Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
136+
137+
Licensed under the terms of any of the following licenses at your choice:
138+
139+
* [GNU General Public License Version 2 or later](http://www.gnu.org/licenses/gpl.html),
140+
* [GNU Lesser General Public License Version 2.1 or later](http://www.gnu.org/licenses/lgpl.html),
141+
* [Mozilla Public License Version 1.1 or later (the "MPL")](http://www.mozilla.org/MPL/MPL-1.1.html).
142+
143+
For full details about the license, please check the `LICENSE.md` file.

0 commit comments

Comments
 (0)