Skip to content

Commit d878e40

Browse files
acoumbacoumb
committed
Package updates: logo, marketplace details, readme.
1 parent 563c058 commit d878e40

File tree

8 files changed

+149
-25
lines changed

8 files changed

+149
-25
lines changed

‎src/Umbraco.Cms.Integrations.Analytics.Cookiebot/Umbraco.Cms.Integrations.Analytics.Cookiebot.csproj

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
<Project Sdk="Microsoft.NET.Sdk.Razor">
2+
3+
<PropertyGroup>
4+
<AddRazorSupportForMvc>true</AddRazorSupportForMvc>
5+
<EnableDefaultContentItems>false</EnableDefaultContentItems>
6+
<TargetFramework>net6.0</TargetFramework>
7+
<ImplicitUsings>enable</ImplicitUsings>
8+
<Nullable>enable</Nullable>
9+
</PropertyGroup>
10+
11+
<PropertyGroup>
12+
<PackageId>Umbraco.Cms.Integrations.Analytics.Cookiebot</PackageId>
13+
<Title>Umbraco CMS Integrations: Analytics - Cookiebot</Title>
14+
<Description>An extension for Umbraco CMS providing an implementation model for Cookiebot banner and declaration.</Description>
15+
<PackageIconUrl></PackageIconUrl>
16+
<PackageProjectUrl>https://github.com/umbraco/Umbraco.Cms.Integrations/blob/main/src/Umbraco.Cms.Integrations.Script.Cookiebot</PackageProjectUrl>
17+
<RepositoryUrl>https://github.com/umbraco/Umbraco.Cms.Integrations</RepositoryUrl>
18+
<Version>1.0.0</Version>
19+
<Authors>Umbraco HQ</Authors>
20+
<Company>Umbraco</Company>
21+
<PackageTags>Umbraco;Umbraco-Marketplace</PackageTags>
22+
<PackageIcon>cookiebot.png</PackageIcon>
23+
</PropertyGroup>
24+
25+
<ItemGroup>
26+
<PackageReference Include="Umbraco.Cms.Web.Website" Version="10.0.0" />
27+
</ItemGroup>
28+
29+
<ItemGroup>
30+
<SupportedPlatform Include="browser" />
31+
</ItemGroup>
32+
33+
<ItemGroup>
34+
<Content Include="Views\**" />
35+
<Content Include="cookiebot.png">
36+
<Pack>true</Pack>
37+
<PackagePath>\</PackagePath>
38+
</Content>
39+
</ItemGroup>
40+
41+
</Project>

‎src/Umbraco.Cms.Integrations.Script.Cookiebot/Views/Partials/UmbracoCms.Integrations/Scripts/Cookiebot/Banner.cshtml renamed to ‎src/Umbraco.Cms.Integrations.Analytics.Cookiebot/Views/Partials/UmbracoCms.Integrations/Analytics/Cookiebot/Banner.cshtml

File renamed without changes.

‎src/Umbraco.Cms.Integrations.Script.Cookiebot/Views/Partials/UmbracoCms.Integrations/Scripts/Cookiebot/Declaration.cshtml renamed to ‎src/Umbraco.Cms.Integrations.Analytics.Cookiebot/Views/Partials/UmbracoCms.Integrations/Analytics/Cookiebot/Declaration.cshtml

File renamed without changes.

‎src/Umbraco.Cms.Integrations.Analytics.Cookiebot/cookiebot.png

4.19 KB
Loading

‎src/Umbraco.Cms.Integrations.Analytics.Cookiebot/readme.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# Umbraco.Cms.Integrations.Analytics.Cookiebot
2+
3+
This integration provides an implementation model for [Cookiebot](https://www.cookiebot.com/) banner and declaration.
4+
5+
## Prerequisites
6+
7+
Requires minimum versions of Umbraco CMS:
8+
- CMS: 10.0.0
9+
10+
## How To Use
11+
12+
### Configuration
13+
14+
The following configuration is required for the Cookiebot scripts to be loaded correctly:
15+
16+
```
17+
"Umbraco": {
18+
"Cookiebot": {
19+
"Settings": {
20+
"Id": "[YOUR_CBID]"
21+
}
22+
}
23+
}
24+
```
25+
`CBID` = `Cookiebot Identifier`
26+
27+
### Working with the Umbraco CMS - Cookiebot integration
28+
The package is a reusable [Razor class library](https://learn.microsoft.com/en-us/aspnet/core/razor-pages/?view=aspnetcore-6.0&tabs=visual-studio) which will allow editors to load the Cookiebot Banner and Declaration scripts.
29+
30+
Per Cookiebot documentation, the Banner script needs to be inserted as the __very first script__ of the website, by placing it in the _HEAD_ tag using this syntax:
31+
32+
`@await Html.PartialAsync("~/Views/Partials/UmbracoCms.Integrations/Analytics/Cookiebot/Banner.cshtml")`
33+
34+
The Declaration script can be added in whatever page you want, using this syntax:
35+
`@await Html.PartialAsync("~/Views/Partials/UmbracoCms.Integrations/Scripts/Cookiebot/Declaration.cshtml")`
36+
37+
Both scripts "pick up" the `CBID` from the website's settings file
38+
`Configuration["Umbraco:Cookiebot:Settings:Id"]`
39+
and update the details accordingly.
40+
41+
42+
### Custom implementations
43+
This integration showcases how easy it is to work with a script-based provider, just by using partial views and Microsoft's `IConfiguration` interface.
44+
45+
You can use this package as reference for creating your own. To do so, please follow these steps:
46+
- Create a new Razor class library for your integration
47+
- Add partial(s) view(s) where you insert your custom script code
48+
- Inject the `IConfiguration` interface into your view: `@inject Microsoft.Extensions.Configuration.IConfiguration Configuration`
49+
- Use `Configuration[YOUR_SETTINGS_PATH:KEY]` to retrieve the required configuration values
50+
- Add `umbraco-markertplace.json` file with Marketplace details of the package
51+
52+
53+
54+
55+

‎src/Umbraco.Cms.Integrations.Analytics.Cookiebot/umbraco-marketplace.json

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
{
2+
"AuthorDetails": {
3+
"Description": "Umbraco HQ",
4+
"Url": "https://umbraco.com/",
5+
"ImageUrl": "https://avatars.githubusercontent.com/u/1419552?s=200&v=4"
6+
},
7+
"Category": "Analytics & Insights",
8+
"LicenseType": "Free",
9+
"PackageType": "Integration",
10+
"PackagesByAuthor": [
11+
"Umbraco.Cms.Integrations.Commerce.CommerceTools",
12+
"Umbraco.Cms.Integrations.Commerce.Shopify",
13+
"Umbraco.Cms.Integrations.SEO.GoogleSearchConsole.URLInspectionTool",
14+
"Umbraco.Cms.Integrations.Crm.Hubspot",
15+
"Umbraco.Cms.Integrations.Crm.Dynamics",
16+
"Umbraco.Cms.Integrations.Crm.ActiveCampaign",
17+
"Umbraco.Cms.Integrations.Automation.Zapier"
18+
],
19+
"RelatedPackages": [
20+
{
21+
"PackageId": "Umbraco.Cms.Integrations.Commerce.CommerceTools",
22+
"Description": "A product and category picker that can be added as a property editor for content, with a value converter providing a strongly typed model for rendering."
23+
},
24+
{
25+
"PackageId": "Umbraco.Cms.Integrations.Commerce.Shopify",
26+
"Description": "A products picker that can be added as a property editor for content, with a value converter providing a strongly typed model for rendering."
27+
},
28+
{
29+
"PackageId": "Umbraco.Cms.Integrations.SEO.GoogleSearchConsole.URLInspectionTool",
30+
"Description": "A tool allowing programmatic access to URL-level data for properties managed in Google Search Console and the indexed version of a URL."
31+
},
32+
{
33+
"PackageId": "Umbraco.Cms.Integrations.Crm.Hubspot",
34+
"Description": "A form picker and rendering component for Hubspot forms."
35+
},
36+
{
37+
"PackageId": "Umbraco.Cms.Integrations.Crm.Dynamics",
38+
"Description": "A form picker and rendering component for Dynamics 365 Marketing forms."
39+
},
40+
{
41+
"PackageId": "Umbraco.Cms.Integrations.Crm.ActiveCampaign",
42+
"Description": "A form picker and rendering component for ActiveCampaign forms."
43+
},
44+
{
45+
"PackageId": "Umbraco.Cms.Integrations.Automation.Zapier",
46+
"Description": "A dashboard interface allowing users to vizualize registered subscription hooks for content types and to call Zapier triggers when content gets published."
47+
}
48+
],
49+
"Tags": [],
50+
"Title": "Cookiebot"
51+
}

‎src/Umbraco.Cms.Integrations.Script.Cookiebot/Umbraco.Cms.Integrations.Script.Cookiebot.csproj

Lines changed: 0 additions & 23 deletions
This file was deleted.

‎src/Umbraco.Cms.Integrations.sln

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -77,9 +77,9 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Umbraco.Cms.Integrations.PI
7777
EndProject
7878
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Umbraco.Cms.Integrations.Crm.ActiveCampaign.Core", "Umbraco.Cms.Integrations.Crm.ActiveCampaign.Core\Umbraco.Cms.Integrations.Crm.ActiveCampaign.Core.csproj", "{14303AD9-B64B-4DE1-AB4E-B0979277EAC2}"
7979
EndProject
80-
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "General", "General", "{54684516-D990-41C7-885E-96A064A55BB1}"
80+
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Analytics", "Analytics", "{54684516-D990-41C7-885E-96A064A55BB1}"
8181
EndProject
82-
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Umbraco.Cms.Integrations.Script.Cookiebot", "Umbraco.Cms.Integrations.Script.Cookiebot\Umbraco.Cms.Integrations.Script.Cookiebot.csproj", "{5CB587DB-D6AD-4AA9-A2FE-52976C5F66C3}"
82+
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Umbraco.Cms.Integrations.Analytics.Cookiebot", "Umbraco.Cms.Integrations.Analytics.Cookiebot\Umbraco.Cms.Integrations.Analytics.Cookiebot.csproj", "{5CB587DB-D6AD-4AA9-A2FE-52976C5F66C3}"
8383
EndProject
8484
Global
8585
GlobalSection(SolutionConfigurationPlatforms) = preSolution

0 commit comments

Comments
 (0)