foto-portfolio/docs/ADMIN-GUIDE.md

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.php?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/.