Update systempreferences.rst
[kohadocs.git] / source / systempreferences.rst
index 58b9451..826bcc4 100644 (file)
@@ -49,7 +49,7 @@ follow they will all read USD for U.S. Dollars.
     have search terms highlighted in results you set the
     OpacHighlightedWords preference to 'Highlight' then edit the
     koha-http.conf for the library that wants this turned off by adding
-    'SetEnv OVERRIDE\_SYSPREF\_OpacHighlightedWords "0"^. After
+    'SetEnv OVERRIDE\_SYSPREF\_OpacHighlightedWords "0"'. After
     restarting the web server that one library will no longer see
     highlighted terms. Consult with your system administrator for more
     information.
@@ -752,7 +752,7 @@ Values:
 Description:
 
 -  This preference allows the system administrator to determine if users
-   will be able to set and see an item type icon
+   will be able to set and see an item type icon in 
    the catalog on both the OPAC and the Staff Client. The images will
    display in both the OPAC and the Staff Client/Intranet. If images of
    item types are disabled, text labels for item types will still appear
@@ -1242,10 +1242,10 @@ Description:
 -  Used when merging authorities.
 
 -  Controls how the indicators of linked authority records affect the
-   corresponding biblio indicators. Currently, the default valueis fine-tuned
+   corresponding biblio indicators. Currently, the default value is fine-tuned
    for MARC21 and copies the authority indicators for UNIMARC.
 
--  For example,a MARC21 field 100 in a biblio record should pick its first
+-  For example, a MARC21 field 100 in a biblio record should pick its first
    indicator from the linked authority record. The second indicator is not
    controlled by the authority. This report supports such MARC conventions.
 
@@ -2582,7 +2582,7 @@ Circulation
 
 
 
-.. _article-requests-label:
+.. _article-requests-sysprefs-label:
 
 Article Requests
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -2606,6 +2606,28 @@ Description:
 
 -  This preference controls whether or not article requests are allowed to be placed by patrons in the OPAC.
 
+.. _articlerequestslinkcontrol-label:
+
+ArticleRequestsLinkControl 
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Default: Use algorithm to show or hide
+
+Asks: \_\_\_ article request link on search results.
+
+Values:
+
+-  Always show
+
+-  Use algorithm to show or hide
+   
+Description:
+
+-  On the OPAC results page, either always show the 'Request article' link 
+   or check the branch, patron and item type combination to determine 
+   whether or not an article can be requested from this particular record 
+   before displaying the link. 
+
 .. _articlerequestsmandatoryfields-label:
 
 ArticleRequestsMandatoryFields
@@ -2828,6 +2850,74 @@ Values:
 
 -  Cumulate
 
+.. _hidepersonalpatrondetailoncirculation-label:
+
+HidePersonalPatronDetailOnCirculation
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Default: Don't
+
+Asks: \_\_\_ hide patrons phone number, email address, street address 
+and city in the circulation page 
+
+Values:
+
+-  Don't
+
+-  Do
+
+Description:
+
+-  This preference controls the display of the patron's phone number, 
+   email address, and physical address from the left side of the screen 
+   (under their picture, if they have one). 
+
+-  Set to 'Do' these informations will only be visible on the patron's 
+   detail page.
+
+.. _holdsautofill-label:
+
+HoldsAutoFill
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Default: Don't
+
+Asks: \_\_\_ automatically fill holds instead of asking the librarian.
+
+Values:
+
+-  Do
+   
+-  Don't
+   
+Description:
+
+-  If set to 'Do', the holds confirmation pop-up will not appear upon checking 
+   in a reserved item.
+
+.. _holdsautofillprintslip-label:
+
+HoldsAutoFillPrintSlip 
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Default: Don't
+
+Asks: \_\_\_ automatically display the holds slip dialog for auto-filled holds.
+
+Values:
+
+-  Do
+
+-  Don't
+   
+Description:
+
+-  If set to 'Do', the holds slip print pop-up will appear automatically 
+   upon checking in a reserved item.
+
+-  :ref:`HoldsAutoFill` must be set to 'do' for this preference to have any 
+   effect. 
+
 .. _updatenotforloanstatusoncheckin-label:
 
 UpdateNotForLoanStatusOnCheckin
@@ -3474,19 +3564,27 @@ Description:
 MarkLostItemsAsReturned
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Default: Mark
+Default: Disable
 
 Asks: \_\_\_ items as returned when flagged as lost.
 
 Values:
 
--  Do not mark
+-  [Select All]
+
+-  From the batch item modification tool
 
--  Mark
+-  From the items tab of the catalog module
+
+-  From the longoverdue cronjob
+
+-  When cataloging an item
 
 Description:
 
--  This preference lets you decide if an item marked as lost is automatically returned from the user's file or not.
+-  The library can choose which of these actions or all of these actions, does an 
+item gets automatically returned from the patron's account or not. 
+
 
 .. _maxoutstanding-label:
 
@@ -4663,6 +4761,57 @@ Values:
 -  Allow
 
 -  Don't allow
+   
+.. _holdssplitqueue-label:
+
+HoldsSplitQueue
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Default: nothing
+
+Asks: In the staff client, split the holds queue into separate tables by \_\_\_
+
+Values:
+
+-  pickup library
+   
+-  pickup library & itemtype
+   
+-  hold itemtype
+   
+-  nothing
+   
+Description: 
+
+-  This feature allows to separate holds by pickup library or itemtype in the 
+   holds page of a record (not in the global holds queue found on the circuation 
+   page).
+
+-  When using the up and down arrows, the priorities will be changed only in 
+   in the group the holds belongs to.
+
+.. _holdssplitqueuenumbering-label:
+
+HoldsSplitQueueNumbering
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Default: the actual priority, which may be out of order
+
+Asks: If the holds queue is split, show librarians \_\_\_
+
+Values:
+
+-  the actual priority, which may be out of order
+
+-  'virtual' priorities, where each group is numbered separately
+   
+Description:
+
+-  This system preference is only effective if :ref:`HoldsSplitQueue` is set to 
+   any value except 'nothing'.
+
+-  This system preference controls the priority numbering on the holds page 
+   of a record (not in the global holds queue found on the circulation page). 
 
 .. _localholdspriority,-localholdsprioritypatroncontrol,-localholdspriorityitemcontrol-label:
 
@@ -6746,6 +6895,52 @@ Description:
    cover images to bib records and display them on the detail page and
    search results in the OPAC.
 
+.. _manual-sysprefs-label:
+
+Manual 
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. _kohamanualbaseurl-label:
+
+KohaManualBaseURL
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Default: https://koha-community.org/manual/
+
+Asks: Location of the Koha manual \_\_\_
+
+Description:
+
+-  You can specify the location of the Koha manual to use. This is the 
+   URL that will be used for the help pages when you click 'Help' at 
+   the top right corner of the page.
+
+-  By default, the Koha manual is used, but you can use this system 
+   preference to substitute for your own help pages.
+
+-  If the URL starts with '/', the value of :ref:`staffClientBaseURL` 
+   will be used as a prefix. 
+
+-  Note that it will be suffixed by the version / the language / the 
+   format (/17.11/en/html) 
+
+.. _kohamanuallanguage-label:
+
+KohaManualLanguage
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Default: English
+
+Asks: Language of the online manual \ad\_\_\_
+
+Description: 
+
+-  By default, the language of the Koha interface will be used 
+   as the manual language. However, if the manual is not translated 
+   in that language, this system preference specifies the fallback 
+   language.
+
+
 .. _novelist-select-label:
 
 Novelist Select
@@ -6890,78 +7085,6 @@ Values:
 
 -  under the Save Record dropdown on the right
 
-.. _oclc-label:
-
-OCLC
-~~~~~~~~~~~~~~~~~~~~~
-
-.. _oclcaffiliateid-label:
-
-OCLCAffiliateID
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Asks: Use the OCLC affiliate ID \_\_\_ to access the xISBN service.
-
-Description:
-
--  This setting is only applicable if the library has an OCLC Affiliate
-   ID. This allows WorldCat searching in the OPAC via the XISBN
-   programming interface. Simply enter the library's OCLC Affiliate ID
-   in the box provided. Please note that using this data is only
-   necessary if :ref:`FRBRizeEditions` and/or
-   :ref:`OPACFRBRizeEditions` and :ref:`XISBN`
-   settings are enabled. For more information on this service please
-   visit the OCLC website:
-   http://www.worldcat.org/affiliate/default.jsp.
-
-    **Important**
-
-    Unless you have signed up for an ID with OCLC, you are limited to
-    1000 requests per day. Available at:
-    http://www.worldcat.org/affiliate/webservices/xisbn/app.jsp
-
-.. _xisbn-label:
-
-XISBN
-^^^^^^^^^^^^^^^^^^
-
-Default: Don't use
-
-Asks: \_\_\_ the OCLC xISBN service to show other editions of a title
-
-Description:
-
--  Set to 'Use' to display an "Editions" tab on the item's detail page.
-   Editions are listed, complete with cover art and bibliographic
-   information. The feed comes from OCLC's xISBN web service. The feed
-   limit for non-commercial sites is 1000 requests per day.
-
-Values:
-
--  Don't use
-
--  Use
-
-    **Important**
-
-    Requires :ref:`FRBRizeEditions` and/or
-    :ref:`OPACFRBRizeEditions` set to 'show'
-
-.. _xisbndailylimit-label:
-
-XISBNDailyLimit
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Default: 999
-
-Asks: Only use the xISBN service \_\_\_ times a day.
-
-    **Important**
-
-    Unless you have signed up for an ID with OCLC, you are limited to
-    1000 requests per day. Available at:
-    http://www.worldcat.org/affiliate/webservices/xisbn/app.jsp
-
 .. _open-library-label:
 
 Open Library
@@ -7725,7 +7848,7 @@ opaclanguagesdisplay
 
 Default: Don't allow
 
-Asks: \_\_\_ patrons to select their language on the OPAC.
+Asks: \_\_\_ patrons to change the language they see on the OPAC.
 
 Values:
 
@@ -8553,6 +8676,10 @@ Values:
           :ref:`OPACXSLTResultsDisplay` need to
           have values in order for this preference to work.
 
+   -  **Important**
+
+          This is only implemented for MARC21 and NORMARC.
+
 -  Detail page only
 
    -  **Important**
@@ -8560,6 +8687,10 @@ Values:
           :ref:`OPACXSLTDetailsDisplay` needs to
           have a value in it for this preference to work.
 
+   -  **Important**
+
+          This is only implemented for MARC21 and NORMARC.
+
    |image70|
 
 -  Neither details or results page
@@ -8571,6 +8702,10 @@ Values:
           :ref:`OPACXSLTResultsDisplay` needs to
           have a value in it for this preference to work.
 
+   -  **Important**
+
+          This is only implemented for MARC21 and NORMARC.
+
 Description:
 
 -  In addition to this option being set, the corresponding XSLT option
@@ -8595,8 +8730,8 @@ Default:
 
     |image1192|
 
-Asks: List export options that should be available from OPAC detail page
-: \_\_\_
+Asks: Select export options that should be available from OPAC detail 
+page: \_\_\_
 
 Description:
 
@@ -8932,13 +9067,13 @@ Description:
 OPACMySummaryHTML
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Asks: Include a "Links" column on the "my summary" tab when a user is
+Asks: Include a "Links" column on the "your summary" tab when a user is
 logged in to the OPAC, with the following HTML (leave blank to disable).
 
 Description:
 
 -  In this preference you can enter HTML that will appear on the
-   'Checked Out' tab on the 'My Summary' section when logged in to the
+   'Checked Out' tab on the 'your summary' section when logged in to the
    OPAC. The placeholders {BIBLIONUMBER}, {TITLE}, {ISBN} and {AUTHOR}
    will be replaced with information from the displayed record. This can
    be used to enter in 'share' links for social networks or generate
@@ -8967,7 +9102,7 @@ Description:
 
 -  This preference will display text above the patron's summary and
    below the welcome message when the patron logs in to the OPAC and
-   view their 'my summary' tab.
+   view their 'your summary' tab.
 
     |image1193|
 
@@ -9300,7 +9435,7 @@ Values:
 Description:
 
 -  If you're :ref:`allowing patrons to make purchase
-   suggestions <suggestion-label>` then they will see the 'my
+   suggestions <suggestion-label>` then they will see the 'your purchase
    suggestions' tab when logged in. This tab shows the patron the
    librarian who approved or rejected the purchase suggestion. This
    preference controls if the patron sees the librarian's name or not.
@@ -9694,7 +9829,7 @@ OPACFinesTab
 
 Default: Allow
 
-Asks: \_\_\_ patrons to access the Fines tab on the My Account page on
+Asks: \_\_\_ patrons to access the Fines tab on the 'your summary' page on
 the OPAC.
 
 Values:
@@ -9749,7 +9884,7 @@ OpacItemLocation
 
 Default: call number only
 
-Asks: Show \_\_\_\_ for items on the OPAC search results.
+Asks: Show \_\_\_ for items on the OPAC search results.
 
 Values:
 
@@ -11417,15 +11552,25 @@ Values:
 
 Description:
 
-When the value of this system preference is set to 'do', Koha will look at the
-patron's circulation history to see if they have checked this item out before.
-An alert will show up on the screen indicating that patron has indeed checked
-this item out.  Staff will be prompted to allow the checkout to occur.
-If the vaulue is set to 'don't', Koha will not check the patron's circulation
-history. When the value is set to 'Unless overridden, do', this will check the
-patron's circulation history even if there are fines, fees, and/or holds on the
-patron's account.  Lastly, if the value is set to 'Unless overridden, don't',
-Koha will not check circulation history regardless of fines, fees, and/or holds.
+-  When the value of this system preference is set to 'do', Koha will look at the
+   patron's circulation history to see if they have checked this item out before.
+   An alert will show up on the screen indicating that patron has indeed checked
+   this item out. Staff will be prompted to allow the checkout to occur.
+
+   |image1390|
+
+-  If the value is set to 'do not', Koha will not check the patron's circulation
+   history.
+
+-  When the value is set to 'Unless overridden, do', this will check the
+   patron's circulation history unless the patron's :ref:`personal setting 
+   <add-a-new-patron>` or the :ref:`patron category setting <adding-a-patron-category>` 
+   specifically say not to.
+   
+-  Lastly, if the value is set to 'Unless overridden, do not',
+   Koha will not check circulation history unless the patron's :ref:`personal 
+   setting <add-a-new-patron>` or the :ref:`patron category setting <adding-a-
+   patron-category>` specifically say to check.
 
      **Note**
 
@@ -11611,7 +11756,7 @@ intranetreadinghistory
 
 Default: Allow
 
-Asks: \_\_\_ staff to access a patron's checkout history.
+Asks: \_\_\_ staff to access a patron's checkout and hold history.
 
     **Important**
 
@@ -11629,7 +11774,7 @@ Values:
 
     Reading history is still stored, regardless of staff being allowed
     access or not unless the patron has chosen to have their history
-    anonymized via their :ref:`privacy page <my-privacy-label>`.
+    anonymized via their :ref:`privacy page <your-privacy-label>`.
 
 .. _maxfine-label:
 
@@ -11816,6 +11961,10 @@ SMSSendDriver, SMSSendUsername, and SMSSendPassword
 Asks: Use the SMS::Send:: \_\_\_ driver to send SMS messages. Define a
 username/login \_\_\_ and a password \_\_\_.
 
+    **Note**
+
+    This may not work with all providers.
+
     **Important**
 
     Please refer to your national laws concerning the sending of bulk
@@ -11934,6 +12083,33 @@ Values:
 -  Do
 
 -  Don't
+   
+.. _useemailreceipts-label:
+
+UseEmailReceipts
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Default: Don't send
+
+Asks: \_\_\_ email receipts to patrons for payments and writeoffs.
+
+Values:
+
+-  Don't send
+   
+-  Send
+   
+Description:
+
+-  If set to 'Send', Koha will send emails to the patrons for each 
+   payment or writeoff done in their account.
+
+     **Note**
+
+     -  The letters used are ACCOUNT\_PAYMENT and ACCOUNT\_WRITEOFF
+        
+     -  You can edit them in the :ref:`Notices and slips<notices-&-slips-label>` 
+        tool.
 
 .. _usedischarge-label:
 
@@ -12370,7 +12546,7 @@ defaultSortField Default: author
 defaultSortOrder Default: ascending
 
 Asks: By default, sort search results in the staff client by \_\_\_,
-\_\_\_\_
+\_\_\_
 
 Description:
 
@@ -12595,7 +12771,7 @@ OPACItemsResultsDisplay
 
 Default: Don't show
 
-Asks: \_\_\_ an item's branch, location and call number in OPAC search
+Asks: \_\_\_ an item's library, location and call number in OPAC search results.
 results.
 
 Values:
@@ -13027,6 +13203,10 @@ Values:
           :ref:`XSLTResultsDisplay` need to
           have values in order for this preference to work.
 
+   -  **Important**
+
+          This is only implemented for MARC21.
+
 -  Detail page only
 
    -  **Important**
@@ -13034,6 +13214,10 @@ Values:
           :ref:`XSLTDetailsDisplay` needs to
           have a value in it for this preference to work.
 
+   -  **Important**
+
+          This is only implemented for MARC21 and UNIMARC.
+
    |image113|
 
 -  Neither details or results page
@@ -13045,6 +13229,10 @@ Values:
           :ref:`XSLTResultsDisplay` needs to
           have a value in it for this preference to work.
 
+   -  **Important**
+
+          This is only implemented for MARC21 and NORMARC.
+
 Description:
 
 -  In addition to this option being set, the corresponding XSLT option
@@ -13265,7 +13453,16 @@ Description:
 staffClientBaseURL
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Asks: The staff client is located at http:// \_\_\_
+Asks: The staff client is located at \_\_\_
+
+    **Important**
+
+    This should be a complete URL, starting with http:// or https://. 
+    Do not include a trailing slash in the URL.
+
+    **Note**
+
+    This must be filled in correctly for CAS, svc, and load_testing to work.
 
 .. _stafflangselectormode-label: