PluginProbe
Image Source Control Lite – Show Image Credits and Captions / 3.11.0
Image Source Control Lite – Show Image Credits and Captions v3.11.0
3.12.0 3.11.0 trunk 1.1 1.1.1 1.1.2 1.1.2.1 1.1.3 1.10 1.10.1 1.10.2 1.10.3 1.10.4 1.10.5 1.2 1.2.0.1 1.2.0.2 1.2.0.3 1.3.0 1.3.1 1.3.2 1.3.3 1.3.4 1.3.4.1 1.3.5 All 110 releases
image-source-control-isc / readme.txt

readme.txt in Image Source Control Lite – Show Image Credits and Captions 3.11.0, at readme.txt

401 lines 25.1 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
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.0
6 Stable tag: 3.11.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 and warn if they are missing. The original plugin since 2012.
12
13 == Description ==
14
15 Are you concerned about being held liable for violating copyright law and would like to start crediting owners 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 **Frontend Features**
39
40 * Display image credits in the content, for image galleries, images added by shortcodes, and featured images
41 * … see more listed under Premium features below
42 * Define the layout and position of the caption overlay
43 * Show the image source fully, or only on click or mouseover
44 * Attach the Per-page list automatically, by using a shortcode, or with a PHP function
45 * Display image sources on archive pages
46 * Link to the copyright holder and include a link to the image license
47
48 **Backend Features**
49
50 * Add credits for any image file uploaded to the Media library
51 * Dedicated image source fields for the following blocks: Image, Cover Image, Featured Image, Media & Text
52 * 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
53 * Warn about missing image sources
54 * Manage, display, and link available licenses
55 * Enable the features for any files in the media library or for images only
56 * Filter the media library list by images with or without sources, or only those using the standard source
57
58 **Featured Image Caption**
59
60 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.
61
62 The featured image caption shows in the Per-page list with all other image sources on the page.
63
64 Check out the premium features to display the image caption overlay for featured images.
65
66 **Premium Features**
67
68 [Check out all features of Image Source Control](https://imagesourcecontrol.com/?utm_source=wporg&utm_medium=link&utm_campaign=all-features).
69
70 * The Indexer looks for all images in all published content in one go
71 * List credits for images outside the content
72 * Add multiple links to the source string
73 * Manage image credits for images hosted outside the Media Library
74 * Handle images without file extensions
75 * Show image usage in the image details and the List view of the media library
76 * Bulk-edit image copyright information in the media library
77 * Preview image credits in the media library
78 * Show the standard picture credit for all images without a selected source
79 * [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
80 * Show the full text only after a click or on mouseover on the caption overlay
81 * Choose which data is displayed in the [Global List](https://imagesourcecontrol.com/features/global-list/)
82 * List only images with a proper source in the Global List
83 * Show the Global List as a table or a simple list view
84 * Show image sources for Elementor background images, images in Kadence Blocks Galleries, and Kadence Related Content Carousel
85 * Developer options to show overlay captions for CSS background images
86 * Support for [background images of the Group block](https://imagesourcecontrol.com/blog/group-block-background-image/)
87 * Exclude certain images from showing the overlay by adding the `isc-disable-overlay` class
88 * Detect Unused Images (see below)
89 * Personal email support
90
91 Extended compatibility with Elementor, Avada, WP Bakery, Divi, Fusion Builder, and other page builders
92 themes like Soledad and Kadence (including Kadence Blocks, Kadence Theme Kit Pro, Kadence Shop Kit Pro, and Kadence Related Content Carousel),
93 as well as with plugins like Advanced Custom Fields, WPML, Lightbox Gallery, Newsletter plugin, and JetEngine.
94
95 [See Pricing](https://imagesourcecontrol.com/pricing/?utm_source=wporg&utm_medium=link&utm_campaign=pricing).
96
97 **Unused Images**
98
99 Premium media cleaner features to remove unused images safely.
100
101 - Go to _Media > Unused Images_ to see and remove unused images
102 - Run the Content Scan to find actually used images in the frontend
103 - Run the Database Scan to find references to images outside the content, like in meta data or options
104 - Bulk delete unused images
105 - Check either all images and pages, or only new or changed ones
106 - Works for pages behind a login (e.g., membership sites or maintenance mode)
107 - Filter the list by various states
108 - Ignore certain images from being listed as unused
109
110 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.
111
112 [See Pricing](https://imagesourcecontrol.com/pricing/?utm_source=wporg&utm_medium=link&utm_campaign=pricing).
113
114 **Media Trash**
115
116 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.
117
118 - Enabled the module in the settings
119 - Media Trash has its own menu under _Media > Media Trash_
120 - Clear the media trash in bulk
121 - Recover trashed images with one click
122
123 [See Pricing](https://imagesourcecontrol.com/pricing/?utm_source=wporg&utm_medium=link&utm_campaign=pricing).
124
125 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.
126
127 == Instructions ==
128
129 Take a look at the [Image Source Control Documentation](https://imagesourcecontrol.com/documentation/?utm_source=wporg&utm_medium=link&utm_campaign=documentation).
130
131 Find a list of missing images sources and other debug tools under _Media > Image sources_
132
133 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.
134
135 **Manually included image sources on pages/posts**
136
137 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.
138
139 Use `[isc_list id="123"]` to show the list of any post or page.
140
141 Use the PHP code `<?php if( function_exists('isc_list') ) { isc_list(); } ?>` within your template files.
142
143 **List all image sources**
144
145 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]`.
146
147 Use `[isc_list_all per_page="25"]` to show only a limited number of images per page.
148
149 Use `[isc_list_all included="all"]` to show all attachments in the list, including those not explicitly attached to a post.
150
151 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.
152
153 **Remove “nofollow” from all source links**
154
155 In order to remove “nofollow” from source links, follow the [instructions in our documentation](https://imagesourcecontrol.com/documentation/#remove-nofollow-from-all-source-links).
156
157 == Installation ==
158
159 This section describes how to install the plugin and get it working.
160
161 e.g.
162
163 1. Upload `image-source-control-isc.zip` through the 'Plugin' menu in your WordPress backend
164 1. Activate the plugin
165 1. Visit _Settings > Image Sources_ for the main settings
166
167 See the _Instructions_ section [here](https://wordpress.org/plugins/image-source-control-isc/#description).
168
169 == Screenshots ==
170
171 1. Display image attribution captions as an overlay above the image
172 1. Display a list of all images of your site and their sources on a dedicated page
173 1. Edit image source settings in the Image block
174 1. Bulk-editing image sources in the Media Library (Pro)
175 1. List image usage in the Media Library in an optional column (Pro)
176 1. Unused Images – Media Cleaner feature to safely remove unused images (Pro)
177 1. Customizing the display of image captions as an overlay
178 1. Customizing the list of image sources displayed under posts
179 1. Customizing the global list of image sources
180 1. Manage image usage licenses
181 1. The Scanner searches for unused images (Pro)
182
183 == Changelog ==
184
185 = 3.11.0 =
186
187 * Feature (Pro): New “Media Trash” module to move images to the trash instead of directly deleting them permanently. This allows for easy recovery
188 * Dev (Pro): Log failed license API requests when the debug option is enabled to help troubleshoot license activation issues
189
190 = 3.10.0 =
191
192 * 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.
193 * Improvement (Pro): Find images used in WooCommerce product archive thumbnails
194 * Improvement (Pro): Compatibility for image captions in the Soledad theme
195 * Improvement (Pro): Find used images in the "Above Header Background Image" option in Kadence Theme Kit Pro
196 * Improvement (Pro): Find used images in the variation images added by Kadence Shop Kit Pro
197 * Fix (Pro): Icons in buttons were misplaced in WordPress 7.0
198
199 = 3.9.2 =
200
201 * Security: Limit input fields and output of source text to specific HTML tags and attributes. This prevets potential script execution. Reported by WordFence
202
203 = 3.9.1 =
204
205 * Improvement (Pro): Better guiding to the license input field to improve onboarding experience
206 * Fix: Pagination links were missing when the number of items in the Global List was set to 0. Only 10 results showed up
207 * Fix (Pro): rename the `compatibility` directory to `Compatibility` to resolve case-sensitive filesystem failure
208 * Fix (Pro): Added more checks for the `wp_isc_index` table to prevent fatal errors when the table is missing for unexpected reasons
209
210 = 3.9.0 =
211
212 * Improvement (Pro): Removed the old “Indexer” page to find unused images in the content. All features are covered by the Scanner
213 * 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
214 * Improvement (Pro): The pagination count in the Unused Images list shows the total number of images right away
215 * Improvement: Settings label position unified for a homogeneous look
216
217 = 3.8.0 =
218
219 * Feature (Pro): Add a reset button to clear the index for Unused Images
220 * Improvement (Pro): Compatiblity with Elementor thumbnails in the directory `/uploads/elementor/thumbs\`
221 * Improvement (Pro): Removed check indicator icons from the Unused Images list since they were confusing and are irrelevant when using the Scanner
222 * Improvement (Pro): Finished renaming "Indexer" and "Deep Check" into "Content Scan" and "Database Scan"
223 * Improvement (Pro): Updated Polish and German translations
224 * Fix (Pro): A replaced featured image was not marked as unused when using the Content Scan
225 * Fix: Prevent the storage from containing empty URLs when an image ID was identified but the image URL not found in the database
226 * Dev (Pro): Renamed `isc_indexer_global_image_threshold` filter into `isc_unused_images_global_image_threshold`
227 * Dev: Removed Pro files from autoloading mapper
228
229 = 3.7.0 =
230
231 * Feature (Pro): Introducing the new unified **Scanner** for Unused Images. This powerful tool combines the previous Indexer and Database search into a single, streamlined interface. The existing "Indexer" page will slowly be phased out. The individual Deep Check will be renamed to "Database Check" in the future
232 * Feature (Pro): Bulk edit image sources for multiple images directly in the Media Library list view
233 * Feature (Pro): Mark images as "Ignored" in the Unused Images list to focus on relevant items
234 * Feature: Added a download button for the ISC log file in the settings for easier debugging
235 * Improvement (Pro): Adaptive batching for the Content Scan to optimize performance based on server speed
236 * Improvement (Pro): New "Any image URL" indexing option to detect images in CSS backgrounds and inline styles during the Content Scan
237 * Improvement (Pro): Specialized usage detection for images in Advanced Custom Fields (ACF) and the Newsletter plugin
238 * Improvement (Pro): Enhanced detection and labeling of "Global" images found in the page head or body
239 * Improvement (Pro): Detailed error logging for the Scanner to help troubleshoot access issues, empty and redirected pages
240 * Improvement (Pro): Add warning when many pages scanned but few images found
241 * Improvement: Automatically clear admin notices from other plugins on ISC pages to provide a cleaner management interface
242 * Improvement: Added a "Layout" section in Global List settings with links to styling tips and documentation
243 * Improvement: Support for single quotes in HTML attributes for better compatibility with themes like Kadence and block-based background images
244 * Improvement: Improved detection of scaled and rotated images to ensure correct attribution
245 * Improvement: Display the Post ID in the Global List when a post has no title
246 * Fix (Pro): Appearance list showed an upsell pitch
247 * Fix: Moved Global List filtering to the database query level to fix pagination issues and improve performance
248 * Fix: Hide the "Tools" link when the Image Sources module is disabled
249 * Dev (Pro): Prevent attachments from self-referencing their own entry in wp_posts during usage detection
250 * Dev (Pro): Add safety margin when deleting old entries from the index table
251 * Dev: Prevented deprecation notices in the block editor for future WordPress versions (7.0+)
252 * Dev: Resolved PHP 8.4 compatibility issues related to nullable parameters
253 * Dev: Moved the log file to the WordPress uploads directory for better accessibility and security
254 * Dev: Significant increase in automated test coverage for the Indexer, Global List, and Unused Images modules
255 * Dev: Hardened hook handling to prevent potential fatal errors during future plugin updates
256 * Dev: The `isc_image_sources_attachments_with_empty_sources_where_clause` filter hook can be used to manipulate the `where` clause of the search for images without an image source.
257
258 = 3.6.1 =
259
260 * Fix (Pro): Overlays did not display on background images of core blocks (i.e., groups) due to an undocumented change in WP 6.9 regarding the conversion of apostrophes in inline styles
261
262 = 3.6.0 =
263
264 * Feature (Pro): Execute the Indexer for Unused Images as a logged-in user; enable this option if your site is (partially) hidden behind a login or user capabilities
265 * Feature (Pro): Optionally run the indexer only on un-indexed instead of all posts
266 * Improvement (Pro): Added labels for icons in the Unused Images list for better clarity
267 * Improvement (Pro): An image is no longer considered “used” if the attached post is moved to the trash; previously, only fully deleting the post did that
268 * Fix: Prevent a fatal error on comment edit pages
269 * Fix: The Images-only option caused non-images (e.g., PDFs) to no longer show in the media library
270 * Dev: Disables autoload of the `isc_storage` option
271
272 = 3.5.0 =
273
274 * Feature (Pro): Search for unused media files in the `wp_usermeta` table to support plugins like WP User Meta
275 * Feature (Pro): Show the Global List in a simple list view using the `style` attribute, i.e., `[isc_list_all style="list"]`
276 * Improvement (Pro): Support for caption overlays on full width images in the Divi builder
277 * Improvement (Pro): Support for the `data-bg-url` attribute in the Fusion Builder
278 * Improvement (Pro): Ignore false positive results for unused images caused by the Newsletter Plugin
279 * Improvement (Pro): Automatically purge outdated entries in the Indexer to handle unpublished content
280 * Improvement: Show a warning in the media library when image filepath and `wp_posts.guid` don’t match; e.g., after migrating the domain
281 * Dev: Cache the SQL query in `get_oldest_entry_date()` to prevent the same query running multiple times on ISC pages in WP admin
282
283 = 3.4.0 =
284
285 * Feature: Added a filter option to the Media Library list view to show only images using the “Standard” source
286 * Feature: Added SVG to the list of accepted image file types
287 * Feature (Pro): Show overlays for Divi background images. To use it, enable the appropriate option in the Overlay settings
288 * Improvement: Prevent the content from jumping when the caption overlay is placed. The caption markup is now hidden until it was placed correctly. Critical JavaScript errors on the site could prevent them from showing, though.
289 * Improvement (Pro): Rewritten rendering of the Appearance list, combining results from indexer, database check and image sources. Optional details list can be enabled in settings
290 * Improvement (Pro): Moved the Elementor compatibility option to the Overlay settings, since it is only relevant for overlays
291 * Improvement (Pro): Support for JetEngine smart filters
292 * Improvement (Pro): Added Polish translation
293 * Fix (Pro): The Per-page list stayed empty on the first page load after a post was saved when the Per-page list was enabled in the default settings and the Overlay were set to display on images outside the main content
294 * Fix (Pro): The Appearance list in the Media details didn’t show if the Image Sources module was disabled, though that list depends solely on Unused Images
295 * Dev (Pro): Removed storing post title and type from Database check to avoid outdated data
296 * Dev (Pro): Some code for overlays was loaded even when overlays were disabled. This caused no frontend output
297 * Dev (Pro): The thumbnail now has its own entry in the `isc_index` table if found when indexing a single post in the frontend
298
299 = 3.3.1 =
300
301 - Fix (Pro): The option to enable the expandable list for the Per-page List wasn’t stored
302 - Fix: Sometimes, a “Next” link could show up on the pagination of the last page of the Global List, even if there were no more images to show
303 - Dev: The query for the Global List was improved to load quickly also on sites with many images
304 - Dev: Moved the Global List rendering methods to a dedicated class
305
306 = 3.3.0 =
307
308 - Feature (Pro): Layout option to collapse the Per-page list below the content by default and only open it on click
309 - Improvement: Minified JavaScript files in frontend and backend for faster load times
310 - Improvement (Pro): Consider the site_icon image as "used" and don’t list it under Unused Images
311 - Improvement (Pro): Support for JetEngine AJAX-loaded content
312 - Improvement (Pro): The expand-on-click caption option is more stable and should not create random line breaks
313 - Fix (Pro): Honor the Elementor compatibility option and disable the feature, if the option is not checked
314 - Fix (Pro): Made a string on the Indexer page translatable
315 - Dev: The main caption CSS can be customized via the `isc_public_caption_default_style` filter
316 - Dev: The new `isc_update_captions_styles()` JavaScript function allows developers to update the caption styles in the frontend. E.g., useful for dynamically loaded content
317 - Dev (Pro): Improved handling nested output buffer calls to prevent issues with other plugins; here it was WPBakery
318 - Dev (Pro): Use the `isc_unused_images_ids_considered_used` filter to add IDs of images that should not show as unused images
319
320 = 3.2.0 =
321
322 April 29th, 2025
323
324 - Feature: You can use the option “Images only” to disable features for non-images in the media library, e.g., PDF files
325 - Improvement: When authors change content, ISC now looks for removed or new images at the next visit of that page in the frontend. This highly improved compatibility with page builders and dynamic content like shortcodes.
326 - Improvement: When WP_DEBUG is enabled, show a button to list the content of the internal storage on the Tools page
327 - Improvement: Removes image source output on pages with the Global List on it
328 - Improvement (Pro): Ignores image URLs in `href` attributes when looking for image sources
329 - Improvement (Pro): Clears the URL storage when the Indexer runs. This can help with issues when a site was migrated to another URL
330 - Improvement (Pro): Extends ignored options for unused images
331 - Improvement (Pro): The column with image sources forms in the Media Library list view only shows if the user has the permission to edit any image information
332 - Improvement (Pro): The forms to edit image sources in the Media Library list view only show if the user has the permission to edit information for that given image
333 - Improvement (Pro): The Indexer for Unused Images now works with posts translated by WPML
334 - Fix: Removes old index information when the last image in a post is removed
335 - Fix (Pro): Some reserved characters in URLs caused (e.g., `&`) the bulk edit fields for images sources in the media library to be cut off
336 - Dev: Extracts post meta handling (`isc_image_posts`, `isc_post_images`) into dedicated classes.
337 - Dev (Pro): Disable image source form fields in the Media Library list view when submitting the filter form to prevent broken URLs. This is related to a compatibility issue caused by a third-party setup
338 - Dev (Pro): The Indexer now works in batches to prevent timeouts on large sites when Query Monitor is installed
339 - Dev (Pro): Pages with the Global List shortcode are now ignored by the Indexer.
340 - Dev: Adds cleanup routines for meta data for deleted and trashed posts.
341 - Dev: Replace some direct DB calls with WP functions
342 - Updates German translation
343
344 = 3.1.4 =
345
346 - Fix: PHP E_ERROR in Media Library List view when screen options are missing
347
348 = 3.1.3 =
349
350 - Fix: The filter “Images with sources” in the Media Library list view was not working correctly
351 - Fix: early loaded text domains caused a PHP warning
352 - Fix: A missed trait caused a warning in PHP 8.2
353
354 = 3.1.2 =
355
356 - Fix: Indexer not loading due to changed screen ID
357 - Fix: PHP warning when saving the Global List settings in PHP 8.2
358
359 = 3.1.1 =
360
361 - Fix: PHP notices for traits in PHP 8.1
362
363 = 3.1.0 =
364
365 - Improvement: (Pro) Captions are now working by default for image URLs stored outside the `src` attribute, which is often the case when using lazy loading.
366 - Improvement: (Pro) The indexer now works with cached frontends.
367 - Fix: (Pro) The IPTC options were disabled when deactivating the Unused Images module
368
369 = 3.0.0 =
370
371 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.
372
373 - Feature: You can now switch off modules you don’t need (Image Sources, Unused Images)
374 - Feature: (Pro) Run the [full-content indexer](https://imagesourcecontrol.com/documentation/#unused-images) to identify all images in the content. This improves compatibility with page builders and plugins that add images to the content dynamically and is useful for either Image Sources and Unused Images
375 - Feature: (Pro) New column with the image source preview to the Media Library list view
376 - Feature: New filter to list only images without sources in the Media Library list view for quickly adding missing images
377 - Feature: Added support for AVIF files
378 - Improvement: The list of images without sources now ignores images that have the standard source set
379 - Improvement: (Pro) Show the image path in the list of Unused Images
380 - Fix: Prevented a JavaScript console error in the list view
381 - Fix: Pages using the Global List shortcode were not counted in the page index stats
382 - Dev: Deprecated `ISC_Class`
383
384 = 2.29.1 =
385
386 - Security: Limit the pretext for the caption preview in the backend to text only to prevent XSS attacks with manipulated links that could be executed by admin users
387 - Fix: When resizing the screen, right-aligned captions sometimes received line breaks. The new calculation prevents this
388
389 = 2.29.0 =
390
391 - Increased the required WordPress version to 6.0
392 - Improvement: (Pro) added Swiss and Austrian localizations
393 - Fix: a warning was thrown in WordPress 6.7 about text domains loaded too early
394 - Dev: hardened code against the_content being set to `null` by other plugins
395 - Dev: various code style improvements
396
397 == Upgrade Notice ==
398
399 = 3.0.0 =
400
401 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.