Skip to content

Commit 6f64030

Browse files
docs: add blog entry for release 1.1.0 of conjoon
refs #18
1 parent d2a5c3c commit 6f64030

File tree

5 files changed

+81
-0
lines changed

5 files changed

+81
-0
lines changed
Loading
Loading
Loading
Loading
+81
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
---
2+
title: conjoon 1.1.0
3+
authors: [ThorstenSuckow]
4+
tags: [update, minor release, feature, local mail accounts]
5+
---
6+
7+
I'm happy to announce **conjoon 1.1.0**, a feature release that brings a lot of qol-improvements, bug fixes and a major feature to **conjoon**.
8+
9+
## Highlights
10+
11+
### **extjs-app-localmailaccount**
12+
With the new authentication package [**extjs-app-localmailaccount**](/docs/api/packages/@conjoon/extjs-app-localmailaccount), you're now able to store multiple Email-Accounts directly on your computer. While the first major release of **conjoon** came bundled with [**extjs-app-imapuser**](/docs/api/packages/@conjoon/extjs-app-imapuser), an auth-package for authorizing against a single IMAP account (that was in particularly developed for free email hosters), this package now focuses on custom installations where users maintain their own instances of **conjoon**.
13+
14+
15+
#### Enabling extjs-app-localmailaccount - Frontend:
16+
The package comes bundled with **conjoon**, so there's nothing left to do for you except for enabling the package. Use the latest version of [**create-conjoon**](/docs/api/misc/@conjoon/create-conjoon) to ease the installation process - it allows you to copy an **official release** to the directory of your previous installation (make sure you read the documentation before you overwrite the directory contents, or if you'd rather get a dev environment for **conjoon** up and running).
17+
18+
Once you have updated, open [`conjoon.conf.json`](/docs/conjoon.conf.json), then look for the section where `extjs-app-imapuser` is configured. Add a property named `disabled` (if not already existing) and set this to `true`.
19+
20+
```json
21+
{
22+
"extjs-app-imapuser": {
23+
"disabled": true
24+
}
25+
}
26+
```
27+
28+
For `extjs-app-localmailaccount`, set the property to `false`:
29+
30+
```json
31+
{
32+
"extjs-app-localmailaccount": {
33+
"disabled": false
34+
}
35+
}
36+
```
37+
38+
:::caution missing configuration for extjs-app-localmailaccount
39+
In case you have no `extjs-app-localmailaccount` existing with your `conjoon.conf.json`,
40+
refer to the [**documentation**](/docs/api/packages/@conjoon/extjs-app-localmailaccount#what-goes-into-an-extjs-app-localmailaccount-configuration) and utilize the default configuration coming with the package.
41+
:::
42+
43+
Once everything is set configured, restarting your instance of **conjoon** should now directly boot to the `MailDesktopView`. A new button will be available in its toolbar:
44+
45+
![](./img/addaccount-btn.png)
46+
47+
Clicking it will open up the `MailAccountWizard` that lets you choose from a set of pre-configured accounts:
48+
49+
![](./img/wizard-step1.png)
50+
51+
:::tip
52+
You can also apply custom mail server information by scrolling down the list and pick the `"...other IMAP account"`-entry.
53+
:::
54+
55+
Once you have provided the required details, the Email Account will be stored in the **Local Storage** of your browser. It is always editable afterwards by selecting the node prepresenting the Email Account from the `MailFolderTree` on the left side of the `MailDesktopView`:
56+
57+
![](./img/account-settings.png)
58+
59+
#### Enabling extjs-app-localmailaccount - Backend:
60+
Please make sure you take a look at the updates that came with the available backends, namely [**lumen-app-email**](https://www.conjoon.org/docs/api/backends/@conjoon/lumen-app-email#configureapi) - you need to update to the latest version to make sure the updated client can properly communicate with the backend.
61+
Make sure you apply the proper api-configuration to your backend instance.
62+
Upgrading to a new version of **lumen-app-email** will also update to the latest version of [**php-lib-conjoon**](https://github.com/conjoon/php-lib-conjoon). Needless to say, **lumen-app-email** is fully backwards compatible.
63+
64+
### Supporting UI-State-management
65+
I have added support for saving the state of the UI so you do not have to expand/collapse various views once you re-enter the application. This is a small qol-improvement for now. The initial support for this opens the door for more improvements in this regard.
66+
67+
## Other changes
68+
69+
Other notable changes include:
70+
71+
- blocked bg-images do not trigger external content warning [conjoon/extjs-app-webmail#284](https://github.com/conjoon/extjs-app-webmail/issues/284)
72+
- replying to email fails after sorting a large grid [conjoon/extjs-app-webmail#270](https://github.com/conjoon/extjs-app-webmail/issues/270)
73+
- onMailDesktopViewShow's internal callback cancels events [conjoon/extjs-app-webmail#283](https://github.com/conjoon/extjs-app-webmail/issues/283)
74+
- opening a message with erroneous key-fragments triggers error [conjoon/extjs-app-webmail#282](https://github.com/conjoon/extjs-app-webmail/issues/282)
75+
onMailAccountActiveChange triggers error if editor with error state is opened [conjoon/extjs-app-webmail#274](https://github.com/conjoon/extjs-app-webmail/issues/274)
76+
- child-folders not loaded when MailDesktopView is not opened via route [conjoon/extjs-app-webmail#256](https://github.com/conjoon/extjs-app-webmail/issues/256)
77+
- icons for mail folder missing upon first expand [conjoon/extjs-app-webmail#281](https://github.com/conjoon/extjs-app-webmail/issues/281)
78+
- error thrown when MailAccountWizard is destroyed and configs are loaded [conjoon/extjs-app-webmail#280](https://github.com/conjoon/extjs-app-webmail/issues/280)
79+
- reading pane button enabled when MailAccountWizard is active [conjoon/extjs-app-webmail#278](https://github.com/conjoon/extjs-app-webmail/issues/278)
80+
- protocol handler for mailto does not consider instance's pathname [conjoon/extjs-app-webmail#268](https://github.com/conjoon/extjs-app-webmail/issues/268)
81+
- button for toggling gridlist gets activated when MailAccountWizard is shown [conjoon/extjs-app-webmail#277](https://github.com/conjoon/extjs-app-webmail/issues/277)

0 commit comments

Comments
 (0)