Table of Contents

Changes Overview for 2sxc/EAV

This page collects all the changes of all versions into one place, making it easier to search for certain keywords.

👉 if you only care about breaking, please check Breaking Changes Overview for 2sxc/EAV

Version 18

Changes in 2sxc 18.00 (2024-07-12)

  1. ✅ ITemplateService with MergeSources(...)
  2. ✅ Oqtane 5.1 or 5.2 SSR Release

There's a lot more! I don't have time to describe it yet, but here's the short list

https://github.com/2sic/2sxc/releases/tag/v18.00.00

...and more.

Changes in 2sxc 18.01 (2024-09-23)

  1. 🔢 Pickers
    1. ✅ Improve Picker-UIs
    2. ✅ Picker with Radio-Buttons (for patrons 🦹🏾‍♂️)
    3. ✅ Picker with Checkboxes (for patrons 🦹🏾‍♂️)
    4. ✅ Pickers with tooltips, more help, etc. (for patrons 🦹🏾‍♂️)
  2. 🧪 Formulas
    1. ✅🔁 Major refactor of internal code structure
    2. ✅👨🏾‍💻 Improve visibility of formulas in the UI for dev-users (always show for developes 👨🏾‍💻)
  3. 🔁 Refactoring / internal
    1. ✅🔁 Edit-UI Drop NgRx
    2. ✅🔁 Edit-UI Switch most code to Signals
    3. ✅🔁 Edit-UI feature to store user settings in the local storage and session
    4. ✅👨🏾‍💻 Create debugging system to log changes in production (developers 👨🏾‍💻)
  4. Internal content types
    1. ✅ Use newer picker features for Wysiwyg and other UIs
    2. ✅ String-Default (basic field) enable different Text-Wrappings
  5. ☢️ DNN Enhancements
    1. ✅☢️ Improve startup speed
  6. 🩸 Oqtane Enhancements
    1. ✅🩸 Improve DLL clean-up on startup
    2. ✅🩸 Fix compile of AppCode DLLs in inner-content
    3. ✅🩸 Interactive Server bugs closing signalr connections
  7. 🦹🏾‍♂️ Patron Features
    1. ✅⚡ Optimize data loading for better performance
    2. ✅🔢 Many new picker features for patrons

Version 17

Changes in 2sxc 17.00 (2023-12-23)

  1. ✅ DNN: Require CodeDome C# 7.3 to be installed
  2. ✅ Docs infrastructure can now be multi-versioned
  3. ✅ Show app icon in admin UI
  4. ✅ Ctrl+Click on toolbar buttons to open in new tab
  5. ✅ Completely refactor internal APIs to do advanced work and save data
  6. ✅ Change UI to use Angular 17 (from Angular 14)
  7. ✅ Get intellisense to work in VS Code
    1. ✅ Work out best way to do this in VS Code
    2. ✅ Work out best way to hide non-public APIs
    3. ✅ Work out best way to include docs (xml files, nuget, etc.)
  8. ✅ Support C# 7.3 in DNN with warning if not installed
  9. ✅ System Capabilities Framework for tagging apps which need certain technologies/features
  10. ✅ Crazy new compiled typed shared code /ThisApp/Code - see Hot App Code
  11. ✅ New APIs on Typed Code
    1. IsPublished
    2. Publishing
    • Publishing.HasPublished, Publishing.HasUnpublished, Publishing.HasBoth
    • Publishing.GetPublished(), Publishing.GetUnpublished(), Publishing.GetOpposite()

Changes in 2sxc 17.01 (2024-01-18)

  1. Moved almost all internal APIs in the ToSic.Sxc namespace to hidden locations #3189
  2. Marked a lot of internal APIs so that they won't appear in IntelliSense
  3. ♨️ HotBuild: Improved errors in Razor so the user can better find them #3246
  4. ♨️ HotBuild: Improved errors when compiling ThisApp #3247
  5. ♨️ HotBuild: Support Editions such as live and staging with auto-fallback #3248
  6. ♨️ Roslyn: Improve error if @inherits ends in semicolon #3245
  7. ♨️ HotBuild: Show all compiled types in insights
  8. ♨️ HotBuild: Minimize exact pre-included namespaces
  9. ♨️ HotBuild: Performance Improvements
  10. 🟣 Toolbars: Show hover on layout button after a delay with module-infos #3251

New Features / Important Improvements

  1. Kit.PageParameters now has new commands Toggle(...), Remove(...) and Filter(...) see docs #3241 #3242 #3243
  2. 🟣 Toolbars: Tweak Notes can now delay and linger #3250 docs
  3. Create-New File now shows templates for RazorTyped, CodeTyped and ApiTyped
  4. ✏️ App-Management UI now uses a left-menu (experimental)
  5. ✏️ Edit-UI: Boolean fields can now be toggled by clicking on the label
  6. 🖼️ Resizer: Improve handling of images in virtual-application folders

Bugfixes

  1. ITypedItem.Equals now works #3213
  2. Old Render APIs were broken, which affected News App 4.1.1 and others #3252
  3. Fix bug with UniqueKey which affected HotSpots App
  4. Various minor UI bugfixes related to the entity-picker and dropdowns

v17.01.04

Minor enhancements and bugfixes

  1. Image toolbar now shows resize specs 🌟 #3270
  2. Toolbar notes now support a format = html #3271
  3. Edit inner-content in accordions for non-website-admins #3234
  4. Old Razor base class - PageData didn't always work #3260
  5. HotBuild now respects additional assemblies from web.config #3272

v17.01.05

minor bugfixes l enhancements including

  1. dropdown pills fixed #3269
  2. REST Query API fails when used from "outside" #3274
  3. page picker in UI is broken in 17.01.04 #3276
  4. auto-serialized ITypedItem and IEnumerable<ITypedItem> #3277
  5. refactor an internal old API to init app-objects #3275
  6. HotBuild Performance Improvements (locking / caching)
  7. HotBuild improve detection when CS files inherit from ThisApp base 1. classes
  8. Internal Lookup System Performance Improvements
  9. internal work for the new Picker-UI system

v17.01.06

  1. Upgrade System.Data.SqlClient #3209
  2. TweakButton on dynamic code #3279
  3. Edit menu in Dnn fix #3280
  4. Bug with dropdowns #3281
  5. Export/Import App now includes hidden entities #3282
  6. Export/Import App now includes Attribute SysSettings #3283

v17.01.07

  1. ajax reload on details-pages eg. blog-post #3287
  2. SQL DataSource can't connect #sql #3285

Changes in 2sxc 17.02 (2024-02-22)

  1. ✅ Improve infos about layout in toolbar
  2. ✅ Improve infos about image resizer in toolbar
  3. ✅ Improve Create New App Experience
    1. ✅ Create new app template
    2. ✅ Improve the new app wizard - allow selecting template
    3. ✅ Improve create-app code to use the new template
  4. ✅ Update Monaco to latest version
  5. ✅ Ability to change input config types/metadata - eg. skip @String when never needed
  6. ✅ Improve HotBuild
    1. ✅ Improve initial list of included assemblies and namespaces @STV
    2. ✅ Improve caching of information how to build/compile to improve speed
    3. ✅ Add support for sub-folders
    4. ✅ Support Editions
    5. ✅ Improve error messages on building the ThisCode folder
    6. ✅ Improve error messages when building Razor and C# using Roslyn
    7. ✅ Improve detection so that build is locking (prevent multiple builds on high-load)
    8. ✅ Create system to generate models
    9. ✅ Provide special UI to build the code and debug Copilot
    10. ✅ Switch to AppCode ThisApp
    11. ✅ Provide final place for base type
      1. ✅ Custom.Data.CustomItem base class
      2. ✅ GPS data
  7. ✅ fix/improve date picker
  8. ✅ Ability to share field configurations
    1. ✅ Custom config inherit from multiple sources for keeping the Label
    2. ✅ Preserve config on export/import

https://github.com/2sic/2sxc/releases/tag/v17.02.00

Changes in 2sxc 17.03 (2024-03-04)

  1. ✅ New Pickers released with a lot of features, incl. Sources, custom labels, help, tooltips, multi-select and much more!
  2. ✅ Ability to install recommended apps in a later step!
  3. ✅ New typed razor RazorTyped<TModel>
  4. ✅ New typed App using IAppTyped<TSettings, TResources>
  5. ✅ Publish As<Type> and AsList<Type> API
  6. ✅ Publish App.Data.GetAll<TModel>() and App.Data.GetOne<TModel>(id) APIs
  7. ✅ New Custom.Data.CustomItem base class with GPS data, As<Type> and AsList<Type> API
  8. ✅ improve App_Data/app.json schema to include editions for Copilot
  9. ✅ Add template app Basic and Empty
  10. ✅ Intellisense: Find way to link to the official docs from inside the help

Changes in 2sxc 17.04 (2024-03-11)

Improvements

  1. MyView.Resources added to complement existing MyView.Settings #3315
  2. ITypedItem.Img(...) added to complement exitsing ITypedItem.Picture(...) #3324
  3. Dnn improve Roslyn build performance in many cases from ca. 2.5 seconds to 0.5 seconds #3322
  4. Query: Improve $select OData parameter
  5. REST API - add $select OData Parameter #3319
  6. Razor / Typed Code: add a Customize helper ojbect #3316
  7. Admin UI - Data Scopes now show count
  8. Add Razor compile code help for more common problem such as accessing typed-items dynamically
  9. Improve razor compile help - show errors before warnings
  10. Picker - auto extract additional fields to retrieve based on placeholders in Label / Help texts etc.

Generate Data Models Improvements

  1. Include Scope name
  2. Include content-types in Configuration scope
  3. CustomItem - implement == and != operators to use wrapper equality
  4. Lots of docs for custom data
  5. app.json editions configuration, add isDefault

Bugfixes

  1. UI Date Picker - fix but with UTC offset #3321
  2. UI Page Picker - fix, was broken in 17.03.00 #3320
  3. Calling Query using JS missed the Id property #3325
  4. Admin: state of the DateTime Show-Time toggle didn't properly get persisted #3318

Changes in 2sxc 17.05 (2024-03-25)

We believe this is stable, but ask the community to do in-depth testing so we can release an LTS

Highlights

  1. Improved Code-Generator to be in a standalone DLL ToSic.Sxc.Code.Generate
  2. Improved Code-Generator to generate Razor, Code and WebApi base classes

Enhancements

  1. Impove image-resize tooltip #3329
  2. $2sxc JS used in modules which are rendered into Dnn themes #3333
  3. Improve logging of parameters of DataSources (eg. Value-Filter DS)
  4. Prepare for Oqtane 5 SSR
  5. Improve architecture for generating App-objects in the background

Bugs fixed

  1. various admin and replace-operations on inner-content #3299
  2. fix quickE when selecting content-blocks #3317
  3. Token templates - fix some toolbars #3328
  4. Fix issue with Oqtane urls
  5. Fix issue with Oqtane WebApis which affected Blog RSS feed

Changes in 2sxc 17.06 LTS (2024-03-28)

The first LTS (Long-Term-Stable) Release of 2sxc 17.

Easter LTS Release

  1. ✅ Prepare for Oqtane SSR (Server-Side Rendering)
  2. ✅ Provide Code Generator for Content Types, Razor and Services
  3. ✅ Improve discoverability of REST APIs
  4. ✅ Document new Pro Typed mode
  5. ✅ Document new strong-typed mode
  6. ✅ Auto-Install more apps from catalog - even after some have already been installed - ca. 1d
    1. ✅ Feature to tell new auto-installer what apps are already installed
    2. ✅ App-Auto-Installer UI to add-install apps later on
  7. ✅ LTS

Bugfixes

  • When accessing an App through another app (eg first going to Apps-Management) it show the data of the original app
  • Opening features in Apps-Management didn't work reliably
  • Edit-UI Picker / Dropdown code was cleaned up
  • Copilot Razor Generator ready to use
  • Copilot Service generator ready to use
  • Copilot WebApi generator ready to use
  • Copilot previously failed if the AppCode folder was missing
  • Fix to a data-caching issue in 17.05 (this was important)

Changes in 2sxc 17.07 (2024-05-04)

published/blogged:

  1. ✅/✅ 2sxc 17.07
  2. ✅/✅ 2shine 5.3 (May 4th)
  3. ✅/✅ Content App 17.07 (May 6th)
  4. ✅/✅ Mobius Form Builder 06.00 for 2sxc 17.07 (May 7th)
  5. ✅/✅ Release all apps as typed (May 8th)

Changes in 2sxc 17.08 (2024-05-16)

  1. ✅ WebApi in AppCode
  2. ✅ DataSources in AppCode
  3. ✅ ITemplateService
  4. ✅ Add CmsContext.Block and CmsContext.Module.Block as well as Block.Guid
  5. ✅ Cache Service internal
  6. ✅ Switch Edition UI
  7. ✅ Switch Edition Permissions for non-super users
  8. ✅ Update Image Resizer
  9. ✅ Re-Release another LTS ca. 17.09

Version 16

Changes in 2sxc 16.00 LTS (2023-05-04)

No relevant changes, just minor bugfixes + our convention to upgrade the main version every 6 months. We mainly finished the docs for various features, so this is what is now done.

  1. ✅ improve IConfiguration API - lighten the IDataService API
  2. ✅ Document new data sources API
  3. ✅ finish Dynamic DataSources
  4. ✅ Document CDN / Asset management
  5. ✅ Document Formula improvements
  6. ✅ IDataService completed
  7. ✅...and documented
  8. ✅ New WYSIWYG mode completed (and documented)
  9. ✅ Toolbars Service Improvements: transport data for use in notes etc. ca. 0.5d 2dm
  10. ✅ Data-conversion of entities to json in attribute... - documented

Changes in 2sxc 16.01 LTS (2023-05-23)

Various bugfixes + some enhancements.

  1. ✅ New rich WYSIWYG experience
  2. ✅ Edit-UI can now be opened to only show a few specified fields (feature API not yet public, but used in the new WYSIWYG feature) #3080
  3. ✅ New ITypedItem and AsTyped(...) API
  4. ✅ New Data.Content and Data.Header objects
  5. ✅ IDynamicEntity now has methods like String(...), Int(...), Bool(...), Date(...), Decimal(...), Double(...), Long(...), DateTime(...), Float(...) to convert values to the desired type. #3089
  6. ✅ Sort-Items UI was enhanced with remove, add, add-existing #3077
  7. ✅ DynamicDataSource now supports relationships #3078
  8. ✅ DynamicDataSource now shows better errors in Razor on compile issues #3084
  9. ✅ Razor now automatically suggests the insights button on the toolbar if there are errors #3085
  10. ✅ Enhancement: Serializing Entities to JSON now skips empty fields such as messages or ephemeral fields
  11. ✅ Clean up Formulas code into better SoC @SDV
  12. ✅ Clean up ancient documentation which is probably invalid, but still seen by many :(

Dnn / Evoq

  1. ✅ Evoq: Better support for list management together with page workflow #3087
  2. ✅ Dnn Skin: Adding module to skin using IRenderService now allows editing entities #3092

Oqtane

  1. ✅ Enabled full WASM support for Oqtane #3083 (previously only server-rendering worked)
  2. 🪲 Improvement on how AJAX reloads work, resolves some reload-errors #3081

Minor Bugfixes

  1. 🪲 Two bugfixes related to Formulas v1 - returning date #3088
  2. 🪲 XML-Data-Export now works with IsContentAdmin permissions (before it required IsSiteAdmin) #3075
  3. 🪲 View list of data now works with IsContentAdmin permissions (before it required IsSiteAdmin)
  4. 🪲 Fixed issue with GetService<ILogService>() because ILogService had been renamed to ISystemLogService #3082

Changes in 2sxc 16.02 (2023-07-07)

Major Enhancements

  1. ✅ ImageFlow upgraded to version 0.10.0 - thereby making sure it works with FIPS enabled #3121
  2. ✅ Brand new typed code Pro mode
    • ITypedItem and ITyped interfaces with properties such as Id, Guid and methods such as .String(name), ...
    • RazorPro, ApiPro, CodePro base classes with completely reworked API such as AsStack(...), MyPage or AllSettings
    • ApiPro now serializes JSON using new defaults which are more common in WebApis (lower-case properties, auto-serialize entities, etc.)

Documentation

  1. ✅ Upgraded DocFX from 2.48.1 to 2.67.3 with major improvements to the generated docs
  2. ✅ Improved Documentation of all Razor and WebApi base classes!

Support for Developers

  1. ✅ Dramatically improved insights with more details and filtering options
  2. ✅ Created system to automatically detect and warn about deprecated code - using buttons in the toolbar
  3. ✅ Created CodeHelp system to guide developers when common coding mistakes were made
  4. ✅ New Obsolete system collects issues per App and shows them even if the current Razor is not affected
  5. ✅ Show CodeHelp warnings if a RazorPage doesn't have @inherits

Various bugfixes + some enhancements.

  1. ✅ Refactored Razor and WebApi base classes to use Composition over Inheritance
  2. ✅ RazorBlade upgrade from v4.2.0 to 4.4.0 (also for .net 7 compatibility)
  3. ✅ Feature to not show edit-toolbar buttons on HTML coming from Resources
  4. ✅ Improve not showing a metadata-toolbar on images which are coming from demo-items

Dnn / Evoq

  1. ✅ Downgrade SQL to still work with SQL Server 2012 as people had trouble upgrading #3120
  2. ✅ Since ImageFlow was upgraded, the following DLLs were also upgraded
    • Imageflow, 0.7.24 -> 0.10.0
    • Imageflow.Net, 0.7.24 -> 0.10.0
    • Imazen.Common, 0.7.7 -> 0.8.1
    • Imazen.HybridCache, 0.7.7 -> 0.8.1
    • Newtonsoft.Json, Version=10.0.0.0 -> 13.0.0.0
  3. ✅ As part of the upgrade we also had to upgrade some MS DLLs
    • Microsoft.Bcl.AsyncInterfaces, Version=6.0.0.0 -> 7.0.0.0
    • System.Collections.Immutable, Version=6.0.0.0 -> 7.0.0.0
    • System.Text.Encodings.Web, Version=6.0.0.0 -> 7.0.0.0
    • System.Text.Json, Version=6.0.0.0 -> 7.0.0.2
    • System.Memory, Version=4.0.1.1 -> 4.0.1.2

Oqtane

  1. ✅ Oqtane 4.0 Support (with .net 7) #3123
  2. ✅ Reworked API Middleware to avoid conflicts with OAuth 2

Minor Bugfixes

  1. 🪲 Fixed issue with Swiper not being able to add slides #3108 #3112
  2. 🪲 Fixed issue with DatePicker in Edge and also added more cultures #3113
  3. ✅ Changed internal APIs to return RazorBlade IHtmlTag objects instead of previously IHybridHtmlString #3098

Changes in 2sxc 16.03 (2023-08-21)

Enhancements around Typed Code

  1. ✅ Typed: rename RazorPro to RazorTyped etc. #3147
  2. ✅ Make all typed objects very strict when checking if fields exist
  3. ✅ Add much more helpful info / error when fields not found
  4. ✅ Typed: Massively enhanced with strict checks and reduced the possibility of writing code which doesn't do anything
  5. ✅ Typed: ITypedItem now has a new .Picture(...) method making the code nicer #3135
  6. ✅ Typed: ITypedItems can now be mocked #3141 to create alternate data in code when no data exists
  7. ✅ Typed: New methods ContainsKey(...), Keys(...) #3142
  8. ✅ Typed: New methods IsEmpty(...) and IsNotEmpty(...) #3144
  9. ✅ Typed: method .String(..., scrubHtml) now also accepts a string containing tags to remove #3146
  10. ✅ Typed: If an error occurs, much more information is provided as to how to fix #3143 #3145
  11. ✅ Typed Json: now also supports paths, so you can use Kit.Json.ToTyped(jsonString).Int("Root.Child.Id")
  12. ✅ Typed Json: now also strict using propsRequired by default
  13. ✅ Typed: the property .Dyn now only exists on ITypedItem (entity-based) and not on other wrappers

Other Enhancements

  1. ✅ Image Resizer: New Square resize settings #3134
  2. ✅ Image Resizer: ImageService can now also handle IFile objects and get the metadata automatically #3140
  3. ✅ Web Farm Cache: Updated for v16.02+ (enterprise customers only)
  4. ✅ Page Parameters: now support ITyped so you can use MyPage.Parameters.Int("id") and similar

Support for Developers

  1. ✅ Errors now highlight the .cshtml line which caused the error
  2. ✅ Errors on mistyped property names now gives very detailed information about it

DNN / Evoq

  1. ✅ Image Resizer: Upgrade to dnn-imageflow 1.2.1 #3130
  2. ✅ Newtonsoft internal version in DNN Manifest now matches 13.0.3

Oqtane

  1. ✅ Oqtane: Better error when Oqtane in installed without sufficient DB permissions #3128 / #3131
  2. ✅ Internal: Code cleanup with warnings new EF-Core #3132
  3. ✅ Internal: EF Core QuerySplittingBehavior #3133

Minor Bugfixes

  1. 🪲 turnOn failed on AJAX reloads during editing #3127
  2. 🪲 Oqtane: Bugfix importing App Assets #3129
  3. 🪲 Web Farm Cache: Fix issue which occured on license uploads
  4. 🪲 Licenses: fix issue with multiple licenses / names resulting in an unlicensed message

Changes in 2sxc 16.04 (2023-09-05)

Highlight: UniqueKey

  • ✅ Razor: New UniqueKey property (in Typed mode) #3151
  • ✅ Razor: New Kit.Keys.UniqueKeyWith(...) for unique IDs and working with JS #3152

Images

  • ✅ Images: Images in rich wysiwyg mode now are shown nicely after import into other site
  • ✅ Images: Dialog-Options to set empty title and not use fallback #3150
  • ✅ Images: Enable crop/title dialog for public files, with delayed toolbar and warning-hint #3057
  • ✅ Images: Fix Safari bug with small images #2
  • ✅ Images: Ability to specify alternate toolbar #3157
  • ✅ Images: Ability to specify no toolbar #3158
  • ✅ Images: Ability to use Toolbar outside of main picture/img tag using img.Toolbar() #3156
  • ✅ Images: Metadata now also has a DescriptionExtended

Razor in Typed Mode

  • ✅ MyModel: Improve handling fallback / required #3149
  • ✅ App.Folder.Url to replace App.Path for clearer APIs
  • ✅ App.GetQuery(...) to replace App.Query[name]
  • ✅ All ITyped objects now behave strict by default
  • ✅ Complete various scenarios for ITyped with unit tests, especially conversion of anonymous and json-based ITyped
  • ✅ All ITyped now have APIs for ContainsKey, IsEmpty and IsNotEmpty
  • ✅ Razor: Errors now highlight the .cshtml file with a 🎯 emoji
  • GetDraft / GetPublished (decided not to implement yet)
  • ✅ Override Equality operations - using ITyped.Equals

Oqtane

  • 🩸 Improve indexing in Google #3154
  • 🩸 Improve pre-render adding JS/CSS
  • 🩸 Improve page header changes (title, metadata) using latest Oqtane 4 APIs

Patrons

  • 🦸🏽 New feature to better control language fallback sequence (beta) #3159
  • 🦸🏽 Improve showing expired features - important when testing a feature for 24h

Bugfixes

  • 🪲 Languages: Bug in UI: Some labels and dropdown-labels didn't show in current language #3153
  • 🪲 lots of minor bugfixes

Changes in 2sxc 16.06 (2023-09-20)

  1. ✅ Tutorials for new Pro mode / Quick-Ref
  2. ✅ Optimize build of 2sxc to use local config-files so it's easier for others to contribute @STV
  3. ✅ Improve JS build to make it easier for others to contribute
  4. ✅ Improve headers handling in Oqtane 4

Changes in 2sxc 16.07 LTS (2023-09-22)

  1. ✅ new TypeItem.Parent(...) - especially. .Parent(current: true) api #3173
  2. ✅ new parameters to the .Picture(...) incl. picClass, imgAttributes and picAttributes
  3. ✅ fix bug where presentation data was generated even if not used #3185

Major: Release 16.07 LTS 🚀

Changes in 2sxc 16.09 (2023-11-22)

  1. ✅ TypedItem.Picture("Child.Property") path notation
  2. ✅ fix js minification of inpage.min.js
  3. ✅ Release all apps in the new typed mode
  4. ✅ Blazor .net 8 / Oqtane 5 support
  5. ✅ Improve file-upload to prevent files with ".." in the name
  6. ✅ Improve DataSource Caching and cache-flushing
  7. ✅ Add new (beta ⌛) feature for copyright management (Patron AdvancedCMS) to add copyright info to each image
  8. ✅ Extend SQL Database to store SysSettings and Guid on Attributes for future features
  9. 🐞 Fix minor issue with old .Code for older Razor base classes
  10. 🐞 Fix minor issue with edit-dialog in scenarios with multiple portal aliases
  11. 🐞 Fix minor issue with IMetadata.Children(...) / ...Child(...) #3217
  12. 🐞 Fix DataSource LanguageModeler #3219
  13. 🐞 Fix DataSource TreeMapper
  14. 🩸 Oqtane: Adam backend didn't always serialize all properties #3206

Version 15

Changes in 2sxc 15.00 (2022-12-23)

  1. ✅ Improve logging
    1. ✅ Place it in an own library DLL for better reuse
    2. ✅ Create ICodeLog for improve logging in Razor and WebApi which ensures compatibility with existing code
    3. ✅ Improve automatic connecting logs with helpers so most Init(Log) become obsolete
  2. ✅ Update CsvHelper DLL to latest version
  3. ✅ Improve install-file names
  4. ✅ Update to Razor Blade 4
  5. ✅ Support Oqtane v4 with .net 7 - ATM Oqtane doesn't plan on going to .net 7
  6. ✅ Tutorial App
    1. ✅ Improve internal structure
    2. ✅ Change how to show code vs results - mostly use tabs
  7. ✅ Razor APIs and Services
    1. ✅ Improve ImageService to have an imgAltFallback on .Img(), .Picture() and .ImgOrPic()
    2. ✅ Improve ImageService to better respect multi-language crop-settings and labels
    3. ✅ Improve Page service Parameters.Set(...) to also allow bool, int etc. (not just strings)
    4. ✅ Create Kit.HtmlTag
    5. ✅ Create ITurnOnService and Kit.Page.TurnOn(...)
  8. ✅ Data Sources
    1. ✅ Improve ValuFilter Data Source to also allow Contains on numbers
  9. ✅ DB Clean-Up
    1. ✅ Remove SQL triggers which log XML data to DataTimeline which isn't used any more
    2. ✅ Remove XML column NewData in DataTimeline which isn't used any more
  10. ✅ Internal APIs
    1. ✅ Improve Settings/Resources Stack with various unit tests
    2. ✅ Improve Settings/Resources Stack to have internal quick access to deep objects using a path like "Images.Content.Width"
    3. ✅ Create API DependenciesBase to better handle log attachments to dependencies
  11. ✅ TinyMCE upgrade to v6
  12. ✅ Drop _ prefix requirement on cshtml files by protecting them in an another manner
    1. ✅ It's not needed on Oqtane, as the files are not accessible
    2. ✅ Only needed ATM on DNN because each file could be called from the browser directly
    3. ✅ Probably make sure all base classes refuse to render standalone
  13. ✅ Ability to use compressed GZIP data for DataTimeline (patrons)
    1. ✅ Technical features
    2. ✅ Toggle to turn on/off
  14. ✅ Rename internal .data folder to App_Data/system and similar as this folder will contain private data in future
  15. ✅ Feature to deploy a corporate license in an installation to auto-enable certain features on all sites
  16. ✅ Settings: Ability to augment the preset configuration / settings with custom overrides
  17. ✅ Provide Google Services API Keys (Maps, Translate) from backend to edit UI
  18. ✅ Ability to set own default GPS coordinates for when not set
    1. ✅ Ability to configure them in settings
    2. ✅ Provide Default maps coordinates from backend to Edit UI
  19. ✅ Ability to import apps from folder directly (patrons)
    1. ✅ Functionality
    2. ✅ Hints / Infos to user
    3. ⏳ Documentation
  20. ✅ Integration of Google Translate in the Edit UI
    1. ✅ Functionality for one field
    2. ✅ For many fields
    3. ✅ Configure so it only affects string fields
    4. ✅ Ability to disable auto-translate on certain fields - eg. name fields
    5. ✅ Ability to add custom API key
    6. ✅ Clear warning when using the demo key
    7. ✅ Make sure the license is respected and easy to spot
    8. ⏳ Documentation for this (how the fields are selected, how to activate, etc.)
  21. ✅ Release v15 before XMas

Breaking Changes in 2sxc 15.00

Tip

In summary we've made a lot of internal breaking changes. But for all normal users it will have no effect at all.

We believe it will only affect you in these scenarios:

  1. If you have a custom DataSource, you will need to make some minor changes and recompile them
  2. If you used special, non-public Logging APIs you would need to update your work
  3. If you used any undocumented APIs, you will need to check if everything still works

API Changes that may affect you

  1. DataSource base class was completely refactored
    see instructions
  2. Old static ToSic.Eav.DataSource was removed (deprecated since v13)
  3. Internal logging API ILog was completely refactored
    see instructions
  4. Internal object wrappers were completely refactored
    see instructions
  5. TinyMCE Upgrade to v6
  6. Database changes
  7. Minor API changes

Breaking Updates which probably don't affect anybody

  1. SQL changes - minor updates to the Database
  2. Internal APIs which were removed
    1. Static ToSic.Eav.Data.Builder.AttribBuilder.AddValue(...)

Changes in 2sxc 15.01 (2023-01-31)

  1. ✅ Export / Import
    1. ✅ Create export bundle configuration to mark content-types and entities for export together
    2. ✅ Create json bundle export system
    3. ✅ Create json bundle import system
    4. ✅ Extend the file-based data loader to also load bundles
    5. ✅ Change all pre-loaded data items to be in bundles
  2. ✅ New Auto-Installer with search, list-view etc.
  3. ✅ Remaining docs for Features released in v15.00
    1. ✅ Finish API and docs for Logging v15.01
    2. ✅ Ability to import apps from folder directly (patrons)
    3. ✅ Documentation for google translate (how the fields are selected, how to activate, etc.)
  4. ✅ Indicate premium/patron features in UI and explain what it is and how to get it
    1. ✅ Visual indicators on buttons
    2. ✅ Visual messages in certain places
    3. ✅ Details dialog to know more about the feature
    4. ✅ Public DB of the feature explaining it in more details, how to activate etc. on https://patrons.2sxc.org/features
  5. ✅ Licenses / Features
    1. ✅ Ability to license a specific feature only (for enterprise customers)
    2. ✅ Feature to generate enterprise license fingerprints for enterprise distribution
    3. ✅ Allow parts of the license to expire earlier (for evaluation purpose)
  6. ✅ Internal / Data Management
    1. ✅ Ability to retrieve Entities for App, parent-App, global-App etc. for certain settings-pickers
    2. ✅ System query to retrieve such entities (need for Wysiwyg-functionality)
  7. ✅ Oqtane: fix compatibility so it works in Oqtane 3.3+
  8. ✅ FIPS Compliance
    Note that the image resizer is not yet FIPS compliant, and it may take a while for it to become compliant
    1. ✅ Change Secure Data Service to be FIPS compliant
    2. ✅ Change System fingerprint to use FIPS compliant SHA256
  9. ✅ Internal - re-org ApiKeys for UI to be in a better place
  10. ✅ Enhance Page DataSource with community requests

Changes in 2sxc 15.02 (2023-02)

This was a quick release, no changes to report ATM, they will be reported in v15.03

also done:

  1. ✅ Upgrade Blazor-CMS.org to use 2sxc 15.01 for real-life testing
  2. ✅ Create blog on Blazor-CMS.org
  3. ✅ Publish Tutorial in Blazor-CMS.org
  4. ✅ CSP Training at DNN Summit
  5. ✅ Image Perfectionist Training at DNN Summit

Changes in 2sxc 15.03 (2023-02-21)

  1. ✅ APIs
    1. ✅ EntityId now has a OwnerId property
    2. ✅ Kit.Page.Activate(condition: bool, features: "...")
  2. ✅ move to .net 6 (and drop .net standard 2.0) - almost done, last tests
  3. ✅ Bugs
    1. ✅ RazorBlade json serialization https://github.com/2sic/2sxc/issues/2998
    2. ✅ Support for use on DNN 404 pages
    3. ✅ Date was off in date-picker
  4. ✅ FIPS compliance on encryption APIs
  5. ✅ DataSources
    1. ✅ Pages DataSource
      1. ✅ Improve Pages DataSource with LinkTarget
      2. ✅ Improve Pages DataSource with internal ability to configure what to get
      3. ✅ Improve Pages DataSource to have a UI to configure what to get - @2dm
    2. ✅ Users DataSource Massively improved - with Roles and configurable
    3. ✅ Roles DataSource improved
  6. ✅ Internal - Rework Getting-Started Server to be latest and greatest @2ro ... and more see https://github.com/2sic/2sxc/releases

Breaking Changes in 2sxc 15.03

Tip

In summary we've made a lot of internal breaking changes. But for all normal users it will have no effect at all.

We believe it will only affect you in these scenarios:

  1. TODO

API Changes that may affect you

  1. An internal user property IUser.IsDesigner was renamed to IUser.IsSiteDeveloper
  2. An internal, deprecated user property IUser.IsAdmin was removed
  3. An internal, deprecated user property IUser.IsSuperUser was removed
  4. An internal property IUser.Guid was changed from Guid? to Guid
  5. The Users DataSource had a property called IncludeSystemAdmins which was changed from bool to string to allow for more options
  6. The Users DataSource had a property called RoleIds which returned a non-standard string-array. It has been removed, and the new Roles returns standard related entities.
  7. Removed static ToSic.Eav.Data.Build.Entity(...) method which was deprecated in v12

API Changes which should really not affect you

These are internal APIs which we changed to make everything more immutable. They should never have been in use outside of the internal code.

  1. Changed IValue.Languages from IList to IEnumerable and made it immutable
  2. Change IEntity.Attributes from Dictionary<string, IAttribute> to IImmutableDictionary<string, IAttribute> as a step to later make it immutable
  3. Removed some old, probably never used APIs on IAttribute<T> such as
    • IAttribute<T>[int[] languageIDs]
    • IAttribute<T>[string]
    • IAttribute<T>[string[]]
    • IAttribute[string[] languageKeys] - was always marked as private
  4. Changed the type of Attribute.Type from string to ValueTypes to make it more strong-typed
  5. Removed the property Attribute.ControlledType which previously contained the ValueType

Changes in 2sxc 15.04 (2023-03-22)

  1. ✅ Oqtane: Compatibility with Oqtane 15.04
  2. ✅ Formula improvements
    1. ✅ Get App or global settings for formulas
    2. ✅ Better support for promises
    3. ✅ Ability to set the value of another field
    4. ✅ Intellisense on Formulas
  3. ✅ Cdn remapping to other cdn like cdn.2sxc.org or custom CDN
    1. ✅ Ability to remap all cdn urls to a different url
    2. ✅ New template CDN on https://cdn.2sxc.org
    3. ✅ New template repo for anybody that wants to create their own CDN or host on their path https://github.com/2sxc/cdn.2sxc.org
  4. New APIs for Data Sources finalized
    1. ✅ Public IDataFactory API
    2. ✅ Public IDataSourceFactory API
    3. ✅ Enhanced IDataSource API
    4. ✅ Prototype of live DataSources
  5. ✅ Make everything internal immutable
  6. ✅ Improve WYSIWYG
    1. ✅ Ability to select which "mode" the editor is in, affecting toolbars
    2. ✅ Allow selected mode to affect other things (like deny image-drop if in text-mode)
    3. ✅ Sections to better align images
    4. ✅ Use classes to determine size instead of styles
    5. ✅ WYSIWYG Images which auto-resize on the server based on size (eg 1/2 of the screen)
  7. ✅ New Data Sources and System Queries
    1. ✅ New Data Source Scopes
    2. ✅ New Query Scopes
    3. ✅ New Data Source MetadataTargetTypes
    4. ✅ New Query MetadataTargetTypes
    5. ✅ New DataSource Licenses - with state
    6. ✅ New Query Licenses
    7. ✅ New DataSource Features - with state
    8. ✅ New Query Features
    9. ✅ New DataSource Sites
    10. ✅ New Query Sites
    11. ✅ Improve data sources for Pages
  8. ✅ Query Improvements
    1. ✅ Allow edit/new to be done in a query-selector
    2. ✅ Get query to know if entity can be edited (based on AppId)
    3. ✅ We've renamed the system queries to have a much simpler name such as System.Sites which we'll make available to public use soon.
    4. ✅ New LookUp for Settings- and Resources-Stack - to use Settings and Resources
    5. ✅ Change internal key for Settings to MyConfiguration to avoid naming conflicts (breaking but probably no impact)
  9. ✅ Custom DataSources - breaking
    1. ✅ New IDataFactory API
    2. ✅ New RawEntity and IRawEntity API
    3. ✅ New API for data sources to make data generation easier
    4. ✅ Improved custom DataSources API
    5. ✅ New base class CustomDataSourceLight
    6. ✅ New base class CustomDataSourceAdvanced
    7. ✅ Error handling is now simpler / more standardized
  10. ✅ Jewels
    1. ✅ CmsContext.View now has a Path, PathShared, PhysicalPath and PhysicalPathShared property
    2. ✅ Page.Activate(...) now has a condition: true parameter which lets you only activate a feature if a condition is met
    3. ✅ Page.Parameters has new Get(name) and Get<type>(name) and Get(name, fallback: 7) APIs to make it easier to work with url parameters
  11. ✅ The Toolbar now has a new Info button which is used to show an info-bubble to the user or provide a help-link to somewhere. You'll soon see this in our standard apps to inform users about special cases such as "why the toolbar isn't available on demo-data"
  12. ✅ Bugs fixes
    1. ✅ 2sxc in DNN Skins on 404 pages https://github.com/2sic/2sxc/issues/2986
    2. ✅ Issue with Mobius Forms in v15.03

Breaking Changes in 2sxc 15.06

Tip

In summary we've made a lot of internal breaking changes. But for all normal users it will have no effect at all.

We believe it will only affect you in these scenarios:

  1. TODO

API Changes that may affect you on IEntity

These were internal APIs which were not publicly documented, but may have been used by some developers.

  1. IEntity.GetDraft() was removed to ensure the entity is immutable
  2. IEntity.GetPublished() was removed to ensure the entity is immutable

Note: GetDraft() and GetPublished() are still available on DynamicEntity in Razor and WebApi. They were only removed on IEntity.

Renamed DataSources

These data sources had uncommon names, and were renamed to be more consistent. We believe that they were only used in VisualQuery and not in code, so it should not affect you.

  1. CsvDataSource is now Csv
  2. SerializationConfiguration is now Serialization

Breaking Changes in EAV and 2sxc v14

We try to minimize breaking changes, and most breaking changes won't affect your work, because it's internal API. We're documenting it here to ensure you know what happened, in case you still run into this.

Summary

V14 did some clean-up of internal APIs, but otherwise there are no known breaking changes.

Note that these changes could be seen as a breaking change for certain users:

  1. Change in App Zip Package in v14.08 v14.08
  2. Change in App Data Folder in v14.08 v14.08

All Changes V14

14.00 - 14.07.05 (2022-Q2 & 2022-Q3)

Q2

  1. ✅ Image-Service/Picture
  2. ✅ Image primary area / corner selector
  3. ✅ Patron features with licensing & payment system
  4. ✅ LightSpeed cache
  5. ✅ v14 Release
  6. ✅ DNN 9.6.1 only
  7. ✅ Formula Boost with many new features #1
  8. ✅ DNN DI integration
  9. ✅ Update turnOn to 0.1.2
  10. ✅ CSP for the site (DNN only ATM)
  11. ✅ Formula Boost #2 (more context info, features-infos, etc.)
  12. ✅ NPM Types updated to latest release
  13. ✅ Enterprise Features which will be availabe for bigger sponsors
  14. ✅ Patron-System, where sponsors of 2sxc get some extra features
  15. ✅ Standardize how to integrate into other systems (non-Dnn/Oqtane)
  16. ✅ Service Kits
  17. ✅ Deprecation System
  18. ✅ Toolbar Services v1
  19. ✅ JS Docs updated to the latest version and auto-generated
  20. ✅ Tutorials Formulas
  21. ✅ Update all Apps to the lastest/greatest conventions
  22. ✅ v14 LTS

Q3

  1. ✅ Toolbars Service Improvements
    1. ✅ icon-metadata
    2. ✅ group C# API - ToolbarBuilder now has Group command
    3. ✅ SVG icons - Toolbar Buttons can now use SVGs for icons (usually base64 encoded)
    4. ✅ base64
    5. ✅ ui multiple params
    6. ✅ bugfixes
    7. ✅ params multiple params
    8. ✅ array params
  2. ✅ Debug-logging on Oqtane client side code, bugfixing ca. 0.5d
  3. ✅ Change storage of app.xml to App_Data, change how import works and enable import-from-folder/git
  4. ✅ Clean up JS code, latest webpack, packages etc. ca. 1d
  5. ✅ Infrastructure for automated testing of JS - ca. 5d
  6. Apps / App Maintenance
    1. ✅ Update most apps which used ephemeral variables for formulas to just use parameters (new in v14) ca. 0.5d
    2. ✅ new Timeline Apps
    3. ✅ new Files App
    4. ✅ new Jobs
    5. ✅ Make many Apps backwards compatible with Bootstrap 3 for a big customer
    6. ✅ Have the core apps tested & optimized for WCAG for a government customer
  7. ✅ Re-release sxc-angular
  8. ✅ Remove dependency on SharpZipLib

14.09 - 14.12 (2022-10)

  1. ✅ Improve UI/Flow of system registration (ATM still confusing)
  2. ✅ Make sure edit-ui doesn't need material fonts from CDN for icons
  3. ✅ Create a new app.json configuration file for 2sxc apps to tune how export/import works
  4. ✅ Remove Newtonsoft JSON and migrate to System.Text.Json
  5. ✅ Improve handling of app-metadata (resources, settings)
  6. ✅ Enable init and import completely new app directly from folder/git copy 1d SDV
  7. ✅ Ability to sync Apps through git including the Assets and ADAM
  8. ✅ Improve handing feature details to edit-ui
  9. Data Sources
    1. New data source Users
    2. New data source Roles
  10. ✅ Update Imageflow to latest version
  11. ✅ Remove dependency on Newtonsoft - only use System.Text.Json
  12. ✅ Create https://schemas.2sxc.org for json schemas
  13. ✅ Create JSON Schemas for image recipe and app.json
  14. ✅ More formula tutorials how to call a WebAPI
  15. ✅ Security update System.Data.SqlClient
  16. ✅ Oqtane 2shine Theme release
  17. ✅ cre8magic v0.0.1 released

14.12.00 - 14.12.03 LTS (November 2022)

  1. ✅ Publish blazor-cms.org
    1. ✅ get a great page speed - 95%+
    2. ✅ Get blazor-cms.org to index really well in google
  2. ✅ v14 LTS #2 ca. v14.12 🚀

Important Changes

  1. Assembly Binding Issue on Installs from 2sxc 13.04 to 14.02
  2. Change in App Zip Package in v14.08 v14.08
  3. Change in App Data Folder in v14.08 v14.08
  4. New app.json with Export Exclude v14.09

Version 13

TODO

  1. New WebApi route app/auto/data to replace /app/auto/content - the old one will still work, but we won't document it any more, because it was a confusing name
  2. Lots of metadata stuff... TODO:
  3. New sxc.data and sxc.query

Breaking Changes in 2sxc 13.00

API Changes that may affect you

  1. An old, non-DI feature for Inner Content is being deprecated and will be removed in v14
    see instructions

  2. An old feature for publishing module InstanceData as JSON is removed
    see instructions

  3. An old feature to create DataSources is removed
    see instructions

  4. Two old data-conversion features DataToDictionary and EntitiesToDictionary were removed
    see instructions

  5. Some internal functionality which enabled IEntity objects to convert links containing file:... and page:... has been removed. This only affects special deep code calls on IEntity and does _not affect DynamicEntity objects in Razor see instructions

  6. The old feature Eav.Factory.Resolve<T>() was deprecated and will be removed in v14
    see instructions

  7. The old feature BlockDataSource.Cache.GetContentType(...) was removed see instructions

  8. The Dnn Static ToSic.Sxc.Dnn.Factory is being deprecated and will be removed in v14 see instructions

Major Updates with may affect you

  1. The Image Resizer is being replaced with ImageFlow
  2. The App containing Site-wide settings is changed to Primary - previously it used the Content app for this. We believe this won't affect many users, as the settings-stack is still very new in v12

Things which probably don't affect anybody

  1. SQL changes - minor updates to the Database
  2. .net Framework and Dll Updated to Match Dnn 9 Requirements - but still works in Dnn 7.4.2
    1. .net Framework 4.7.2 now required (previously .net Framework 4.5.1)
    2. .net Standard 2.0.3 required (previously .net Standard 1.6)
      Important: This will be referenced in the web.config upon installation
    3. Dependency Injection updated to .net core 2.1.1 (previously 1.1)
    4. Newtonsoft.Json updated to v10.0.3
  3. Entity Framework updated to 2.1.1 (previously 1.1) - Oqtane is unmodified and uses 3.1.4
  4. Dnn DLLs renamed
    1. ToSic.Sxc.Dnn.dll became ToSic.Sxc.Dnn.Core.dll for consistency
    2. ToSic.SexyContent.WebApi.dll became ToSic.Sxc.Dnn.WebApi.dll
    3. ToSic.SexyContent.Razor.dll became ToSic.Sxc.Dnn.Razor.dll
  5. An internal object ToSic.Eav.Apps.State was removed

Internal APIs which were removed

  1. Static ToSic.Eav.Data.Builder.AttribBuilder.AddValue(...)

13.01

  • JSON fields
  • Link.Image with srcSet Parameter ?
  • ToSic.Sxc.Services.IFeaturesService

13.02

  • JS
  • Global Apps

13.03 TODO

13.04 TODO

13.05

  • Moved the Web.IInPageEditingHelper to Services.IEditService - this is non breaking and shouldn't matter, as people won't be using the direct inteface
  • Moved the Web.ILinkHelper to Services.ILinkService - this is non breaking and shouldn't matter, as people won't be using the direct inteface

13.x 2022-Q1

  1. ✅ Improve Tutorials massively
  2. ✅ View Metadata
  3. ✅ Oqtane Website Mode which can be indexed in Google
  4. ✅ Improve Feature-Management
  5. ✅ IFeaturesService
  6. ✅ Shared Apps across Sites (Patrons only feature)
  7. ✅ Enable editing of Shared Templates / files
  8. ✅ Enable shared APIs
  9. ✅ Disable translation of specific content-types
  10. ✅ Dnn Factory replacement to render module or get DynamicCode outside of 2sxc
  11. ✅ Fully integrate with Dnn Dependency Injection
  12. ✅ Improve DI Scopes to Module-Level
  13. ✅ IImageService

13.x LTS 2022-Q2

  1. ✅ v13 LTS

Version 12

Changes Version 12.10

  1. New Children DataSource
  2. New Parents DataSource
  3. New Metadata DataSource
  4. New MetadataTargets DataSource
  5. The StreamMerge DataSource got three new out-streams Distinct, And and Xor
  6. Moved IPageService from previously ToSic.Sxc.Web to ToSic.Sxc.Services but preserving compatibility with old code
  7. Moved IPageService from previously ToSic.Sxc.Web to ToSic.Sxc.Services but preserving compatibility with old code

Breaking Change Version 12.10

  1. Jquery is completely removed. This shouldn't affect your code, since all old code usually runs in DNN where jQuery is included by default.

Changes Version 12.06 LTS

No relevant changes

Changes Version 12.05

  1. Introduced IJsonService for json serialize/deserialize
  2. Introduced IConvertService for simple data-type conversion, also available on the Convert property of Razor12 and Api12
  3. Introduced ToSic.Sxc.Services.ILogService to log messages to the system (Dnn/Oqtane)
  4. Introduced IMailService to easily send mails cross-platform
  5. Introduced ISecureDataService to use encrypted settings
  6. Introduced IRenderService for inner-content rendering (Oqtane code must use this)
  7. Published ToSic.Eav.DataFormats.EavLight to better document simple eav data
  8. Published IConvertToEavLight as the new standard way to prepare entities for WebAPI serialization. This is meant to replace previous code using objects such as EntitiesToDictionary or DataToDictionary which are now marked as obsolete.
  9. New Razor12, Api12 and Code12 Classes now don't support old, obsolete APIs anymore
  10. Link.Image now also accepts parameters as a parameter
  11. Link.Image and Link.To always create safe urls now (spaces are encoded etc.)
  12. Link.To and Link.Image now have a parameter type which can be "full" to ensure domains are always added to links (for use in APIs generating RSS etc.)
  13. Update to RazorBlade v3.7
  14. Edit.Toolbar now supports condition so that toolbars may or may not be created based on a true/false value
  15. Link.Image now also accepts a factor or aspectRatio which is a string like 1:2 or 3/4
  16. AsDynamic(...) now also wraps anonymous objects in quite an amazing way
  17. Bugfix: lots of small ones

Breaking Change Version 12.05

V12 adds new properties to Razor and WebAPI which could result in some surprises: Path, Convert, Settings, Resources and DevTools. Especially the new Path and Convert could clash with existing code which had @using System or @using System.IO so the code would just read Path.GetFileName(...) or something. Because of this, we only give the latest classes Custom.Dnn.Razor12, Custom.Dnn.Code12, Custom.Hybrid.Razor12, Custom.Hybrid.Api12 etc. these properties.

This means that previous base classes do not have these by design, and we encourage you to move to these latest base classes.

Important: 2sxc 12.00 - 12.04 also had some of these properties on ToSic.Sxc.Dnn.RazorComponent as well as ToSic.Sxc.Dnn.ApiController. So if you were eager to use these properties but didn't change the base class, you were able to use it. To protect thousands of upgrade-scenarios we had to take them away from the old base classes. Sorry!

Possible Breaking Changes

  1. We believe nothing broke, but it could be that some commands on EntitiesToDictionary or DataToDictionary were accidentally changed. Pls report so we can fix that.
  2. The Link.To(...) now returns safe URLs. This should not be an issue, but in rare cases post-processing of the string returned may expect spaces or something, which are now %20
  3. We disabled old obsolete APIs on the new Razor12, Api12 and Code12 base classes. In case you were using this (not likely) you'll get an error telling you about this.

Changes Version 12.04 incl 12.03 which was not officially released

  1. Settings Stack and Resources Stack added, and the Settings / Resources object now have this
  2. Global Settings.Images.xxx settings defined for Content, Screen, Lightbox and Section
  3. Global Settings.Resources.xxx defined for fancybox3, fancybox4, bootstrap4, bootstrap5
  4. Link.Image API created to support predefined sizes/resize modes etc.
  5. Created feature where DynamicEntities can browse to sub-items using their identifier (used for Settings.Images.Content where Content is actually the title of a sub-entity)
  6. Added debug-feature for DynamicEntity get
  7. String-Dropdown inputs now have a value-key presets option (instead of the key-value which was flaky) and added support for escaping special characters
  8. #Oqtane 2.2 support added
  9. Introduced Monaco (VS-Code online) editor for beta-testing source-editing

Breaking Change Version 12.04

  1. DynamicEntity now has a property Count because it's a list as well, this could cause issues if a content-type has a property Count
  2. DynamicEntity is now always a list. Because of this we removed the DynamicEntityWithList object. We believe the type is never referenced in user code, but if it is, this would be a breaking change.
  3. Many parts that prepare Entities returned a Dictionary<string, object> and now return an IDictionary<string, object>.
    We believe this shouldn't hurt much, since the result would usually be in a var or returend directly to the API for streaming, but in case someone had used explicitly typed code, this will require a minor change

Changes Version 12.02

  1. Formulas feature finalized
  2. DynamicEntityStack object created
  3. Hybrid IPageService created with Activate and similar features
  4. CmsContext was enhanced with View information
  5. Content-Type icons can now be stored in the app with an [App:Path]/image.jpg style reference
  6. Enabled view-configuration to configure search behavior incl. not-to-index or what streams should be indexed
  7. turnOn created / deployed
  8. #Oqtane 2.1 support added in 2sxc 12.02.01

Changes Version 12.00 Todo

Version 11

Changes Version 11.00

Breaking Changes

The following changes are all super-low-profile, but we want to document them just to be through:

  1. DataStream and IDataStream loses a very old property called .LightList - we're pretty sure it's not in use anywhere, if you have it, just use .List instead.

Enhancements

  1. Brand new Admin UI based on Angular 9 and Ivy with new Code-Editor, new VisualQuery and much more
  2. Razor CodeBehind
  3. Automatic Polymorphism
  4. Updated Razor Blades to 3.02 with the new Tags.SafeUrl(...) command
  5. Field: Boolean-Tristate which saves true/false/null
  6. App.Data.Create(...) now returns entities it just created

Changes Version 11.01

Enhancements

  1. In-Page Toolbar now recognises sub-item lists and provides sorting and editing buttons #2009
  2. Item-lists now have a button to add existing items to them #1278
  3. New system to create extensions in an app, in the system folder
  4. Ability to create custom Input Fields just by placing them in the system folder #2070

Minor

  1. Improve Equality Check for DynamicEntities and EntitiesInList #2075
  2. Data-table in admin UI now shows Title field no matter if there is another field which is the title #1639
  3. Button to flush app-cache in admin-ui #2073
  4. 2sxc Insights now available from the super-user toolbar #2069
  5. PT translations are added again #2064
  6. Loads of enhancements and minor issues in the UI

Changes Version 11.02

Enhancements

  1. App-Extensions system in the folder system
  2. Custom WebComponent based input fields #2082
  3. API to reconfigure the wysiwyg input control #2090
  4. Show view use with links to pages and more #2077
  5. UI - fields can now be set to not-translate #2086
  6. UI - boolean can now show different labels based on the value it has #2085

Minor

  1. Add HR language pack for editor #2087
  2. show app-name in admin ui
  3. show app-icon in apps-management #2078

Changes Version 11.03 - todo

Changes Version 11.04 - todo

Changes Version 11.05

  1. Old Edit UI be removed
  2. Old Admin-UI be removed
  3. APIs which only the old UIs used be removed
  4. Old helper JS for AngularJS apps (located in /js/angularjs) will be removed from the distribution. They had not been updated for over 3 years and we believe they were not widely used. Anybody upgrading will still preserve the files that are there. If you really need them, download an old release of 2sxc and get them manually.

Changes Version 11.06 - 11.11 - todo

👉 See the Project Issues

Changes Version 11.13

  1. VisualQuery 3 with a lot of new features
    1. Click on a stream shows what's in that stream
    2. Much better error handling to avoid queries from crashing if a stream has an error
    3. All internal DataSources were updated to use this new Error-Handling
    4. Output of Query is now tabbed which is much nicer to use
    5. Visual-Query only returns top 25 results by default to help with creating queries with large amounts of data
    6. UI was enhanced to show more user-friendly names/infos
    7. DynamicIn was introduced so DataSources can indicate that they expect a lot of In-streams
    8. UI enhanced with better/larger buttons/icons
    9. In Streams are now managed better so they can connect before it's known if the source Out actually has that stream
  2. New DataSource Error to provoke an error in a Query for testing
  3. New DataSource SerializationConfiguration lets you determine how things are serialized
  4. DataSource AttributeFilter enhanced to have keep-all or remove-all and multi-line configuration (easier)
  5. New DataSource Tutorial with updated sample code
  6. Insights-Logging was enhanced to log Exceptions (used in the VisualQuery Error handling)

Bugfixes

  1. Toolbar had issue when color code was numbers only

Changes Version 11.14 - 11.22 LTS TODO

Breaking Changes in EAV and 2sxc v11

We try to minimize breaking changes, and most breaking changes won't affect your work, because it's internal API. We're documenting it here to ensure you know what happened, in case you still run into this.

Summary

There were small breaking changes in 11.00 to 11.11 but they were internal so shouldn't affect normal developers.

Breaking Changes Version 11.07 - Drop the old edit UI

  1. In 11.07 the old edit UI was removed, so customizations for that UI would not be in effect any more.

Breaking Changes Version 11.10 - Mainly Dependency Injection

  1. In v11.10 we used much more dependency injection than ever before and stopped using static values which were still in the API in many places. Because of this, certain helper objects to create entities or lookup values were changed and their constructors were changed. We invested a lot of time to try to ensure that old APIs still work, but in case you're hit by one of these, make sure you check the DI and switch to resolving the objects using DI.

Breaking Changes Version 11.11 - Language Detection

  1. Previously the language detection used the Thread culture. Turns out this wasn't reliable because Dnn does some funny stuff (probably historical) which means that API-calls ended up using the language stored in some cookie instead of the one specified by the URL. We changed this, which should be more reliable. But if you were relying on this strange effect, then it may be a breaking change.
  2. Internally our tokens were also using the thread culture. When we changed this, we also had to change how tokens pick up the language. In rare cases this may affect you.
  3. We changed all tokens to always resolve boolean values to true/false (previously they would have been changed to the current language, like wahr for german). We believe this change is only an improvement, and should ensure that internal resolves in Queries etc. result in reliable output.

Breaking Changes Version 11.11 - DataSources: DataSourceConfiguration

Note that we also improved the DataSourceConfiguration to an interface IDataSourceConfiguration and documented this. As a side effect the API stays the same, but you will have to recompile your data sources for them to work again - sorry.

Breaking Changes Version 11.11.03 - IEntity Values

  1. IEntity had a command called Value(fieldName) which was probably never used. The idea used to be that it does language lookup internally, but we refactored this out since it could never be fully reliable because the full language list wasn't known to the IEntity. So we re-purposed the method (assuming it's not used) to just lookup the first occurance of the value. This way it`s useful for configurations and similar which are not multi-language.
  2. IEntity also had a Value(fieldname, lookup) method. We are deprecating it, and making the lookup not happen from now on. We believe it was never used.
  3. IEntity had a command called PrimaryValue(fieldName) which was probably never ever used, so we're deprecating it. Use Value(fieldName) instead.

Breaking Changes Version 11.11.03 - Other

  1. UI Toolbar dropped the button and command for item-history, as the history is now part of the edit dialog

Version 10

Changes Version 10.01 - 10.09 LTS

  • Develop and fine-tuning of the new Edit-UI based on Angular 8

Changes Version 10.20-00 to 10.20-05

  • Enhanced ListCache so it will prevent parallel buildup - important for long-loading DataSources like SharePoint DataSources
  • Updating to RazorBlade 3.1 which doesn't need extension methods

Changes Version 10.20-06

  • Created AsDynamic(string)
  • Created AsDynamic(DataSource) to enable AsDynamic(Data) instead of AsDynamic(Data["Default"])

Changes Version 10.21

  • New AsList() for better code
  • New AsDynamic(string) to work with json
  • /dist/ is now cleaned up on every update, to better distribute changing JS file structures

Changes Version 10.22

  • Query Params added for VisualQuery
  • Created QueryRun DataSource
  • Insights now includes the code file and line numbers
  • Insights now also measures time needed to execute some code
  • Various performance enhancements
  • Improved SoC for AppsCache and AppRoot DataSource

Changes Version 10.23

  • Lots of logging enhancements

Changes Version 10.24 LTS

  • New stable LTS
  • Improved/fixed QueryRun DataSource
  • Improved Insights
  • Enhancements to use 2sxc with Redis Cache
  • WYSIWYG enhancements for better H1-Hx, P and Blockquote
  • Performance enhancements
  • Intenal refactoring for APIs
  • Introduced an internal Compatibility-Level to disable very old features when using new RazorComponents

Changes Version 10.25 LTS

  • Changed how the $2sxc client JavaScripts are loaded for much better performance and better Google PageSpeed
  • Enabled various features for the Content area which previously were hidden, like Resources and Settings
  • Released brand new Content-Templates App with best-practices for 10.25
  • Fixed bugs with Evoq Page Publishing
  • Enhanced the ValueFilter DataSource to handle dates which were null

Changes Version 10.26

  • TinyMCE Updated to 5.1
  • Enhanced CreateInstance API to also work when compiling Razor files from a WebApi
  • New DataSource StreamPick
  • New automatic Param called [Params:ShowDrafts] to be used in VisualQuery - returns True or False
  • New tokens [App:AppId] and [App:ZoneId] to use in VisualQuery calles (dropdown from query)
  • Changed List-Caching bbehavior to create more reliable cache-keys for complex queries (previously it only went through Default streams to generate the cache-key)

Changes Version 10.27

Possibly breaking changes

  1. Because the dynamic entity list now has a type which is dynamic, it cannot be cast to List<dynamic> any more. IList<dynamic> works, but in case you have any code casting it to List<dynamic> you'll need to change that to either IList<dynamic> or IEnumerable<dynamic>.

New Features / Major Improvements

  • Changed DynamicEntity so that accessing a property which contains many other entities it will return a DynamicEntityWithList. This allows Razor files to access the properties like .EntityId or .FirstName of the main entity in a sub-list easily without requiring AsList(...) #1993
  • Updated Quick-Dialog to use Angular 9, Ivy and the latest Dnn-Sxc-Angular #1992
  • New DataSource AttributeRename #2004
  • Completely refactored internal list management API #1995
  • Complete refactoring of the inpage code to make it typesafe (no more any types)
  • Created brand-new, simpler way to create custom Toolbars and specs
  • Introduces JS/API 2sxc-Insights for debugging In-Page code

Enhancements

  • Performance-Enhance App DataSource to delay building objects until needed #1991
  • Performance-Enhance internal Token Lookup #1998
  • Enhanced Dnn Search Index logging #1997
  • Corrected help-links on all data sources #1994

Bugfixes

  • Cache-All-Streams only used the Default-Streams for Cache-Key identification #1988
  • QueryRun DataSource doesn't show statitics on all streams #1989
  • Modified date and Owner information were missing on json stored entities #2005 / #2006
  • Fixed bug in JS API for non-2sxc endpoint resolution #2000
  • Queries didn't resolve Dnn tokens when accessed in the Search Index #1999

Breaking Changes in EAV and 2sxc

We try to minimize breaking changes, and most breaking changes won't affect your work, because it's internal API. We're documenting it here to ensure you know what happened, in case you still run into this.

Summary

Version 10 has a lot of small breaking changes because we restructured the internal API so it's consistent when we publish it. All these things shouldn't affect you, because they were internal APIs, but in case it does - here's what we did.

Version 10.22 and 10.23

  1. Renamed the RootDataSource and the Interface to IAppRoot
  2. Split SOC of the AppRoot DataSource so that caching, Root-Metadata and ListCache is fully separate
  3. Since the Logging system now auto-picks up the code lines and names of the methods, we simplified the commands and dropped some parameters.
  4. Moved quite a bit of the DataSource objects into sub-objects, again for SOC.

Version 10.20-04 (ca. 2019-12-03)

  1. Renamed DataTableDataSource to DataTable, old name still works.
  2. Renamed ExternalDataDataSource to ExternalData, old name still works.
  3. Renamed ToSic.SexyContent.DataSources.ModuleDataSource to ToSic.Sxc.DataSources.CmsBlock, old name still works.
  4. Renamed ToSic.Eav.DataSources.VisualQuery.VisualQueryAttribute to ToSic.Eav.DataSources.Queries.VisualQueryAttribute, old name still works.
  5. Renamed ToSic.SexyContent.Environment.Dnn7.Factory to ToSic.Sxc.Dnn.Factory, old name still works.
  6. Renamed ToSic.Eav.DataSources.BaseDataSource to ToSic.Eav.DataSources.DataSourceBase for consistency, old name still works.
  7. Moved the LookUp namespaces into the Core DLL

Version 10.20-02 (ca. 2019-11-22)

More internal changes which shouldn't affect anybody, but make the API ready for public docs...

  1. Moved/renamed the internal Eav.AppDataPackage to Eav.Apps.AppState
  2. Moved/renamed some internal interfaces like Entity...
  3. Did a major change for how Attribute<T> for relationships work.
    Before they were Attribute<EntityRelationship> and now they are Attribute<IEnumerable<IEntity>>.
    This also affects Value<EntityRelationship> which is now Value<IEnumerable<IEntity>>
  4. Moved Tenant<T> and Container<T> including matching interfaces to Eav.Environment
  5. Renamed IAppIdentity to IInAppAndZone and IZoneIdentity to IInZone
  6. Renamed ICacheKeyProvider to ICacheKey
  7. Renamed CacheChainedIEnumerable<T> to SynchronizedList<T>
  8. Moved/Renamed MetadataFor to Eav.Metadata.Target. Left old name compatible.
  9. Moved some extension methods for IEntity from ToSic.Eav.Data.Query to ToSic.Eav.Data
  10. Changed Permissions to be strong-typed EntityBased objects

Version 10.20.01 (2019-11-12)

  1. Internal code now uses the term Header instead of ListContent. External code provides both for backward-compatibility
  2. moved internal interfaces for engines (Razor/Token) to final namespaces ToSic.Sxc.Engines
    1. IEngine
    2. EngineBase
    3. ITokenEngine
    4. IRazorEngine
  3. corrected architecture - some template-management code had slipped into Eav.Apps, was moved back to Sxc.Apps
  4. The Template object was moved from Eav.Apps to Sxc.Views and we added an interface IView. We also renamed the internal properti ViewNameInUrl to UrlIdentifier.
  5. To correct the API a CmsManager was created extending the AppManager, which is in charge of Views
  6. Moving internal stuff related to content blocks
    1. IContentBlock from SexyContent.Interfaces to Sxc.Blocks
    2. from ToSic.SexyContent.ISxcInstance to ToSic.Sxc.Blocks.IBlockContext
    3. actually moved a lot of things there incl. ContentBlock now BlockConfiguration and more - all internal stuff
  7. Moving the ToSic.SexyContent.App to ToSic.Sxc.Apps.App
  8. In a razor page, we added the preferred Purpose. The old InstancePurpose will still work
  9. Placed some things we just moved in 10.20 to a final place - since it's a very recent change, we updated the docs in the 10.20.00 section

Changed, but completely internal

  1. Some namespaces on SexyContent.ContentBlocks were moved to Sxc.Blocks

Version 10.20.00 (2019-11-05)

  1. the internal interface IInPageEditingHelpers was moved from ToSic.SexyContent.Interfaces to the namespace ToSic.Sxc.Web
  2. the internal interface ILinkHelper was moved to ToSic.Sxc.Web
  3. the internal interface IHtmlHelper was moved to ToSic.Sxc.Dnn
  4. the property Configuration on dynamic entities was deprecated in 2sxc 4 and removed in 2sxc 10 - we don't think it was ever used
  5. moved internal Metadata interfaces (ca. 5) into final namespace ToSic.Eav.Metadata
  6. Moved a bunch of internal interfaces which we believe were never used externally from ToSic.Eav.Interfaces to ToSic.Eav.Data
    1. ToSic.Eav.Data.IAttribute
    2. ToSic.Eav.IAttribute<T>
    3. IAttributeBase
    4. IAttributeDefinition
    5. IChildEntities
    6. IContentType
    7. IDimension
    8. IEntityLight
    9. ILanguage
    10. IRelationshipManager
    11. IValue
    12. IValue<T>
    13. IValueOfDimension<T>
  7. Moved a bunch of internal interfaces which we believe were never used externally from ToSic.Eav.Apps.Interfaces to ToSic.Eav.Apps
    1. IApp
    2. IAppData
    3. IAppDataConfiguration
    4. IAppEnvironment
    5. IEnvironmentFactory
    6. IInstanceInfo
    7. IItemListAction
    8. IPagePublishing
    9. ITenant
    10. IZoneMapper
  8. the internal namespace ToSic.Eav.ValueProvider was changed to ToSic.Eav.LookUp and inside it
    we renamed a bunch of internal interfaces and objects which we believe were never used externally

Deprecated/Changed, but not broken

  1. the internal interface ToSic.SexyContent.IAppAndDataHelpers was renamed to ToSic.Sxc.IDynamicCode but the old interface still exists, so it shouldn't break
    it was used by Mobius Forms
  2. moved ToSic.Eav.Interfaces.IEntity to ToSic.Eav.Data.IEntity - but preserved the old interface for compatibility it was used everywhere

Clean-Up, but not broken

  1. We're transitioning to the term Header instead of ListContent in templates.
    The Razor pages and WebApi have this starting now, while old terms still work. Note that we're not creating a HeaderPresentation, because you should use Header.Presentation

Version 9

Changes Version 9.0

  • [x] Change data access to Entity Framework Core 1.1
  • [x] Change IoC Layer to use .net Core mechanisms
  • [x] Replace Quick-Dialogs with Angular4 implementation

Changes Version 9.1

  • [x] Move primary quick-dialog GUI to bottom of page

Changes Version 9.3

  • [x] Item-Level versioning, history and rollback

Changes Version 9.4

  • [x] Drop all dependencies to Telerik - file browser using ADAM

Changes Version 9.5

Changes Version 9.6

Changes Version 9.7 - the JSON-Content-Types & Entities Upgrade

  • [x] New features in entity json serialization
    • [x] Support for schema-free (very dynamic) entities
  • [x] new features in content-type json serialization
    • [x] defined json format for content-types
    • [x] full serialization and deserialization of json-based content types
  • [x] SQL IRepository storage enhancements
    • [x] extended SQL table Entities to also store AppId and ContentType (name) to ensure that json-entities can be stored
    • [x] Support to persist entities as JSON in repository (DB)
  • [x] file-storage implementation of IRepository loader, to created a standard-based app-content-types provider
    • [x] Ability to provide file-based json content-types at a system level, which is probably the better solution for most scenarios (more flexible, easier to spot changes, etc.)
  • [x] global content-types system
    • [x] Support for code-provided content-types, which allows faster feature-evolution
    • [x] Support for JSON based i18n on code-provided content-types, to allow better translation removed again, as not needed
  • [x] Ensure export/import of data of these new content-types (req. extensive refactoring)
  • [x] extensive automated testing of these new features

Changes Version 9.8 - the VisualQuery Upgrade

  • [x] SqlDataSource in VisualQuery Designer
  • [x] Show DataSources which have Fallback-In-Streams in VisualQuery Designer
  • [x] UI Updates on VisualQuery Designer, to better fit current needs
  • [x] More help documentation for various data sources in VisualQuery Designer
  • [x] Shuffle DataSource now configurable in VisualQuery
  • [x] Support for Schema-Free Content (dynamic, without existing content-type)

Changes Version 9.9 - another VisualQuery Upgrade

  • [x] Enhance relationship filter to enable filtering on other fields of related items
  • [x] Enhance other data sources with features which so far were not available in the visual designer

Changes Version 9.10 - Combobox and more DataSources (WIP)

Changes Version 9.11 - Query-Picker & more DataSources

  • [x] Entity-Picker delivering items from a query, instead of a type
  • [x] string-dropdown-query to pick string-items from a query instead of pre-filled
  • [x] query export / import
  • [x] multi-select items in a string-query-picker

Changes Version 9.12

  • [x] Json-based global query definitions
  • [x] Method to add parameters to a called query (like when using an entity-pickers which uses a query)
  • [x] pre-build queries for things like zones, apps, content-types, fields, query-info etc.
  • [x] data sources for Zones, Apps, Queries, Attributes, etc.
  • [x] limit streams returned by a query

Changes Version 9.13

  • [x] Enhanced API to create custom DataSources + ca. 10 blog posts for that
  • [x] Standalone FnL / UDT DataSource (removed it from core distribution)

Changes Version 9.14 LTS

Changes Version 9.15-9.42 LTS

Didn't have time to document this yet, sorry. If you need to know, best check the git-history.

Breaking Changes in EAV and 2sxc Version 9

We try to minimize breaking changes, and most breaking changes won't affect your work, because it's internal API. We're documenting it here to ensure you know what happened, in case you still run into this.

Version 9.20.00 (2018-03-04)

  1. Minor breaking change in ADAM properties, like Id instead of FolderID which was a leftover of Dnn naming.
    see full blog post

Version 09.08.00 (2017-11-28)

  1. Minor breaking change List<IEntity> instead of Dictionary<int, IEntity> on the IDataSource
    see full blog post

Version 09.03.00 (2017-10-08)

  1. Breaking change on inconsistent naming ToSic.Eav.IEntity instead of ToSic.Eav.Interfaces.IEntity.
    see full blog post

Changes Version 8

Changes Version 8.00 - 8.8

Didn't find time to document this :)

Changes Version 8.09

  • [x] Very Rich Content (Inner Content 2.0)
  • [x] Item-Delete directly from in-page toolbar

Changes Version 8.10

  • [x] Shuffle data sources (to randomize items)
  • [x] Public (anonyomous) REST API for query and read/write content-items

Changes Version 8.11-8.12

Mostly smaller bugfixes

Version 1-7 (2012-2016)

Didn't find time to document this :)

Edit this page