Image Source Control Manual

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

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.

add missing fields

Now you find a the new submenu Missing Sources under Media. Please visit this page by clicking on the link.

It is currently still necessary to update the fields for the sources once after you have activated the plugin. Please do so by clicking add metafields to images. Normally, you only need to do this once. Anyway, if there are any problems with images not showing up in the following list, please use this link again. Depending on the performance of your system and the amount of images, this might take a few seconds. If you got somehow interrupted, please simply use it again.

Image Source Control admin 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.

Use authors names

If you check this field in case you the copyright owner of an image is the posts author, his name will be used in the image liste instead of a default text.

Custom text for owned images

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

Link to webgildes 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.

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.

list missing 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

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"]