Major release

[iJungleboy]

This is another huge release. As we migrated all our apps to become Hybrid and run on Oqtane and Dnn, we found hundreds of improvements to make your life easier.

Ultra-Highlight

We updated 18 of our most popular apps to be super-clean, easy to understand and use the latest best-practices, while making them compatible with Oqtane. You can find them on our App Catalog

Highlights

1. New Cross-Platform IMailService for sending mails Create cross-platform IMailService #2554
   2. This is extra awesome, as you can also give it an array of ADAM IFiles and it will attach them ot the mail
2. New Cross-Platform ILogService to report errors to Dnn/Oqtane
3. New IJsonService Create cross-platform Newtonsoft independent DI using JsonService #2516 Create Json-Conversion as part of 2sxc to simplify APIs and not require Newtonsoft in Razor #2513
4. New Convert property which is an IConvertService to safely convert numbers, strings and more, also for use in JS or JSON Create Helper-API to safely convert dynamic data to int, float, bool etc. #2533
5. New IRenderService for inner content Feat: Provide an IRenderService for inner content in v12 #2550
6. Created IParameters with Add, Remove and Set commands to easily generate url-parameters which reuse existing url-parameters - for example when paging on a list which already has filters Feature: Re-Use existing page parameters to construct modified urls #2532
7. Created an ISecureDataService to decrypt protected values/secrets in settings like google API keys Create ISecureDataService for passwords and similar #2556

Enhancements

1. Link.To and Link.Image now always creates a Safe-URL (encoding Umlauts and spaces etc.) Link.To should always return a safe url with escaped characters etc. and not need Tags.SafeUrl #2542
2. Link.To and Link.Image can now also have a parameter type: "full" to ensure a domain is added - important for linking stuff in WebAPIs like for RSS feeds Extend Link.To and Link.Image to provide links with Domain if needed #2543
3. Link.To can now easily re-use existing parameters of the CmsContext.Page.Parameters or slighly modify them Feature: Re-Use existing page parameters to construct modified urls #2532
4. Link.Image now has a parameters parameter to add stuff to the URL Allow adding parameters: to Link.Image #2548
5. Link.Image now can use 1:2 or 3/4 for the factor and aspectRatio parameter Enable Link.Image to take a Factor and AspectRatio of "2:1" or "2/1" as well as numbers like 0.5 #2520
6. Adam IFile objects now have a property PhysicalPath making certain operations like adding e-mail attachments easier Feat: Adam file and folder objects should also have a asset property PhysicalPath #2549
7. Edit.Toolbar now has a condition to selectively add a toolbar or not (for example only for certain users) Feat: Conditional toolbar #2525
8. DataSource objects now have a new GetStream(...) method which lets you get an empty list or null back if it doesn't find the stream Feat: Create GetStream(...) with options to return null or empty list if not found #2522
9. CmsContext.Site.Url now consistently has the current protocol as well Site.Url, Page.Url should return consistent values in DNN and Oqtane #2547
10. The SerializationConfiguration DataSource can now also filter out null/empty/zero values to make the JSON of a VisualQuery smaller Feat: Serialization options to drop null, zero or empty-string values #2551 Feat: Improve Serialization in Query to drop null, empty or zero values #2557
11. DynamicObjects can now wrap anonymous objects for mixing with settings, determining fallbacks etc. - great for Link.Image Enable AsDynamic to also wrap anonymous objects for mixing with settings #2519

Internal Refactoring and Improvements

1. LogHistory is now non-static and uses DI Refactor: Make LogHistory and GlobalTypes non-static and use DI #2528
2. Insights now shows warning if services were not customized to a platform Multi-Platform: Add Insights-Warning when services are not implemented / unknown #2529
3. System features now also use Dependency Injection instead of static accessors Get Features (to detect activated security relevant features) become a service on IFeatures #2539
4. New Razor12, Code12 and Api12 don't support obsolete APIs any more Re-org new Razor12 classes to have new APIs, and ensure old ones don't #2540
5. Entity Decorators now use a simpler model Refactor: Improve Entity Decorators #2552
6. Improve error message if a stream on a DataSource can't be found Feat: Improve error messages if a stream on a DataSource isn't found #2521
7. DynamicObject wrappers wrapping anonymous objects will also auto-wrap anonymous object properties to make object navigation a breeze Extend DynamicObject Wrapper to re-wrap sub-objects, but only anonymous ones #2535
8. Updated to RazorBlade 3.7 Update external dependency RazorBlade to v3.7 #2534
9. Clean-up data-to-dictionary conversion, created official IConvertToEavLight objects for DI Clean up & standardize use of data-to-dictionary interfaces / apis #2512
10. ADAM now doesn't create folders when just checking if files exist Avoid creating empty folders in ADAM when only "reading" the folder #2517
11. exporting apps will now exclude empty ADAM folders

Possible Breaking Changes

1. The Link.To now creates a safe url and converts special characters. If you were playing around with urls after Link.To it may not have the identical format any more
2. If you were already using new base classes like Razor12 and used obsolete APIs in there, it will fail now and tell you what you should use instead

Minor Bugfixes

1. Oqtane now treats ADAM files as normal files and shows them in the file manager
2. Lots of small Oqtane bugfixes like Oqtane: Enable loading of app system json-content-types #2527 Adam sub folders and files are missing in Oqtane File Management #2537 In Oqtane void method in web api controller returns status 200 instead of 204 #2555 Adam sub folders and files are missing when exporting app from Oqtane #2536
3. Serializing a DynamicJacket Object now works as expected Minor: Serializing a Json-based DynamicObject (DynamicJacket) returns an array #2511
4. Dnn 9.10 updated a Microsoft-DLL which cause issues HttpResponseException on AppQueryController when 'content-type' header is missing #2544
5. string-from-query shows IDs instead of titles Entitypicker shows Ids instead of String/Title #2515
6. CmsContext.Page.Parameters was also providing magic-parameters like the Dnn TabID - this was filtered out Dnn: Make sure CmsContext.Page.Parameters only has real url parameters #2530 Oqtane: Make sure CmsContext.Page.Parameters only has real parameters #2531
7. Bugfix requireJs issue which affected custom input fields Bug: Custom Input Field not working - probably timing issue #2526
8. Random bug, sometimes App file-system based content-types are missing till restart @2524

---

This discussion was created from the release Major release.