=== OpenAsset ===
Requires at least: 6.0
Requires PHP: 8.0
Tested up to: 7.0.0
Stable tag: 6.2.0
Tags: DAM, Digital Asset Management, Images, Projects, Team
Contributors: OpenAsset
License: GPLv2
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sync your AEC Project Portfolio, Employees and Images from OpenAsset to your Wordpress Website.

== Description ==

**It is possible to use this plugin to just sync images without integrating data, however, if you are looking to sync Project or Employee data to your website, it requires writing code for frontend integration.  It is therefore advised that you do not install directly on your live website.  Install onto a development environment first.  Ensure your integration is fully tested before you deploy live.**

**Anyone can download this plugin but in order to install and configure, it requires you to be an OpenAsset customer and have a specific OpenAsset license. If you are interested in the obtaining the license please reach out to your OpenAsset Customer Success Manager or [submit this form](https://pages.openasset.com/integrations-contact-us.html)**

OpenAsset is a leading provider of Digital Asset Management solutions designed to meet the unique needs of the Architecture, Engineering, and Construction (AEC) industries. Our vision is to supercharge productivity of AEC marketing and business pursuit teams so they can win more business.

OpenAsset's Website Connector for WordPress enables AEC companies to sync project and employee profiles with relevant details, experience, and marketing-ready images directly from OpenAsset to their public-facing website.  This eliminates data redundancy, ensuring that high-quality assets are maintained centrally, streamlining workflows and boosting efficiency.

**Effortless Project Showcase:** Showcase your AEC projects seamlessly on your website with a few clicks. The connector enables display of approved and consistent project details, enhancing your online presence.

**Employee Profiles that Stand Out:** Highlight your team's expertise by effortlessly publishing employee profiles directly from the DAM. Keep your team information up-to-date and impress your clients with the talent behind your projects.

**Marketing-Ready Images:** Present your projects with stunning visuals. The connector enables you to select and publish marketing-ready images directly from your DAM, ensuring consistency and professionalism across your web presence.

**Data Consistency and Centralization:** Say goodbye to inconsistency. The connector synchronizes with your OpenAsset instance, ensuring that the information on your website is up-to-date and reflective of your latest projects and team members.

**Presentation and web design in your control:**  The connector offers a simple UI template that you are free to modify or your web developer is able to integrate the data into your fully custom website UI.

== Links ==

* [openasset.com](https://www.openasset.com)
* [Using OpenAsset's Website Connector for WordPress](https://success.openasset.com/en/articles/8970283-using-openasset-s-website-connector-for-wordpress)
* [Using the templates bundled with OpenAsset's Website Connector for WordPress](https://success.openasset.com/en/articles/8971102-using-the-templates-bundled-with-openasset-s-website-connector-for-wordpress)
* [Creating a fully custom UI with OpenAsset's Website Connector for WordPress](https://success.openasset.com/en/articles/8971297-creating-a-fully-custom-ui-with-openasset-s-website-connector-for-wordpress)

== Installation ==

**It is possible to use this plugin to just sync images without integrating data, however, if you are looking to sync Project or Employee data to your website, it requires writing code for frontend integration.  It is therefore advised that you do not install directly on your live website.  Install onto a development environment first.  Ensure your integration is fully tested before you deploy live.**

**Anyone can download this plugin but in order to install and configure, it requires you to be an OpenAsset customer and have a specific OpenAsset license. If you are interested in the obtaining the license please reach out to your OpenAsset Customer Success Manager or [submit this form](https://pages.openasset.com/integrations-contact-us.html)**

**Plugin Installation**

To install, from your WordPress dashboard:

1. Visit Plugins > Add New
2. Search “OpenAsset”
3. Install and Activate "OpenAsset" from your plugins page.
4. In your OpenAsset instance, [create an OpenAsset API token](https://success.openasset.com/en/articles/6243971-generating-an-authentication-token-in-openasset).
5. Add your API credentials to the plugin installation page.

[Read more here](https://success.openasset.com/en/articles/8970283-using-openasset-s-website-connector-for-wordpress)

**Website installation**

Installing OpenAsset's Website Connector for WordPress into your website will require work from your web developer.  The connector makes it easy to configure the data and images that you would like to sync from OpenAsset. There are a couple of options available to you when displaying this on your website:

* The connector is bundled with some simple templates. These can either be used as a quick proof of concept, or your web developer is free to modify them to suit the look and branding of your website.  [Read more here](https://success.openasset.com/en/articles/8971102-using-the-templates-bundled-with-openasset-s-website-connector-for-wordpress)
* Alternatively the data made available by the plugin can be built into a fully custom website frontend. [Read more here](https://success.openasset.com/en/articles/8971297-creating-a-fully-custom-ui-with-openasset-s-website-connector-for-wordpress)

== Support ==

**Support OpenAsset's Website Connector for WordPress is provided directly from OpenAsset's support team.**
If you have questions pertaining to downloading, installing, configuring and syncing the plugin, please reach out to: [support@openasset.com](mailto:support@openasset.com)

**Note:** We do not offer support for modifying or customizing your web pages including issues relating to the presentation of your information or images. Please contact your web developer for this.

== 3rd Party Services ==

OpenAsset's Website Connector for WordPress makes use of OpenAsset's API to retrieve and display data from your OpenAsset instance. By using this plugin you agree to OpenAsset's terms of service and privacy policy.

* [OpenAsset Terms & Conditions](https://openasset.com/terms-ltd)
* [OpenAsset Privacy Policy](https://www.iubenda.com/privacy-policy/69272435)

Using this plugin means that you do not need to interact with OpenAsset's API in code but for reference it is [documented here](https://developers.openasset.com)

== Screenshots ==

1. Connect to OpenAsset and choose to sync Projects, Employees or both.
2. Project Portfolio templates to get started or build your own.
3. Team templates to get started or build your own.

== Changelog ==

= 6.2.0 =
* Fix - "Select" option removed from Auto Sync Frequency menu.
* Fix - Smoothed transition to welcome page on first login.
* Fix - File caption and description now gated by options.
* Fix - Project Keywords now sync when no Project Fields are selected.
* Fix - When you initially install the plugin and choose to use Text Assets, the fields are deselected by default.
* Fix - Text Asset Name and Body Text fields are now locked selected.
* Fix - Role options now load correctly before first sync is run.
* Fix - Role title field now locked to sync by default.
* Fix - Roles now only sync when the connected Project is set to "Show on Website".
* Enhancement - OpenAsset Logo updated to latest branding.
* Enhancement - Images update on WordPress.org plugin page.
* Enhancement - Advice notice added when updating the plugin version.

= 6.1.2 =

* Fix - Incremental syncs now complete quickly on mid-sized datasets. Previously, sites with a few hundred projects or employees could stall during change detection on hosts with strict PHP execution time limits.
* Fix - Deleted employees in OpenAsset are now cleaned up in WordPress on the next sync, matching how deleted projects are already handled.
* Fix - Sync error messages that previously required detailed logging to see (queue initiation errors, API credential issues, term assignment failures, aborted syncs after repeated API errors) now appear in the standard log automatically.
* Fix - Plugin, WordPress, and PHP versions are now logged at the start of every sync to make debug logs easier to triage.

= 6.1.1 =

* Fix - Resolved issue of long-running syncs staying stuck on "Pending" in the dashboard eventhough they completed successfully.
* Fix - Image-heavy and large dataset syncs now complete reliably on managed hosting with strict PHP execution time limits.

= 6.1.0 =
* New - Option to enable detailed logging.
* New - Debug Log Preview.
* New - Download Debug Log.
* Enhancement - Basic logging is now persistent.
* Fix - Sync timestamps are now consistent with OpenAsset.

= 6.0.0 =

* New - Welcome screen for newly installed plugins.
* New - Dashboard that reports on sync stats.
* New - Links to help pages from the welcome screen and dashboard.
* Enhancement - Design and style overhaul for the entire plugin UI.
* Fix - Project $post_content is now not updated by the plugin and therefore free to be used as you wish.
* Fix - New method to identify keywords in order to avoid clashes with duplicate names across categories.

= 5.0.0 =

* New - Video Syncing for Projects and Employees
* New - Email sync notifications
* New - Sync Logs with error reporting
* Fix - Project Name Field prevented from being unset

= 4.1.0 =
* New - Default syncing now checks for changes in OpenAsset in order to speed it up.
* New - Improved progress reporting for syncs.
* New - Full syncs are now available as "maintenance syncs" that can be run manually or on a schedule.
* New - Support for using alternative Featured Images for Projects and Employees.
* New - Support for excluding Image Sizes from sync.
* Enhancement - Wordpress Image Alt field now populated by OpenAsset caption in the bundled templates.
* Enhancement - The Text Asset "show on website" field can now be a reference field.
* Enhancement - Date fields are now easier to read on the individual Text Asset wpadmin pages.
* Enhancement - Text Asset creation in wpadmin disabled.
* Fix - Intermittent issue where the "Sync Projects/Employees" menus would not have options on first install.

= 4.0.0 =
* New - Support for Text Asset Syncing.
* Enhancement - Asset sections in WP Admin sidebar have icons.
* Enhancement - Logging extended to better assist debugging.
* Fix - On completion of initial sync, asset sections appear automatically in the WP Admin sidebar.
* Fix - Fixed max images for Projects and Employees being 1 more than it should.
* Fix - Only the selected Project Keyword Categories sync.

= 3.3.0 =
* New - Support for using an alternative field for Project titles.
* Fix - Fixed autocomplete field values now populate the Employee sync filter
* Fix - Max images per Employee now works correctly when "Show on Website" is set to "yes"

= 3.2.0 =
* New - Support for choosing to sync Project Hero Images and Employee Primary Photos.
* Enhancement - Notification if you switch admin screen with unsaved settings.
* Enhancement - Limitless Project / Employee sync. (250 limit removed).
* Enhancement - Sync functionality optimised.
* Fix - Keywords with the same name in different categories now sync.

= 3.1.0 =
* New - Support for filtering Projects by Project Keyword.
* New - Support for syncing images that are closest to 3000x3000px.
* New - Support for syncing Project lat/long coordinates (Location Data).
* Enhancement - Consistent order of search and filter controls in different Media Library views.
* Enhancement - Notifications about missing "Show on Website" fields are now inline with sync options.
* Enhancement - Sync status bar now reports on number of records to sync at the point that numbers are received.

= 3.0.0 =
* New - In the Media Library, images can be filtered by Project/Employee and by Project and Employee name.
* Enhancement - Project and Employee posts can now be edited meaning SEO plugins can be used on them.
* Enhancement - In the General Settings, the visibility status can now be set for newly synced Project and Employee posts.
* Fix - Minor copy fixes on Settings pages.
* Fix - Minor style fixes to templates.

= 2.0.0 =
* New - Support for syncing custom file fields from OpenAsset.
* New - Support for filtering Project and Employee sync by custom field.
* Enhancement - Support for choosing to sync Roles.
* Enhancement - Support for choosing the number of Roles to sync.
* Enhancement - Post types for Projects and Employees are now registered so they can be added to the top menu in the wp-admin.
* Enhancement - Project, Employee and Role Data Options are now only shown if they are set to sync in the General Settings.
* Enhancement - Hyperlinked OpenAsset Instance URL on the General Settings.
* Enhancement - Various UI enhancements to the admin UI.
* Enhancement - Various code enhancements.
* Fix - On admin pages, red error messages no longer flash up then go away.
* Fix - Date sorting now working correctly
* Fix - Authentication step now cleans OpenAsset URL.
* Fix - List page formatting in template formatted correctly.
* Fix - Sync banner no longer appears when switching admin tabs.
* Fix - Note copy is a consistent size on the admin pages.

= 1.1.2 =
* Fix - Project keywords now syncing when changed in OpenAsset.
* Fix - Projects & Employees can now sync without any metadata selected.
* Fix - Projects & Employees can no be sorted by options other than name.

= 1.1.1 =
* Enhancement - Creation and deletion of oa-project and oa-employee custom post types are now linked to "Sync Projects" and "Sync Employees".
* Enhancement - Various code enhancements.
* Fix - Projects and Employees can be synced fully independently of each other.

= 1.1.0 =
* Enhancement - Images directly replaced in OpenAsset will now re-sync to Wordpress.
* Enhancement - "Save" and "Save & Sync" buttons moved to the top of the admin pages for easier use.
* Enhancement - Project and Employee name fields are now locked as these always must be synced so that you can identify them.
* Enhancement - The default max image options changed to Projects - 4, Employees - 0 (note the hero images / primary photos sync by default).
* Enhancement - The instance URL field is now not editable once installed.  (To connect to another instance of OpenAsset, you need to uninstall the plugin first).
* Enhancement - Templates now support OpenAsset Demo theme.
* Enhancement - Template project keyword navigation simplified.
* Enhancement - Various code enhancements.
* Fix - Custom post types created by the plugin are now called oa-project and oa-employee rather than project and employee.
* Fix - File Description field not selected on new install.
* Fix - Navigation to admin pages via the wp-admin sidebar goes to correct pages.
* Fix - Template the "Meet the Team" and "Keywords" headings will not show if there's no information beneath.
* Fix - Template Employee primary photo display when there are no projects associated.
* Fix - Template Employee primary photo do not display incorrect image when there isn't one.

= 1.0.5 =
* Fix - Minor edits to readme.txt

= 1.0.4 =
* Fix - Minor edits to readme.txt

= 1.0.3 =
*General Availability - June 3rd 2024*

* Enhancement - Various code enhancements

= 1.0.2 =
* Enhancement - Various code enhancements.
* Fix - Incorrect headshot display on template when no headshot is set.
* Fix - Issue of missing headshots when no projects are associated.
* Fix - Image "Show on Website" is off issue.


= 1.0.1 =
* New - Record sync counter during sync process.
* Enhancement - Various code enhancements.
* Fix - Missing Copyright Holder and Photographer syncing.


= 1.0.0 =
*Beta release - April 8th 2024*

== Upgrade Notice ==

= 6.1.3 =
As all websites are unique, we recommend upgrading and testing on a staging site before deploying to production. If you experience syncing issues after upgrading, run a full maintenance sync to ensure all your data is updated.

= 1.0.3 =
This is the first publicly available version, enjoy!

