Adobe 65007312 Programming Guide - Page 187

10 Defining Metadata: A Walkthrough This chapter shows how a plug-in can define metadata fields that Lightroom can display along with standard metadata for photos, and which you can use as a private data model for plug-in processing. It also illustrates how the private data can be used to customize the Plug-in Manager. These concepts and techniques are introduced and explained in more detail in Chapter 3, "Creating Export and Publish Services." Adding custom metadata This simple example plug-in demonstrates how to define your own metadata fields to be associated with photos. Your fields can be displayed in the Lightroom Metadata panel, where users can set or modify their values. You can also define private data for your plug-in, which is not displayed to users. First, we will create the framework for the plug-in, which is similar to that for an export plug-in. 1. Create a new folder in your chosen directory called myMetadata.lrplugin. 2. In this folder, create three new files Info.lua MyMetadataDefinitionFile.lua MyMetadataTagset.lua 3. Edit the Info.lua file to add the following code: return { LrSdkVersion = 3.0, LrToolkitIdentifier = 'sample.metadata.mymetadatasample', LrPluginName = LOC "$$$/MyMetadataSample/PluginName=My Metadata Sample", LrMetadataProvider = 'MyMetadataDefinitionFile.lua', LrMetadataTagsetFactory = 'MyMetadataTagset.lua', } Define metadata fields Now we are going to create the custom metadata fields in the definition file. 4. Open the file MyMetadataDefinitionFile.lua and add the following code as the initial framework: return { metadataFieldsForPhotos = { }, schemaVersion = 1, } The schema-version value provides version control; it can be incremented to notify users of changes to the plug-in. 187