=== 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 ==

Version Numbering

Version components: `{major}.{minor}.{bugfix}[-{stage}.{level}]` * {major} = Major structural code changes and/or incompatible API changes (ie. breaking changes). * {minor} = New functionality was added or improved in a backwards-compatible manner. * {bugfix} = Backwards-compatible bug fixes or small improvements. * {stage}.{level} = Pre-production release: dev < a (alpha) < b (beta) < rc (release candidate).

Repositories

* [GitHub](https://jsmoriss.github.io/adobe-xmp-for-wp/) * [WordPress.org](https://plugins.trac.wordpress.org/browser/adobe-xmp-for-wp/)

Changelog / Release Notes

**Version 1.6.0 (2020/11/21)** * **New Features** * None. * **Improvements** * Added support for the copyright <dc:rights></dc:rights> tag. * **Bugfixes** * None. * **Developer Notes** * None. * **Requires At Least** * PHP v7.4.33. * WordPress v6.0. == Upgrade Notice == = 1.6.0 = (2020/11/21) Added support for the copyright <dc:rights></dc:rights> tag.