WordPress Plugin

About the plugin

Purchasing

Setup

Browsing and importing PhotoShelter files

Enabling multisite support

Re-Authenticating

About the plugin:

The WordPress plugin enables you to easily browse and search your PhotoShelter Library and import supported files so they can be embedded into pages or posts on your WordPress site (including WordPress Multisite). PhotoShelter customers can copy files to their WordPress media Library or browse their Brands Library within the WordPress page editor and files directly into pages and posts. Plus, metadata automatically imports from PhotoShelter and can be edited without affecting anything in your PhotoShelter Library.

Purchasing:

1. There are two options to use the PhotoShelter Importer plugin for WordPress:

   Option 1: Give WordPress users access to everything in your PhotoShelter account
   You will need to create a new user with a unique email address and password (one that is not already in use with PhotoShelter). This will serve as your integrations account and allow everyone in your WordPress environment to access your organization’s Library without impacting your login limit. 
   
   Option 2: Limit WordPress users access to specific Collections or Galleries
   You will need to create an Invited User email address and password (e.g. wordpress@mycompany.com) and invited that user to the specific Collections or Galleries you want WordPress users to have access to.

2. Next, you will need to contact our support team to purchase the plugin and obtain an API key.

Setup:

1. In the WordPress plugin directory, search for "PhotoShelter" and install the "PhotoShelter Importer." Once installed, click "Activate."

   

2. When the plugin has been installed and activated, you will need to go to Settings > PS Importer Settings to connect your PhotoShelter Library.
   
   

3. Enter the API key sent to you by Customer Support when you purchased the plugin. Once the API key has been saved, you will need to authorize access to your Library. 
   

4. When you are redirected to photoshelter.com, log with one of these choices depending on your needs:
   
   Option 1: Give WordPress users access to everything in your PhotoShelter account
   Log in with the integrations account that you set up for this plugin. Then, you enter your PhotoShelter Organization ID to ensure that your Library is accessible. This can be found in your PhotoShelter account under Admin > Account Settings.
   
   
   
   Option 2: Limit WordPress users's access to specific Collections or Galleries
   Log in using an Invited User email (e.g. wordpress@mycompany.com), if you want WordPress users to have access to only the specific Collections or Galleries shared with the Invited User email (e.g. wordpress@mycompany.com).
   
   If you use log in as an Invited User, you do not need to enter your PhotoShelter Organization ID.

Browsing and importing PhotoShelter files:

After you've set up the plugin, you'll be able to browse your PhotoShelter for Brands account and import specific files directly into WordPress. 

1) Click on the PhotoShelter Importer item in the WordPress menu

2) Browse through the available Collections and Galleries or use search to find files that match a specific term. 

3) Click on a thumbnail to see a preview of the file and select a size to import

4) Click Import to add the file to your WordPress Media Library

Embedding Files

Image files can be embedded into your WordPress post using the link available next to the file in the import window. Video files cannot be embedded and must be imported into the Media Library.

Enabling Multisite Support

If you want to use the PhotoShelter Importer plugin with WordPress multisite, you'll need to install the plugin on your multisite network:

1. On the WordPress menu, click My Sites > Network Admin > Plugins

2. Click add new to install a new plugin 

3. Find and install the PhotoShelter Importer in the plugin directory

4. After installation, you will see a link to Network activate the plugin. Click it to make the plugin available to all sites on your multisite network.

Re-Authenticating:

If you ever encounter trouble when loading the Library content during an import, we suggest re-authenticating in the plugin as the login session may have expired. 

1. On the WordPress menu, click Settings > PS Importer.

​

2. Click to Log out.

3. Follow the instructions in the Setup portion of this article to reconnect WordPress with your PhotoShelter for Brands Account

Compatibility 

PhotoShelter's WordPress plugin requires write access to your organization's WordPress server. This means that your WordPress setup must have writable storage to import assets from the Library into your WordPress instance. Please contact your organization's IT team to confirm compatibility before installing the plugin. 

Known Plugin Conflicts

Your organization's WordPress instance may contain incompatible plugins that prevent the Library from loading. When possible, we recommend disallowing any incompatible plugins. 

The following plugins are incompatible with the PhotoShelter WordPress plugin:

• Slack Notifications by dorzki: https://wordpress.org/plugins/dorzki-notifications-to-slack/ ​

If you have any questions, get in touch with our Customer Success team.