Contributors: sbressler, Byron lutz

Donate link: http://www.scottbressler.com/blog/plugins/

Tags: media, image, images, credit, byline, author, user

Requires at least: 3.5 (probably)

Tested up to: 3.5

Stable tag: 1.2

Adds a "Credit" field when uploading media to posts and displays it under the images on your blog to properly credit the artist.

This plugin has been modified by Byron Lutz to work with WordPress 3.5. I bumped the version number and made some significant structural changes so this plugin is not directly compatible with Scott's versions (for more see the wiki on GitHub).

Upgrade instructions are on the wiki.

Feel free to get in touch with me about anything you'd like me to add to this plugin or any feedback. I love hearing from my users! E-mail me here.

This plugin adds a "Credit" field when uploading media to posts and displays it under the images on your blog to properly credit the artist.

When adding media through the Media Uploader tool or editing media already in the Media Library, this plugin adds a new field to the media form that allows users to assign credit for given media to a user of your blog (assisted with autocomplete) or to any freeform text (e.g. courtesy photos, etc.).

When this media is then inserted into a post, a new shortcode, [media-credit], surrounds the media, inside of any caption, with the provided media credit information. Media credit inside this shortcode is then displayed on your blog under your media with the class .media-credit, which has some default styling but which you can customize to your heart's content.

You can also display all the media by an author on the author's page. See more in the FAQ.

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

Since this plugin is not on the WordPress.org plugin repository you must do a manual install:

1. Download the contents of this repository
2. Extract the contents of the zip file into your /wp-content/plugins/ directory
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Make the proper modification to your WordPress install (see the wiki)
5. Party.

You should see the shortcode in the visual editor but not on the front-end of your site. See the wiki for a fix to this.

Add this to your theme's functions.php file to get rid of those pesky media-credit shortcodes:

<?php function ignore_media_credit_shortcode( $atts, $content = null ) { return $content; } global $shortcode_tags; if ( !array_key_exists( 'media-credit', $shortcode_tags ) ) add_shortcode('media-credit', 'ignore_media_credit_shortcode' ); ?>

Also, I'd really appreciate it if you gave me some feedback as to why you disabled the plugin and how it could have better suited your needs.

Indeed, just call the template tag <?php display_author_media($author_id); ?> in your theme's author.php (or elsewhere, if you want). The template tag has optional parameters if you want to customize the CSS or text. The default options will display thumbnails of the 10 most recent media items credited to the given user floated to the right with a width of 150px and a header of <h3>Recent Media</h3>.

These options can be changed with a more verbose call to the function: <?php display_author_media($author_id, $sidebar = true, $limit = 10, $link_without_parent = false, $header = "<h3>Recent Media</h3>", $exclude_unattached = true); ?>. This will make only the 10 most recent media items that are attached to a post display with the given header taking up the maximum width it's afforded. Each image will link to the post in which it appears, or the attachment page if it has no parent post (unless $link_without_parent is set to false). If you don't care about whether the media is attached to a post, change $exclude_unattached to false. This function as a whole will only display media uploaded and credited to a user after this plugin was installed.

I'm so glad you asked; you certainly can! Just call <?php get_media_credit_html($post); ?> with an attachment_id (int) or post object for an attachment to get the media credit, including a link to the author page. To echo the results, call <?php the_media_credit_html($post); ?>.

Yep! If you would prefer plain-text rather than a link for all media credit (and leaving out the separator and organization), call <?php get_media_credit($post); ?> which uses the same parameter as above. To echo the results, call <?php the_media_credit($post); ?>.

You sure can. Just link to the artist's website in the name attribute in the media-credit shortcode, found in HTML view for a post, or directly when adding an image. For example, if your post contains:

[media-credit name="Artist" align="alignleft" width="300"]<img src="http://www.mysite.com/files/2010/09/image.jpg" width="300" height="450" class="size-300 wp-image-2" />[/media-credit]

change it to:

[media-credit name="<a href='http://www.artistwebsite.com/'>Artist</a>" align="alignleft" width="300"]<img src="http://www.mysite.com/files/2010/09/image.jpg" width="300" height="450" class="size-300 wp-image-2" />[/media-credit]

Note the link to www.artistwebsite.com above.

(Thanks to Mike Schuerlein for this excellent question!)

Feel free to get in touch with me about anything you'd like me to add to this list. E-mail me here.

1. Media can easily be credited to the creator of the media with the new Credit field visible when uploading or editing media
2. Media credit is nicely displayed underneath photos appearing on your blog
3. Recent media items attributed to an author can be displayed nicely on the author's page using a very simple template tag (see the FAQ for more information)

• Updates the plugin for WordPress 3.5

• Fixes total autocomplete failure on WordPress 3.1
• Fixes freeform credit situation where a user was selected but freeform text was entered afterward
• Fixes extra output on activation notices (they weren't serious, but I imagine some people were freaking out seeing them)

• Updating media credit in the Media Library really does update the credit within posts correctly now! (props: Greg Wrey)
• Adding multiple images with freeform media credit to a post also now works as expected (props: Greg Wrey)

• Now compatible with TinyMCE! Media credit will appear inline (i.e. below the photo) when using the Visual editor rather than as an ugly shortcode.
• Updating media credit in the Media Library will now correctly and safely update it in an attached post, regardless of whether it's a WP user or not

• Added filter on the_author so that media credit is properly displayed in Media Library (not yet for unattached media, though - will be added in WP 3.1 hopefully)
• Made $post parameter actually optional in template tags (used global $post if not given)

• Changed post meta field from media-credit to _media_credit so that it doesn't appear in custom fields section on Post edit page normally. Upgrade script will handle changing the key for all existing metadata.

• Added author media rendering methods (see FAQ)
• If media credit is edited in the Media Library, the media credit in the post to which media is attached to will now update as well!
• Only load JS and CSS in admin on pages that need it
• Blank credit can now be assigned to media
• Switched rendering of media-credit shortcode credit info to div instead of span for more readable RSS feed

• Switched autocomplete to an older, more stable version - should be working great now for all blogs!
• With above, fixed loss of control of AJAX functionality in WordPress admin area
• Default options are now correctly registered when the plugin is activated
• Any pre-existing options will not be overwritten when activating the plugin
• Separator and organization names on the settings page are properly escaped

• Fixed autocomplete when selecting credit so that it only shows currently selectable users (particularly important for WordPress MU users).
• Made it so that upon clicking in the Credit field the text already there will be highlighted - start typing right away!
• Hid media credit inline with attachments if the "Display credits after post" option is enabled.

• Initial release.

Options

This plugin provides a few options which appear on the Media page under Settings. These options are:

• Separator
• Organization
• Display credits after post

Example

This is best explained with an example. With a separator of " | " and an organization of The Daily Times, media inserted will be followed with a credit line appearing as follows, with the username linking to the author page for that user:

John Smith | The Daily Times

Further explanation

Separator: These are the characters that separate the display name for a user on your blog from the name of the organization, as described below. The default separator is " | " but feel free to change this to suit your needs.

Organization: This is what appears after the separator as listed above. The default organization is the name of your blog.

Display credits after post: With this option enabled, media credit shortcodes will not appear by default when inserting media into your posts. Instead, the plugin will look through the content of your posts for any media attachments and display something like the following at the end of each post with the CSS class .media-credit-end:

Images courtesy of John Smith | The Daily Times, Michael Scott and Jane Doe.

In this example, John Smith is a user of your blog, while the latter two credits are not.