8.4.0 - One way, not the other.
This patch release adds support for one way dictionary syncing, including and excluding content and media based on path, and improved performance on Umbraco 8.4+ installations and improvements to how Dependencies are calculated.
Get uSync
uSync is best installed via NuGet, as part of a calorie-controlled installation. you can also download it as a Umbraco package via the Umbraco BackOffice or the our.umbraco.com website.
uSync
Sync DataTypes, DocumentTypes, MediaTypes, Languages, Macros, Templates & MemberTypes
PM> install-package uSync
Content Edition
Add Content, Media, Domains, Dictionary Types and Content Templates
PM> install-package uSync.ContentEdition
more info at https://jumoo.co.uk/uSync
Release Notes
in this release, we've added three much requested features: One Way Dictionary Item syncing, include/exclude paths and create date syncing for content and media.
One Way Dictionary Syncing
Adding a new option to the Dictionary Handler will now cause it to only sync new items (existing dictionary items will be left alone).
<Handler Alias="dictionaryHandler" Enabled="true">
<Add Key="OneWay" Value="true" />
</Handler>
see https://jumoo.co.uk/usync/docs/v8/contentEdition/dictionaryHandler/ for more details
Include / Exclude based on path.
This was in uSync v4.x so we've ported it over. you can have include / exclude path values for content or media
<Handler Alias="contentHandler" Enabled="true">
<Add Key="Include" Value="/Homepage,/settings" />
<Add Key="Exclude" Value="/Homepage/Blog" />
<Add Key="RulesOnExport" Value="true" />
</Handler>
see https://jumoo.co.uk/usync/docs/v8/contentEdition/contentHandler/ for more details.
CreateDate
The CreateDate value for content and media is now included in the .config
files and synced when imported. this change is backwards compatible (as in it will be left if the value isn't in the config) - but you will see much improved syncing speeds if you perform a full export to get the value into all your config files.
Speed
As always we have been working on speed, in this version we've removed a double lookup workaround we had in place for Umbraco issue 2997 with content and media items. the underlying issue has been fixed in Umbraco 8.4.
So now if you are running Umbraco 8.4 or above we will do a single lookup - hitting the DB one less time, making it all a bit quicker.
Updates:
- 78a0513 Update to how Dependency Checks work
- 122e3ee New setting for Dictionary Items - allowing you to sync only new items.
- 9fa9597 serialize the CreateDate for content/media as part of the sync.
- 40010d9 Remove the double lookup on post-Umbraco 8.4 installations.
- 31a4ee0 Include/exclude path settings.
⚠️ Version bump
We have gone to v8.4 in this release as we have changed (added to) the .config file format for content and media, this means existing files will still sync but uSync will consider each file to have changed - the recommendation is to do a full content/media export to get the files up to the new format, as this will reduce false positives and increase the speed of all checks.