TaskRox Help & User Manual

Photos is a first-class project module, separate from attachments inside Diary, HSE, QA, or Wall.

Use it when you need: - a central visual register - filtering by category, uploader, album, or date - progress-photo history - defensible evidence that can be reused across records

The module supports four views: - All Photos — grid (2–6 columns) or list browsing with selection mode - Albums — grouped photo sets with cover images - Timeline — chronological grouping by date with expand/collapse - Linked — photos grouped by their parent record and module

Filter by search text, category, album, date range (from/to), and GPS presence (any / has GPS / no GPS). Sort by upload date, taken date, caption, category, or file size in ascending or descending order.

13 categories are available: Progress, Safety, Quality, Defect, Incident, RFI, Delivery, Plant, Personnel, Weather, Environmental, Completion, and General.

Click the Upload button to open the upload sheet. You can: - drag-and-drop files onto the upload area - click to browse and select files - use the Camera button on mobile to capture directly from the device camera

Before uploading, set a category, album, caption, tags, and location text. These are applied to all selected photos in the batch. The upload shows a progress bar with file count (e.g. "3/5").

Supported formats: JPG, JPEG, PNG, GIF, WebP, HEIC, HEIF. Maximum file size: 25 MB per photo.

EXIF data is automatically extracted on upload — the taken-at date, GPS coordinates, and image dimensions are stored with each photo. Thumbnails (256px, JPEG 80%) are generated automatically.

On mobile devices, the upload sheet shows a dedicated Camera button that opens the device camera directly (rear-facing by default).

The workflow is: 1. Open Photos module on your phone or tablet 2. Tap Upload 3. Tap the camera icon to capture, or the gallery icon to select existing photos 4. Set category, album, and caption 5. Tap Upload to submit

Photos are uploaded immediately when you tap submit — there is no auto-upload on capture, so you can review and tag before sending. All uploads work over your current network connection (Wi-Fi or mobile data).

Albums group photos into named sets. Create an album from the Albums tab using the New Album button.

Each album has: - a name and optional description - a cover photo (set from any photo in the album) - a photo count badge

You can add photos to an album during upload (select from the album dropdown) or via bulk actions (select photos → Add to album). Photos can also be assigned to an album from the photo edit sheet.

Each photo stores more than a file: - caption and description - category and tags - album - taken/uploaded timestamps - optional GPS coordinates and location text - source module and linked record

Click any photo to open the lightbox. From there, open the edit sheet to update metadata or manage links.

The Linked tab groups photos by their parent record. Photos can be linked to diary entries, NCRs, RFIs, wall posts, Gantt tasks, ITPs, MOC changes, test requests, and decisions.

Photos can be linked to records in two ways:

From the record — Diary entries, NCRs, and RFIs include a PhotoPicker section. Use it to browse, search, and select existing photos from the library, or upload new ones directly. Linked photos appear as thumbnails on the record.

From the Photos module — Open a photo's edit sheet and use the links section to attach it to any supported entity type.

Wall post integration — When you attach an image to a wall post, a photo record is automatically created in the Photos module and linked back to the post. This also applies to previously posted wall images (backfilled).

Deleting a photo that is linked to records shows a warning with the linked record count before confirming.

Enter selection mode by clicking the checkbox icon. Select individual photos or use Select all.

Available bulk actions: - Tag — apply tags to all selected photos - Add to album — move selected photos into an album - Delete — remove selected photos (with confirmation)

Export your photo register from the module header: - CSV — all metadata fields - XLSX — formatted headers and date formatting - Print view — opens a print-optimised page at /photos/print for generating a PDF via the browser's print dialog

Exports respect the current filter selection (category, album, date range).