.. /*  
    * 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-letterheads:

Letterheads
-----------

A *tap* on the Letterhead button in the main SafePages view shows the
Letterhead dialog. See :ref:`SafePages <ch-webapp-user-main>`.

.. _ss-user-letterheads:

.. figure:: ../images/manual/screenshots/user/sp-01-04-user-letterheads.png
   :alt: User Web App: Letterheads
   :width: 400

   User Web App: Letterheads


-  Press the top button to get a pop-up list of letterheads. When a
   letterhead is selected from the list it can be previewed and edited.
   The selected letterhead acts as default in the Print and PDF dialog:
   see :ref:`User Web App: PDF - Letterhead <ss-user-pdf-letterhead>` and
   :ref:`User Web App: Print - Select Printer <ss-user-print-select-printer>`.

-  Press the |RST_BUTTON_REFRESH| button to rebuild the list if you suspect public
   letterheads were added or removed.

-  Press the |RST_BUTTON_NEW| button to create a new letterhead from the current
   SafePages. All the SafePages are used for the letterhead.
   :ref:`User Web App: Letterhead - New <ss-user-letterhead-new>` is an example of a fresh
   created letterhead.

.. note::

   Depending on :ref:`User Privileges <ch-webapp-admin-user-group-edit-user-privileges>`
   buttons and sections for creating and editing letterheads might not
   be shown.

.. note::

   If the SafePages contain DRM-restricted content the |RST_BUTTON_NEW| button is
   *not* visible.

.. _ss-user-letterhead-new:

.. figure:: ../images/manual/screenshots/user/sp-01-04-user-letterhead-new.png
   :alt: User Web App: Letterhead - New
   :width: 400

   User Web App: Letterhead - New

-  If the letterhead document consists of *one* page, this page is applied
   to every page of the document. The letterhead page is scaled and
   rotated as needed to fit the input page.

-  If the letterhead document has *more* than one page, each page of the
   letterhead is applied to the corresponding page of the output
   document. If the output document has more pages than the letterhead,
   then the final letterhead page is repeated across these remaining
   pages of the output document.

-  Letterheads can be applied on the |RST_BUTTON_FOREGROUND| or |RST_BUTTON_BACKGROUND|.

-  Users who are administrator can mark letterheads as *public* by
   ticking the |RST_CHECKBOX_PUBLIC| checkbox. Public letterheads are available for
   all users, but can be edited and deleted by administrators only.

-  The |RST_GUILABEL_NAME| of a *private* letterhead can be edited. The |RST_GUILABEL_NAME| of a
   *public* letterhead can be edited by an administrator only.

-  Tap on a letterhead thumbnail to get a detailed pop-up image. See
   :ref:`User Web App: Letterhead - Detail <ss-user-letterhead-detail>`.

-  Press the |RST_BUTTON_APPLY| button to commit changes or push the 
   |RST_BUTTON_DELETE| button to remove the letterhead.

.. note::

   For a background letterhead to be effective, SafePages should be
   transparent. HTML pages printed from browsers like Internet Explorer
   and Firefox might pose a problem here. The white background on HTML
   pages might act as a solid background.


.. _ss-user-letterhead-detail:
   
.. figure:: ../images/manual/screenshots/user/sp-01-04-user-letterhead-detail.png
   :alt: User Web App: Letterhead - Detail
   :width: 400

   User Web App: Letterhead - Detail


-  Press the |RST_BUTTON_X_CLOSE| button in the upper right corner, or *tap* outside the
   pop-up, to close the pop-up image.