README

A TYPO3 extension for searching and importing stock photos directly in the TYPO3 backend.

Powered by Unsplash

Features

Backend Module: Dedicated module under "Media" for browsing and importing photos
Advanced Search: Filter by text, orientation (landscape, portrait, square), and color
Local Import: Downloads images to your fileadmin for GDPR compliance and performance
Automatic Metadata: Populates title, description, alt text, copyright, and photographer info
Download Tracking: Complies with Unsplash API guidelines by tracking downloads
Custom Metadata Fields: Stores Unsplash photo ID, URL, and photographer URL for reference

Requirements

TYPO3 v14.0+
PHP 8.2+
Unsplash API Access Key (Get one here)

Installation

Via Composer (recommended)

composer require dkd-dobberkau/fal-photo-browser

Manual Installation

Download the extension
Place it in packages/dkd_fal_photo_browser/
Add the path repository to your composer.json:

{
    "repositories": [
        {
            "type": "path",
            "url": "packages/*"
        }
    ]
}

Run composer require dkd-dobberkau/fal-photo-browser:@dev

Activate Extension

vendor/bin/typo3 extension:setup --extension=dkd_fal_photo_browser

Configuration

API Key Setup

Set the UNSPLASH_ACCESS_KEY environment variable with your Unsplash API key.

DDEV

Add to .ddev/config.yaml:

web_environment:
  - UNSPLASH_ACCESS_KEY=your_access_key_here

Apache/Nginx

SetEnv UNSPLASH_ACCESS_KEY your_access_key_here

fastcgi_param UNSPLASH_ACCESS_KEY your_access_key_here;

Docker

environment:
  - UNSPLASH_ACCESS_KEY=your_access_key_here

Content Security Policy

The extension automatically registers CSP rules to allow loading thumbnail images from images.unsplash.com in the backend.

Usage

Navigate to Media > Photo Browser in the TYPO3 backend
Enter a search term (e.g., "mountains", "office", "technology")
Optionally filter by orientation or color
Click Import on any photo to download it

Imported images are stored in fileadmin/unsplash/YYYY/MM/ with full metadata including:

Title and description
Alt text
Photographer name and URL
Copyright notice
Original Unsplash URL

File Structure

dkd_fal_photo_browser/
├── Classes/
│   ├── Controller/
│   │   └── PhotoBrowserController.php
│   ├── Domain/
│   │   └── Dto/
│   │       └── UnsplashPhoto.php
│   └── Service/
│       ├── FileImportService.php
│       └── UnsplashApiService.php
├── Configuration/
│   ├── Backend/
│   │   ├── AjaxRoutes.php
│   │   └── Modules.php
│   ├── ContentSecurityPolicies.php
│   ├── Icons.php
│   ├── Services.yaml
│   └── TCA/
│       └── Overrides/
│           └── sys_file_metadata.php
├── Resources/
│   ├── Private/
│   │   ├── Language/
│   │   │   └── locallang_mod.xlf
│   │   └── Templates/
│   │       └── Backend/
│   │           └── Index.html
│   └── Public/
│       ├── Css/
│       │   └── backend.css
│       ├── Icons/
│       │   └── module-falphotobrowser.svg
│       └── JavaScript/
│           └── photo-browser.js
├── composer.json
├── ext_emconf.php
└── ext_tables.sql

Metadata Fields

The extension adds custom fields to sys_file_metadata:

Field	Description
`unsplash_photo_id`	Original Unsplash photo ID
`unsplash_photo_url`	Link to photo on Unsplash
`unsplash_photographer_url`	Link to photographer's profile

These fields appear in a dedicated "Unsplash" tab when editing file metadata.

API Compliance

This extension follows Unsplash API Guidelines:

Downloads are tracked via the API (required)
Photographer attribution is stored in metadata
"Powered by Unsplash" attribution in the UI
Images are hotlink-free (downloaded locally)

License

GPL-2.0-or-later

Credits

Photos provided by Unsplash
Built for TYPO3 CMS

dkd-dobberkau / fal-photo-browser

Maintainers

Package info

Statistics

Security