# Admin Guide (Backoffice)

Open `https://your-domain.com/admin/` and log in. All content management
happens here; visitors never see this area.

## Front page

*Front page* edits the landing page: your name/title, the introduction text
(line breaks are kept), and the full-page hero image. Uploading a new hero
image replaces the old one. Images are stored in full resolution, unmodified.

## Showreel

*Showreel* manages the portfolio shown at `/showreel.php` — each image fills
the whole screen, in the order listed. Upload images (a few at a time — these
go through the webhost, which may have upload size limits), reorder them with
the arrow buttons, remove them with ✕. Showreel images are stored locally on
the webhost.

## Galleries

*Galleries* is for delivering whole events to clients.

**Create** a gallery with a title, and optionally:

- **Password** — visitors must enter it before seeing the gallery. You can
  set, change, or remove it later.
- **Expiry date** — after this day the gallery link shows "not available".
  Nothing is deleted; clearing the date brings it back.
- **Resize uploads to** — cap the longest edge of every image uploaded into
  this gallery: *Ultra (4096 px)*, *High (2560 px)*, *Mid (1920 px)*,
  *Low (1280 px)*, or your own number. The default, *Original*, stores what the
  camera produced. Resizing happens in your browser before the file is sent, so
  it also gets big images past the webhost's upload limit — but re-saving the
  image drops its EXIF data (camera, lens, date, location), so choose
  *Original* when that matters. Files the browser cannot read, such as RAW, are
  uploaded at full size regardless.

All of these can be changed later in the gallery editor. Changing the
resolution affects new uploads only; images already in the gallery stay as they
were stored.

Each gallery gets an unguessable link like
`/gallery/?g=wedding-mueller-x7Kf3q` — copy the *Share link* from the
gallery editor and send it to your client.

**Upload images** by dropping them onto the upload area in the gallery editor.
Unless the gallery caps its resolution (above), files are stored in **full
resolution, byte-for-byte unmodified**. Keep the browser tab open until every file
shows *done*; failed files offer a *retry* link. A small preview thumbnail is
generated by your browser for the gallery grid; files the browser cannot
decode (e.g. RAW) are uploaded anyway, just without a preview.

**Delete** an image (✕ on its thumbnail) or a whole gallery — this also
removes the files from S3 permanently.

## Settings

Change the admin password here (minimum 8 characters). The change takes
effect immediately. The username and the S3 settings can only be changed by
editing the files in `config/` on the server.

After 5 failed login attempts the login is locked for 15 minutes.

## Good to know

- Visitors load gallery photos straight from Hetzner S3 through signed URLs
  that expire after ~1 hour; reloading the page issues fresh ones. Nobody can
  use a shared image URL indefinitely, and expired galleries really do go dark.
- All content lives in flat files: `data/` (JSON) and `media/`
  (showreel/hero images). Backing up = copying those two folders plus
  `config/`.