Description
** this plugin is no longer being update. Please feel free to adopt me! **
Allows users to add custom fields to the media uploader and access those fields in template files. Great for adding copyrights etc.
Includes the following functions to help improve your website:
thisismyurl_get_custom_media_field( $attachment_id, $unique_field_id )
– Fetches the valuethisismyurl_has_custom_media_field( $attachment_id, $unique_field_id )
– Returns boolean valuethisismyurl_custom_media_field( $attachment_id, $unique_field_id )
– Displays the value
To use this plugin effectively, download and intall it on your WordPress blog. Next, access the settings page (Settings > Add Custom Fields to Media) and create a new custom field for your media uploads.
- Unique ID – The unique variable name for this item. It may not contain special characaters or spaces
- Field Title – The name you want to appear in the media uploader
- Field Help – A descriptive message you want to appear in the media uploader
Once you’ve added a custom field, you can access it via the Media menu in WordPress or during the Add Media process of uploading a new item.
To display the information on your website, please use thisismyurl_custom_media_field( $attachment_id, $unique_field_id )
.
If you would like to load the contents into a variable, please use thisismyurl_get_custom_media_field( $attachment_id, $unique_field_id )
To check if a variable exists, use thisismyurl_has_custom_media_field( $attachment_id, $unique_field_id )
In all cases the $unique_field_id is the Unique ID you specified when creating the field.
The $attachment_id is the ID of the attachment itself (not the post that you’re working with).
Updates
Updates to the plugin will be posted to http://thisismyurl.com/downloads/add-custom-fields-to-media/
Donations
If you would like to donate to help support future development of this tool, please visit http://thisismyurl.com/downloads/wordpress-plugins/
Installation
To install the plugin, please upload the folder to your plugins folder and active the plugin.
FAQ
- How do I see the results?
-
Includes the following functions to help improve your website:
thisismyurl_get_custom_media_field( $attachment_id, $unique_field_id )
– Fetches the valuethisismyurl_has_custom_media_field( $attachment_id, $unique_field_id )
– Returns boolean valuethisismyurl_custom_media_field( $attachment_id, $unique_field_id )
– Displays the value
- How do I add a photo credit to a featured image?
-
Here’s my code snippet for adding a photo credit directly under a featured image.
if ( thisismyurl_has_custom_media_field() ) { $credit_name = thisismyurl_get_custom_media_field( get_post_thumbnail_id( $post->ID ), 'credit_name' ); $credit_url = thisismyurl_get_custom_media_field( get_post_thumbnail_id( $post->ID ), 'credit_url' ); if ( empty( $credit_name ) ) $credit_name = $credit_url; if ( !empty( $credit_url ) ) $credit_text = '<a href="' . $credit_url . '" title="' . $credit_name . '">' . $credit_name . '</a>'; else $credit_text = $credit_name; $credit_text = '<div class="media-credit">' . $credit_text . '</div>'; echo $credit_text; }
Note that I named my Unique ID’s credit_name and credit_url in this example, and am fetching the them based on the ID returned for the Post feature image using get_post_thumbnail_id( $post->ID ).
- Why does this plugin have thisismyurl_ before the function name?
-
Each plugin added to WordPress has the potential to conflict with the core, theme, or other plugins. To ensure this plugin adds only unique code to your website, the prefix thisismyurl_ is added to each function. thisismyurl is my personal domain, as well as my @thisismyurl alias on Twitter. If you’d like to ask me questions about the plugin, please feel free to Tweet me.
- Where can I get more information, or technical support for this plugin?
-
Technical support is available for free from the WordPress community on wordpress.org.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Add Custom Fields to Media” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Add Custom Fields to Media” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.2.5 (March 31, 2013)
- fixed incorrectly named categories
- removed link to website from plugin links
- encoded and removed icon
- added support link
1.2.1 (September 13. 2012)
- language customization
- renamed function for compatibility
1.2.0 (September 13. 2012)
Added functions:
thisismyurl_has_custom_media_field( $attachment_id, $unique_field_id )
– Returns boolean valuethisismyurl_custom_media_field( $attachment_id, $unique_field_id )
– Displays the value
1.0.1
- fixed a bug in the fetch function
1.0.0
- initial release