schliesser / credits
Give credits: Automatically list all used images with their copyright. Multisite support.
Installs: 131
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 3
Type:typo3-cms-extension
Requires
- php: ^8.1
- typo3/cms-filemetadata: ^12.4 || ^v13.0
Requires (Dev)
- saschaegerer/phpstan-typo3: dev-master
- typo3/cms-composer-installers: ^5.0
- typo3/coding-standards: ^0.8.x-dev
- typo3/testing-framework: ^8.0
README
The Credits extension for TYPO3 provides a content element that lists all images used within the site, provided that copyright information has been properly maintained in the metadata. For each image, the extension also lists the pages on which the image is used.
Features
- Displays a list of all images with copyright information.
- Shows the pages where each image is used.
- Easy integration as a TYPO3 content element.
- Multisite support: only images used in the same site are displayed.
Requirements
- TYPO3 v12.4 or higher
- PHP 8.1 or higher
- TYPO3 core extension: filemetadata (
typo3/cms-filemetadata
)
Installation
Install via Composer: composer require schliesser/credits
Or via Extension Manager from TER.
Configuration
No configuration needed. Not even a TypoScript to include!
Usage
Add copyrights to file metadata
To ensure the extension works correctly, make sure to maintain the copyright information in the metadata of each image:
- Navigate to the Filelist module in the TYPO3 backend.
- Select an image file and open the file properties.
- Selecte the metadata tab.
- Enter the copyright information in the copyright field.
- Save the changes.
NOTE: Only images with copyright are listet!
Add the content element
In the TYPO3 backend, go the page where you want to display the image copyright list. Add a new content element and select the "Image Copyright Listing" element from the wizard. You can add a Headline. No further configuration is needed.
Customization
To customize the HTML output, you can override the Fluid templates used by this extension. Copy the template from EXT:credits/Resources/Private/Templates to your site package extension and adjust them as needed.
Register your custom template path in TypoScript:
tt_content.credits_images.20.view.templateRootPaths.100 = EXT:site_package/Resources/Private/Templates/Credits
Contribution
We welcome contributions to improve this extension. Please submit your issues and pull requests on GitHub.
Development setup
- Clone project and
cd
into the extension folder - Install dependencies for tests:
composer install
- Run tests with:
composer run test