v10.2.1 - Compatibility release.

This is a patch release of uSync it contains a small fix for property tab/groups and an update for compatibility. It has all the same features as 10.2.0 release

Fixes

#417 - Logging missing when a sync fails because of tab/group aliases being incorrect in files.

Updates

10.2.1 adds compatibility check method to uSync (4f79d6d) that allows us to know if the current version of Umbraco supports language-based permissions this feature is used in uSync.Complete's PeopleEdition when syncing user groups.

Full Changelog: v10.2.0...v10.2.1

v10.2.0 - ⬆️ Upload ⬇️ download

This is a minor release of uSync containing fixes, and things features that are not breaking changes.

Fixes

• #413 - uSync 10 converting JSON Numbers and bools to strings on export
• Typos - mainly in comments ( cea0a5d, 98d3093, 286cade)
• Sims who are on fire will no longer be forced to attend graduation before they can put themselves out

Updated

• Upload / download buttons (#411) adds the ability to upload or download the uSync folder from the dashboard (for admins only)
• Add back a .targets to silently remove old uSync 9 app_plugins folder on build (related to #414)

Upload / Download

The new upload / download feature allows you to grab a zip file copy of your uSync folder from the dashboard.

under the everything group there will appear an "Export to file"

and "Import from File" options

When you import you are given the option to pick the file and do a "normal" or "clean import" - A clean import will wipe the current contents of the uSync folder before the zip file is unpacked into the folder.

This feature means you don't have to copy the uSync folder to disk , it is not as powerful or clever as the import/export in uSync exporter which will gather all the dependencies and can include other files (such as views and templates) but it does give you a quick way to get things onto a server.

Full Changelog: v10.1.0...v10.2.0

v10.1.0 - uSync Mode 🎛️ Release

This is a patch release of uSync for Umbraco 10 - it contains some fixes and features to support new features in Umbraco 10.1.0.

TL:DR There are no major issues, v10.1 is backwards compatible with Umbraco 10.0.

Sync Fixes

• V10/multi picker fix by @KevinJump in #401
• Fix - Null check on Member tracker can cause issues when reporting on Member syncs
• #406 Tab sort order is not enough to ensure tabs are always sorted

UI Fixes

• Update link to the docs in the settings.controller.js by @erikjanwestendorp in #403
• Sims can no longer WooHoo in the Elevator with a Sim who is on a different floor.
• Update the link to the format change list to v10 repo

Features

• Support for Umbraco 10.1 production mode, (read only files) in template syncing
• Json Serialization cleanup (#402)
• Enable FailOnWarning setting so we fail if properties can't be set. by @KevinJump in #395
• Disable dashboard option #409
• Update Import options so methods calling import can choose not to pause the export processes while doing so.

New Contributors

• @erikjanwestendorp made their first contribution in #403

---

Installing

dotnet add package uSync -v 10.1.0

---

Upgrading v9 to v10

Migrating from uSync v9 to uSync 10 shouldn't be to hard,

• none of the file formats for the uSync files have changes
• All the same features exist for uSync 10 as did for uSync 9

We have moved to using a Razor class library for the static files (so javascript, html) that is used in the backoffice for uSync and as such uSync will nolonger put any files in app_plugins/uSync -

After upgrading to uSync 10 you shoud either:
A. Remove all uSync files from app_plugins
or
B. run dotnet clean the the clean up will remove the files for you.

After upgrade uSync should still be there and everything will sync like just before.

Migrating v8 to v10

If you are migrating a site from v8 to v10 then there will be code changes etc you will need to make to your views and custom code, but if you want to import all of your settings and content uSync will do that for you.

uSync 8 will store data in /usync/v8 if you copy / rename this folder to /uSync/v9 then uSync 9 and 10 will import the settings and content into your new v9 or v10 site

#uSyncAllTheThings

Full Changelog: v10.0.0...v10.1.0

v10.0.0 - uSync 10 🎉- For the Umbraco v10

This is the uSync 10 release which is the major release to be in sync with Umbraco 10. It contains changes to the code base so that uSync carries on syncing all the things

Updates

• Change to the way scheduled content is serialized
• porting the uSync.BackOffice.StaticAssets library to a Razor Class Library Package so the files are not in App_Plugins anymore
• clean-up of obsoleted calls to Umbraco libraries

What's Changed

• Updated NuGet README with v10 by @leekelleher in #393

---

Installing

dotnet add package uSync -v 10.0.0

---

Upgrading v9 to v10

Migrating from uSync v9 to uSync 10 shouldn't be to hard,

• none of the file formats for the uSync files have changes
• All the same features exist for uSync 10 as did for uSync 9

We have moved to using a Razor class library for the static files (so javascript, html) that is used in the backoffice for uSync and as such uSync will nolonger put any files in app_plugins/uSync -

After upgrading to uSync 10 you shoud either:
A. Remove all uSync files from app_plugins
or
B. run dotnet clean the the clean up will remove the files for you.

After upgrade uSync should still be there and everything will sync like just before.

Migrating v8 to v10

If you are migrating a site from v8 to v10 then there will be code changes etc you will need to make to your views and custom code, but if you want to import all of your settings and content uSync will do that for you.

uSync 8 will store data in /usync/v8 if you copy / rename this folder to /uSync/v9 then uSync 9 and 10 will import the settings and content into your new v9 or v10 site

#uSyncAllTheThings

Full Changelog: v9.4.0...v10.0.0

v9.4.0 - First boot 🥇🥾

This is a major minor release of uSync it contains some new functionality for first time setup of a site with uSync a.k.a FirstBoot 🥇🥾.

What's New

• FirstBoot 🥇🥾 - #382
• Selectable Sets - #384

Firstboot

(see docs https://docs.jumoo.co.uk/usync/uSync/key_topics/firstboot )
First boot allows you to configure your Umbraco site / repo so when someone checks it out or deploys it it will automagically sync all new settings/content as a one time thing.

Also a nice new 'NoNodes' screen.

Selectable Sets.

(see docs https://docs.jumoo.co.uk/usync/uSync/key_topics/sets)
Adds the ability to add your own handler sets - which you can then pick in a drop down.

(drop down will only appear when there are multiple 'selectable' sets).

Fixes

#388 Fix typo @calvindavis

Full Changelog: v9.3.1...v9.4.0

v9.3.1 - tweak patch fix patch

I suppose it was inevitable that when i raised the issue causing Umbraco to release 9.4.1 the next uSync release would also require a minor patch release 🤦

Fortunately this release isn't to fix anything "major" - there where a couple of really small bugs we noticed when prepping the accompanying uSync.Complete release, and one UI bug which is only a bit of a pain if you have set the UIEnabledGroups setting to a single group

Unless you are experiencing these specific issues below we don't think you need to update to this release

(two of the issues are uSync.Complete UI and the next uSync.Complete release will reference this version of uSync to address those)

All the things we said about Release 9.3.0 are still true - its faster and has a nice UI tweaks.

Fixes

• #379 the dashboard is blank if UIEnabledGroups contains only one group
• #380 Partial Import should import based on level and sort order just like the default import methods
• #381 Media import report no change even when they make the changes

v9.3.0 - Single Pass

This is a patch release of uSync, it contains some performance and UI updates and checks that we don't create files with names that may clash well known aspnet core file names.

What's Changed

• FIx: better null checking in PostCleanFiles by @KevinJump in #358
• Small amend to the "view appsettings" dialog. by @AndyBoot in #365
• V9/line endings by @KevinJump in #359
• Single pass - media/content by @KevinJump in #362
• V9/safe file names by @KevinJump in #370
• Add ability to read clean files for the root element -1 (so we can cl… by @KevinJump in #371
• Fix #372 - also return true when we find the parent but don't set it. by @KevinJump in #373
• Fix #361 - Support Importing templates when the actual view is compiled by @KevinJump in #375
• Fix #374 - JSON in UI box is wrong for sets by @KevinJump in #375
• #377 Performance improvements on Content Type saving and Content Sorting.
• #378 UI Tweaks and updates to buttons, progress bars and motivational messaging.

New Contributors

• @AndyBoot made their first contribution in #365

Full Changelog: v9.2.0...v9.2.1
Release Milestone: https://github.com/KevinJump/uSync/milestone/11

v9.2.0 - Performance

This is a minor release of uSync 9 for Umbraco 9 that addresses some speed issues with saving on large sites, and adds support for syncing the CleanupHistroy settings on ContentTypes introduced in Umbraco 9.1.

Highlights

Speed improvements on large sites.

For v9.2 and v8.11 - We received some reports of uSync impacting save/move/delete options on very large sites (1000's pages). (HT @prjseal)

Based on this feedback we have optimised how uSync checks for clashes and duplicates and reduced the amount of disk activity around these processes. If you have a site with a lot of content on slow disks (e.g. azure) you should notice a significant improvement in save/delete and move times with these releases.

One of the choices we made early on with uSync was to have the uSync folder largely readable, (so you could actually see what is going on). However this does lead to some issues, for example whenever you rename or move an item, we have to check to make sure there isn't a uSync file somewhere on disk that could be the same item. this CleanUp code is quite disk intensive, and when you have a lot of content a lot of files are read to check for these clashes.

however the reality is for the default configuration we don't need to do all of the checks - as a result we have optimized just when and where the clean-up code called to reduce the load on most setups.

n,b for extra large sites recommend using "Flat File structure and Guid File names" this completely eliminated these checks making it even faster.

For more information we have written a documentation page for performance tuning uSync on larger sites.

History Clean-up support

Introduced in Umbraco 9.1 / 8.18.0 - History clean up lets you control how many versions of content are kept and for how long. This is achieved via additional settings on the ContentType. uSync v9.2/v8.11.0 now support serializing this as part of the sync process.

Fixes

• #347 Improve performance on save/move/delete for large sites
• #348 Renaming and then deleting a content type produces a rouge clash when reporting changes
• #351 when Published items moved to the trash uSync will attempt (and fail) to publish them when syncing on target site
• #349 After a content item is renamed the Friendly path stored in the config file still uses old name
• #350 Moving a content type from a folder to the root is not reflected in sync
• #343 uSync import will fail if you swap the alias of two doctypes

Update

• #346 Support HistoryCleanup properties on ContentTypes
• #342 Improve the readability of the details panel
• #341 Include path in sync action for better UX.

This is a major minor release of uSync that moves the code base to multi-targeting dotnet 5 and 6 . we have made this change to smooth the way to supporting both Umbraco 9 (.net 5) and Umbraco 10 (.net 6) within the same package.

(Milestone : https://github.com/KevinJump/uSync/milestone/8?closed=1)

Features

• #338 - Multi-target package (Umbraco 10 prep)
• Migrate soon to be obsolete AddUnique to AddSingleton (Umbraco 9.3 prep)

Fixes

• Remove history settings
• Consistent line endings in config files, (fixes false positives if you compare uSync files generated on windows and Linux)
• #337 Ensure we parsing of path variable works in all cultures
• #335 Ensure items with same name but different location in tree don't overwrite uSync files.

---

Get uSync

usync 9 is distributed as a nuget package and can be added to your site in a couple of ways.

via dotnet add

via a command line you can add uSync

dotnet add package uSync  --version 9.2.0

as a package reference

You can add the dependency directly to your projects .csproj file.

<ItemGroup>
  <PackageReference Include="uSync" Version="9.2.0" />
</ItemGroup>

via Visual Studio package manager console

If you are old school . install-package still works

install-package uSync -version 9.2.0.

v8.11.1 - MultiURL Pickers in nested / block content

This is a minor patch to Umbraco 8.11.x branch that addresses an issue that can occur with MultiUrl picker values when stored in nested or block content.

Issues

• #400 Issues with MultiUrl Pickers and Blocks

More

The issue occurs if you have single-pick multi-url pickers inside block or nested content and no values are selected, uSync prior to this version would serialize the value out as an empty string "". Within the back office the blocks and content would still render, on the front end your would get a null reference exception if your code attempted to access the values inside the mult-url picker properties.

N.B this null reference error is fixed in Umbraco 8.18 and above.

This patch would only be required if running less than Umbraco 8.18

v8.11 - The final v8 frontier 🚀 ?

This is a patch release of uSync with some fixes for known issues - it also contains some performance improvements for content save/delete events on large sites.

It has also tested against the release candidate for Umbraco v8.18.

🤞 this will be the Umbraco v8.18 supported "major.minor" (e.g. 8.11.x is the long term support branch)

Fixes

• #336 - Content item path length to long even if item is excluded via config.
• #348 - Renaming then deleting a content item, will result in a 'clash' warning when re-importing
• #349 - After renaming content the path value in the uSync file contains the old name
• #350 - Moving a content type from a folder to the root isn't reflected after a sync
• #351 - uSync will attempt to publish, published items that have been moved to trash

Updates

• #347 Performance improvements in uSync file clean up for large sites.
• #346 Support for History Clean-up in Umbraco v8.18.0
• Enhancing #323. This fix fixed more than one issue with the DocTypeGridEditor, so has been updated to reflect this, and also clean up legacy DTGE json on import, to aid with syncing from old uSync versions to new.
• branding! " ♾️ uSync all the things" banner on dashboard background

---

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 -version 8.11

Content Edition

Add Content, Media, Domains, Dictionary Items and Content Templates

PM> install-package uSync.ContentEdition -version 8.11

Upgrade

When upgrading the best thing to do is not overwrite your uSync8.config file - new config settings will always defaults to something doesn't alter existing behaviors - so not having values in the config will no break anything.

During a nuget upgrade you should choose not to overwrite the usync8.config file. If you haven't altered any other files from the uSync packages you can also instruct nuget to do this on the update line

PM> update-package uSync.ContentEdition -FileConflictAction Ignore