| 1 |
=== Image Source Control Lite – Show Image Credits and Captions === |
| 2 |
Contributors: webzunft |
| 3 |
Tags: credits, captions, copyrights, attributions, image sources |
| 4 |
Requires at least: 6.0 |
| 5 |
Tested up to: 7.1 |
| 6 |
Stable tag: 3.12.0 |
| 7 |
Requires PHP: 7.4 |
| 8 |
License: GPLv3 or later |
| 9 |
License URI: http://www.gnu.org/licenses/gpl-3.0.html |
| 10 |
|
| 11 |
Show image credits, image captions, and copyrights. Manage image sources, licenses and AI label. The original plugin since 2012. |
| 12 |
|
| 13 |
== Description == |
| 14 |
|
| 15 |
Are you concerned about being held liable for violating copyright law, would like to start crediting owners or [AI-generated images](https://imagesourcecontrol.com/blog/mark-ai-generated-image/) properly? |
| 16 |
|
| 17 |
Do you want to give back to photographers and illustrators by adding image credits, so they are rightfully attributed? |
| 18 |
|
| 19 |
Or are you a creator yourself and want to show information on the picture licenses for your image gallery under which publishers can use or purchase your work? |
| 20 |
|
| 21 |
Image Source Control is your go-to solution when it comes to **handling copyright-protected photos and delete unused images**. |
| 22 |
|
| 23 |
[Documentation](https://imagesourcecontrol.com/documentation/?utm_source=wporg&utm_medium=link&utm_campaign=wp-linkbar-documentation) | [Support](https://wordpress.org/support/plugin/image-source-control-isc/) | [Premium Features](https://imagesourcecontrol.com/unlock-isc/?utm_source=wporg&utm_medium=link&utm_campaign=wp-linkbar-pro) | [Delete Unused Images](https://imagesourcecontrol.com/features/delete-unused-images/?utm_source=wporg&utm_medium=link&utm_campaign=wp-linkbar-delete) |
| 24 |
|
| 25 |
> This level of personal and competent support deserves more than just five stars. |
| 26 |
> Highly recommended! |
| 27 |
|
| 28 |
⭐⭐⭐⭐⭐ by [eunde](https://wordpress.org/support/topic/excellent-plugin-and-absolutely-outstanding-support/) |
| 29 |
|
| 30 |
**Image Credit layouts** |
| 31 |
|
| 32 |
Choose between different credit displays: |
| 33 |
|
| 34 |
* List all image sources below the content of a specific page or place the list manually |
| 35 |
* Show an image caption overlay above or below the image |
| 36 |
* Embed a complete image credit list with thumbnails on your website |
| 37 |
|
| 38 |
**Label AI-generated images** |
| 39 |
|
| 40 |
* [Mark AI-generated images](https://imagesourcecontrol.com/blog/mark-ai-generated-image/) with a label that indicates the image was created by artificial intelligence. Following the EU AI act |
| 41 |
* Available icons: AI, AI-generated, AI-manipulated |
| 42 |
* Show only the icon or add a description text to it in the image source field |
| 43 |
|
| 44 |
**Frontend Features** |
| 45 |
|
| 46 |
* Display image credits in the content, for image galleries, images added by shortcodes, and featured images |
| 47 |
* … see more listed under Premium features below |
| 48 |
* Define the layout and position of the caption overlay |
| 49 |
* Show the image source fully, or only on click or mouseover |
| 50 |
* Attach the Per-page list automatically, by using a shortcode, or with a PHP function |
| 51 |
* Display image sources on archive pages |
| 52 |
* Link to the copyright holder and include a link to the image license |
| 53 |
* Add the EU AI label that marks an image as AI-generated |
| 54 |
|
| 55 |
**Backend Features** |
| 56 |
|
| 57 |
* Add credits for any image file uploaded to the Media library |
| 58 |
* Dedicated image source fields for the following blocks: Image, Cover Image, Featured Image, Media & Text |
| 59 |
* Quickly assign a centrally defined source to any image and choose three options: hide image sources for these images, show a specific source (e.g., your name), or the uploader’s name |
| 60 |
* Warn about missing image sources |
| 61 |
* Manage, display, and link available licenses |
| 62 |
* Enable the features for any files in the media library or for images only |
| 63 |
* Filter the media library list by images with or without sources, or only those using the standard source |
| 64 |
|
| 65 |
**Featured Image Caption** |
| 66 |
|
| 67 |
ISC Lite works for Featured Images. By default, you will see the image credits options in the media library and the featured image options in the block editor. |
| 68 |
|
| 69 |
The featured image caption shows in the Per-page list with all other image sources on the page. |
| 70 |
|
| 71 |
Check out the premium features to display the image caption overlay for featured images. |
| 72 |
|
| 73 |
**Premium Features** |
| 74 |
|
| 75 |
[Check out all features of Image Source Control](https://imagesourcecontrol.com/?utm_source=wporg&utm_medium=link&utm_campaign=all-features). |
| 76 |
|
| 77 |
* The Indexer looks for all images in all published content in one go |
| 78 |
* List credits for images outside the content |
| 79 |
* Add multiple links to the source string |
| 80 |
* Manage image credits for images hosted outside the Media Library |
| 81 |
* Handle images without file extensions |
| 82 |
* Show image usage in the image details and the List view of the media library |
| 83 |
* Bulk-edit image copyright information in the media library |
| 84 |
* Preview image credits in the media library |
| 85 |
* Show the standard picture credit for all images without a selected source |
| 86 |
* [Display IPTC copyright metadata](https://imagesourcecontrol.com/blog/iptc-copyright-information-image-caption-wordpress/) in the backend and automatically as a standard source in the frontend |
| 87 |
* Show the full text only after a click or on mouseover on the caption overlay |
| 88 |
* Choose which data is displayed in the [Global List](https://imagesourcecontrol.com/features/global-list/) |
| 89 |
* List only images with a proper source in the Global List |
| 90 |
* Show the Global List as a table or a simple list view |
| 91 |
* Show image sources for Elementor background images, images in Kadence Blocks Galleries, and Kadence Related Content Carousel |
| 92 |
* Developer options to show overlay captions for CSS background images |
| 93 |
* Support for [background images of the Group block](https://imagesourcecontrol.com/blog/group-block-background-image/) |
| 94 |
* Exclude certain images from showing the overlay by adding the `isc-disable-overlay` class |
| 95 |
* Detect Unused Images (see below) |
| 96 |
* Personal email support |
| 97 |
|
| 98 |
Extended compatibility with Elementor, Avada, WP Bakery, Divi, Fusion Builder, Flatsome UX Builder, and other page builders |
| 99 |
themes like Soledad and Kadence (including Kadence Blocks, Kadence Theme Kit Pro, Kadence Shop Kit Pro, and Kadence Related Content Carousel), |
| 100 |
as well as with plugins like Advanced Custom Fields, WPML, Lightbox Gallery, Newsletter plugin, and JetEngine. |
| 101 |
|
| 102 |
[See Pricing](https://imagesourcecontrol.com/pricing/?utm_source=wporg&utm_medium=link&utm_campaign=pricing). |
| 103 |
|
| 104 |
**Unused Images** |
| 105 |
|
| 106 |
Premium media cleaner features to remove unused images safely. |
| 107 |
|
| 108 |
- Go to _Media > Unused Images_ to see and remove unused images |
| 109 |
- Run the Content Scan to find actually used images in the frontend |
| 110 |
- Run the Database Scan to find references to images outside the content, like in meta data or options |
| 111 |
- Bulk delete unused images |
| 112 |
- Check either all images and pages, or only new or changed ones |
| 113 |
- Works for pages behind a login (e.g., membership sites or maintenance mode) |
| 114 |
- Filter the list by various states |
| 115 |
- Ignore certain images from being listed as unused |
| 116 |
|
| 117 |
Constantly extended support for finding used and unused images in plugins and page builders, e.g., Elementor, Divi, WP Bakery, WP User Meta, WooCommerce, Kadence, and the Newsletter Plugin. |
| 118 |
|
| 119 |
[See Pricing](https://imagesourcecontrol.com/pricing/?utm_source=wporg&utm_medium=link&utm_campaign=pricing). |
| 120 |
|
| 121 |
**Media Trash** |
| 122 |
|
| 123 |
Move images to the trash instead of directly deleting them permanently. This eases the test if a deleted image was actually unused and allows for easy recovery if it was not. |
| 124 |
|
| 125 |
- Enabled the module in the settings |
| 126 |
- Media Trash has its own menu under _Media > Media Trash_ |
| 127 |
- Clear the media trash in bulk |
| 128 |
- Recover trashed images with one click |
| 129 |
|
| 130 |
[See Pricing](https://imagesourcecontrol.com/pricing/?utm_source=wporg&utm_medium=link&utm_campaign=pricing). |
| 131 |
|
| 132 |
Btw., Image Source Control is a suitable alternative to the discontinued or closed plugins Image Credits, [Credit Tracker](https://imagesourcecontrol.com/blog/credit-tracker/?utm_source=wporg&utm_medium=link&utm_campaign=credit-tracker), or FSM Custom Featured Image Caption. |
| 133 |
|
| 134 |
== Instructions == |
| 135 |
|
| 136 |
Take a look at the [Image Source Control Documentation](https://imagesourcecontrol.com/documentation/?utm_source=wporg&utm_medium=link&utm_campaign=documentation). |
| 137 |
|
| 138 |
Find a list of missing images sources and other debug tools under _Media > Image sources_ |
| 139 |
|
| 140 |
You can choose to display image sources below the post content or as a small caption overlay above your images. Just visit the settings page of the plugin to enable those options. |
| 141 |
|
| 142 |
**Manually included image sources on pages/posts** |
| 143 |
|
| 144 |
You can add the Per-page list manually to pages or posts via the shortcode `[isc_list]` in your content editor or a text widget. |
| 145 |
|
| 146 |
Use `[isc_list id="123"]` to show the list of any post or page. |
| 147 |
|
| 148 |
Use the PHP code `<?php if( function_exists('isc_list') ) { isc_list(); } ?>` within your template files. |
| 149 |
|
| 150 |
**List all image sources** |
| 151 |
|
| 152 |
You can add a paginated list with ALL attachments and sources attached to posts and pages—the Global list—using the shortcode `[isc_list_all]`. |
| 153 |
|
| 154 |
Use `[isc_list_all per_page="25"]` to show only a limited number of images per page. |
| 155 |
|
| 156 |
Use `[isc_list_all included="all"]` to show all attachments in the list, including those not explicitly attached to a post. |
| 157 |
|
| 158 |
The plugin searches your post content and thumbnail for images (attachments) and lists them if you included at least the image source or marked it to use the default image source. |
| 159 |
|
| 160 |
**Remove “nofollow” from all source links** |
| 161 |
|
| 162 |
In order to remove “nofollow” from source links, follow the [instructions in our documentation](https://imagesourcecontrol.com/documentation/#remove-nofollow-from-all-source-links). |
| 163 |
|
| 164 |
== Installation == |
| 165 |
|
| 166 |
This section describes how to install the plugin and get it working. |
| 167 |
|
| 168 |
e.g. |
| 169 |
|
| 170 |
1. Upload `image-source-control-isc.zip` through the 'Plugin' menu in your WordPress backend |
| 171 |
1. Activate the plugin |
| 172 |
1. Visit _Settings > Image Sources_ for the main settings |
| 173 |
|
| 174 |
See the _Instructions_ section [here](https://wordpress.org/plugins/image-source-control-isc/#description). |
| 175 |
|
| 176 |
== Screenshots == |
| 177 |
|
| 178 |
1. Display image attribution captions as an overlay above the image |
| 179 |
1. Display a list of all images of your site and their sources on a dedicated page |
| 180 |
1. Edit image source settings in the Image block |
| 181 |
1. Bulk-editing image sources in the Media Library (Pro) |
| 182 |
1. List image usage in the Media Library in an optional column (Pro) |
| 183 |
1. Unused Images – Media Cleaner feature to safely remove unused images (Pro) |
| 184 |
1. Customizing the display of image captions as an overlay |
| 185 |
1. Customizing the list of image sources displayed under posts |
| 186 |
1. Customizing the global list of image sources |
| 187 |
1. Manage image usage licenses |
| 188 |
1. The Scanner searches for unused images (Pro) |
| 189 |
1. Mark AI-generated images with a label that indicates the image was created by artificial intelligence |
| 190 |
|
| 191 |
== Changelog == |
| 192 |
|
| 193 |
= 3.12.0 |
| 194 |
|
| 195 |
* Feature: Label AI-generated images. You can now choose to mark an image as AI-generated. This will add one of three possible labels provided by the European Union |
| 196 |
* Improvement (Pro): One can now use `/:|` to separate captions into multiple segments and link them. The new separators only apply when followed by a space. |
| 197 |
* Improvement (Pro): Flatsome UX Builder compatibility with the Unused Images Database Scan |
| 198 |
* Improvement: Show compatibility notices on the Settings page |
| 199 |
* Fix (Pro): With WordPress 7.1, the admin notice about a missing license displayed twice |
| 200 |
* Fix (Pro): Cleanup orphaned entries in the index table after a full Content Scan |
| 201 |
* Dev: List storage content on the Tools page also without `WP_DEBUG` enabled |
| 202 |
* Dev: The error log can now list the plugin settings |
| 203 |
|
| 204 |
= 3.11.1 = |
| 205 |
|
| 206 |
* Fix (Pro): A critical PHP error in Polish translation caused the site to crash |
| 207 |
|
| 208 |
= 3.11.0 = |
| 209 |
|
| 210 |
* Feature (Pro): New “Media Trash” module to move images to the trash instead of directly deleting them permanently. This allows for easy recovery |
| 211 |
* Dev (Pro): Log failed license API requests when the debug option is enabled to help troubleshoot license activation issues |
| 212 |
|
| 213 |
= 3.10.0 = |
| 214 |
|
| 215 |
* Feature (Pro): New “Deep Check” option to find unused images in post and term meta fields added by plugins. This is optional to save performance. |
| 216 |
* Improvement (Pro): Find images used in WooCommerce product archive thumbnails |
| 217 |
* Improvement (Pro): Compatibility for image captions in the Soledad theme |
| 218 |
* Improvement (Pro): Find used images in the "Above Header Background Image" option in Kadence Theme Kit Pro |
| 219 |
* Improvement (Pro): Find used images in the variation images added by Kadence Shop Kit Pro |
| 220 |
* Fix (Pro): Icons in buttons were misplaced in WordPress 7.0 |
| 221 |
|
| 222 |
= 3.9.2 = |
| 223 |
|
| 224 |
* Security: Limit input fields and output of source text to specific HTML tags and attributes. This prevets potential script execution. Reported by WordFence |
| 225 |
|
| 226 |
= 3.9.1 = |
| 227 |
|
| 228 |
* Improvement (Pro): Better guiding to the license input field to improve onboarding experience |
| 229 |
* Fix: Pagination links were missing when the number of items in the Global List was set to 0. Only 10 results showed up |
| 230 |
* Fix (Pro): rename the `compatibility` directory to `Compatibility` to resolve case-sensitive filesystem failure |
| 231 |
* Fix (Pro): Added more checks for the `wp_isc_index` table to prevent fatal errors when the table is missing for unexpected reasons |
| 232 |
|
| 233 |
= 3.9.0 = |
| 234 |
|
| 235 |
* Improvement (Pro): Removed the old “Indexer” page to find unused images in the content. All features are covered by the Scanner |
| 236 |
* Improvement (Pro): When the WordPress `MEDIA_TRASH` constant is enabled, a "Move to Trash" option shows up in the bulk actions on the Unused Images page |
| 237 |
* Improvement (Pro): The pagination count in the Unused Images list shows the total number of images right away |
| 238 |
* Improvement: Settings label position unified for a homogeneous look |
| 239 |
|
| 240 |
= 3.8.0 = |
| 241 |
|
| 242 |
* Feature (Pro): Add a reset button to clear the index for Unused Images |
| 243 |
* Improvement (Pro): Compatiblity with Elementor thumbnails in the directory `/uploads/elementor/thumbs\` |
| 244 |
* Improvement (Pro): Removed check indicator icons from the Unused Images list since they were confusing and are irrelevant when using the Scanner |
| 245 |
* Improvement (Pro): Finished renaming "Indexer" and "Deep Check" into "Content Scan" and "Database Scan" |
| 246 |
* Improvement (Pro): Updated Polish and German translations |
| 247 |
* Fix (Pro): A replaced featured image was not marked as unused when using the Content Scan |
| 248 |
* Fix: Prevent the storage from containing empty URLs when an image ID was identified but the image URL not found in the database |
| 249 |
* Dev (Pro): Renamed `isc_indexer_global_image_threshold` filter into `isc_unused_images_global_image_threshold` |
| 250 |
* Dev: Removed Pro files from autoloading mapper |
| 251 |
|
| 252 |
== Upgrade Notice == |
| 253 |
|
| 254 |
= 3.0.0 = |
| 255 |
|
| 256 |
3.0 rewrites a lot of classes mainly to split features into modules. Developers who used any classes and methods directly should test their code. |
