Email Builder Starter Kit initial (#3)

* feat(css): experimental way of defining classes for the emailbuilder

* feat(Product): product base

* feat(widgets): remove unused widgets, experimental content item selectors

* feat(example): dancing goat initial

* feat(mjml): add to startup

* feat(widgets): Product, Article Widgets implementation, mapper api, dancing goat examples

* feat(widgets): removed unused widgets, add example css

* feat(css): style sheet source file configurable

* feat(configuration): add builder

* feat(solution): cleanup repo

* feat(repo): add comments

* feat(widgets): bring back button, content, hero

* feat(sections): multiple columns

* feat(docs): initial

* fix(docs): grammar and wording

* feat(docs): add screenshots to readme

* feat(product/article): positioning the link to the product/article page

* feat(styles): use configured style sheet on Button, Content and Hero widgets

* feat(Content Widget): rich text editor

* feat(logo, hero): use media library as image source for widgets. add logo widget

* feat(logo, hero): update docs

* fix: Solution name fixed

* feat(article, product): change api to register widget data retrievers generically in startup, rename mappers to WidgetDataRetriever, update docs, fix grammar

* feat(XbyK): update to v30.3.0

* feat(update): remove email builder warning surpression which is not needed because of the  newest emailbuilder version

* fix(EmailSection): removed unneccesary EmailSection.cs file, move the properties of the Section Component to the razor file

* fix(Widgets): seal property classes for all widgets

* fix(CssLoaderService): use CMS.IO

* fix(naming): rename style sheet path property in mjml email builder options

* feat(update): remove email builder warning surpression which is not needed because of the  newest emailbuilder version

* feat(product/article): positioning the link to the product/article page

* feat(styles): use configured style sheet on Button, Content and Hero widgets

* feat(Content Widget): rich text editor

* feat(logo, hero): use media library as image source for widgets. add logo widget

* feat(logo, hero): update docs

* feat(article, product): change api to register widget data retrievers generically in startup, rename mappers to WidgetDataRetriever, update docs, fix grammar

* fix(button): remove widget properties

* fix(Button): readd button widget properties

* feat(Button): explanation text of the url property

* feat(Button): enums into separate files

* fix(Components): removed unneccesary usings

* fix(Product template): separate markup and code

* fix(code cleanup)

* fix(IWidgetDataRetriever): rename

* fix(formatting): run dotnet format

* fix(editorconfig): line endings default

* fix(editorconfig)

* fix(repo): line endings

* fix(formatting): line endings

* fix(formatting): add gitattributes

* fix(naming): rename product template to EmailBuilderStarterKitTemplate

* feat(Default template): change title to subject of the email

* fix(Default template): remove redundand mj-section

* fix(SectionBase): number of sections

* fix(format): remove unused using

* fix(Rcl.csproj): remove unneccesary file imports

* fix(SectionBase): zonename increment

* fix(Data retrieval): remove the need to specify a channel

* fix(WidgetProperties): move properties to code behind files

* feat(Article, Product widgets): log error on attempt to use the widgets without registers IWidgtetDataProviders

* fix(formatting & widget models): remove unused usings, seal widget model classes

* fix(naming)

* feat(repo): update nuget versions

* fix(repo): package url

* feat(Article): remove usage of Url.Content

* feat(styling): prefix all classes with mj-email-

* fix(naming)

* fix(comments): typo

* fix(cssLoaderService): sealed

* feat(LogoWidget): seal properties

* feat(Icons): add icons for components

* fix(repo)

* fix(CssLoaderService): CMS.IO used.

* refactor(HorizontalAlignment): typos fixed, renamed for generalization

* refactor(ContentPositionType): renamed for generalization

* rafactor(IMediaFileService): extract to a separate file, annotation changed

* rafactor: project updates

* refactor: widgets removed

* feat: Product widget improved. Content types filter added.

* feat: localizations configured

* refactor: Text widget renamed

* feat: Image widget and text widget improved. Inline editor added.

* feat(TextWidget): css class parameter added

* feat: css class property in configuration

* feat(divider): divider widget added

* feat: Product widget layout improved. Image resolver example.

* feat: localizations for widgets and properties

* fix: button css class configurable

* fix: code formatting and clean up

* refactor: starter kit registration simplified

* feat: content type code name mapping to guid in content type filters.

* fix: code formatting

* fix: text widget supports only inline editing

* fix: multiple issues fixed

* fix: code formatting, razor rules added. Missing library configuration added.

* feat: DancingGoat upgraded. Documentation updated.

* fix: code formatting

* docs: Update documentation and resource strings, final TW review

* Delete images/xperience-section-usage.png

* Add xperience-section-usage.png image

* docs: Heading capitalization fix

* fix: Polished XML docs

---------

Co-authored-by: bkapustik <boriskokap@gmail.com>
Co-authored-by: kapustb <55467298@mff.cuni.cz>
Co-authored-by: Boris Kapustík <82807109+bkapustik@users.noreply.github.com>
Co-authored-by: David Benovsky <DavidB@kentico.com>
Co-authored-by: Ondřej Machala <15248835+OndraM-Kentico@users.noreply.github.com>

Author: 5 people

.editorconfig

@@ -1,4 +1,4 @@
-# Severity levels of analyzers https://docs.microsoft.com/en-us/visualstudio/code-quality/roslyn-analyzers-overview?view=vs-2019#severity-levels-of-analyzers
+# Severity levels of analyzers https://docs.microsoft.com/en-us/visualstudio/code-quality/roslyn-analyzers-overview?view=vs-2019#severity-levels-of-analyzers
 
 root = true
 
@@ -8,6 +8,12 @@ indent_size                                                               = 4
 indent_style                                                              = space
 insert_final_newline                                                      = true
 
+[*.razor]
+end_of_line                                                               = crlf
+indent_size                                                               = 4
+indent_style                                                              = space
+insert_final_newline                                                      = true
+
 # Formatting Rules
 
 ## IDE0055: Fix formatting
@@ -64,7 +70,7 @@ csharp_preserve_single_line_statements                                    = fals
 csharp_preserve_single_line_blocks                                        = true
 
 ### Using directive options
-csharp_using_directive_placement                                          = outside_namespace : error
+csharp_using_directive_placement                                          = outside_namespace:error
 dotnet_diagnostic.IDE0065.severity                                        = error
 
 # Code Style Rules
@@ -210,35 +216,29 @@ dotnet_diagnostic.IDE0062.severity                                        = warn
 csharp_style_inlined_variable_declaration                                 = true : error
 dotnet_diagnostic.IDE0018.severity                                        = error
 
-csharp_style_var_elsewhere                                                = true : error
-csharp_style_var_for_built_in_types                                       = false : error
-csharp_style_var_when_type_is_apparent                                    = true : error
-dotnet_diagnostic.IDE0007.severity                                        = error
-dotnet_diagnostic.IDE0008.severity                                        = error
-
-csharp_style_expression_bodied_constructors                               = true : error
+csharp_style_expression_bodied_constructors                               = true:error
 dotnet_diagnostic.IDE0021.severity                                        = error
 
-csharp_style_expression_bodied_methods                                    = true : error
+csharp_style_expression_bodied_methods                                    = true:error
 dotnet_diagnostic.IDE0022.severity                                        = error
 
-csharp_style_expression_bodied_operators                                  = true : error
+csharp_style_expression_bodied_operators                                  = true:error
 dotnet_diagnostic.IDE0023.severity                                        = error
 dotnet_diagnostic.IDE0024.severity                                        = error
 
-csharp_style_expression_bodied_properties                                 = true : error
+csharp_style_expression_bodied_properties                                 = true:error
 dotnet_diagnostic.IDE0025.severity                                        = error
 
-csharp_style_expression_bodied_indexers                                   = true : error
+csharp_style_expression_bodied_indexers                                   = true:error
 dotnet_diagnostic.IDE0026.severity                                        = error
 
-csharp_style_expression_bodied_accessors                                  = true : error
+csharp_style_expression_bodied_accessors                                  = true:error
 dotnet_diagnostic.IDE0027.severity                                        = error
 
-csharp_style_expression_bodied_lambdas                                    = true : error
+csharp_style_expression_bodied_lambdas                                    = true:error
 dotnet_diagnostic.IDE0053.severity                                        = error
 
-csharp_style_expression_bodied_local_functions                            = true : error
+csharp_style_expression_bodied_local_functions                            = true:error
 dotnet_diagnostic.IDE0061.severity                                        = error
 
 csharp_style_pattern_matching_over_as_with_null_check                     = true : error
@@ -256,10 +256,10 @@ dotnet_diagnostic.IDE0078.severity                                        = erro
 csharp_style_prefer_not_pattern                                           = true : error
 dotnet_diagnostic.IDE0083.severity                                        = error
 
-csharp_prefer_braces                                                      = true : error
+csharp_prefer_braces                                                      = true:error
 dotnet_diagnostic.IDE0011.severity                                        = error
 
-csharp_prefer_simple_using_statement                                      = true : error
+csharp_prefer_simple_using_statement                                      = true:error
 dotnet_diagnostic.IDE0063.severity                                        = error
 
 csharp_style_prefer_index_operator                                        = true : warning
@@ -297,45 +297,70 @@ dotnet_naming_symbols.const_field_symbols.required_modifiers              = cons
 dotnet_naming_symbols.const_field_symbols.applicable_accessibilities      = *
 dotnet_naming_style.const_field_symbols.capitalization                    = pascal_case
 
-dotnet_naming_rule.const_fields_must_be_pascal_case.severity              = error
+dotnet_naming_rule.const_fields_must_be_pascal_case.severity = error
 dotnet_naming_rule.const_fields_must_be_pascal_case.symbols               = const_field_symbols
-dotnet_naming_rule.const_fields_must_be_pascal_case.style                 = const_field_symbols
+dotnet_naming_rule.const_fields_must_be_pascal_case.style = const_field_symbols
 
 dotnet_naming_symbols.private_field_symbol.applicable_kinds               = field
 dotnet_naming_symbols.private_field_symbol.applicable_accessibilities     = private
 dotnet_naming_style.private_field_style.capitalization                    = camel_case
-dotnet_naming_rule.private_fields_are_camel_case.severity                 = warning
+dotnet_naming_rule.private_fields_are_camel_case.severity = warning
 dotnet_naming_rule.private_fields_are_camel_case.symbols                  = private_field_symbol
-dotnet_naming_rule.private_fields_are_camel_case.style                    = private_field_style
+dotnet_naming_rule.private_fields_are_camel_case.style = private_field_style
 
 dotnet_naming_symbols.non_private_field_symbol.applicable_kinds           = field
 dotnet_naming_symbols.non_private_field_symbol.applicable_accessibilities = public,internal,friend,protected,protected_internal,protected_friend
 dotnet_naming_style.non_private_field_style.capitalization                = pascal_case
-dotnet_naming_rule.non_private_fields_are_pascal_case.severity            = warning
+dotnet_naming_rule.non_private_fields_are_pascal_case.severity = warning
 dotnet_naming_rule.non_private_fields_are_pascal_case.symbols             = non_private_field_symbol
-dotnet_naming_rule.non_private_fields_are_pascal_case.style               = non_private_field_style
+dotnet_naming_rule.non_private_fields_are_pascal_case.style = const_field_symbols
 
 dotnet_naming_symbols.parameter_symbol.applicable_kinds                   = parameter
 dotnet_naming_style.parameter_style.capitalization                        = camel_case
-dotnet_naming_rule.parameters_are_camel_case.severity                     = warning
+dotnet_naming_rule.parameters_are_camel_case.severity = warning
 dotnet_naming_rule.parameters_are_camel_case.symbols                      = parameter_symbol
-dotnet_naming_rule.parameters_are_camel_case.style                        = parameter_style
+dotnet_naming_rule.parameters_are_camel_case.style = private_field_style
 
 dotnet_naming_symbols.non_interface_type_symbol.applicable_kinds          = class,struct,enum,delegate
 dotnet_naming_style.non_interface_type_style.capitalization               = pascal_case
-dotnet_naming_rule.non_interface_types_are_pascal_case.severity           = error
+dotnet_naming_rule.non_interface_types_are_pascal_case.severity = error
 dotnet_naming_rule.non_interface_types_are_pascal_case.symbols            = non_interface_type_symbol
-dotnet_naming_rule.non_interface_types_are_pascal_case.style              = non_interface_type_style
+dotnet_naming_rule.non_interface_types_are_pascal_case.style = const_field_symbols
 
 dotnet_naming_symbols.interface_type_symbol.applicable_kinds              = interface
 dotnet_naming_style.interface_type_style.capitalization                   = pascal_case
 dotnet_naming_style.interface_type_style.required_prefix                  = I
-dotnet_naming_rule.interface_types_must_be_prefixed_with_I.severity       = error
+dotnet_naming_rule.interface_types_must_be_prefixed_with_i.severity = error
 dotnet_naming_rule.interface_types_must_be_prefixed_with_I.symbols        = interface_type_symbol
-dotnet_naming_rule.interface_types_must_be_prefixed_with_I.style          = interface_type_style
+dotnet_naming_rule.interface_types_must_be_prefixed_with_i.style = interface_type_style
 
 dotnet_naming_symbols.member_symbol.applicable_kinds                      = method,property,event
 dotnet_naming_style.member_style.capitalization                           = pascal_case
-dotnet_naming_rule.members_are_pascal_case.severity                       = error
+dotnet_naming_rule.members_are_pascal_case.severity = error
 dotnet_naming_rule.members_are_pascal_case.symbols                        = member_symbol
-dotnet_naming_rule.members_are_pascal_case.style                          = member_style
+dotnet_naming_rule.members_are_pascal_case.style = const_field_symbols
+csharp_style_namespace_declarations = block_scoped:silent
+csharp_style_prefer_method_group_conversion = true:silent
+csharp_style_prefer_top_level_statements = true:silent
+csharp_style_prefer_primary_constructors = true:suggestion
+
+[*.{cs,vb}]
+dotnet_style_operator_placement_when_wrapping = beginning_of_line
+tab_width = 4
+indent_size = 4
+end_of_line = crlf
+dotnet_style_coalesce_expression = true:error
+dotnet_style_null_propagation = true:error
+dotnet_style_prefer_is_null_check_over_reference_equality_method = true:error
+dotnet_style_prefer_auto_properties = true:warning
+dotnet_style_object_initializer = true:error
+dotnet_style_prefer_collection_expression = true:suggestion
+dotnet_style_collection_initializer = true:error
+dotnet_style_prefer_simplified_boolean_expressions = true:warning
+dotnet_style_prefer_conditional_expression_over_assignment = true:error
+dotnet_style_prefer_conditional_expression_over_return = true:silent
+dotnet_style_explicit_tuple_names = true:error
+dotnet_style_prefer_inferred_tuple_names = true:error
+dotnet_style_prefer_inferred_anonymous_type_member_names = true:error
+dotnet_style_prefer_compound_assignment = true:error
+dotnet_style_prefer_simplified_interpolation = true:error

.gitattributes

@@ -0,0 +1 @@
+* text eol=crlf

.github/workflows/ci.yml

@@ -23,7 +23,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Run dotnet format
-        run: dotnet format Kentico.Xperience.RepoTemplate.sln --exclude ./examples/** --verify-no-changes
+        run: dotnet format Kentico.Xperience.Mjml.StarterKit.sln --exclude ./examples/** --verify-no-changes
 
   build_and_test:
     name: Build and Test

Directory.Build.props

@@ -6,11 +6,11 @@
     <Copyright>Copyright © $(Company) $([System.DateTime]::Now.Year)</Copyright>
     <Trademark>$(Company)™</Trademark>
     <VersionPrefix>1.0.0</VersionPrefix>
-    <VersionSuffix>prerelease-1</VersionSuffix>
+    <VersionSuffix>prerelease-3</VersionSuffix>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
 
-    <PackageProjectUrl>https://github.com/Kentico/REPOSITORY_NAME</PackageProjectUrl>
-    <PackageReleaseNotes>https://github.com/Kentico/REPOSITORY_NAME/releases</PackageReleaseNotes>
+    <PackageProjectUrl>https://github.com/Kentico/xperience-by-kentico-email-builder-starter-kit</PackageProjectUrl>
+    <PackageReleaseNotes>https://github.com/Kentico/xperience-by-kentico-email-builder-starter-kit/releases</PackageReleaseNotes>
     <PackageIcon>logo.png</PackageIcon>
     <PackageReadmeFile>README.md</PackageReadmeFile>
     <PackageTags>xperience;kentico;aspnetcore</PackageTags>

Directory.Packages.props

@@ -6,10 +6,12 @@
     <DisableImplicitNuGetFallbackFolder>true</DisableImplicitNuGetFallbackFolder>
   </PropertyGroup>
   <ItemGroup>
-    <PackageVersion Include="Kentico.Xperience.Admin" Version="29.6.0" />
-    <PackageVersion Include="Kentico.Xperience.WebApp" Version="29.6.0" />
-    <PackageVersion Include="kentico.xperience.azurestorage" Version="29.6.0" />
-    <PackageVersion Include="kentico.xperience.imageprocessing" Version="29.6.0" />
+    <PackageVersion Include="Kentico.Xperience.Admin" Version="30.4.0" />
+    <PackageVersion Include="Kentico.Xperience.WebApp" Version="30.4.0" />
+    <PackageVersion Include="kentico.xperience.azurestorage" Version="30.4.0" />
+    <PackageVersion Include="kentico.xperience.imageprocessing" Version="30.4.0" />
+	<PackageVersion Include="kentico.xperience.mjml" Version="30.4.0" />
     <PackageVersion Include="SonarAnalyzer.CSharp" Version="9.32.0.97167" />
+	<PackageVersion Include="Microsoft.AspNetCore.Components.Web" Version="8.0.14" />
   </ItemGroup>
 </Project>

Directory.build.targets

@@ -9,6 +9,5 @@
             <AssemblyToSign Include="$(XmlSerializersTargetPath)" Condition="Exists('$(XmlSerializersTargetPath)')" />
         </ItemGroup>
 
-        <Exec Command="dotnet AzureSignTool sign --azure-key-vault-url $(AuthenticodeKeyVaultUrl) --azure-key-vault-tenant-id $(AuthenticodeTenantId) --azure-key-vault-client-id $(AuthenticodeClientId) --azure-key-vault-client-secret $(AuthenticodeClientSecret) --azure-key-vault-certificate $(AuthenticodeCertificateName) --timestamp-rfc3161 $(TimestampServerUrl) --skip-signed %(AssemblyToSign.Identity)" />
     </Target>
 </Project>

Kentico.Xperience.Mjml.StarterKit.sln

@@ -1,7 +1,21 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.12.35728.132
+MinimumVisualStudioVersion = 10.0.40219.1
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Kentico.Xperience.Mjml.StarterKit.Rcl", "src\Kentico.Xperience.Mjml.StarterKit.Rcl\Kentico.Xperience.Mjml.StarterKit.Rcl.csproj", "{5BDAC64C-436F-475F-9650-B22DB74958F1}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "DancingGoat", "examples\DancingGoat\DancingGoat.csproj", "{A2326E6C-ECF8-4E8A-A499-0ED6A4E2203B}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{23EE9335-7EFE-4936-931F-5ED671605425}"
+	ProjectSection(SolutionItems) = preProject
+		.editorconfig = .editorconfig
+		Directory.Build.props = Directory.Build.props
+		Directory.build.targets = Directory.build.targets
+		Directory.Packages.props = Directory.Packages.props
+		global.json = global.json
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -12,5 +26,12 @@ Global
 		{5BDAC64C-436F-475F-9650-B22DB74958F1}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{5BDAC64C-436F-475F-9650-B22DB74958F1}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{5BDAC64C-436F-475F-9650-B22DB74958F1}.Release|Any CPU.Build.0 = Release|Any CPU
+		{A2326E6C-ECF8-4E8A-A499-0ED6A4E2203B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{A2326E6C-ECF8-4E8A-A499-0ED6A4E2203B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{A2326E6C-ECF8-4E8A-A499-0ED6A4E2203B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{A2326E6C-ECF8-4E8A-A499-0ED6A4E2203B}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
 	EndGlobalSection
 EndGlobal