This is the manual of Image Source Control (ISC), our plugin for WordPress to help you to never forget to add the copyright holder of an image on your blog.

installation

ISC Plugin gefunden

WordPress findet das Plugin

You can download ISC from the plugin directory on wordpress.org. You can either download the archive, unzip and upload it via FTP into your plugin directory under wp-content/plugins or you can search for the plugin under Plugins > Add New from directly in your blog and also install it from there.

After having installed the plugin, please don’t forget to activate it under Plugins > Installed Plugins aktivieren.

Image Source Control admin panel

image source control settings panel

image source control settings panel

To fine tune Image Source Control, you find the admin panel under Settings > Image Control in the backend of your WordPress-Installation.

Image list headline

Here you can choose the headline that appears above the image lists of posts or pages.

Hide the image list

You can choose whether to show the image list only after clicking on the headline or always show it. It is advised to show the image list on default.

Full images list – Thumbnails

You can enable thumbnails in the complete image list. This will make it more colorful and interesting for visitors. If you activate the display of thumbnails you can also choose the size of the thumbnails. You can either use the default thumbnail sizes defined by WordPress or your theme (thumbnail, medium, large) or define custom thumbnail width and height.

Licences

Enabling licences lets you choose a licence for each image. You can maintain the licences yourself by just entering the name and url for one licence per line in the text field. Licences will be linked in the frontend if you entered the url.

Exclude own images from lists

Check the ”Exclude own images” box to NOT list images marked as being your own in the images lists for posts or the whole site.

Use authors names

If you check this field, the name of the uploader of the image will be shown as the author in image source lists.

Custom text for owned images

If you didn’t choose to display the uploaders name as the copyright owner of an image (see Use authors names), this default text will be shown in the image lists.

Link to webgilde’s website

By checking this option, you display a link below the complete image list (not all image lists on posts and pages, just the main image list, if you use it at all). This will help others to use Image Source Control and is an approval of the plugin authors hard work.

Source as caption on image

You can activate this to show the image source as a layer above the image. Choose a text you want to display before the image source, e.g. Source:

Select the position of the image caption from the options. You can optimize this with your own CSS manually.

Warnings

You can choose to see a warning on each admin page when there is at least one image source missing by activating Warning when there is at least one missing source. When activating Warnings when source not available you will receive warnings and be not allowed to save an image, if the source is missing.

list missing sources

Liste fehlender Bildquellen

List of missing image sources

After updating the meta fields and reloading the page, you should see a list with images without information about the source. This list contains the title of the image and the post it is attached to.

Click the image title to reach the edit page for the image. Here you should see two additional fields right below the others. One is a normal text field to include the name of the image owner or author and the other field is a checkbox to mark if this is your image. Only one of these information is needed for the image to not being listed in the list with missing sources and to have a source information displayed in the frontend.

image sources in the frontend

image sources list

list of image sources in the frontend

There are two possibilities to display image sources of a post in the frontend. One is a shortcode you can enter in the content field and the other is a function you can add to your template file.

using the shortcode

You can simple write this shortcode into the content editor of your post or page to display the list of image sources of this post or page on the position you put it. The shortcode is fairly simple.

[isc_list]

include into templates

If you want to list the images on more than a few posts and pages and therefore include it into your template, you can open the template file and write the following code where you want to display the list later:

<?php if( function_exists('isc_list') ) { isc_list(); } ?>

As you can see on the screenshot on the right the image sources are placed below a headline. The list included the title of the image and the author. In case you marked the “This is my image” checkbox, the image author will be uniform for all of your images. This will be addressed in a later version of the plugin.

For any further question, please visit the support forum on wordpress.org to ask.

list all image sources

ISC also provides a shortcode to list all image sources of the whole blog and its posts and pages. You can also limit the number of image sources per page and so create a paginated list. The table includes the image title, the post it is attached to and the author.

Use the following shortcode to list all images.

[isc_list_all]

Use the attribute ‘per_page’ to list only a limited number of image sources per page (here: 25).

[isc_list_all per_page="25"]

Filters

In case you need to add image sources yourself, like for images in custom fields, you can use the following filters (see the WordPress Plugin API for information on how to use filter).

isc_images_in_posts

Is applied for the images that are belonging to a post and saved as a meta field to it. This information is used when listing images for single posts and pages. $image_urls contains an array with other arrays for each post. Each looks similar to this example: ‘thumbnail’ is preserved for the post thumbnail. You probably won’t need it.


{attachment_id} =&gt; array('src' =&gt; 'http://example.com/wp-content/uploads/2011/01/example-image.png'
'thumbnail' =&gt; 1
)

From the following call of the filter you can see, that the post ID is submitted in case you need it. Use add_filter() like described on the Plugin API to add your filter to it.

$_imgs = apply_filters('isc_images_in_posts', $_imgs, $post_id);

isc_images_in_posts_simple

This filter also runs on the images that are saved for a post, but it adds a meta field to the images containing the posts it is used in. These fields are used when showing the complete image list. If you don’t show the complete list of images on your post, you might not need this filter.

An element in the array that is filtered looks like this

1 =&gt; 'http://example.com/wp-content/uploads/2011/01/example-image.png'

The filter call looks like this. You can use the $post_id in case you need it. Use add_filter() like described on the Plugin API to add your filter to it.

$image_urls = apply_filters('isc_images_in_posts_simple', $image_urls, $post_id);