<?xml version="1.0" encoding="UTF-8"?>
<chapter id="details.settings">
<chapterinfo>
  <authorgroup>
    <author
>&Roger.Lum; &Roger.Lum.mail; </author>
  </authorgroup>
  <date
>2014-08-30</date>
  <releaseinfo
>4.7.01</releaseinfo>
</chapterinfo>

<title id="details.settings.title"
>&kappname;-instellingen</title>

<para
>De onderstaand beschreven instellingen wijzigen het gedrag van &kappname;. Deze instellingen kunnen worden gewijzigd via <menuchoice
><guimenu
>Instellingen</guimenu
><guimenuitem
>&kappname; instellen...</guimenuitem
></menuchoice
>. </para>

<sect1 id="details.settings.general">
<title id="details.settings.general.title"
>Algemeen</title>

<sect2 id="details.settings.general.global">
<title
>Globale opties</title>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Koersnauwkeurigheid</guilabel
></term>
    <listitem>
      <para
>Voer in hoeveel cijfers precisie, na de decimale komma, uw prijzen moeten hebben. Dit bijvoorbeeld instellen op 2 zal resulteren in prijzen als 35,18, terwijl instellen op 4 dezelfde prijs kan tonen als 35,1791</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Sla op elke</guilabel
></term>
    <listitem>
      <para
>Activeer dit vakje als u wilt dat &kappname; uw bestanden periodiek opslaat. De standaard is elke 10 minuten.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Uw fiscale jaar start op</guilabel
></term>
    <listitem>
      <para
>Voer de begindag en maand van uw fiscale jaar in</para>
    </listitem>
  </varlistentry>
  <!-- FIXME missing Calculator -->
</variablelist>
</sect2>

<sect2 id="details.settings.general.views">
<title
>Opties voor weergave</title>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Opstarten</guilabel
></term>
    <listitem>
      <para
>Kies de initiële weergave bij opstarten.</para>
      <itemizedlist>
        <listitem
><para
>Start met de <link linkend="firsttime.mainwindow"
>beginpagina</link
></para
></listitem>
        <listitem
><para
>Start met de laatst gekozen pagina</para
></listitem>
      </itemizedlist>
    </listitem>
  </varlistentry>
  <!-- FIXME missing Type of KMyMoney view -->
  <varlistentry>
    <term
><guilabel
>De titelbalk op elke pagina weergeven</guilabel
></term>
    <listitem>
      <para
>Of de titel van de huidige weergave getoond moet worden op elke pagina.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Synchroniseer rekening selectie van het kasboek met het Investeringen overzicht</guilabel
></term>
    <listitem>
      <para
>If this option is selected, selecting an account on the investments view will change the account selection on the ledger view, and viceversa.</para>
    </listitem>
  </varlistentry>
<!-- FIXME not in master
  <varlistentry>
    <term
><guilabel
>Icon size of navigation bar</guilabel
></term>
    <listitem>
      <para
>Select the size of the icons of the left-side navigation bar.</para>
    </listitem>
  </varlistentry>
  -->
</variablelist>
</sect2>

<sect2 id="details.settings.general.filter">
<title
>Filteropties</title>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Ongebruikte categorieën niet tonen</guilabel
></term>
    <listitem>
      <para
>Verberg niet gebruikte categorieën</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Gesloten rekeningen niet tonen</guilabel
></term>
    <listitem>
      <para
>Verberg gesloten rekeningen</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Aandelenrekeningen tonen</guilabel
></term>
    <listitem>
      <para
>Accounts met aandelen worden normaal verborgen. Selecteer deze optie om ze te tonen.</para>
    </listitem>
  </varlistentry>
  <!--FIXME missing Show in categories account list view-->
  <varlistentry>
    <term
><guilabel
>Afgesloten periodieke transacties niet tonen</guilabel
></term>
    <listitem>
      <para
>Verberg afgehandelde periodieke transacties</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Geen transacties tonen van voor</guilabel
></term>
    <listitem>
      <para
>Transacties verbergen van voor de geselecteerde datum.</para>
      <para
>Setting this option to January 1, 1900 is a good way to debug date-related file import problems.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Gecontroleerde transacties niet tonen</guilabel
></term>
    <listitem>
      <para
>Filter transactions by reconciliation state. Transactions that are marked as <emphasis
>Reconciled</emphasis
> will not be shown.</para>
    </listitem>
  </varlistentry>
</variablelist>
</sect2>
</sect1>

<sect1 id="details.settings.home">
<title id="details.settings.home.title"
>Hoofdpagina</title>

<para
>These options allow you to customize the appearance of the Home page by choosing which entries to show on the Home page and the order in which they appear. </para>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Bezittingen en schulden</guilabel
></term>
    <listitem>
      <para
>Het toont de balans tussen al uw bezittingen en schulden</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Betalingen</guilabel
></term>
    <listitem>
      <para
>Het toont de eerste 5 gebeurtenissen van uw geplande transacties</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Voorkeursrekeningen</guilabel
></term>
    <listitem>
      <para
>Het toont het saldo en credit van uw rekeningen met voorkeur</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>rekening voor betalingen</guilabel
></term>
    <listitem>
      <para
>Het toont de saldo's van uw activa- en passiva-rekening, behalve voor de investeringsrekeningen</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Favoriete Rapporten</guilabel
></term>
    <listitem>
      <para
>Het toont een lijst met uw rapporten met voorkeur</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Prognose (periode)</guilabel
></term>
    <listitem>
      <para
>Het toont een prognose voor uw activa- en passiva-rekeningen</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Netto waarde prognose</guilabel
></term>
    <listitem>
      <para
>It shows a chart of your forecast net worth for the next 90 days</para>
    </listitem>
  </varlistentry>
<!--FIXME
  <varlistentry>
    <term
><guilabel
>Forecast (history)</guilabel
></term>
    <listitem>
      <para
>???</para>
    </listitem>
  </varlistentry>
-->
  <varlistentry>
    <term
><guilabel
>Budget</guilabel
></term>
    <listitem>
      <para
>It shows the budget items for the current month which have a negative difference compared to the actual income or expense</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Cashflow</guilabel
></term>
    <listitem>
      <para
>It shows an analysis of your cash flow for the current month</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Percentage van standaard lettertype</guilabel
></term>
    <listitem>
      <para
>Select the size of the font on the Home page</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Onthoud grootte van lettertype als het programma wordt afgesloten bij handmatig wijzigen met het muiswiel</guilabel
></term>
    <listitem>
      <para
>Selecting this will save your font size preference if you have changed it from the Home page by using the mouse-wheel</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Toon informatie over de rekeninglimiet</guilabel
></term>
    <listitem>
      <para
>Shows the limit of the accounts on the Payment Accounts and Preferred Accounts sections of the Home page</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Toon de status van het saldo van zichtbare online rekeningen</guilabel
></term>
    <listitem>
      <para
>Shows the balance-status of mapped accounts on the Assets and Liabilities Summary, the Payment Accounts and the Preferred Accounts sections of the Home page. The balance-status is symbolized by an icon in the columns preceding the account names. A green checkmark is displayed when online-balance and local file balance are in sync. If the local file has transactions newer than the previously online-updated ones a mailbox with a green arrow gets shown. This alerts the user to start an online-update. Mismatching local file and online-balances are highlighted by a red warning sign. </para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Aantal niet gemarkeerde transacties per rekening tonen [!M]</guilabel
></term>
    <listitem>
      <para
>Insert an additional column between account name and current balance showing the number of not marked transactions for the accounts on the Assets and Liabilities Summary, the Payment Accounts and Preferred Accounts sections of the Home page </para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Aantal vrijgegeven transacties per rekening tonen [C]</guilabel
></term>
    <listitem>
      <para
>Insert an additional column between account name and current balance showing the number of cleared transactions for the accounts on the Assets and Liabilities Summary, the Payment Accounts and Preferred Accounts sections of the Home page </para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Aantal niet gecontroleerde (niet gemarkeerd + vrijgegeven) transacties per rekening tonen [!R]</guilabel
></term>
    <listitem>
      <para
>Insert an additional column between account name and current balance showing the number of not reconciled transactions (i.e. the sum of all not marked and cleared transactions) for the accounts on the Assets and Liabilities Summary, the Payment Accounts and Preferred Accounts sections of the Home page</para>
    </listitem>
  </varlistentry>

</variablelist>
</sect1>

<sect1 id="details.settings.register">
<title id="details.settings.register.title"
>Ledger</title>

<para
>These options allow you to modify the behavior of the transaction registers. </para>

<sect2 id="details.settings.register.display"
><title
>Weergavetabblad</title>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Toon een raster in het kasboek</guilabel
></term>
    <listitem>
      <para
>Show grid lines in the transaction register.</para>
    </listitem>
  </varlistentry>
  <!--FIXME missing Show all register entries in full detail-->
  <varlistentry id="details.settings.register.lens">
    <term
><guilabel
>De kasboeklens gebruiken</guilabel
></term>
    <listitem>
      <para
>With this option enabled, the ledger will show all lines of detail for the transaction you have currently selected, even if you have set the <link linkend="reference.menus.settings.transactiondetail"
>Show Transaction Detail</link
> menu option turned off.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
  <term
><guilabel
>Transactieformulier tonen</guilabel
></term>
    <listitem>
      <para
>Show the <link linkend="details.ledger.transactionform"
>transaction form</link
> at the bottom of the transaction register for entering and editing transactions. With this option turned off, you edit the transaction within the register itself.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Toon altijd een Nr. veld</guilabel
></term>
    <listitem>
      <para
>Always have the number (<quote
>No.</quote
>) field when entering or editing a transaction.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Toon groepering regel tussen de transacties</guilabel
></term>
    <listitem>
      <para
>Display group headers in the register</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Toon kop voor het vorige en het huidige fiscale jaar </guilabel
></term>
    <listitem>
      <para
>Display group headers for the current and the previous fiscal year</para>
    </listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="details.settings.register.sorting">
<title
>Sorting tab</title>
<sect3 id="details.settings.register.sorting.normal">
<title
>Normal view tab</title>

<para
>Choose the sort order of the ledger while in the Normal view. </para>
</sect3>

<sect3 id="details.settings.register.sorting.reconciliation">
<title
>Reconciliation view tab</title>

<para
>Choose the sort order of the ledger while in the Reconciliation view. </para>
</sect3>

<sect3 id="details.settings.register.sorting.search">
<title
>Search view tab</title>
<para
>Choose the sort order of the ledger while in the Search view. </para>
</sect3>
</sect2>

<sect2 id="details.settings.register.dataentry">
<title
>Data Entry tab</title>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Transactie type invoegen in Nr. veld voor nieuwe transacties</guilabel
></term>
    <listitem>
      <para
>Automatically place the type of the transaction, &eg;., Deposit, Withdrawal, etc., in the No. field.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Automatisch ophogen controle nummer</guilabel
></term>
    <listitem>
      <para
>Have the check number automatically increment whenever entering a new check transaction.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Bewaar wijzigingen als u een andere transactie of splitsing selecteert</guilabel
></term>
    <listitem>
      <para
>When enabled, selecting a different transaction or split will save edits to the current transaction.</para>
      <para
>When disabled, selecting a different transaction will cancel them. Instead, you must explicitly accept the changes.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Gebruik Enter om te schakelen tussen velden</guilabel
></term>
    <listitem
><para
>When enabled, pressing Enter will change the focus to the next field of the transaction form.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Namen vanaf het begin overeen laten komen</guilabel
></term>
    <listitem>
      <para
>Mark this option if you always want to match names &eg;, for payees from the start. If unset, any substring is matched</para>
    </listitem>
  </varlistentry>
  <!--FIXME missing Automatic reconciliation-->
  <varlistentry>
    <term
><guilabel
>Standaard transactie controle status</guilabel
></term>
    <listitem>
      <para
>Select the default reconciliation state for new transactions.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Automatisch vullen</guilabel
></term>
    <listitem>
      <para
>Select the desired behavior for autofill or deactivate it</para>
      <itemizedlist>
        <listitem>
          <para
>Niet automatisch invullen</para>
        </listitem>
        <listitem>
          <para
>Same transaction if amount differs less than X percent</para>
          <para
>When entering a new transaction with this option, &kappname; will display a list of previous transaction for the payee and account. If previous transactions differ in less than X percent, they will be considered identical. If the percentage is 0, all previous transactions for the payee and account will be displayed. When selecting a transaction, all transactions details except the date will be autofilled with those of the selected transaction.</para>
        </listitem>
        <listitem>
          <para
>Inclusief de meest gebruikte transactie voor deze begunstigde</para>
          <para
>When entering a new transaction with this option enabled, &kappname; will fill in all the transaction details based on the previously most often used transaction with the selected payee.</para>
        </listitem>
      </itemizedlist>
    </listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2 id="details.settings.register.import">
<title
>Import tab</title>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Match transaction within days</guilabel
></term>
    <listitem>
      <para
>Search for matching transactions within the range of the imported transaction +/- given days</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Naar de standaard categorie vragen voor een nieuwe begunstigde</guilabel
></term>
    <listitem>
      <para
>Whenever a new payee is detected during an import, the user will be asked for the default category for the payee.</para>
    </listitem>
  </varlistentry>
</variablelist>
</sect2>
</sect1>

<sect1 id="details.settings.schedules">
<title id="details.settings.schedules.title"
>Periodieke Transacties</title>

<para
>These options allow you to modify the behavior of the <link linkend="details.schedules"
>scheduling features</link
>. </para>

<sect2 id="details.settings.schedules.startupoptions">
<title
>Schedule startup options</title>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Periodieke transacties nakijken bij opstarten</guilabel
></term>
    <listitem>
      <para
>Enables checking the schedule upon startup of &kappname;.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Transacties dit aantal dagen van te voren invoeren</guilabel
></term>
    <listitem
><para
>Specify how many days in advance should the scheduled transactions be entered.</para>
    </listitem>
  </varlistentry>
  <!--FIXME missing Processing Days-->
  <varlistentry>
    <term
><guilabel
>Aantal toekomstige dagen zichtbaar in het kasboek</guilabel
></term>
    <listitem>
      <para
>Specify how many days should the schedules show up in the ledger.</para>
      <para
>The scheduled transactions will be listed in the ledger. You can enter or skip the scheduled transactions by right-clicking on them.</para>
    </listitem>
  </varlistentry>
</variablelist>
</sect2>
</sect1>

<sect1 id="details.settings.onlinequote">
<title id="details.settings.onlinequote.title"
>Online koersen</title>

<para
>These settings modify how online quotes are retrieved from different online sources. </para>

<para
>This tab allows you to change the online quote sources for &kappname;. Generally speaking, this is an advanced feature, and should only be attempted by the most technically adept users. </para>

<para
>For more details, please refer to the <link linkend="details.investments.onlinequotes"
>Online Price Quotes</link
> section. </para>
</sect1>

 <!-- FIXME Reports page missing-->

<sect1 id="details.settings.forecast">
<title id="details.settings.forecast.title"
>Prognose</title>

<para
>These options allow you to modify how the forecast is calculated. </para>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Aantal dagen te prognotiseren</guilabel
></term>
    <listitem>
      <para
>Selecteer voor hoeveel dagen u een prognode wilt maken. De standaard is 90 dagen</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Aantal dagen voor rekeningcyclus</guilabel
></term>
    <listitem>
      <para
>The normal number of days that your commonly-used accounts go through an income-expense cycle. For example, if you receive your salary on a monthly basis, you should select 30 days here.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Dag van de maand waarop de prognose start</guilabel
></term>
    <listitem>
      <para
>Select the day of the month when you want to start the forecast. This would usually be the day when you receive your salary or other income.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Prognosemethode</guilabel
></term>
    <listitem>
      <para
>De te gebruiken prognosemethode.</para>
      <para
>Scheduled and future transaction forecasts your balance based on the information of your scheduled and future transactions.</para>
      <para
>History-based uses your past transactions to extrapolate a forecast.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Aantal cycli te gebruiken in de prognose</guilabel
></term>
    <listitem>
      <para
>If using a history-based method, how many previous account cycles should &kappname; use to calculate the forecast.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Prognose op basis van historie</guilabel
></term>
    <listitem>
      <para
>Select the method to use when calculating a forecast based on historic information</para>
      <para
>Simple moving average averages your past transactions to calculate a forecast.</para>
      <para
>Weighted moving average averages your past transactions, but it will give more importance to the most recent transactions.</para>
      <para
>Linear regression uses a linear-regression formula based on your past transactions to calculate the forecast</para>
    </listitem>
  </varlistentry>
</variablelist>
</sect1>

<sect1 id="details.settings.encryption">
<title id="details.settings.encryption.title"
>Versleuteling</title>

<para
>These options allow you to modify the data encryption settings. </para>

<variablelist>
  <varlistentry>
    <term
><guilabel
>GPG-versleuteling gebruiken</guilabel
></term>
    <listitem>
      <para
>Enables the use of GPG to encrypt data file. See the section on <link linkend="details.formats.encrypted"
>GPG Encryption</link
> for more details.</para>
    </listitem>
  </varlistentry>
</variablelist>

<sect2 id="details.settings.encryption.gpgencryption">
<title
>GPG-versleuteling</title>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Uw sleutel</guilabel
></term>
    <listitem>
      <para
>Enter the email address or the hexadecimal key id to use for data encryption.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Additionele sleutels</guilabel
></term>
    <listitem>
      <para
>Select additional keys to use for data encryption.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Also encrypt with kmymoney-recover key</guilabel
></term>
    <listitem>
      <para
>Encrypts data with the &kappname; recover key. Selecting this option will allow core &kappname; developers to decrypt your data file in case you lose your encryption key.</para>
    </listitem>
  </varlistentry>
</variablelist>
</sect2>
</sect1>

<sect1 id="details.settings.colors">
<title id="details.settings.colors.title"
>Kleuren</title>

<para
>Deze opties stellen u in staat de kleuren in &kappname; te wijzigen. </para>

<sect2 id="details.settings.colors.foreground">
<title
>Voorgrondtabblad</title>

<para
>Modify any of the foreground colors by clicking on the color button and opening a color select palette. </para>
</sect2>

<sect2 id="details.settings.colors.background">
<title
>Achtergrondtabblad</title>

<para
>Modify any of the background colors by clicking on the color button and opening a color select palette. </para>

<para
>Note the <guilabel
>Use system colors</guilabel
> checkbox at the top of the tab. If this is checked, &kappname; uses colors provided by the system, such as those associated with a selected theme, although the details depend on which operating system and possibly which window system or display manager is running. Very often, if you experience odd colors or odd combination of colors, toggling this checkbox will help. </para>
</sect2>
</sect1>

<sect1 id="details.settings.fonts">
<title
>Lettertypen</title>

<para
>These options allow you to modify the fonts. </para>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Gebruik systeemlettertypen</guilabel
></term>
    <listitem>
      <para
>Select this to use system fonts. Deselecting this option allows you to customize fonts.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Lettertype voor cel</guilabel
></term>
    <listitem>
      <para
>Specify the custom font to use within each cell.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
><guilabel
>Lettertype voor kop</guilabel
></term>
    <listitem>
      <para
>Specify the custom font to use for the headers of each view.</para>
    </listitem>
  </varlistentry>
</variablelist>
</sect1>

<sect1 id="details.settings.plugins">
<title
>Plug-ins</title>

<para
>These options allow you to modify the behavior of any installed plugins. Note that the list of plugins displayed will depend on which plugins &kappname; found when it started. It does not matter whether the plugin was compiled as part of the application or added as a separate package. <screenshot
> <screeninfo
>Configure Plugins</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="configure_plugins.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Configure Plugins</phrase
> </textobject
> </mediaobject
> </screenshot
> For most plugins, the only choice is to enable or disable it, as indicated by the checkbox next to the name of the plugin. In addition, there is also an <guibutton
>information</guibutton
> (&infoicon;) button for each, which will show the plugin version and author. Further information on configuring and using these plugins may be found in the separate sections for <link linkend="details.impexp.csv"
>CSV Import</link
> and <link linkend="details.impexp.ofx"
>OFX Import</link
> plugins. It is also true for the <link linkend="details.reconcile"
>Reconciliation report</link
>, although that report is only a minor part of the larger reconciliation process. The one plugin that does require a configuration step is the Print Check plugin. </para>

<sect2 id="details.settings.plugins.printchecks">
<title
>Print check plugin</title>

<para
>This plugin is included with the source of &kappname;, and should always be enabled. It allows printing of a check based on the data from a selected transaction, with the layout controlled by an html template. You need to use a template which is matched to your pre-printed checks. When you click on the <guibutton
>configure</guibutton
> (&configicon;) button , the <guilabel
>Print check</guilabel
> configuration dialog is displayed. At the top is a text box for the path to the selected template. To the right of that is a button which brings up a file chooser, to select an alternative template file. </para>

<para
>A template file is an html file, in which specific strings are used to reference the fields from the transaction and from the current account and institution to show where they will be printed on the check. &kappname; is shipped with some sample template files. You should either be able to use one of them, or modify one to suit your needs. When the default template is selected, the configuration dialog will show you the directory which contains the sample files. </para>
 
<!-- info from source code on substitution variables
    // data about the user
    checkHTML.replace("$OWNER_NAME", file->user().name());
    checkHTML.replace("$OWNER_ADDRESS", file->user().address());
    checkHTML.replace("$OWNER_CITY", file->user().city());
    checkHTML.replace("$OWNER_STATE", file->user().state());
    // data about the account institution
    checkHTML.replace("$INSTITUTION_NAME", institution.name());
    checkHTML.replace("$INSTITUTION_STREET", institution.street());
    checkHTML.replace("$INSTITUTION_TELEPHONE", institution.telephone());
    checkHTML.replace("$INSTITUTION_TOWN", institution.town());
    checkHTML.replace("$INSTITUTION_CITY", institution.city());
    checkHTML.replace("$INSTITUTION_POSTCODE", institution.postcode());
    checkHTML.replace("$INSTITUTION_MANAGER", institution.manager());
    // data about the transaction
    checkHTML.replace("$DATE", KGlobal::locale()->formatDate(QDate::currentDate(), KLocale::LongDate));
    checkHTML.replace("$CHECK_NUMBER", (*it).split().number());
    checkHTML.replace("$PAYEE_NAME", file->payee((*it).split().payeeId()).name());
    checkHTML.replace("$PAYEE_ADDRESS", file->payee((*it).split().payeeId()).address());
    checkHTML.replace("$PAYEE_CITY", file->payee((*it).split().payeeId()).city());
    checkHTML.replace("$PAYEE_POSTCODE", file->payee((*it).split().payeeId()).postcode());
    checkHTML.replace("$PAYEE_STATE", file->payee((*it).split().payeeId()).state());
    checkHTML.replace("$AMOUNT_STRING", converter.convert((*it).split().shares().abs()));
    checkHTML.replace("$AMOUNT_DECIMAL", MyMoneyUtils::formatMoney((*it).split().shares().abs(), currency));
    checkHTML.replace("$MEMO", (*it).split().memo());
-->


</sect2>
</sect1>
</chapter>
