DF Studio supports publishing assets directly to the media library of a remote WordPress site. This saves time, because the user is not required to download files and upload them to WordPress, and increases security because the images do not leave the DF Studio Library except by a secure connection to the WordPress site which is recorded in the asset’s history.
Before assets can be shared directly between DF Studio and WordPress, the remote service must be configured. This is a one-time operation, which requires a few steps by an administrator of the WordPress account, and ends with DF Studio support staff registering the connection within the system on behalf of the user.
1. Install a WordPress Plug-In for Remote Authentication
Using a WordPress administrator account, install a plug-in to enable remote authentication. Two plug-ins are supported by DF Studio. The OAuth 1.0a plug-in is highly recommended. It is based on the secure OAuth standard, and never shares account information between WordPress and DF Studio (instead relying upon the exchange of a secure token).
Once the plug-in has been installed and activated on the WordPress account, a service must be configured. Click “Applications” in the “Users” menu, then click “Add New”.
Add a new application using the following information:
Consumer Name: DF Studio
(Where example.dfstudio.com should be replaced by the site URL of the DF Studio account.)
The Description field in the plug-in settings is not shared with DF Studio, and can be used to display internal information to other users within the WordPress account if desired.
Click the “Add Consumer” button to save the configuration, and make note of the Client Key and Client Secret values for registering the service with DF Studio.
DF Studio also supports the WP Basic-Auth plug-in, although it is less secure. For information about configuring a remote WordPress service using the Basic-Auth plug-in, see Configure with the Basic-Auth Plug-in below.
2. Register the Service with DF Studio
Once the plug-in has been installed and activated, contact DF Studio support staff to register a service within the DF Studio account. Use the “Contact Us” link within the knowledge base or email firstname.lastname@example.org with the following information:
- The DF Studio account name and site with which to register the service. (e.g., account example_network on example.dfstudio.com)
- The URL of the WordPress site: the web address where viewers access the WordPress site. (e.g., https://example_company.com/blog)
- The Service Name that is preferred for the remote publishing service (e.g., PR WordPress Page). This will appear as an option in the DF Studio interface when account holders are choosing where assets should be published.
- Client Key (e.g., 4pGbOMtb9fEW)
- Client Secret (e.g., litwnF4qpkuAdauXV8eCgDKz7CdoAJ9…)
The Client Key and Client Secret can be found within the WordPress account by visiting Users > Applications, and clicking Edit under the DF Studio application.
DF Studio support staff will use this information to register the remote service within the publishing system.
3. Authenticate Between DF Studio and WordPress
Once the plug-in has been configured and the service has been registered, it will appear in the Connect to Services section when using the Publish Assets overlay in DF Studio. Each DF Studio user who needs access to publish assets using a particular service will need to authenticate the connection one time, after which DF Studio will store the credentials securely for future use.
See Publish Assets to a Remote Service for details about publishing assets, or follow the steps below to complete the one-time authentication.
a) Select any asset, or begin without a selection to publish all assets in the current view. Then click the “Publish” button in the toolbar at the bottom of the window.
b) In the Publish Assets overlay, choose the new service by clicking the “Connect” button beside its name. (This will match the Service Name provided to DF Studio support staff in step 2.)
c) A message will appear, explaining that the user will be connected to WordPress for authentication. Click “OK” to visit the WordPress login page.
d) Log in to the WordPress site if necessary, and click the “Authorize” button to grant DF Studio access to publish images into the WordPress account.
Once the connection is registered and authenticated using the steps above, it will be stored in DF Studio and available to the account holder whenever opening the Publish Assets overlay. If the service expires, it can normally be restored by repeating step 3. In rare cases, it may be necessary to re-register the service with DF Studio (repeat steps 2 and 3).
Configure with the Basic-Auth Plug-in
DF Studio recommends that all users employ the OAuth plug-in described above for creating a secure connection between the DF Studio account and the WordPress site. However, if the OAuth plug-in is not available, the WP Basic-Auth plug-in is also supported, although it does not represent the same level of security. As indicated by the plug-in developer, it is intended for debugging and testing only. Once it is installed and activated, no further steps are needed within the WordPress account.
After installing and activating the Basic-Auth plug-in, contact DF Studio support to register the service, as described in step 2 above. The Client Key and Client Secret are not available for the Basic-Auth plug-in and may be omitted.
In step 3 above, steps a and b are identical for both plug-ins. Services configured with Basic-Auth will be authenticated by providing the WordPress username and password rather than connecting to the WordPress site for authentication (steps c and d, above). These credentials will be stored securely by DF Studio and used whenever the DF Studio user publishes assets to the WordPress site.