About this plugin
Image Credit Companion (ICC) is a comprehensive WordPress plugin designed to help content creators and editors properly track, manage, and display image attribution information. Whether you’re running a news site, blog, or any content-driven website, ICC ensures you maintain proper image credits and comply with licensing requirements.
Key Features
- Automatic Image Detection: Automatically scans and tracks images used in posts, supporting both Gutenberg blocks and Classic Editor content
- Editor-Friendly Interface: Gutenberg sidebar panel for easy metadata management during content creation
- Flexible Output Options: Display image sources via shortcodes, dynamic blocks, or automatic footer injection
- Comprehensive Admin Interface: Site-wide overview with filtering, bulk editing, and usage statistics
- Template System: Customizable output templates with theme override support
- Performance Optimized: Efficient database design with caching and indexed queries
- Security First: Proper sanitization, validation, and capability-based access control
How It Works
-
Detection: When you save a post, ICC automatically scans the content for images in various formats:
- Gutenberg blocks (Image, Gallery, Cover, Media & Text)
- Classic Editor HTML content
- Inline images in paragraph blocks
-
Storage: Image usage is tracked in a custom database table, while metadata (author, source, license) is stored as attachment post meta
-
Management: Editors can add metadata through:
- Gutenberg sidebar panel (per-post view)
- Media modal (global attachment editing)
- Admin bulk editing interface
-
Display: Image sources can be shown using:
- Shortcodes: [imagcrco_image_sources] or [imagcrco_post_image_sources]
- Dynamic block: “Image Sources” block
- Automatic footer injection (configurable)
Supported Image Sources
- Core Image blocks
- Gallery blocks
- Cover blocks
- Media & Text blocks
- Classic Editor HTML images
- Inline images in paragraph blocks
Output Formats
- Unordered List: Clean bullet-point format
- Ordered List: Numbered list format
- Inline: Comma-separated inline format
Template Customization
ICC supports theme overrides for complete customization. Create templates in your theme:
- yourtheme/image-credit-companion/list-ul.php
- yourtheme/image-credit-companion/list-ol.php
- yourtheme/image-credit-companion/list-inline.php
Usage Examples
Basic Shortcode Usage
Display image sources for the current post:
[imagcrco_image_sources]
Display all image sources site-wide:
[imagcrco_image_sources scope=”site”]
Display with specific formatting:
[imagcrco_image_sources list=”ol” show_missing=”true”]
g. inside an Elementor single post template, below the featured image widget):
[imagcrco_image_credit]
Display the credit line of a specific image:
[imagcrco_image_credit attachment_id=”123″]
Note: For backward compatibility, the legacy shortcodes [image_sources] and [post_image_sources] are still supported but the prefixed versions above are recommended.
Advanced Shortcode Attributes
- scope: “post” (default) or “site”
- post_id: Specific post ID (for post scope)
- list: “table”, “ul”, “ol”, or “inline” (default: the Default Output Style setting)
- show_missing: “true” or “false” (default: false)
- per_page: Items per page for site-wide pagination (default: 20)
Dynamic Block Usage
- Add the “Image Sources” block to your post or page
- Configure the block settings in the sidebar
- Choose scope, list style, and other options
- The block will automatically display the appropriate image sources
Support
For support, feature requests, or bug reports, please visit the plugin support forum.
Privacy Policy
This plugin does not collect, store, or transmit any personal data. All image metadata is stored locally on your WordPress installation and is not shared with external services.
Credits
Developed with ❤️ for the WordPress community. Special thanks to all contributors and testers who helped make this plugin possible.