=== Image Source Control ===
Contributors: webzunft
Tags: image, images, picture, picture source, image source, bild, bilder, photo, photos, foto, media, caption, copyright
Requires at least: 5.3
Tested up to: 5.7
Stable tag: 2.2.0
Requires PHP: 5.6
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

The Image Source Control manages image sources, displays them and warns if they are missing.

== Description ==

Did you ever forget to add the source to an image in the frontend, and the lawyer of the copyright holder knocked on your door due to missing credits?

Image Source Control (ISC) helps to prevent this situation.

Just add the image source in the backend and choose how to display it on your website.

**Image Source layouts**

Choose between different credit displays:

* list all image sources below the content of a specific page or place the list manually
* credit as a caption above the image
* embed a complete credit list of all images and photos on your website

**Frontend Features**

* display credits for images in the content, galleries, shortcodes, and featured images
* define the layout and position of the image source
* attach the image source list below the content automatically or using a shortcode or PHP function
* display image sources on archive pages
* block editor: detects image sources for the image, cover image, and gallery blocks
* link to the copyright holder and include a link to the image license

**Backend Features**

* manage image source within the Media dashboard and in the settings of the Image and Cover Image blocks
* quickly assign a centrally defined source to any image and choose three options: hide photo sources for these images, show a specific source (e.g., your name), or the uploaders name
* warn about missing image sources
* manage, display, and link available licenses

**Localization**

English, German

== Instructions ==

Take a look at the [Image Source Control Manual](https://imagesourcecontrol.com/manual/).

Find a list of missing images sources and other debug tools under _Media > Image sources_

**Automatic image sources**

You can choose to display image sources automatically 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.

**Manually included image sources on pages/posts**

You can add the image source list manually to pages or posts via the shortcode `[isc_list]` in your content editor or a text widget.

Use `[isc_list id="123]` to show the list of any post or page.

Use the PHP code `<?php if( function_exists('isc_list') ) { isc_list(); } ?>` within your template files.

**List all image sources**

You can add a paginated list with ALL attachments and sources attached to posts and pages using the shortcode `[isc_list_all]`.

Use `[isc_list_all per_page="25"]` to show only a limited number of images per page.

Use `[isc_list_all included="all"]` to show all attachments in the list, including those not explicitly attached to a post.

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.

== Legal Notice ==

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

== Installation ==

This section describes how to install the plugin and get it working.

e.g.

1. Upload `image-source-control-isc.zip` through the 'Plugin' menu in your WordPress backend
1. Activate the plugin
1. Visit _Settings > Image Control_ for the main settings

See the _Instructions_ section [here](https://wordpress.org/plugins/image-source-control-isc/#description).

== Screenshots ==

1. edit image source settings in the Image block
1. display a list with all images of your site and their sources
1. display image source within the image
1. basic settings to customize how to display image sources
1. settings to manage image source licenses

== Changelog ==

= 2.2.0 =

- added compatibility with the [upcoming Pro version](https://imagesourcecontrol.com/pro/)
- Pro: show an overlay for images outside of the main content (e.g., feature images and some page builder)
- add option to strip overlay output from any markup and use hooks to define own styles
- find sources for images after moving the site to another URL

= 2.1.1 =

- only load ISC-related scripts on the plugin’s admin pages
- compatibility with line breaks between link and image tags when placing the overlay
- prevent adding the overlay multiple times to images that appear more than once on a page
- fixed overlay text showing up in automatically created excerpts
- fixed jQuery shorthand warnings in the backend
- fixed source overlays for images with links

= 2.1.0 =

- rewritten jQuery to vanilla JavaScript in the frontend code
- only index the images of posts in the main loop to prevent getting it from filtered content

= 2.0.0 =

- the full source list is now updated when a post is visited for the first time not after being saved
- the "own image" option is now "standard source" to better represent its purpose and possibilities
- improved settings page visually and for more clarity
- use span instead of div container for source overlays
- rewrite of the block options to make them more stable
- introducing a model class
- introduced debug option
- introduced option to reindex image-post relations again
- introduced `isc_sources_list_override_output` filter to allow overriding the output of a source list
- introduced `isc_source_list_empty_output` filter to allow output when a list of sources is empty
- fixed showing the sources list on single pages when the "list below content" was disabled while the same option for archive pages was
- fixed indexing post content for images when the post is saved in the block editor
- fixed infinite loops breaking autosave feature in the block editor
- various fixes to debug tables
- removed unneeded code to recognize the gallery shortcode in classic editor
- removed broken PHP code causing an issue when using the `isc_images_in_posts_simple` filter
- removed option to add a link to the ISC website in the frontend

= 1.10.4 =

* fixed block editor files being loaded in the frontend

= 1.10.3 =

* fixed JavaScript bug in block editor with WordPress 5.3

= 1.10.2 =

* removed CSS class which was set automatically in the image block

= 1.10.1 =

* fix for block translations

= 1.10 =

* added image source settings to Image block

= 1.9.7 =

* changed `licence` string to `license` to match en_US language base
* extended list of copyright licenses

= 1.9.6 =

* fixed issue using [isc_list] without overlays

= 1.9.5 =

* removed additional output introduced in 1.9.3

= 1.9.4 =

* fixed index error

= 1.9.3 =

* prevent image source overlay on full image source list and below
* optimized query of missing-sources check
* only check for missing sources when an image was uploaded or once every 24 hours

= 1.9.2 =

* prevent infinite loop for posts with automatic image source lists where images are not index yet
* moved German translation to wordpress.org

= 1.9.1 =

* delayed displaying source overlay by 100 ms to give images a chance to load their height
* fixed wrong height of the overlay being used 
* fixed missing textdomain code to allow translations added through wordpress.org

= 1.9 =

THIS UPDATE CONTAINS SOME BASIC CHANGES ON HOW IMAGES ARE DETECTED IN THE CONTENT. PLEASE TEST IT.

Please [reach out](https://wordpress.org/support/plugin/image-source-control-isc) in case you are suddenly missing any image sources.

* rewritten the way how images are detected in the content of the post or page
* replaced use of image url with attachment ID where possible to lift some heavy loads
* fix for image names including dimensions (e.g., 300x250)
* works with version 2.4.0 of Gutenberg plugin
* place overlay correctly even when page continues to shift after being loaded
* load public JavaScript in footer by default
* prevent saving ISC post meta information on non-public post types

= 1.8.11.2 =

* fixed align value not being understood correctly

= 1.8.11.1 =

* fixed missing index issue
* call parent class in admin class constructor

= 1.8.11 =

* cleanup
* removed log spam introduced with 1.8.10
* prevent SQL injection through crafted img src attributes

= 1.8.10.1 =

* hotfix for php below 5.3

= 1.8.10 =

* don’t list images attached to non-public posts in the full image list, when only visible images should be displayed, thanks to heiglandreas
* added fallback to read images from galleries
* added `isc_get_image_by_url_query` filter
* fixed image list being empty due to autosave
* read src from attribute according to dom documentation, thanks to heiglandreas
* tested with WordPress 4.4 beta 4

= 1.8.9 =

* rather use than error-log query

= 1.8.8 =

* search for image urls regardless of their used protocol (http or https)

= 1.8.6 | 1.8.7 =

* removed duplicate post links on full source list

= 1.8.5 =

* fixed deprecated sanitize_url()

= 1.8.4 =

* [feature] added option to display all images in the full list, not just those visible in posts
* [fixed] default author text not showing up

= 1.8.3 =

* [fixed] saving pre text for source overlay, thanks to maler.whick

= 1.8.2 =

* [feature] show image sources for changed images
* [feature] show image sources for images with query parameters

= 1.8.1 =

* [fixed] set default value for new option to prevent error message

= 1.8 =

* [feature] display image sources on archive pages (see settings)
* [feature] use `isc_thumbnail_source()` to display thumbnail source in templates
* [feature] added image sources for galleries and other shortcodes
* updated German translation

= 1.7.3 =

* [fixed] bug on ajax calls preventing the source fields to show up on ajax called pages in the dashboard
* [fixed] bug on multisite update
* [optimized] don’t hide setting boxes
* [optimized] finished moving all publically needed function to its own class

= 1.7.2 =

* [fixed] error message shown when list type settings was empty or unsaved
* [fixed] source overlay showing if no image source was set for it
* [optimized] trim source input

= 1.7.1 =

* [fixed] source list function referring to the wrong plugin class

= 1.7.0 =

* [optimized] manage different source display types on top of settings page
* [optimized] renamed settings page to "Image Sources"
* [removed] hiding source list elements in the frontend is no longer possible
* [fixed] show source list not only below posts, but every other post type
* [fixed] removed screenshots from main plugin files