Update docs
This commit is contained in:
+37
-1
@@ -1,7 +1,8 @@
|
||||
# Let visitors send photos back
|
||||
|
||||
Visitors to a share can send their own photos and videos into it, for example guests adding their pictures to a
|
||||
wedding album. The photos go straight into the album in Immich and appear in the gallery for everyone.
|
||||
wedding album. The photos go straight into the album in Immich and appear in the gallery for everyone, unless you
|
||||
choose to [review them first](#review-uploads-before-they-appear).
|
||||
|
||||
This guide assumes IPP is already [installed](/installation) behind a reverse proxy.
|
||||
|
||||
@@ -16,6 +17,7 @@ This guide assumes IPP is already [installed](/installation) behind a reverse pr
|
||||
- [Set a storage quota](#set-a-storage-quota)
|
||||
- [Request size limits](#request-size-limits)
|
||||
- [Tag uploaded photos](#tag-uploaded-photos)
|
||||
- [Review uploads before they appear](#review-uploads-before-they-appear)
|
||||
- [Get a notification for each upload](#get-a-notification-for-each-upload)
|
||||
- [Questions](#questions)
|
||||
|
||||
@@ -237,6 +239,35 @@ uploads, or to copy them into a second album. In Immich, open **Workflows** and
|
||||
2. Filter: **Filter by filename**, match type `startsWith`, pattern `ipp_upload_`.
|
||||
3. Action: **Add Tags** with a tag such as `Sent by visitors`, or **Add to Album(s)**.
|
||||
|
||||
## Review uploads before they appear
|
||||
|
||||
Immich has no approval queue for uploads through a shared link, but a workflow can move each upload into your
|
||||
**locked folder** the moment it arrives. IPP never shows a locked photo, so the upload leaves the gallery until you
|
||||
decide to keep it. This is the staging step: visitors upload, you approve, the gallery updates.
|
||||
|
||||
The locked folder needs a PIN. Set one in your Immich account settings if you have not already. Then create a
|
||||
workflow as in [Tag uploaded photos](#tag-uploaded-photos), with these actions:
|
||||
|
||||
1. Trigger: **Asset Upload**.
|
||||
2. Filter: **Filter by filename**, match type `startsWith`, pattern `ipp_upload_`.
|
||||
3. Action: **Move to locked folder**. Add a second action, **Add Tags**, if you want the approved uploads to stay
|
||||
easy to find afterwards.
|
||||
|
||||
To review, open the locked folder in Immich and enter your PIN. A photo's info panel lists the album it was sent
|
||||
to under **Appears in**, since it is still a member while locked. Move the photos you want to keep out of the locked
|
||||
folder: they return to the gallery on the next cache refresh. Delete the rest. Pair this with a
|
||||
[notification](#get-a-notification-for-each-upload) so you know when there is something to review; its message names
|
||||
the share, which is the only record of the destination for a share of individual photos, as those have no album.
|
||||
|
||||
Two things to know:
|
||||
|
||||
- The upload is pulled back, not held back. The workflow runs a few seconds after the file is stored, and IPP
|
||||
caches a share's photo list for up to 2 minutes, so a visitor who has the gallery open can see the photo for a
|
||||
short while. Anyone who copied the photo's address in that window can keep opening it until you delete it.
|
||||
- Keeping a photo relies on Immich leaving it in the album while it is locked, which it does for photos a workflow
|
||||
moves. If a future Immich version removes it from the album instead, add the approved photos back to the album
|
||||
by hand.
|
||||
|
||||
## Get a notification for each upload
|
||||
|
||||
Set [`upload.notifyUrl`](/config/upload-service#notifyurl) to a URL that receives a JSON message for each stored
|
||||
@@ -260,6 +291,11 @@ So a new photo can take up to about 7 minutes to show for a visitor who already
|
||||
|
||||
Immich keeps the one copy and adds it to the share. The visitor's list shows the file as a duplicate.
|
||||
|
||||
### Can I approve uploads before visitors see them
|
||||
|
||||
Not in Immich itself, but a workflow that moves each upload to your locked folder gives you the same result. See
|
||||
[Review uploads before they appear](#review-uploads-before-they-appear).
|
||||
|
||||
### Can visitors see who uploaded what, or remove photos
|
||||
|
||||
No. The upload page shows nothing from the share, only the visitor's own uploads in progress, and nothing can be
|
||||
|
||||
Reference in New Issue
Block a user