Image Credit Companion

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

1. 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

2. Storage: Image usage is tracked in a custom database table, while metadata (author, source, license) is stored as attachment post meta

3. Management: Editors can add metadata through:

   • Gutenberg sidebar panel (per-post view)
   • Media modal (global attachment editing)
   • Admin bulk editing interface

4. 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”]

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: “ul” (default), “ol”, or “inline”
• show_missing: “true” or “false” (default: false)

Dynamic Block Usage

1. Add the “Image Sources” block to your post or page
2. Configure the block settings in the sidebar
3. Choose scope, list style, and other options
4. 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.