Difference between revisions of "Kmail/Configuring Kmail"

(small tweaks for easier translation, images should be translatable)
(formatting tweeks)
Line 67: Line 67:
 
Apart from the options presented in the configuration dialog, some options can only be set directly in the KMail configuration file or through KIOSK (eg. Input into '''Konsole'''). These so called “hidden” configuration options cannot be changed via the normal '''KMail''' Settings dialog; they must be made by modifying the configuration file using a text editor or the kwriteconfig program. The configuration file is to be written in the format of [Section Name] and the following lines are the variables and their settings. If you are manually editing the configuration file you will need to add the [Section Name] before adding variables. The kwriteconfig will add the section for you as long as you use the <code>--group</code> switch.
 
Apart from the options presented in the configuration dialog, some options can only be set directly in the KMail configuration file or through KIOSK (eg. Input into '''Konsole'''). These so called “hidden” configuration options cannot be changed via the normal '''KMail''' Settings dialog; they must be made by modifying the configuration file using a text editor or the kwriteconfig program. The configuration file is to be written in the format of [Section Name] and the following lines are the variables and their settings. If you are manually editing the configuration file you will need to add the [Section Name] before adding variables. The kwriteconfig will add the section for you as long as you use the <code>--group</code> switch.
 
The '''KMail''' configuration file is called kmailrc and can be found in your home directory. The location can vary according to your operating system or distribution, but can always be found by running the command  
 
The '''KMail''' configuration file is called kmailrc and can be found in your home directory. The location can vary according to your operating system or distribution, but can always be found by running the command  
<code>kde4-config --path config --locate</code> '''''kmailrc'''''. For the remainder of this section, assume that the configuration file is located in '''''/path/to/kmailrc'''''.  
+
<code>kde4-config --path config --locate kmailrc</code>. For the remainder of this section, assume that the configuration file is located in <tt>/path/to/kmailrc</tt>.  
{{Warning|Whenever changing these options, make sure to quit '''KMail''' first before editing the configuration file. Only restart '''KMail''' after you have made and saved the changes to the configuration file.}}  
+
 
 +
{{Warning|1=Whenever changing these options, make sure to quit '''KMail''' first before editing the configuration file. Only restart '''KMail''' after you have made and saved the changes to the configuration file.}}  
  
 
* Send Message Distribution Notifications with an empty sender string (SendMDNsWithEmptySender)
 
* Send Message Distribution Notifications with an empty sender string (SendMDNsWithEmptySender)
  
 
Some servers might be configured to reject such messages, so if you are experiencing problems sending MDNs, make sure this option is set to false.
 
Some servers might be configured to reject such messages, so if you are experiencing problems sending MDNs, make sure this option is set to false.
To enable this feature, add to the <menuchoice>[MDN]</menuchoice> section: <br />
+
To enable this feature, add to the '''[MDN]''' section of the Configuration File:
'''Configuration File:'''
+
 
<menuchoice>SendMDNsWithEmptySender</menuchoice>='''''true'''''<br />
+
{{Input|1=SendMDNsWithEmptySender=true}}
If there is no such section, simply add [MDN]on a line by itself just above the option.  
+
 
'''Input into '''Konsole''':
+
If there is no such section, simply add <code>[MDN]</code> on a line by itself just above the option.  
<code>kwriteconfig --file '''''/path/to/kmailrc''''' --group MDN --key SendMDNsWithEmptySender '''''true''''' </code><br />
+
Alternatively, input the following into '''Konsole''':
 +
 
 +
{{Input|1=kwriteconfig --file <tt>/path/to/kmailrc</tt> --group MDN --key SendMDNsWithEmptySender true}}
 +
 
 
{{Note|The default setting of “false” strictly speaking violates Internet standards, but is set that way for practical reasons, to avoid servers rejecting MDNs that '''KMail''' generates because they think they are SPAM. }}
 
{{Note|The default setting of “false” strictly speaking violates Internet standards, but is set that way for practical reasons, to avoid servers rejecting MDNs that '''KMail''' generates because they think they are SPAM. }}
  
 
* MaximumAttachmentSize
 
* MaximumAttachmentSize
  
This allows the maximum filesize allowed for attachments in the mail composer to be limited. To limit attachments to 20 MB in size, for example, add a line under <menuchoice>[Composer]</menuchoice> section: <br />
+
This allows the maximum filesize allowed for attachments in the mail composer to be limited. To limit attachments to 20 MB in size, for example, add a line under '''[Composer]''' section of the Configuration File:
'''Configuration File:'''
+
 
<menuchoice>MaximumAttachmentSize</menuchoice>='''''20'''''<br />
+
{{Input|1=MaximumAttachmentSize=20}}
'''Input into '''Konsole''':
+
 
<code>kwriteconfig --file '''''/path/to/kmailrc''''' --group Composer --key MaximumAttachmentSize '''''20'''''</code><br />
+
Alternatively, input the following into '''Konsole''':
+
 
 +
{{Input|1=kwriteconfig --file <tt>/path/to/kmailrc</tt> --group Composer --key MaximumAttachmentSize 20}}
 +
 
 
* CloseDespiteSystemTray
 
* CloseDespiteSystemTray
  
This option allows you to configure the application to close fully, even if there is a system tray icon configured, which would normally keep the application running. To enable the feature, add a line under <menuchoice>[General]</menuchoice> section: <br />
+
This option allows you to configure the application to close fully, even if there is a system tray icon configured, which would normally keep the application running. To enable the feature, add a line under '''[General]''' section of the Configuration File:
'''Configuration File:'''
+
 
<menuchoice>CloseDespiteSystemTray</menuchoice>='''''true'''''<br />
+
{{Input|1=CloseDespiteSystemTray=true}}
'''Input into '''Konsole''':
+
 
<code>kwriteconfig --file '''''/path/to/kmailrc''''' --group General --key CloseDespiteSystemTray '''''true'''''</code><br />
+
Alternatively, input the following into '''Konsole''':
 +
 
 +
{{Input|1=kwriteconfig --file <tt>/path/to/kmailrc</tt> --group General --key CloseDespiteSystemTray true}}
  
 
==== OutOfOffice Specific ====
 
==== OutOfOffice Specific ====
  
When manually entering entries into the configuration file, and there is no such section, simply add [OutOfOffice]on a line by itself just above the option. Applying defaults to the out-of-office configuration dialog via the corresponding button will restore this domain, in case the user has changed it.   
+
When manually entering entries into the configuration file, and there is no such section, simply add <code>[OutOfOffice]</code> on a line by itself just above the option. Applying defaults to the out-of-office configuration dialog via the corresponding button will restore this domain, in case the user has changed it.   
  
 
* CheckOutOfOfficeOnStartup
 
* CheckOutOfOfficeOnStartup
  
With this option enabled, '''KMail''' will check on every startup if there is an active out-of-office configured and show a warning if this is the case. To disable the feature, add a line under <menuchoice>[OutOfOffice]</menuchoice> section: <br />
+
With this option enabled, '''KMail''' will check on every startup if there is an active out-of-office configured and show a warning if this is the case. To disable the feature, add a line under '''[OutOfOffice]''' section of the Configuration File:
'''Configuration File:'''
+
 
<menuchoice>CheckOutOfOfficeOnStartup</menuchoice>='''''false'''''<br />
+
{{Input|1=CheckOutOfOfficeOnStartup=false}}
'''Input into '''Konsole''':
+
 
<code>kwriteconfig --file '''''/path/to/kmailrc''''' --group OutOfOffice --key CheckOutOfOfficeOnStartup '''''false'''''</code><br />
+
Alternatively, input the following into '''Konsole''':
 +
 
 +
{{Input|1=kwriteconfig --file <tt>/path/to/kmailrc</tt> --group OutOfOffice --key CheckOutOfOfficeOnStartup false}}
  
 
* Allow out-of-office settings to be adjusted by the user.
 
* Allow out-of-office settings to be adjusted by the user.
  
In case you don't want users to be able to upload their own out-of-office scripts to the server you can add to the <menuchoice>[OutOfOffice]</menuchoice> section : <br />
+
In case you don't want users to be able to upload their own out-of-office scripts to the server you can add to the '''[OutOfOffice]''' section of the Configuration File:
'''Configuration File:'''
+
 
<menuchoice>AllowOutOfOfficeSettings</menuchoice>='''''false'''''<br />
+
{{Input|1=AllowOutOfOfficeSettings=false}}
If there is no such section, simply add "[OutOfOffice]" on a line by itself just above the option.
+
 
'''Input into '''Konsole''':
+
If there is no such section, simply add <code>[OutOfOffice]</code> on a line by itself just above the option.
<code>kwriteconfig --file '''''/path/to/kmailrc''''' --group OutOfOffice --key AllowOutOfOfficeSettings '''''false'''''</code><br />
+
Alternatively, input the following into '''Konsole''':
 +
 
 +
{{Input|1=kwriteconfig --file <tt>/path/to/kmailrc</tt> --group OutOfOffice --key AllowOutOfOfficeSettings false}}
 
    
 
    
 
* Allow out-of-office scripts to be uploaded by the user, but no settings changed.
 
* Allow out-of-office scripts to be uploaded by the user, but no settings changed.
  
If you want to allow your users to upload their own out-of-office scripts but you do not want them to be able to change the domain to react to and the react-to-spam setting, you can add to the <menuchoice>[OutOfOffice]</menuchoice> section : <br />
+
If you want to allow your users to upload their own out-of-office scripts but you do not want them to be able to change the domain to react to and the react-to-spam setting, you can add to the '''[OutOfOffice]''' section of the Configuration File:
'''Configuration File:'''
+
 
<menuchoice>AllowOutOfOfficeUploadButNoSettings</menuchoice>='''''true'''''<br />
+
{{Input|1=AllowOutOfOfficeUploadButNoSettings=true}}
'''Input into '''Konsole''':
+
 
 +
<!-- Uncomment if correct
 +
Alternatively, input the following into '''Konsole''':
 +
 
 +
{{Input|1=kwriteconfig --file <tt>/path/to/kmailrc</tt> --group OutOfOffice --key AllowOutOfOfficeUploadButNoSettings true}}
 +
-->
  
 
* Default domain to limit out-of-office replies to.
 
* Default domain to limit out-of-office replies to.
  
When editing vacation (out-of-office) scripts, the user can specify a domain to limit the sending of such replies to. To pre-load this setting with a default value, add to the <menuchoice>[OutOfOffice]</menuchoice> section :<br /> 
+
When editing vacation (out-of-office) scripts, the user can specify a domain to limit the sending of such replies to. To pre-load this setting with a default value, add to the '''[OutOfOffice]''' section of the Configuration File:
'''Configuration File:'''
+
 
<menuchoice>OutOfOfficeDomain</menuchoice>='''''myMailDomain.test'''''<br />
+
{{Input|1=OutOfOfficeDomain=myMailDomain.test}}
*Enable sending of out-of-office replies to messages marked as SPAM.
+
 
By default, out-of-office replies are not sent to messages marked as SPAM. To override this behavior, add to the <menuchoice>[OutOfOffice]</menuchoice> section : <br />
+
<!-- Uncomment if correct
'''Configuration File:'''
+
Alternatively, input the following into '''Konsole''':
<menuchoice>OutOfOfficeReactToSpam</menuchoice>='''''true'''''<br />
+
 
 +
{{Input|1=kwriteconfig --file <tt>/path/to/kmailrc</tt> --group OutOfOffice --key OutOfOfficeDomain myMailDomain.test}}
 +
-->
 +
 
 +
* Enable sending of out-of-office replies to messages marked as SPAM.
 +
 
 +
By default, out-of-office replies are not sent to messages marked as SPAM. To override this behavior, add to the '''[OutOfOffice]''' section of the Configuration File:
 +
 
 +
{{Input|1=OutOfOfficeReactToSpam=true}}
 
   
 
   
 +
<!-- Uncomment if correct
 +
Alternatively, input the following into '''Konsole''':
 +
 +
{{Input|1=kwriteconfig --file <tt>/path/to/kmailrc</tt> --group OutOfOffice --key OutOfOfficeReactToSpam true}}
 +
-->
 +
 
* disregardUmask
 
* disregardUmask
  
In versions prior to 1.9, KMail saved all attachments to disk with permissions set to 600 — only readable or writable by the owner of the file. In response to user feedback, this was made configurable in KMail version 1.9, with the defaults changed to honour the umask set on the user account while saving files to disk. To enable this feature, add under <menuchoice>[General]</menuchoice> section: <br />
+
In versions prior to 1.9, KMail saved all attachments to disk with permissions set to 600 — only readable or writable by the owner of the file. In response to user feedback, this was made configurable in KMail version 1.9, with the defaults changed to honour the umask set on the user account while saving files to disk. To enable this feature, add under '''[General]''' section of the Configuration File:
'''Configuration File:'''
+
 
<menuchoice>disregardUmask</menuchoice>='''''true'''''<br />
+
{{Input|1=disregardUmask=true}}
<code>kwriteconfig --file '''''/path/to/kmailrc''''' --group General --key disregardUmask '''''true'''''</code><br />
+
 
 +
Alternatively, input the following into '''Konsole''':
 +
 
 +
{{Input|1=kwriteconfig --file <tt>/path/to/kmailrc</tt> --group General --key disregardUmask true}}
  
 
* AutoLostFoundMove
 
* AutoLostFoundMove
Line 147: Line 181:
 
'''Configuration File:'''
 
'''Configuration File:'''
  
 +
* ShowUserAgent
  
* ShowUserAgent
+
Starting in version 1.9, KMail can show the User-Agent or X-Mailer value from the message header when using Fancy Headers (see <menuchoice>View → Headers</menuchoice> menu). To enable this feature, add under '''[Reader]''' section of the Configuration File:
 +
 
 +
{{Input|1=ShowUserAgent=true}}
 +
 
 +
Alternatively, input the following into '''Konsole''':
  
Starting in version 1.9, KMail can show the User-Agent or X-Mailer value from the message header when using Fancy Headers (see <menuchoice>View → Headers</menuchoice> menu). To enable this feature, add under <menuchoice>[Reader] </menuchoice> section: <br />
+
{{Input|1=kwriteconfig --file <tt>/path/to/kmailrc</tt> --group Reader --key ShowUserAgent true}}
'''Configuration File:'''
 
<menuchoice>ShowUserAgent</menuchoice>='''''true'''''<br />
 
<code>kwriteconfig --file '''''/path/to/kmailrc''''' --group Reader --key ShowUserAgent '''''true'''''</code><br />
 
  
 
[[Category:Office]]
 
[[Category:Office]]
 
</translate>
 
</translate>

Revision as of 18:16, 21 December 2013

Under construction.png
Under Construction
This is a new page, currently under construction!


Other languages:

Configuring KMail

Configure Kmail

KMail configuration can be reached through Settings → Configure KMail.... Listed below are the links to the many configuration options in KMail.

Identities

Accounts

You can quickly set up new accounts with the Account Wizard. The following describes the manual configuration tabs. This page allows you to create one or more (incoming and outgoing) accounts, i.e. combinations of mail servers, login information and other settings. Typically, you will create one incoming (used to retrieve messages) and one outgoing (used for sending messages) account. You can create as many accounts as you want, though, and assign each one to different identities or decide on a per-message basis.

Appearance

Composer

Security

Misc

Options without a user interface representation

Apart from the options presented in the configuration dialog, some options can only be set directly in the KMail configuration file or through KIOSK (eg. Input into Konsole). These so called “hidden” configuration options cannot be changed via the normal KMail Settings dialog; they must be made by modifying the configuration file using a text editor or the kwriteconfig program. The configuration file is to be written in the format of [Section Name] and the following lines are the variables and their settings. If you are manually editing the configuration file you will need to add the [Section Name] before adding variables. The kwriteconfig will add the section for you as long as you use the --group switch. The KMail configuration file is called kmailrc and can be found in your home directory. The location can vary according to your operating system or distribution, but can always be found by running the command kde4-config --path config --locate kmailrc. For the remainder of this section, assume that the configuration file is located in /path/to/kmailrc.

Warning.png
Warning
Whenever changing these options, make sure to quit KMail first before editing the configuration file. Only restart KMail after you have made and saved the changes to the configuration file.


  • Send Message Distribution Notifications with an empty sender string (SendMDNsWithEmptySender)

Some servers might be configured to reject such messages, so if you are experiencing problems sending MDNs, make sure this option is set to false. To enable this feature, add to the [MDN] section of the Configuration File:

SendMDNsWithEmptySender=true

If there is no such section, simply add [MDN] on a line by itself just above the option. Alternatively, input the following into Konsole:

kwriteconfig --file /path/to/kmailrc --group MDN --key SendMDNsWithEmptySender true
Note
The default setting of “false” strictly speaking violates Internet standards, but is set that way for practical reasons, to avoid servers rejecting MDNs that KMail generates because they think they are SPAM.


  • MaximumAttachmentSize

This allows the maximum filesize allowed for attachments in the mail composer to be limited. To limit attachments to 20 MB in size, for example, add a line under [Composer] section of the Configuration File:

MaximumAttachmentSize=20

Alternatively, input the following into Konsole:

kwriteconfig --file /path/to/kmailrc --group Composer --key MaximumAttachmentSize 20
  • CloseDespiteSystemTray

This option allows you to configure the application to close fully, even if there is a system tray icon configured, which would normally keep the application running. To enable the feature, add a line under [General] section of the Configuration File:

CloseDespiteSystemTray=true

Alternatively, input the following into Konsole:

kwriteconfig --file /path/to/kmailrc --group General --key CloseDespiteSystemTray true

OutOfOffice Specific

When manually entering entries into the configuration file, and there is no such section, simply add [OutOfOffice] on a line by itself just above the option. Applying defaults to the out-of-office configuration dialog via the corresponding button will restore this domain, in case the user has changed it.

  • CheckOutOfOfficeOnStartup

With this option enabled, KMail will check on every startup if there is an active out-of-office configured and show a warning if this is the case. To disable the feature, add a line under [OutOfOffice] section of the Configuration File:

CheckOutOfOfficeOnStartup=false

Alternatively, input the following into Konsole:

kwriteconfig --file /path/to/kmailrc --group OutOfOffice --key CheckOutOfOfficeOnStartup false
  • Allow out-of-office settings to be adjusted by the user.

In case you don't want users to be able to upload their own out-of-office scripts to the server you can add to the [OutOfOffice] section of the Configuration File:

AllowOutOfOfficeSettings=false

If there is no such section, simply add [OutOfOffice] on a line by itself just above the option. Alternatively, input the following into Konsole:

kwriteconfig --file /path/to/kmailrc --group OutOfOffice --key AllowOutOfOfficeSettings false
  • Allow out-of-office scripts to be uploaded by the user, but no settings changed.

If you want to allow your users to upload their own out-of-office scripts but you do not want them to be able to change the domain to react to and the react-to-spam setting, you can add to the [OutOfOffice] section of the Configuration File:

AllowOutOfOfficeUploadButNoSettings=true


  • Default domain to limit out-of-office replies to.

When editing vacation (out-of-office) scripts, the user can specify a domain to limit the sending of such replies to. To pre-load this setting with a default value, add to the [OutOfOffice] section of the Configuration File:

OutOfOfficeDomain=myMailDomain.test


  • Enable sending of out-of-office replies to messages marked as SPAM.

By default, out-of-office replies are not sent to messages marked as SPAM. To override this behavior, add to the [OutOfOffice] section of the Configuration File:

OutOfOfficeReactToSpam=true


  • disregardUmask

In versions prior to 1.9, KMail saved all attachments to disk with permissions set to 600 — only readable or writable by the owner of the file. In response to user feedback, this was made configurable in KMail version 1.9, with the defaults changed to honour the umask set on the user account while saving files to disk. To enable this feature, add under [General] section of the Configuration File:

disregardUmask=true

Alternatively, input the following into Konsole:

kwriteconfig --file /path/to/kmailrc --group General --key disregardUmask true
  • AutoLostFoundMove

Activate this option to automate the handling of not yet uploaded messages in disconnected IMAP folders that cannot be uploaded. This can happen if the folder was removed from the server or your access rights have been restricted. Such messages will automatically be moved to a newly created lost+found folder if this option is enabled; you will be asked how to proceed every time otherwise. Configuration File:

  • ShowUserAgent

Starting in version 1.9, KMail can show the User-Agent or X-Mailer value from the message header when using Fancy Headers (see View → Headers menu). To enable this feature, add under [Reader] section of the Configuration File:

ShowUserAgent=true

Alternatively, input the following into Konsole:

kwriteconfig --file /path/to/kmailrc --group Reader --key ShowUserAgent true

This page was last edited on 21 December 2013, at 18:16. Content is available under Creative Commons License SA 4.0 unless otherwise noted.