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

Printing from iOS and iPadOS
----------------------------

.. list-table:: Printing from iOS and iPadOS
   :width: 100%
   :widths: 12 88
   
   * - |image73|
     - If :ref:`SavaPage IPP Everywhere <ch-printer-ipp-everywhere>`
       is configured in a Local Network, the corresponding AirPrint printer
       is automatically detected and can directly be used without
       any configuration. |br| 
       |br|

       -  64-bit iOS (iPadOS) is supported, 32-bit is **not**.

       -  :ref:`IP Based Authentication <ch-auth-ip-based>` or 
          :ref:`Basic Authentication <ch-auth-basic>` is needed
          before submitting a print job.

   * - |image74|

     - For your convenience ``https://:savapage:8632/ios/install`` is 
       available to add a SavaPage icon to the Home Screen automatically.
       See :ref:`URL Cheat Sheet <app-url-cheat-sheet>`. A click on the icon
       opens the SavaPage User Web App full-screen and will therefore be
       part of the multitasking bar. |br|
       |br|
       This convenience comes with a penalty though, since Apple treats
       full-screen WebApps in a “special” way, i.e. when they are selected
       from the multitasking bar and regain focus the Web App is reloaded. |br|
       |br|
       Luckily, since SavaPage utilizes an :ref:`authentication
       token <ch-security-auth-tokens>`, an automatic login is performed.
       However, the page needs to be retrieved from the server again, giving
       some performance penalty. |br|
       |br|

       .. note::
   
          Only one SavaPage Web Clip can be present on an iOS  device.
          A new install overwrites the previous one.

       .. warning::

          When using the :ref:`Payment Gateway Plug-in <app-plugin-payment-gateway>`,
          the redirect URL as forwarded to and applied by the payment provider does not
          show in the same User WebApp as where the payment started, but is shown on
          a new tab in the default browser.

       .. tip::

          If you don't care about the full-screen User Web App, and
          want optimal performance, you can just add any SavaPage
          Web App to the Home Screen manually by surfing to the URL,
          then click the **Share** button and choose **Add to Home Screen**.
          Clicking the home screen icon will not open the Web App
          full-screen, but as a tabbed instance in the browser. Also,
          it will not be reloaded by definition as the browser regains
          focus.

.. /*  
    * Images
    */

.. |image73| image:: ../images/manual/ipp-everywhere-275x320.png
   :width: 80px
   :target: #ch-printer-ipp-everywhere
.. |image74| image:: ../images/manual/apple-logo-128x128.png
   :width: 70px