=== JSM Adobe XMP / IPTC for WordPress ===
Plugin Name: JSM Adobe XMP / IPTC for WordPress
Plugin Slug: adobe-xmp-for-wp
Text Domain: adobe-xmp-for-wp
Domain Path: /languages
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl.txt
Assets URI: https://jsmoriss.github.io/adobe-xmp-for-wp/assets/
Tags: photoshop, xmp, iptc, rdf, xml
Contributors: jsmoriss
Requires PHP: 7.4.33
Requires At Least: 6.0
Tested Up To: 7.0
Stable Tag: 1.6.0
Provides Adobe XMP / IPTC information from Media Library or NextGEN Gallery images using a shortcode or PHP class method.
== Description ==
Retrieve the following Adobe XMP / IPTC information from images in the WordPress Media Library and NextGEN Galleries:
* Creator Email
* Owner Name
* Creation Date
* Modification Date
* Label
* Credit
* Source
* Headline
* City
* State
* Country
* Country Code
* Location
* Title
* Description
* Creator
* Rights
* Keywords
* Hierarchical Keywords
The extracted XMP / IPTC data is cached on disk to improve performance and is refreshed if / when the original image is modified.
You can use the plugin in one of two ways; calling a method in your theme template(s) or using the [xmp] shortcode in your content.
There are no plugin settings - simply install and activate the plugin.
== Installation ==
= Automated Install =
1. Go to the wp-admin/ section of your website.
1. Select the *Plugins* menu item.
1. Select the *Add New* sub-menu item.
1. In the *Search* box, enter the plugin name.
1. Click the *Search Plugins* button.
1. Click the *Install Now* link for the plugin.
1. Click the *Activate Plugin* link.
= Semi-Automated Install =
1. Download the plugin ZIP file.
1. Go to the wp-admin/ section of your website.
1. Select the *Plugins* menu item.
1. Select the *Add New* sub-menu item.
1. Click on *Upload* link (just under the Install Plugins page title).
1. Click the *Browse...* button.
1. Navigate your local folders / directories and choose the ZIP file you downloaded previously.
1. Click on the *Install Now* button.
1. Click the *Activate Plugin* link.
== Frequently Asked Questions ==
= How do I retrieve XMP data as an array? =
my $adobeXMP =& adobeXMPforWP::get_instance(); my $xmp = $adobeXMP->get_xmp( $image_id ); echo '<p>Photograph by ' . $xmp[ 'Creator' ] . '</p>';= How do I include a shortcode in a post or page? =
[xmp id="101,ngg-201"]This shortcode prints all the XMP information for Media Library image ID "101" and NextGEN Gallery image ID "201". The XMP information is printed as a definition list <dl> with a CSS class name of "xmp_shortcode" that you can style for your needs. Each <dt> and <dd> element also has a style corresponding to it's title - for example, the "Creator" list element has an "xmp_creator" CSS class name. Here's an example of the definition list HTML:
<dl class="xmp_shortcode"> <dt class="xmp_credit">Credit</dt> <dd class="xmp_credit">JS Morisset</dd> <dt class="xmp_source">Source</dt> <dd class="xmp_source">Underwater Focus</dd> <dt class="xmp_hierarchical_keywords">Hierarchical Keywords</dt> <dd class="xmp_hierarchical_keywords">What > Photography > Field of View > Wide-Angle > Fish-Eye</dd> </dl>
The shortcode can also take a few additional arguments:
*include (defaults to "all")
Define which XMP elements to include, for example:
[xmp id="101" include="creator,creator email"]*
exclude (defaults to none)
Exclude some XMP elements, for example to print all XMP elements, except for the "creator email":
[xmp id="101" exclude="creator email"]*
show_title (defaults to "yes")
Include / exclude the <dt> definition titles.
[xmp id="101" show_title="no"]*
show_empty (defaults to "no")
Include / exclude empty <dd> definition values.
*not_keyword (defaults to none)
Exclude a list of (case incensitive) keywords, for example:
[xmp id="101" not_keyword="who,what,where"]
To exclude a hierarchical keyword list, use hyphens between the keywords, for example:
[xmp id="101" not_keyword="who,what,where,who-people-unknown"]== Screenshots == == Changelog ==