{% extends "base.html" %}
{% block title %}Help · PrintServer{% endblock %}
{% block subtitle %}How to find a station and print{% endblock %}
{% block content %}
<article class="panel help-article">
  <h1>Customer help</h1>
  <p class="lede">Use this site to find a station, print a file, or install only the printers you check. You do not have to put all 30 on your laptop.</p>
  {% if server is defined and server.site_url %}
  <p>This server: <code>{{ server.site_url }}</code></p>
  {% endif %}

  <nav class="help-nav" aria-label="Help topics">
    <a href="#open-site">Open the site</a>
    <a href="#sign-in">Sign in</a>
    <a href="#find-station">Find a station</a>
    <a href="#print-website">Print from the website</a>
    <a href="#existing">Already on my laptop</a>
    <a href="#install-page">Install printers page</a>
    <a href="#windows-printer">Connect a Windows printer</a>
    <a href="#disconnect">Disconnect</a>
    <a href="#drivers">Download a driver</a>
    <a href="#test">Test connection</a>
    <a href="#client">Windows app</a>
  </nav>

  <h2 id="open-site">Open the site from a laptop</h2>
  <ol>
    <li>Join the office network (same LAN as PrintServer). Guest Wi‑Fi that cannot reach office PCs will not work.</li>
    <li>In Edge or Chrome, open the LAN address your admin gave you, for example <code>http://192.168.x.x:8090</code>.</li>
    <li>If the page does not load, the laptop is on the wrong network or the server firewall is blocking the website port.</li>
  </ol>

  <h2 id="sign-in">Sign in</h2>
  <ol>
    <li>Use the <strong>customer</strong> account your admin created (not the admin login unless you are an admin).</li>
    <li>After sign-in you see printers, station numbers, locations, driver versions, and Connected / Disconnected.</li>
  </ol>

  <h2 id="find-station">Find the printer in front of you</h2>
  <ol>
    <li>Look at the station label on the printer or desk (for example <strong>ST-12</strong>).</li>
    <li>Type that station in Search. You can also search by name or office location.</li>
    <li>Check <strong>Connection</strong>. Connected means the server can reach that printer. Disconnected means do not send a job yet.</li>
  </ol>

  <h2 id="print-website">Print a file from the website (no local printer)</h2>
  <p>Use this when you just need to send a document and do not need Word’s Print dialog.</p>
  <ol>
    <li>Sign in and find the station.</li>
    <li>Under <strong>Print through server</strong>, choose that printer.</li>
    <li>Choose your file and click <strong>Send print job</strong>.</li>
    <li>The server sends the file to the printer IP. You do not install anything on the laptop.</li>
  </ol>

  <h2 id="existing">Already have printers and drivers on the laptop?</h2>
  <p>Yes — you can keep using them. A web browser cannot see your local printers. Use the <strong>Windows PrintServer app</strong>.</p>
  <ol>
    <li>Open the Windows app and sign in.</li>
    <li>The <strong>On this PC</strong> column shows if that station is already installed, or if only the driver is present.</li>
    <li>Select the station and click <strong>Use existing on this PC</strong>. That sets your current printer as the default. It does not add another <code>PS-</code> copy.</li>
    <li>If Connect this station finds a match, choose <strong>Yes</strong> to use the existing one, or <strong>No</strong> only if you really want a new PrintServer queue.</li>
  </ol>
  <p>Disconnect removes only <code>PS-</code> printers. Printers you installed yourself stay. Drivers already on the PC are reused when a new <code>PS-</code> queue is added.</p>

  <h2 id="install-page">Install printers page (fastest for several stations)</h2>
  <ol>
    <li>Open <strong>Install printers</strong> in the top bar (or go to <code>/install</code>).</li>
    <li>Search if you want, then check the boxes for the stations you need.</li>
    <li>Click <strong>Download install script</strong>. You get a <code>.cmd</code> file. Double-click it (do not open it in PowerShell ISE). It runs with Bypass so unsigned-script policy does not block it.</li>
    <li>Windows gets only the printers you checked. Previous <code>PS-</code> printers on that laptop are replaced by this selection.</li>
    <li>Use <strong>Clear</strong> to uncheck, or <strong>Check all in this list</strong> after a search (for example every printer on the 3rd floor). That only ticks boxes; it does not install yet. Avoid checking all 30 unless you really need them.</li>
  </ol>

  <h2 id="windows-printer">Connect this station as my Windows printer</h2>
  <p>Use this when you want <strong>File → Print</strong> in Word, Excel, or the browser. Map <em>only the station you are standing at</em>. Do not add all 30 printers.</p>
  <p>A web browser cannot install a Windows printer by itself. Use the Windows PrintServer app, or download the connect script.</p>
  <h3>Option A — Windows app (easiest)</h3>
  <ol>
    <li>Open the <strong>Windows app</strong> page and click <strong>Download Windows app (zip)</strong>, or use the button on Install printers.</li>
    <li>Unzip, then double-click <strong>Start-PrintServer-App.cmd</strong>.</li>
    <li>Set Server URL to this site (LAN address and port).</li>
    <li>Sign in with your customer account.</li>
    <li>Select the station row. If <strong>On this PC</strong> already shows a printer, click <strong>Use existing on this PC</strong>.</li>
    <li>Otherwise click <strong>Connect this station</strong>. If one is already installed, pick Yes to reuse it.</li>
  </ol>
  <h3>Option B — Script from this website</h3>
  <ol>
    <li>On the printer list, click <strong>Connect station</strong> for the row you want.</li>
    <li>Click <strong>Download connect script</strong>. You get a <code>.cmd</code> file.</li>
    <li>Double-click it. If SmartScreen warns, choose More info → Run anyway. Do not open the file in PowerShell ISE.</li>
    <li>If Windows asks for permission to add a printer, approve it.</li>
    <li>If it says no driver was found, download the driver for that station, install it, then run the script again.</li>
  </ol>
  <p>The script names the Windows queue with a <code>PS-</code> prefix so it is easy to see and easy to remove.</p>

  <h2 id="disconnect">Disconnect when you leave that station</h2>
  <ol>
    <li>In the Windows app, click <strong>Disconnect station</strong>, or</li>
    <li>On the website Connect dialog, download <strong>Disconnect script</strong> and run it, or</li>
    <li>In Windows: Settings → Bluetooth &amp; devices → Printers &amp; scanners → select the <code>PS-...</code> printer → Remove.</li>
  </ol>
  <p>Connecting from a single row, or installing a new checkbox selection, replaces previous <code>PS-</code> printers with what you chose.</p>

  <h2 id="drivers">Download a driver</h2>
  <p>Admins and customers can both download driver packages. Use this if the connect script cannot find a Windows driver, or if IT wants the printer installed by IP with the vendor installer.</p>
  <ol>
    <li>Find the station and click <strong>Download driver</strong>, or use the driver library on the portal.</li>
    <li>Run the installer on the laptop if it is an <code>.exe</code>, or install the <code>.inf</code> if IT instructed that.</li>
    <li>Then use <strong>Connect this station</strong> again so Word can see the queue.</li>
  </ol>

  <h2 id="test">Test if the printer is online</h2>
  <ol>
    <li>Click <strong>Test</strong> on the printer row (website or Windows app).</li>
    <li>Connected means print port 9100 or IPP 631 answered.</li>
    <li>Disconnected means the device is off, on another VLAN, or the IP is wrong. Tell an admin; do not keep sending jobs.</li>
  </ol>

  <h2 id="client">Windows app summary</h2>
  <ul>
    <li><strong>Search</strong> — station, name, location</li>
    <li><strong>Test connection</strong> — is this printer reachable?</li>
    <li><strong>Download driver</strong> — save the package IT uploaded</li>
    <li><strong>On this PC</strong> — already installed printer or driver</li>
    <li><strong>Use existing on this PC</strong> — keep your current printer, set it as default</li>
    <li><strong>Connect this station</strong> — add a PS- queue only if you still need one</li>
    <li><strong>Disconnect station</strong> — remove PS- printers only</li>
    <li><strong>Print file</strong> — send through the server without a local queue</li>
  </ul>
  <p>You never need all 30 printers installed. Connect the station you are using, print, then connect a different station when you move — or disconnect when you are done.</p>
</article>
{% endblock %}