Warning, /office/kmymoney/doc/details-settings.docbook is written in an unsupported language. File is not indexed.
0001 <?xml version="1.0" encoding="UTF-8"?>
0002 <chapter id="details.settings">
0003 <chapterinfo>
0004 <authorgroup>
0005 <author> &Roger.Lum; &Roger.Lum.mail; </author>
0006 <author>
0007 <personname><firstname>Michael</firstname><surname>Carpino</surname></personname>
0008 <email>mfcarpino@gmail.com</email>
0009 </author>
0010 <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author>
0011 </authorgroup>
0012 <date>2019-03-31</date>
0013 <releaseinfo>5.0.3</releaseinfo>
0014 </chapterinfo>
0015
0016 <title>&kmymoney; Settings</title>
0017
0018 <para>
0019 The settings described below modify the behavior of &kmymoney;, allowing you
0020 to customize it to meet the needs of your unique financial affairs, and to
0021 modify its look and feel to match your personality. These settings can be
0022 changed through <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
0023 &kmymoney;...</guimenuitem></menuchoice> menu item or by using the keyboard
0024 shortcut <keycombo action="simul">&Ctrl; &Shift;<keycap>,</keycap></keycombo>.
0025 In order for any changes to take effect the <guibutton>Apply</guibutton>
0026 button must be clicked.
0027 </para>
0028
0029 <para>
0030 On the left of the settings dialog is a list of icons and labels, each
0031 representing a particular area of the program. When you click on one of
0032 those icons, the right part of the dialog will display controls for
0033 configuring that area of the program, often divided into several tabs.
0034 </para>
0035
0036 <sect1 id="details.settings.general">
0037 <title>General</title>
0038
0039 <sect2 id="details.settings.general.global">
0040 <title>Global tab</title>
0041
0042 <variablelist>
0043 <varlistentry>
0044 <term><guilabel>Autosave options</guilabel></term>
0045 <!-- I would prefer to use a more consistent hierarchy and use of levels on this
0046 page, but for now, I'm minimizing changes. -->
0047 <listitem>
0048 <para>Checking the <guilabel>Autosave periodically</guilabel> box instructs
0049 &kmymoney; to autosave your files at a defined interval. The default value is
0050 10 minutes. You can change this setting from 0 (backup immediately after
0051 entering a transaction) up to 60 minutes.</para>
0052
0053 <para>Checking the <guilabel>Autosave when file is modified upon close</guilabel> box
0054 instructs &kmymoney; to autosave your file when the program is closed. You also have the
0055 option upon closing the program to backup your &kmymoney; file. The Number of backup to
0056 keep can be set at 0 (Off) upto to 20 backups. Any backup files will be stored in the same
0057 folder as the main file. They will be labeled sequentially with 1 being the most current.</para>
0058 </listitem>
0059 </varlistentry>
0060
0061 <varlistentry>
0062 <term><guilabel>Fiscal Year</guilabel></term>
0063 <listitem>
0064 <para>Enter the day and month of your fiscal year. This value is used for
0065 budgets and some reports.</para>
0066 </listitem>
0067 </varlistentry>
0068
0069 <varlistentry>
0070 <term><guilabel>External programs</guilabel></term>
0071 <listitem>
0072 <para>This setting does not directly affect the operation of &kmymoney;,
0073 but provides a convenient way to launch any external utility, such as an
0074 advanced calculator. The first step is to enter the full path to your
0075 chosen program in the <guilabel>Calculator</guilabel> text box. There are
0076 then two ways to launch the program.</para>
0077 <para>First, you can use
0078 <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
0079 Toolbars...</guimenuitem></menuchoice> menu item to place the
0080 <guilabel>Calculator</guilabel> icon on the Toolbar. Then, when you click
0081 that icon on the Toolbar, &kmymoney; will launch the selected
0082 application.</para>
0083 <!-- FIXME since the Settings menu is deferred to the Frameworks docs and
0084 not explicitly described in this manual, it would at least be nice to
0085 refer to the actual Calculator icon here, but I cannot find the
0086 source png. It might also be nice to have a link to Settings Menu
0087 doc page. -->
0088 <para>Second, you can use
0089 <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
0090 Shortcuts...</guimenuitem></menuchoice> menu item to set a custom keyboard
0091 shortcut. (The entry is under &kmymoney;/Calculator in that list.) You can
0092 then use that shortcut to launch the application.</para>
0093 <!-- FIXME is not currently possible to launch the calculator from some menu
0094 item. I have filed a wishlist, and when implemented, it should be
0095 described here, probably as the first choice. -->
0096 <para>
0097 </para>
0098 </listitem>
0099 </varlistentry>
0100 </variablelist>
0101 </sect2>
0102
0103 <sect2 id="details.settings.general.views">
0104 <title>Views tab</title>
0105
0106 <variablelist>
0107 <varlistentry>
0108 <term><guilabel>Startup page options</guilabel></term>
0109 <listitem>
0110 <para>When &kmymoney; starts up, this option indicates whether to start
0111 with the Home View or with the view displayed when the program was last
0112 closed.</para>
0113 </listitem>
0114 </varlistentry>
0115
0116 <varlistentry>
0117 <term><guilabel>Type of the &kmymoney; view</guilabel></term>
0118 <listitem>
0119 <para> You can select one of three general layouts for &kmymoney; to use. If
0120 you select the List or Tree view, the icons and their labels will be located at
0121 the left side of the window. The List view displays larger icons while the Tree
0122 view has smaller icons. The Tabbed view locates the icons and labels across
0123 the top of the window.</para>
0124 </listitem>
0125 </varlistentry>
0126
0127 <varlistentry>
0128 <term><guilabel>Show title bar on each page</guilabel></term>
0129 <listitem>
0130 <para>Checking this box will display the blue &kmymoney; title bar across the
0131 top of each page. Unchecking it will remove the title bar and provide a larger
0132 area for viewing the content of each page.</para>
0133 </listitem>
0134 </varlistentry>
0135
0136 <varlistentry>
0137 <term><guilabel>Synchronize account selection of ledger and investment
0138 view</guilabel></term>
0139 <listitem>
0140 <para>If this option is selected, the accounts displayed in the Ledger View and
0141 Investment View will be synchronized, meaning if you change the account
0142 displayed in one of the views, and then switch to the other view, the
0143 information for the same account will be displayed. This increases the
0144 efficiency of navigating between these 2 tab views. If it is not selected,
0145 selecting either of those views will show the same account previously selected
0146 in that view, regardless of the account selected in the other view.</para>
0147 </listitem>
0148 </varlistentry>
0149 </variablelist>
0150 </sect2>
0151
0152 <sect2 id="details.settings.general.filter">
0153 <title>Filter tab</title>
0154
0155 <sect3>
0156 <title>Accounts / Categories</title>
0157 <variablelist>
0158 <varlistentry>
0159 <term><guilabel>Do not show unused categories</guilabel></term>
0160 <listitem>
0161 <para>Checking this box hides unused categories in the Categories View. A
0162 hidden category is still available should a transaction require it. By typing
0163 a hidden category in the ledger it will become available for use.</para>
0164 </listitem>
0165 </varlistentry>
0166
0167 <varlistentry>
0168 <term><guilabel>Show equity accounts</guilabel></term>
0169 <listitem>
0170 <para>By default, equity accounts are hidden in the Accounts View. Selecting
0171 this option will display the equity accounts in the Accounts View. Equity
0172 accounts are used to track individual equities or investments held in an
0173 Investment Account. This should not be confused with the top level
0174 <emphasis>Equity</emphasis> group of accounts, which includes the account(s)
0175 which contain the opening balances for other accounts.</para>
0176 </listitem>
0177 </varlistentry>
0178
0179 <varlistentry>
0180 <term><guilabel>Show categories in the accounts list view</guilabel></term>
0181 <listitem>
0182 <para>By default, Categories are hidden in the Accounts View. Selecting this
0183 option will display the Categories in the Accounts View.</para>
0184 </listitem>
0185 </varlistentry>
0186
0187 <varlistentry>
0188 <term><guilabel>Do not show zero balance equities</guilabel></term>
0189 <listitem>
0190 <para>Checking this option will remove any zero balance equity accounts from
0191 appearing in the Accounts View.</para>
0192 </listitem>
0193 </varlistentry>
0194 </variablelist>
0195 </sect3>
0196
0197 <sect3>
0198 <title>Schedules</title>
0199 <variablelist>
0200 <varlistentry>
0201 <term><guilabel>Do not show finished schedules</guilabel></term>
0202 <listitem>
0203 <para>Checking this box will hide all finished schedules from appearing in the
0204 Scheduled transaction View.</para>
0205 </listitem>
0206 </varlistentry>
0207 </variablelist>
0208 </sect3>
0209
0210 <sect3>
0211 <title>Transactions</title>
0212 <variablelist>
0213 <varlistentry>
0214 <term><guilabel>Do not show transaction prior to</guilabel></term>
0215 <listitem>
0216 <para>Transactions prior to the date entered here will not be displayed in the
0217 Ledger View. This can be useful if your data includes many years of
0218 transactions; setting this to one or two years ago hides older
0219 transactions.</para>
0220 <para>Setting this option to January 1, 1900 (the default value) is a good way
0221 to debug date-related data import problems, in case some dates were erroneously
0222 very far in the past.</para>
0223 </listitem>
0224 </varlistentry>
0225
0226 <varlistentry>
0227 <term><guilabel>Do not show reconciled transactions</guilabel></term>
0228 <listitem>
0229 <para>Checking this box will filter transactions by reconciliation state.
0230 Transactions that are marked as <emphasis>Reconciled</emphasis> will not be
0231 shown in the Ledger View.</para>
0232 </listitem>
0233 </varlistentry>
0234 </variablelist>
0235 </sect3>
0236 </sect2>
0237 </sect1>
0238
0239 <sect1 id="details.settings.home">
0240 <title>Home</title>
0241
0242 <sect2>
0243 <title>Home page display sections</title>
0244 <para>
0245 These options allow you to customize the appearance of the <link
0246 linkend="firsttime.mainwindow">Home View</link> (also called the Home Page or Main
0247 Window) by choosing which information to display there and the order in which it
0248 appears. Selected sections can be reordered by clicking the respective
0249 <guibutton>Up</guibutton> or <guibutton>Down</guibutton> button.
0250 </para>
0251 <!-- FIXME Many of these sections need a <link> to the doc section actually
0252 describing the content. -->
0253
0254 <variablelist>
0255 <varlistentry>
0256 <term><guilabel>Assets and Liabilities</guilabel></term>
0257 <listitem>
0258 <para>This will display the asset and liability accounts that are open along
0259 with their current balances. This and other account lists on the Home Page are
0260 sorted in alphabetical order, unless otherwise noted.</para>
0261 </listitem>
0262 </varlistentry>
0263
0264 <varlistentry>
0265 <term><guilabel>Payments</guilabel></term>
0266 <listitem>
0267 <para>This will display upcoming occurrences of Scheduled transactions,
0268 distinguishing Overdue payments from Future payments. It shows the date,
0269 schedule name, account and amount of the payment, and the account balance after
0270 the payment. By default it will show up to six transaction. If six are
0271 displayed, there is a link you can select to show more, up to 30 days in
0272 advance.</para>
0273 </listitem>
0274 </varlistentry>
0275
0276 <varlistentry>
0277 <term><guilabel>Preferred accounts</guilabel></term>
0278 <listitem>
0279 <para>This will display the accounts that are identified as Preferred accounts
0280 within the <menuchoice><guimenu>Account</guimenu><guimenuitem>Edit account...
0281 </guimenuitem></menuchoice> Configuration dialog.</para>
0282 <para>For this and all other account list sections addressed by this set of
0283 options, the display will include the account name and current balance, and
0284 other columns specific to that type of report, and in some cases, as configured
0285 elsewhere.</para>
0286 <!-- FIXME - the menu item (or maybe link to actual doc page) should point
0287 to the actual other config location and perhaps which items for
0288 which account type. -->
0289 </listitem>
0290 </varlistentry>
0291
0292 <varlistentry>
0293 <term><guilabel>Payment accounts</guilabel></term>
0294 <listitem>
0295 <para>This will display all Payment accounts; these include any account into
0296 which income can be deposited, and/or out of which bills can be paid.</para>
0297 </listitem>
0298 </varlistentry>
0299
0300 <varlistentry>
0301 <term><guilabel>Favorite Reports</guilabel></term>
0302 <listitem>
0303 <para>This will display a list of all reports that have been identified as a
0304 favorite in the Configuration dialog of the Report. The list ordered
0305 chronologically by when each report became a favorite.</para>
0306 </listitem>
0307 </varlistentry>
0308
0309 <varlistentry>
0310 <term><guilabel>Forecast (schedule)</guilabel></term>
0311 <listitem>
0312 <para>This will display a 30, 60, and 90 day forecast for asset and liability accounts with non zero
0313 balances and with non reconciled transactions.</para>
0314 <!-- FIXME What are the real criteria for inclusion in this (and these other) list(s). -->
0315 </listitem>
0316 </varlistentry>
0317
0318 <varlistentry>
0319 <term><guilabel>Net worth forecast</guilabel></term>
0320 <listitem>
0321 <para>This will display chart of your forecast net worth for the next 90
0322 days.</para>
0323 </listitem>
0324 </varlistentry>
0325
0326 <!-- FIXME "Forecast (history) removed as apparently not actually used. -->
0327
0328 <varlistentry>
0329 <term><guilabel>Budget</guilabel></term>
0330 <listitem>
0331 <para>This will display a current month summary and overruns for any defined
0332 budget(s). If no budget is defined, it will display no budget or overruns, with
0333 the actual current month spending.</para>
0334 </listitem>
0335 </varlistentry>
0336
0337 <varlistentry>
0338 <term><guilabel>Cash Flow</guilabel></term>
0339 <listitem>
0340 <para>This will display a Cash Flow Summary analysis for the current month.</para>
0341 </listitem>
0342 </varlistentry>
0343 </variablelist>
0344 </sect2>
0345
0346 <sect2>
0347 <title>Homepage/Summary page scaling</title>
0348 <variablelist>
0349
0350 <varlistentry>
0351 <term><guilabel>Zoom factor:</guilabel></term>
0352 <listitem>
0353 <para>This option allows for the selection of the font size as a percentage to
0354 fit the Home View based on the user preference.</para>
0355 </listitem>
0356 </varlistentry>
0357
0358 <varlistentry>
0359 <term><guilabel>Remember zoom factor when leaving the program if manually changed
0360 with mouse-wheel</guilabel></term>
0361 <listitem>
0362 <para>Selecting this will save your font size preference if you have changed it
0363 on the Home page by using the mouse-wheel.</para>
0364 </listitem>
0365 </varlistentry>
0366 </variablelist>
0367 </sect2>
0368
0369 <sect2>
0370 <title>Account information display</title>
0371 <para>These options allow you to customize what information is included in any list
0372 of accounts.</para>
0373 <variablelist>
0374 <varlistentry>
0375 <term><guilabel>Show account limit information</guilabel></term>
0376 <listitem>
0377 <para>Displays the account limit as set in the Account Edit dialog. It affects
0378 any list which includes Payment accounts.</para>
0379 </listitem>
0380 </varlistentry>
0381
0382 <varlistentry>
0383 <term><guilabel>Show balance-status of mapped online accounts</guilabel></term>
0384 <listitem>
0385 <para>Shows the balance-status of mapped accounts, symbolized by an icon in the
0386 columns preceding the account name. A green checkmark indicates the online
0387 balance and local balance are the same. A mailbox with a green arrow indicates
0388 that the local file has transactions newer than the most recent online update.
0389 This alerts the user to start an online-update. A red warning sign indicates a
0390 mismatch between the local file and online-balance.</para>
0391 <!-- Note: the colors might be different depending on the selected theme
0392 -->
0393 </listitem>
0394 </varlistentry>
0395
0396 <varlistentry>
0397 <term><guilabel>Show number of not marked transactions per account [!M]</guilabel></term>
0398 <listitem>
0399 <para>Inserts an additional column next to the account name, showing the number
0400 of not marked transactions in the account.</para>
0401 </listitem>
0402 </varlistentry>
0403
0404 <varlistentry>
0405 <term><guilabel>Show number of cleared transactions per account [C]</guilabel></term>
0406 <listitem>
0407 <para>Inserts an additional column showing the number of cleared transactions
0408 for the account.</para>
0409 </listitem>
0410 </varlistentry>
0411
0412 <varlistentry>
0413 <term><guilabel>Show number of not reconciled (not marked + cleared) transactions
0414 per account [!R]</guilabel></term>
0415 <listitem>
0416 <para>Inserts an additional column showing the number of not reconciled
0417 transactions for the account, &ie;, the sum of all not marked and cleared
0418 transactions.</para>
0419 </listitem>
0420 </varlistentry>
0421
0422 <varlistentry>
0423 <term><guilabel>Show date of last reconciliation</guilabel></term>
0424 <listitem>
0425 <para>Inserts an additional column showing the last reconciliation date for the
0426 account.</para>
0427 </listitem>
0428 </varlistentry>
0429 </variablelist>
0430 </sect2>
0431 </sect1>
0432
0433 <sect1 id="details.settings.register">
0434 <title>Ledger</title>
0435
0436 <para>
0437 The following options outlined within this section allow for the modification of the
0438 transaction register contained within the Ledger view tab.
0439 </para>
0440
0441 <sect2 id="details.settings.register.display">
0442 <title>Display tab</title>
0443
0444 <variablelist>
0445 <varlistentry>
0446 <term><guilabel>Show a grid in the register</guilabel></term>
0447 <listitem>
0448 <para>Selecting this option displays grid lines in the transaction
0449 register or Ledger View. It provides an additional viewing option that
0450 may make it easier to visualize separate transactions and their component
0451 parts.</para>
0452 </listitem>
0453 </varlistentry>
0454
0455 <varlistentry>
0456 <term><guilabel>Show all register entries in full detail</guilabel></term>
0457 <listitem>
0458 <para>Selecting this option makes the register show all the information
0459 for all displayed transactions, with separate lines in the Detail Column
0460 for Category and Tags and for the Memo. If it is not selected, Category,
0461 Tags, and Memo will not be displayed.</para>
0462 <para>This has the same effect as selecting the <link
0463 linkend="reference.menus.settings.transactiondetail">Show Transaction
0464 Detail</link> menu option.</para>
0465 </listitem>
0466 </varlistentry>
0467
0468 <varlistentry id="details.settings.register.lens">
0469 <term><guilabel>Use the ledger lens</guilabel></term>
0470 <listitem>
0471 <para>Selecting this option displays all the detail lines for the selected
0472 transaction, even if <guilabel>Show all register entries in full
0473 detail</guilabel> is not selected.</para>
0474 </listitem>
0475 </varlistentry>
0476
0477 <varlistentry>
0478 <term><guilabel>Show transaction form</guilabel></term>
0479 <listitem>
0480 <para>Selecting this option displays the <link
0481 linkend="details.ledger.transactionform">transaction form</link> at the
0482 bottom of the register, and that is where you edit a transaction. If the
0483 transaction form is not displayed, you edit a transaction within the
0484 ledger itself. With this option enabled fewer transactions are visible in
0485 the ledger, compared to when it is disabled.</para>
0486 </listitem>
0487 </varlistentry>
0488
0489 <varlistentry>
0490 <term><guilabel>Always show a No. field</guilabel></term>
0491 <listitem>
0492 <para>Always display the number (<quote>No.</quote>) field when entering or
0493 editing a transaction. With this enabled you'll be able to check numbers
0494 entered in this field for checking accounts.</para>
0495 </listitem>
0496 </varlistentry>
0497
0498 <varlistentry>
0499 <term><guilabel>Show group header between transactions</guilabel></term>
0500 <listitem>
0501 <para>Selecting this option will display group headers in the register.
0502 These refer to time periods or milestones such as Last month, Last week,
0503 This month, Last reconciliation, Next week, and Next Month.</para>
0504 </listitem>
0505 </varlistentry>
0506
0507 <varlistentry>
0508 <term><guilabel>Show header for the previous and current fiscal year
0509 </guilabel></term>
0510 <listitem>
0511 <para>Selecting this option will display group headers in the register for
0512 the current and the previous fiscal year.</para>
0513 </listitem>
0514 </varlistentry>
0515
0516 <varlistentry>
0517 <term><guilabel>Display overdue schedules with planned date</guilabel></term>
0518 <listitem>
0519 <para>Scheduled transactions with future dates are shown in the Ledger
0520 View for the relevant account. When the date passes, and a scheduled
0521 transaction becomes overdue, it is no longer shown in the ledger, unless
0522 this option is selected.</para>
0523 </listitem>
0524 </varlistentry>
0525 </variablelist>
0526 </sect2>
0527
0528 <sect2 id="details.settings.register.sorting">
0529 <title>Sorting tab</title>
0530 <para>
0531 These three sections allow you to set the default sort order of transactions
0532 in the Ledger View. In all cases, the list on the left shows all the fields
0533 available for sorting. To sort on an item, select it (single mouse click) and
0534 click the right arrow between the two lists. The list on the right shows all
0535 the fields which have been selected as part of the sort order for that view.
0536 You can adjust the relative order of the fields by selecting one and adjusting
0537 its position in the list using the up and down arrows to the right of the
0538 list. You can switch between ascending and descending sort for any item
0539 by double clicking on it.
0540 </para>
0541 <para>
0542 The fields available for sorting are the same for all three sections: Amount,
0543 Category, Entry Order (date the transaction was created,) Number, Payee, Post
0544 date, Reconcile state, Security, and Type.
0545 </para>
0546
0547 <sect3 id="details.settings.register.sorting.normal">
0548 <title>Normal view tab</title>
0549 <para>
0550 This tab controls the default sort order of the regular Ledger View.
0551 </para>
0552 </sect3>
0553
0554 <sect3 id="details.settings.register.sorting.reconciliation">
0555 <title>Reconciliation view tab</title>
0556 <para>
0557 This tab controls the default sort order of the ledger while in the
0558 Reconciliation view. This is the display of transactions shown during the
0559 process of <link linkend="details.reconcile">Reconciliation</link>.
0560 </para>
0561 </sect3>
0562
0563 <sect3 id="details.settings.register.sorting.search">
0564 <title>Search view tab</title>
0565 <para>
0566 This tab controls the default sort order of the ledger while in the <link linkend="details.search">Search view</link>.
0567 </para>
0568 </sect3>
0569 </sect2>
0570
0571 <sect2 id="details.settings.register.dataentry">
0572 <title>Data Entry tab</title>
0573 <para>These options affect the process of creating new transactions.</para>
0574
0575 <variablelist>
0576 <varlistentry>
0577 <term><guilabel>Auto increment check number</guilabel></term>
0578 <listitem>
0579 <para>Enabling this will automatically increment the check number whenever
0580 entering a new check transaction. They have the same effect whether you
0581 use the Ledger Lens or the Transaction Form.</para>
0582 </listitem>
0583 </varlistentry>
0584
0585 <varlistentry>
0586 <term><guilabel>Keep changes when selecting a different
0587 transaction/split</guilabel></term>
0588 <listitem>
0589 <para>When enabled, selecting a different transaction or split will save
0590 edits to the current transaction. When disabled, selecting a different
0591 transaction split will prompt you whether or not to save any
0592 changes.</para>
0593 </listitem>
0594 </varlistentry>
0595
0596 <varlistentry>
0597 <term><guilabel>Use Enter to move between fields</guilabel></term>
0598 <listitem>
0599 <para>When enabled, pressing &Enter; will change the focus to the next field
0600 of the transaction. When in the last field, the transaction will be
0601 saved. When disabled, navigation between fields would occur by using the
0602 	 key or the mouse. Pressing the &Enter; key would save the transaction,
0603 no matter which field is currently in focus.
0604 </para>
0605 </listitem>
0606 </varlistentry>
0607
0608 <varlistentry>
0609 <term><guilabel>Match names from start</guilabel></term>
0610 <listitem>
0611 <para>This option controls <link
0612 linkend="details.payees.personalinformation.matching">payee
0613 matching.</link> When enabled, payee names will always be matched from the
0614 start. When disabled, any substring will be matched. Also, when enabled
0615 additional options for matching can be established in the Matching Tab of
0616 the Payees View.</para>
0617 </listitem>
0618 </varlistentry>
0619
0620 <!--FIXME missing Automatic reconciliation-->
0621 <varlistentry>
0622 <term><guilabel>Automatic reconciliation</guilabel></term>
0623 <listitem>
0624 <para>This option needs to be documented.
0625 </para>
0626 </listitem>
0627 </varlistentry>
0628
0629 <varlistentry>
0630 <term><guilabel>Default reconciliation state</guilabel></term>
0631 <listitem>
0632 <para>Select the default reconciliation state for new transactions: Not
0633 reconciled, Cleared, and Reconciled.</para>
0634 </listitem>
0635 </varlistentry>
0636
0637 <varlistentry>
0638 <term><guilabel>Autofill</guilabel></term>
0639 <listitem>
0640 <para>This option allows you to select the desired behavior for autofill.
0641 This controls which, if any, previous transactions for the same payee are
0642 displayed, and which, if any, of those transactions are used to auto-fill
0643 details of the new transaction.</para>
0644 <itemizedlist>
0645 <listitem>
0646 <para>No Autofill</para>
0647 <para>This will deactivate autofill, and you must manually enter all
0648 details for the new transaction.</para>
0649 </listitem>
0650 <listitem>
0651 <para>Same transaction if amount differs less than percentage set below</para>
0652 <para>With this option selected, when you enter a new transaction,
0653 &kmymoney; will display a list of previous transactions for the same
0654 payee and account. If the amount of a previous transactions differ
0655 less than X percent from the amount you have entered, they will be
0656 considered identical, and details from the previous transaction will
0657 be used to autofill details of the new transaction. The "X" above is
0658 specified in the box next to <guilabel>Same transaction if amount
0659 differs less than</guilabel>, and can range from 0 to 100%. If the
0660 percentage is 0, all previous transactions for the payee and account
0661 will be displayed, and you can select one of those transactions to use
0662 for autofill by clicking on it.</para>
0663 </listitem>
0664 <listitem>
0665 <para>With previously most often used transaction for the payee</para>
0666 <para>With this option selected, when you enter new transaction,
0667 &kmymoney; will fill in all the transaction details based on the
0668 previously most often used transaction for the selected payee.</para>
0669 </listitem>
0670 </itemizedlist>
0671 </listitem>
0672 </varlistentry>
0673
0674 <varlistentry>
0675 <term><guilabel>Use memos from previous transaction</guilabel></term>
0676 <listitem>
0677 <para>When selected, the memo from the previously entered transaction will
0678 be automatically entered as the memo for the new transaction.
0679 </para>
0680 </listitem>
0681 </varlistentry>
0682 </variablelist>
0683 </sect2>
0684
0685 <sect2 id="details.settings.register.import">
0686 <title>Import tab</title>
0687
0688 <variablelist>
0689 <varlistentry>
0690 <term><guilabel>Match transaction within days</guilabel></term>
0691 <listitem>
0692 <para>Search for matching transactions within the range of the imported
0693 transaction +/- the given number of days, which can be set from 0 to
0694 99.</para>
0695 </listitem>
0696 </varlistentry>
0697
0698 <varlistentry>
0699 <term><guilabel>Ask for a new payee's default category</guilabel></term>
0700 <listitem>
0701 <para>If this option is selected, whenever a new payee is detected during
0702 an import, the user will be asked for the default category for the
0703 payee.</para>
0704 </listitem>
0705 </varlistentry>
0706 </variablelist>
0707 </sect2>
0708 </sect1>
0709
0710 <sect1 id="details.settings.schedules">
0711 <title>Scheduled Transactions</title>
0712
0713 <para>
0714 These options allow you to modify the behavior of <link
0715 linkend="details.schedules">Scheduling Transactions</link>.
0716 </para>
0717
0718 <sect2>
0719 <title>Startup options</title>
0720 <variablelist>
0721 <varlistentry>
0722 <term><guilabel>Check schedules upon startup</guilabel></term>
0723 <listitem>
0724 <para>Enables checking the schedule upon startup of &kmymoney;. If
0725 a scheduled transaction matches the schedule criteria set then &kmymoney;
0726 will produce a notification requiring handling of the transaction. </para>
0727 </listitem>
0728 </varlistentry>
0729
0730 <varlistentry>
0731 <term><guilabel>Enter transactions this number of days in
0732 advance</guilabel></term>
0733 <listitem><para>Specify how many days in advance a scheduled transaction
0734 should be entered.</para>
0735 </listitem>
0736 </varlistentry>
0737 </variablelist>
0738 </sect2>
0739
0740 <sect2 id="details.settings.schedules.calendar">
0741 <title>Processing Days</title>
0742 <variablelist>
0743 <varlistentry>
0744 <term><guilabel>Use holiday calendar for region</guilabel></term>
0745 <listitem><para>Select the region of the world that best suits your needs.</para>
0746 </listitem>
0747 </varlistentry>
0748 </variablelist>
0749 </sect2>
0750
0751 <sect2><title></title>
0752 <variablelist>
0753 <varlistentry>
0754 <term><guilabel>Number of days to preview schedules in ledger</guilabel></term>
0755 <listitem>
0756 <para>Specify how many days should the scheduled transactions show up in the
0757 ledger.</para>
0758 <para>The scheduled transactions will be listed in the ledger. You can
0759 enter or skip the scheduled transactions by right-clicking on
0760 them.</para>
0761 </listitem>
0762 </varlistentry>
0763 </variablelist>
0764 </sect2>
0765 </sect1>
0766
0767 <sect1 id="details.settings.onlinequote">
0768 <title>Online Quotes</title>
0769
0770 <para>
0771 These settings modify how financial quotes are retrieved from different online
0772 sources. These include both stock, bond, and other equity prices, as well as
0773 prices for precious metals and currency conversion.
0774 </para>
0775
0776 <para>
0777 This tab allows you to change the online quote sources for &kmymoney;.
0778 Generally speaking, this is an advanced feature, and should only be attempted
0779 by the most technically adept users.
0780 </para>
0781
0782 <para>
0783 For more details, please refer to the <link
0784 linkend="details.investments.onlinequotes">Online Price Quotes</link> section.
0785 </para>
0786 </sect1>
0787
0788
0789 <sect1 id="details.settings.colors">
0790 <title>Colors</title>
0791
0792 <para>
0793 These section allows you to customize the colors used within &kmymoney;. If
0794 <guilabel>Custom colors</guilabel> is not checked, then default colors will
0795 be used.
0796 </para>
0797
0798 <para>
0799 To customize colors check the box Custom colors.
0800 </para>
0801
0802 <para>
0803 Modify any of the colors by clicking on the color button, which will open
0804 color select palette. This will provide unlimited options in color selection.
0805 You can select a defined basic color, pick a color by clicking anywhere on the
0806 screen, input an &HTML; defined color, specify values for Hue, Saturation,
0807 Value, Red, Green, and Blue.
0808
0809 </para>
0810 </sect1>
0811
0812 <sect1 id="details.settings.fonts">
0813 <title>Fonts</title>
0814
0815 <para>
0816 These options allow you to modify the fonts within the Cell or Header fields.
0817 </para>
0818
0819 <variablelist>
0820 <varlistentry>
0821 <term><guilabel>Use system fonts</guilabel></term>
0822 <listitem>
0823 <para>Select this to use system fonts. Deselecting this option allows the select
0824 the fonts of your choice.</para>
0825 </listitem>
0826 </varlistentry>
0827
0828 <varlistentry>
0829 <term><guilabel>Cell font</guilabel></term>
0830 <listitem>
0831 <para>Specify the custom font to use within each cell of the registers.</para>
0832 </listitem>
0833 </varlistentry>
0834
0835 <varlistentry>
0836 <term><guilabel>Header font</guilabel></term>
0837 <listitem>
0838 <para>Specify the custom font to use for the headers of each view within the register.</para>
0839 </listitem>
0840 </varlistentry>
0841 </variablelist>
0842 </sect1>
0843
0844 <sect1 id="details.settings.icons">
0845 <title>Icons</title>
0846
0847 <para>
0848 This option allows for the selection of icons that will be displayed.
0849 </para>
0850
0851 <variablelist>
0852 <varlistentry>
0853 <term><guilabel>Individual icon settings</guilabel></term>
0854 <listitem>
0855 <para>Using the pull-down menu there is a selection of available icons available for use.
0856 Additional icons may be available for downloading and use depending on the operating
0857 system installed.</para>
0858 </listitem>
0859 </varlistentry>
0860 </variablelist>
0861 </sect1>
0862
0863 <sect1 id="details.settings.plugins">
0864 <title>Plugins</title>
0865
0866 <para>
0867 This section provides information about the available plugins, and allow you
0868 to modify the behavior of installed plugins. Note that the list of plugins
0869 displayed will depend on which plugins &kmymoney; found when it started. It
0870 does not matter whether the plugin was compiled as part of the application or
0871 added as a separate package.
0872 <screenshot>
0873 <screeninfo>Configure Plugins</screeninfo>
0874 <mediaobject>
0875 <imageobject>
0876 <imagedata fileref="configure_plugins.png" format="PNG" />
0877 </imageobject>
0878 <textobject>
0879 <phrase>Configure Plugins</phrase>
0880 </textobject>
0881 </mediaobject>
0882 </screenshot>
0883 Every plugin can be enabled or disabled, according to the state of the
0884 checkbox next to the name of the plugin. In addition, at the right, there is
0885 also an <guibutton>information</guibutton> (&infoicon;) button for each, which
0886 will show the plugin version and author. For some plugins, further
0887 information on configuring and using it may be found by clicking the
0888 configure, or tool icon just to the left of the information button. There is
0889 only one plugin that requires configuration, and that is the Check printing
0890 plugin.
0891 </para>
0892
0893 <sect2 id="details.settings.plugins.printchecks">
0894 <title>Check printing plugin</title>
0895
0896 <para>
0897 As one example, there is a plugin for printing checks, which
0898 is included with the source of &kmymoney;, and should always be
0899 enabled. It allows printing of a check based on the data from a selected
0900 transaction, with the layout controlled by an &HTML; template. You need to use a
0901 template which is matched to your pre-printed checks. A default, built-in
0902 template is provided. You may also choose a custom template. To do so, click on
0903 the <guibutton>configure</guibutton> (&configicon;) button to get the
0904 <guilabel>Check printing</guilabel> configuration dialog displayed. At the top
0905 you can check the box to use a custom template. To the right of that is a
0906 button which brings up a file chooser, to select an alternate template file.
0907 </para>
0908
0909 <para>
0910 A template file is an &HTML; file, in which specific strings are used to
0911 reference the fields from the transaction and from the current account and
0912 institution to show where they will be printed on the check. &kmymoney;
0913 ships with a default, built-in template. At <ulink url="https://invent.kde.org/office/kmymoney/-/blob/master/kmymoney/plugins/checkprinting/templates/">this</ulink>
0914 address you can find the HTML source file of default template, as well as some
0915 additional templates. You should either be able to use one of them, or modify
0916 one to suit your needs. Note that only a <emphasis>subset</emphasis> of the
0917 HTML standard is supported — the detailed documentation on that can be found
0918 <ulink url="https://doc.qt.io/qt-5/richtext-html-subset.html">here</ulink>.
0919 </para>
0920
0921
0922 <!-- info from source code on substitution variables
0923 // data about the user
0924 checkHTML.replace("$OWNER_NAME", file->user().name());
0925 checkHTML.replace("$OWNER_ADDRESS", file->user().address());
0926 checkHTML.replace("$OWNER_CITY", file->user().city());
0927 checkHTML.replace("$OWNER_STATE", file->user().state());
0928 // data about the account institution
0929 checkHTML.replace("$INSTITUTION_NAME", institution.name());
0930 checkHTML.replace("$INSTITUTION_STREET", institution.street());
0931 checkHTML.replace("$INSTITUTION_TELEPHONE", institution.telephone());
0932 checkHTML.replace("$INSTITUTION_TOWN", institution.town());
0933 checkHTML.replace("$INSTITUTION_CITY", institution.city());
0934 checkHTML.replace("$INSTITUTION_POSTCODE", institution.postcode());
0935 checkHTML.replace("$INSTITUTION_MANAGER", institution.manager());
0936 // data about the transaction
0937 checkHTML.replace("$DATE", KGlobal::locale()->formatDate(QDate::currentDate(), KLocale::LongDate));
0938 checkHTML.replace("$CHECK_NUMBER", (*it).split().number());
0939 checkHTML.replace("$PAYEE_NAME", file->payee((*it).split().payeeId()).name());
0940 checkHTML.replace("$PAYEE_ADDRESS", file->payee((*it).split().payeeId()).address());
0941 checkHTML.replace("$PAYEE_CITY", file->payee((*it).split().payeeId()).city());
0942 checkHTML.replace("$PAYEE_POSTCODE", file->payee((*it).split().payeeId()).postcode());
0943 checkHTML.replace("$PAYEE_STATE", file->payee((*it).split().payeeId()).state());
0944 checkHTML.replace("$AMOUNT_STRING", converter.convert((*it).split().shares().abs()));
0945 checkHTML.replace("$AMOUNT_DECIMAL", MyMoneyUtils::formatMoney((*it).split().shares().abs(), currency));
0946 checkHTML.replace("$MEMO", (*it).split().memo());
0947 -->
0948
0949
0950 </sect2>
0951 <sect2 id="details.settings.plugins.kbanking">
0952 <title>KBanking</title>
0953
0954 <para>
0955 This plugins adds support for HBCI/FinTs, OFX and PayPal online banking to KMyMoney.
0956 After this plugin has been enabled, online banking can be configured in the
0957 <link linkend="reference.menus.settings.help">Settings</link> menu.
0958 </para>
0959
0960 </sect2>
0961 </sect1>
0962 </chapter>