<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its"
      type="topic" id="customize-ui-items">

  <info>
    <link type="guide" xref="index#common-other-problems" />
    <link type="seealso" xref="mail-layout-changing"/>
    <link type="seealso" xref="calendar-layout"/>

    <revision pkgversion="3.34.0" version="0.3" date="2019-09-28" status="final"/>

    <credit type="author">
      <name its:translate="no">Andre Klapper</name>
      <email its:translate="no">ak-47@gmx.net</email>
    </credit>

    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>

    <desc>Moving and changing tool bar buttons, menu entries, and keyboard shortcuts.</desc>
  </info>

  <title>Customizing tool bar and menu items</title>

<note style="warning">
<p>These steps are for tech savvy users. These steps are not suitable for average users.</p>
</note>

<p><app>Evolution</app> offers no graphical interface to customize its tool bars or items in menus.</p>

<p>Advanced users can experiment by exploring and editing the corresponding system-wide file(s) under <file>$PREFIX/share/evolution/ui/</file>.</p>

<p>Copy those files with the file ending <file>.ui</file> which you would like to modify to your personal configuration folder <file>$HOME/.config/evolution/ui/</file>.
Modify the files in your personal configuration folder so the next <app>Evolution</app> software update will not overwrite your changes.</p>

<p>Changing the order of tool bar/menu items in some <file>.ui</file> files may not affect their displayed order in <app>Evolution</app>. As a workaround, the attribute <code>position='top'</code> can be added to some elements (e.g. <code>toolitem</code> and non-empty <code>placeholder</code> elements), which will place them before other items in the group and cause them to be displayed according to their order in the <file>.ui</file> file. This attribute may need to be added to all items in a group to achieve the overall desired item order.</p>

<p>The modified files will be used if the <code>evolution-ui-version</code> attribute of the root <code>ui</code> element matches the version of the default files provided by <app>Evolution</app>.</p>

<p>To change keyboard shortcuts, edit <file>~/.config/evolution/accels</file> while <app>Evolution</app> is not running. Commented lines start with a <code>;</code> character and will be ignored. Not all shortcuts can be changed though.</p>

</page>
