.. /*  
    * This file is part of the SavaPage project <https://www.savapage.org>.
    * Copyright (c) 2026 Datraverse B.V.
    * Author: Rijk Ravestein.
    *
    * SPDX-FileCopyrightText: (c) 2020 Datraverse B.V. <info@datraverse.com>
    * SPDX-License-Identifier: CC-BY-SA-4.0
    *
    * For more information, please contact Datraverse B.V. at this
    * address: info@datraverse.com
    */

.. _ch-webapp-user-main-upload:

Upload
------

.. _ch-webapp-user-main-upload-dialog:

Upload Dialog
~~~~~~~~~~~~~

This dialog implements the |PRODUCT_NAME| |RST_LINK_WEBPRINT| function, and is shown
after a tap on the Upload button in the :ref:`footer <ch-webapp-user-main-footer>`
of the main panel.

.. figure:: ../images/manual/screenshots/user/sp-01-00-user-upload-file.png
   :width: 400
   
   Web Print: Upload File


- **Font for plain text** : change the font when you upload a plain text file (TXT)
  that contains characters not supported by the
  :ref:`Default <ch-i18n-font-default>` font, like :ref:`CJK <ch-i18n-font-cjk>`.
  Use :ref:`Unifont <ch-i18n-font-unifont>` if the source text has a real broad Unicode coverage.

- **Choose Files** to be uploaded. Beware that the actual file selection
  button differs from browser to browser.

- Press the |RST_BUTTON_UPLOAD| button to start the upload.

- The status of the upload will be displayed below the selected file
  name.

- The |RST_BUTTON_RESET| button clears the status messages and selected file.

- The wastebasket |RST_BUTTON_WASTEBASKET_ICON| button shows the number of (uploaded) 
  documents currently present in the :ref:`SafePages <ch-webapp-user-main>` inbox.
  When you press this button, all documents will be deleted, and the button hidden
  (until the inbox is filled again).

- After the upload, use the |RST_BUTTON_BACK|, |RST_BUTTON_PRINT| or |RST_BUTTON_PDF| 
  buttons to navigate to the next step.

:ref:`Supported Document and Graphics <app-printable-file-types>` can be
restricted with the following configuration properties:


.. list-table::  Configuration Properties for Web Print Document Types
   :width: 100%
   :header-rows: 1
   
   * - Configuration property
     - Description
   * - web-print.graphics.enable
     - | Enable graphics files for Web Print: ``Y`` (default) or ``N``.
   * - web-print.file-ext.exclude
     - | A comma or space separated list of file extensions 
       | (without leading point), that are excluded for Web Print. 
       | For example: ``rtf,html,ps,txt``. When TXT file type is 
       | excluded, the Font for plain text selection in the Upload File
       | dialog is removed.

See |RST_LINK_CONFIG_EDITOR| on how to set these items.

.. note::

   For uploaded file types that do not have a page size defined (HTML,
   TXT) the :ref:`default paper size <ch-webapp-admin-options-advanced-default-paper-size>` is
   used. For image files the graphic involved is a best fit on the
   :ref:`default paper size <ch-webapp-admin-options-advanced-default-paper-size>`.