Blog posts by Per Nergård2026-03-10T21:18:57.0000000Zhttps://world.optimizely.com/blogs/Per-Nergard/Optimizely WorldMissing Properties tool for Optimizely CMS<p>If you have been working with Optimizely CMS for a while you have probably accumulated some technical debt in your property definitions. When you refactor your models removing properties, renaming content types, or cleaning up after a migration the old property definitions often stick around in the database. They are harmless for the most part, but they add noise and can be confusing when inspecting content types.</p>
<p> I actually built a tool for this like 10 years ago and I recently had a need to revisit it during a large migration project where we ended up with quite a few orphaned properties that <br /> needed cleaning up.</p>
<p> <strong> What it does</strong></p>
<p> The tool scans all your code-defined content types (PageTypes and BlockTypes) and looks for property definitions in the database that no longer have a corresponding attribute in code. Manually created content types are intentionally skipped it only checks types backed by a C# model.</p>
<p> The results are grouped by content type so you can see exactly what is affected. From there you have a few options:</p>
<p> - Select individual properties and delete them<br /> - Select all properties for a specific content type<br /> - Delete everything at once</p>
<p> Both deletion paths require a confirmation dialog because this operation is permanent and cannot be undone.</p>
<p> There is also a Rescan button if you want to re-check after deploying model changes.</p>
<p> <strong>Installation<br /></strong><br /> Configure blazor and decide on how you want to render the component. I just created a content type specific for the tool. Example layout included on github.</p>
<p> Add the tool to your project and register it in Startup.cs:</p>
<p> services.AddMissingProperties();</p>
<p> <img src="/link/bbd1f90ab6bc4b6cacc86984dd1a48ea.aspx" alt="" width="1200" height="861" /></p>
<p> The source code is on <a href="https://github.com/PNergard/Nergard.MissingProperties">https://github.com/pernergard/NergardToolsAndUtilities</a></p>
<p> </p>2026-03-10T21:18:57.0000000ZBlog postResource Editor - A localization management tool for Optimizely CMS<div>If you have worked with Optimizely CMS for any amount of time you know that managing localization through XML files can be tedious. Content type names, property captions, tab names, editor hints - they all need translations, and keeping those XML files organized across multiple languages is not fun.</div>
<div> </div>
<div>I am a firm believer that translations should be owned by the partner and managed in source control. That said, I fully understand the need to fix localization quickly in a DXP environment without having to deploy code. The Resource Editor was built to handle both scenarios - edit and save to XML files during development, and apply runtime overrides via DDS (Dynamic Data Store) when you need a quick fix in production.</div>
<div> </div>
<div>This tool started as a smaller idea but grew quite a bit as I kept adding features. It is built with Blazor Server and MudBlazor, packaged as a Razor Class Library that you can reference in your Optimizely project.</div>
<div> </div>
<div>TL;DR: The Resource Editor is a Blazor-based admin tool for Optimizely CMS that replaces manual XML editing for localization. It provides visual editors for content type names, properties, tabs, display channels, editor hints, and frontend translations — all with multi-language support. Features include a completeness dashboard, runtime overrides via DDS (no deploy needed), DeepL-powered automated translation at field/item/bulk level, CSV import/export, and a guided migration from legacy XML formats. </div>
<div> </div>
<h2>Getting started</h2>
<div>
<div>The Resource Editor is distributed as a Razor Class Library. Add a project reference and register the services in your `Startup.cs`:<br /><br />
<pre class="language-csharp"><code>public void ConfigureServices(IServiceCollection services)
{
services.AddServerSideBlazor();
services.AddMudServices();
// Optional: Add DeepL translation (must be registered before AddResourceEditor)
services.AddDeepLTranslation(_configuration);
// Register Resource Editor services
services.AddResourceEditor(_configuration);
}</code></pre>
</div>
<div>
<div>Configuration is done through `appsettings.json`:</div>
<div> </div>
<div>
<pre class="language-csharp"><code>{
"ResourceEditor": {
"TranslationFolder": "Resources/Translations",
"EnableFileSaving": true,
"EnableOverrides": true,
"ShowOverridesUI": true,
"EnableAutomatedTranslation": true,
"DeepL": {
"ApiKey": "your-api-key",
"UseFreeApi": true
}
}
}</code></pre>
</div>
<div> </div>
<div> </div>
<div>
<div>
<div>Depending on how you want to render the tool you also need a CSHTML page to host the Blazor component. The tool runs as a full-page Blazor application without the standard Optimizely layout:</div>
<div> </div>
<div>
<pre class="language-html"><code>@using Nergard.ResourceEditor.Components
@using Microsoft.AspNetCore.Components.Web
@model PageViewModel<BlazorToolResourceEditor>
@{ Layout = null; }
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<base href="~/" />
<title>Resource Editor</title>
<link href="https://fonts.googleapis.com/css?family=Roboto:300,400,500,700&display=swap"
rel="stylesheet" />
<link href="_content/MudBlazor/MudBlazor.min.css" rel="stylesheet" />
<component type="typeof(HeadOutlet)" render-mode="Server" />
</head>
<body>
@Html.AntiForgeryToken()
<component type="typeof(ResourceEditorHost)"
render-mode="Server"
param-IsDarkMode="false" />
<script src="_framework/blazor.server.js"></script>
<script src="_content/MudBlazor/MudBlazor.min.js"></script>
</body>
</html></code></pre>
</div>
</div>
</div>
<div> </div>
<div>
<div>Create a page type in Optimizely, set up a controller and view, and you are good to go.</div>
<div> </div>
<h2>Dashboard</h2>
<div>
<div>When you open the Resource Editor you land on the dashboard. It gives you an overview of translation completeness across all your configured languages. Each language card shows progress for content types, properties and tabs so you can quickly see where translations are missing.</div>
<div> </div>
<div>
<div>
<div>The dashboard also shows your view/frontend translation files with their own completion status.</div>
<div> </div>
</div>
<div>
<div>Clicking a language card takes you directly to the Language Overview for that language. More on that further down in the post.</div>
<div> </div>
<div><img src="/link/705a63ef3c6c42adaa31b3bd0fc1efa1.aspx" alt="" width="1200" height="651" /></div>
<div> </div>
<h2>Content type editor</h2>
<div>
<div>This is where you probably will spend most of your time. The editor lets you manage translations for all your content types, organized in three sections: Pages, Blocks and Media.</div>
<div> </div>
<div>
<div>For each content type you can edit the name and description across all languages. Expand a content type and you get access to all its properties where you can edit both the caption (label) and help text.</div>
<div> </div>
<div>
<div>The editor detects shared properties - properties that exist on multiple content types - and highlights them. This is useful because shared properties in Optimizely use a fallback mechanism through `icontentdata`, so changing a shared property translation can affect multiple content types. The base type in the saved xml-files will be icontentdata since I believe that same named properties should be consistent throughout the solution.</div>
<div> </div>
<div>
<div>You can filter by language if you only want to focus on one language at a time. The tool has support for automatic translations but not for the master language which must be managed manually.</div>
<div> </div>
<div><img src="/link/8e91301e30924d8ebdc05c1594c4c79e.aspx" alt="" width="1200" height="500" /></div>
<h2><strong>Tab editor</strong></h2>
<div>
<div>The Tab Editor handles localization of property group names (tabs). These are the tab labels editors see in the content editing UI.</div>
<div> </div>
<div>
<div>It works the same way as the content type editor - select a tab, edit the name across all configured languages, save.</div>
<div> </div>
<div><img src="/link/1cbb177b94214c149fb719ed71fb2e4b.aspx" alt="" width="1200" height="455" /></div>
<div> </div>
<div>
<h2>Display Channels and Editor Hints</h2>
<div>
<div>Two smaller editors handle display channel names and editor hint names. Same pattern - select an item, edit translations, save. These are less commonly needed but nice to have covered.</div>
<div> </div>
<div><img src="/link/69a222d0653144c88840df08ccdf1abf.aspx" alt="" width="1200" height="484" /></div>
<div> </div>
<div>
<h2><strong>View / Frontend Translations</strong></h2>
<div>
<div>The Resource Editor also handles view translation files. </div>
<div> </div>
<div>
<div>These files use a multi-language format where all languages are in a single XML file. The editor presents them as a navigable tree structure where you can edit values per language, add new sections and add new keys.</div>
<div> </div>
<div>
<div>The file pattern is configurable via the `ViewFilePattern` option (defaults to `views_*.xml`).</div>
<div> </div>
<div><img src="/link/2f9b109aeadc43d8a6714fe984a2205a.aspx" alt="" width="1200" height="477" /></div>
<div> </div>
<h2>Language overview</h2>
<div>
<div>The Language Overview gives you a focused view of a single language. It shows all content types and their properties with translation status indicators so you can work through missing translations systematically.</div>
<div> </div>
<div>
<div>This is also where the bulk translate button lives - translate all incomplete fields for a language in one click.</div>
<div> </div>
<div>Note! The automatic translations are only for the non master languages. So put in the effort for good localization texts for the master language you can reap the benefits for the other languages.</div>
<div> </div>
<div><img src="/link/5dcdfcb88976474ab7071cc50d8ba0c1.aspx" alt="" width="1200" height="557" /></div>
<div> </div>
<h2>Overrides</h2>
<div>
<div>This is the feature that makes the Resource Editor work well in DXP environments. Overrides are stored in the Dynamic Data Store and take precedence over XML translations at runtime - no deployment needed.</div>
<div> </div>
<div>
<div>The override system works through a custom `LocalizationProvider` that is automatically registered at position 0 in the provider chain. When Optimizely resolves a localization key, the override provider checks DDS first. If no override exists, it falls through to the standard XML-based providers.</div>
<div> </div>
<div>
<div><em>**Known issue:** There is currently a known issue where overridden content type captions (names) may not be picked up correctly by Optimizely, while help text overrides work as expected. I have an ongoing support ticket with Optimizely for investigation.</em></div>
<div> </div>
<h3>Inline overrides</h3>
<div>
<div>When `ShowOverridesUI` is enabled, every text field in the editors gets a small override button. Click it and you can create an override for that specific field and language. The override is stored in DDS and takes effect immediately.</div>
<div> </div>
<div><img src="/link/cace30955a8f4c108bb4b53060c428f5.aspx" alt="" width="1200" height="479" /></div>
<div>
<div> </div>
</div>
<h3>Override manager</h3>
<div>- View all active overrides with language and value</div>
<div>- Filter by language and search by property name</div>
<div>- Add, edit and delete individual overrides</div>
<div>- **Export to CSV** for documentation or backup</div>
<div>- **Import from CSV** for bulk operations</div>
<div>- **Save to XML** to migrate an override into a permanent translation file</div>
<div>- Clear all overrides</div>
<div> </div>
<div><img src="/link/102e96bc602444a39dbeff5f6b6800ab.aspx" alt="" width="1200" height="435" /></div>
<div> </div>
<h2>Automated translations with DeepL</h2>
<div>
<div>
<div>If you enable automated translation and register the DeepL service, the Resource Editor gives you translation assistance at three levels:</div>
<div> </div>
<div>
<div>
<div>1. **Field level** - Each text field gets a translate button that translates from the default language</div>
<div>2. **Item level** - A "Translate Missing" button in each editor header translates all empty fields for the current item</div>
<div>3. **Bulk level** - In the Language Overview, translate all incomplete fields for an entire language</div>
<div> </div>
<div>
<div>
<div>The translations populate the fields but are not saved automatically - you review and save when you are happy with the results.</div>
<div> </div>
<div>
<div>
<div>To enable it, signup for the free tier of DeepL and then register the DeepL service before the Resource Editor:</div>
<div>
<pre class="language-csharp"><code>services.AddDeepLTranslation(_configuration);
services.AddResourceEditor(_configuration);</code></pre>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<div> </div>
<div>
<div>
<div>The translation service is pluggable. If you want to use a different provider than DeepL, implement `ITranslationService` and register it before calling `AddResourceEditor()`.</div>
<div> </div>
<div><img src="/link/e26f1f3099774d7faa4a1046fe6a6c14.aspx" alt="" width="1200" height="281" /></div>
<div> </div>
<div>
<div>
<h2>XML Migration</h2>
<div>
<div>If you have an existing site with translations in the classic Alloy XML format (separate files like `ContentTypeNames.xml`, `PropertyNames.xml`, `GroupNames.xml`), the Resource Editor detects this automatically and offers a guided migration to its own format. The migration runs step by step with progress tracking and error reporting.</div>
<div> </div>
<div><img src="/link/9a7c8780c3824bd6a8933176e7e5e6cc.aspx" alt="" width="818" height="654" /></div>
<div> </div>
<h2>Configuration options</h2>
<div>
<div>Here is a quick overview of all the configuration options:</div>
<div> </div>
<div>
<pre class="language-csharp"><code>| Option | Default | Description |
|--------|---------|-------------|
| `TranslationFolder` | `Resources/Translations` | Path to translation XML files |
| `EnableFileSaving` | `true` | Allow saving to XML files. Set to `false` on DXP |
| `EnableOverrides` | `true` | Enable DDS-based runtime overrides |
| `ShowOverridesUI` | `true` | Show inline override buttons in editors |
| `EnableAutomatedTranslation` | `false` | Enable automated translation features |
| `ViewFilePattern` | `views_*.xml` | Glob pattern for view translation files |</code></pre>
</div>
</div>
</div>
</div>
</div>
<div> </div>
<div>
<div>
<div>A typical DXP configuration would look like this:</div>
<div> </div>
<div>
<pre class="language-csharp"><code>{
"ResourceEditor": {
"EnableFileSaving": false,
"EnableOverrides": true,
"ShowOverridesUI": true
}
}</code></pre>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<div>
<h2>Source code and license</h2>
<div>
<div>The full source code is available on GitHub: <a href="https://github.com/PNergard/Resource-Editor">Resource Editor GitHub</a></div>
<div> </div>
<div>
<div>This tool grew organically and while I have been testing it using a Alloy demo template, I would still recommend using it with some care - especially the save operations. Back up your XML files before making large changes. I am happy to receive feedback, bug reports and pull requests.<br /><br /><br /></div>
<div> </div>
<div> </div>
</div>
</div>
<p> </p>
</div>
<div> </div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<div> </div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<div> </div>
</div>
</div>2026-02-23T06:58:46.0000000ZBlog postScheduled job for deleting content types and all related content<p>In my previous blog post which was about getting an overview of your sites content <a href="/link/e89ad1059bc047499d1ed92fe36b1726.aspx">https://world.optimizely.com/blogs/Per-Nergard/Dates/2026/1/scheduledjob-for-getting-overview-of-site-content-usage/</a>.<br /><br />I actually found a couple of content types that was related to decomission functionality that actually hade quite a lot of created content. So what to do? ContentTypeObliteratorScheduledJob to the rescue.<br /><br />It's very simple:</p>
<ol>
<li>Get the contenttype ids you want to remove all content for and deleting the actual content type as well.</li>
<li>Take a database backup</li>
<li>Add the contenttype ids into a comma separated list</li>
<li>Run the job and enjoy less code and a less bloated content tree.<br /><br /></li>
</ol>
<p>I have only done a test run on one content type but for that it worked. </p>
<p>Link to my Gist: <a title="Gist link to the ContenttypeObliteratorScheduledJob" href="https://gist.github.com/PNergard/818677955ae0e2c933f30a3186e0fe37">ContentTypeObliteratorScheduledJob</a>.</p>2026-01-30T13:09:03.0000000ZBlog postScheduledJob for getting overview of site content usage<p>In one of my current project which we are going to upgrade from Optimizely 11 I needed to get an overview of the content and which content types we have, are some unused etc.</p>
<p>In order to do that I did a scheduled job that will go through the sites content types, check for usage and if a content type id is specified render links to edit mode for all content instances for that type.</p>
<p>Everything is wrapped up into a CSV file that are easily imported into excell for easy filtering and send that as an attached file via SMTP.<br /><br />In the code you can change sender, recipients and after an initial run and you also want to get the links to the content instances for one or more content types that can be set as well.<br /><br />The collumns you get is the following:<br /><br /><img src="/link/2d7cd960b8a64d3b87e165ef09d482bd.aspx" alt="" width="1731" height="36" /></p>
<p>I expected some content types with zero content instances but to my suprise the number was bigger than I expected.<br /><br />Nothing advanced but a simple way to identify content types that could be removed or find all instances of a content type that you might be able to remove after you actually check the content.<br /><br />You can find the content over at my gist. <a title="Link to tool gist" href="https://gist.github.com/PNergard/f3e2e363bbee0e9c1781348de1550b8a">ScheduledJob content usage Gist</a></p>2026-01-27T22:47:29.0000000ZBlog postScheduledJob overview Blazor component<p>I have always felt that the admin UI for scheduled jobs in Optimizely is harder to use than it needs to be. To check a job you have to go into admin, filter to find the right job, click to see the history, and then click again to view status messages. When you are troubleshooting, this quickly becomes frustrating.</p>
<p>Back in 2017 I tried to improve this by creating a small plugin for viewing scheduled job run history. I wrote about it here:<br /><a class="decorated-link" href="/link/1bd5f39a76cf4152b8bd1054b27f99e9.aspx">https://world.optimizely.com/blogs/Per-Nergard/Dates/2017/9/plugin-for-viewing-scheduled-job-run-history/</a></p>
<p>During the Christmas break I decided to revisit the idea. The result is a Blazor component that gives a better overview of scheduled jobs and their status messages, with fewer clicks and faster access to the information you usually care about. I am using MudBlazor for UI components. It's a Razor Class Library so you need to configure Blazor in you CMS solution and see that the MudBlazor css and js are loaded. </p>
<p>The component includes:</p>
<ul>
<li>
<p>Separate tabs for custom jobs and built-in jobs, since custom jobs are often the ones causing issues</p>
</li>
<li>
<p>Filtering on job names</p>
</li>
<li>
<p>Direct access to the latest run and status message when selecting a job</p>
</li>
<li>
<p>A list view of up to 1000 status message excerpts with keyword filtering</p>
</li>
<li>
<p>Drill-down into a specific status message with additional filtering</p>
</li>
</ul>
<p>Image 1: Overview of the component.<br /><img src="/link/6e9aa90e7cdb4d389a044d29889ae04a.aspx" alt="" width="1242" height="418" /></p>
<p>Image 2: A selected job showing all status messages.</p>
<p><img src="/link/61d90647a4e04383ab98a2c5cf4c4181.aspx" alt="" width="1248" height="565" /></p>
<p>Image 3: Drill-down view of a single status message with filtering.<br /><br /></p>
<p><img src="/link/91173c34077645e6ac19714cc1eca483.aspx" alt="" width="1255" height="565" /></p>
<p>The full source code is available in a public GitHub repository:</p>
<p>https://github.com/PNergard/ScheduledJob-overview-Blazor-component</p>2026-01-15T15:21:39.0000000ZBlog postPageCriteriaQueryService builder with Blazor and MudBlazor<p>This might be a stupid idea but my new years resolution was to do / test more stuff so here goes. This razor component allows users to build and execute queries against your CMS site, providing a semi user-friendly interface for searching for pages based on content type, properties.<br /><br />You do need to have knowledge about your content types and the data but the thought is that when the need arises to identify what pages / how many pages you have with a certain combination of data you should be able to find those without any coding. If the results are not that many maybe manually editing them and adjusting what is needed is enough. If the number is to high or more complex changes needs to be performed a action-button can be added to do the work instead of possible doing a scheduled job or something.<br /><br />You can find the code over at my <a href="https://gist.github.com/PNergard/31e8ab4ad39ddb2bfc123fc4d540ad64">Gist</a>.</p>
<p><strong>Criteria:</strong><br />So you can create criteria parameters based on content type , propertes and condition and make them required or not. Required parameters will be shown in green.<br /><br /><strong>Search:</strong><br />When youre happy with your criterias you select a startnode (Root or any of the defined sites) and hit search. If you are not happy with the results you can delete individual parameters or all.<br /><br /><strong>Results:</strong><br />Simple list with a link to edit mode for each content that opens in a new tab.<br /><br /><strong>Actions:</strong><br />I actually haven't implemented any actions. But the idea is that it's easy to add any action need to perform actions on the search result.<br /><br /><br /></p>
<p><strong>Looks like this:</strong></p>
<p><strong><img src="/link/fd7c2b688d67403eba3c505ce978a8dd.aspx" alt="" width="1018" height="449" /></strong></p>2025-02-10T09:59:23.0000000ZBlog postContent statistics Blazor component<p>Another week and another MudBlazor component to explore. I wanted to test the charts components so I created a small Blazor component that displays som charts based on information we can get from the pages of a site.</p>
<ul>
<li>How many pages are created / updated on a monthly basis</li>
<li>Whats the most used content type</li>
<li>When are pages created during the day</li>
<li>When are pages being updated during the day</li>
<li>Who is the most productive content creator</li>
</ul>
<p>Not life changing stuff but could be a bit fun to get an overview. Code over at my <a href="https://gist.github.com/PNergard/85b2417ecf3b64c069623b340edae10a">Gist</a>.<br /><br />Looks like this in a Alloy solution:<br /><br /><img src="/link/f0dedefc578a476eb6aea1a73faa58f1.aspx" alt="" width="609" height="303" /></p>
<p> </p>2025-01-28T13:54:43.0000000ZBlog postFind and delete non used media and blocks<p>On my new quest to play around with Blazor and MudBlazor I'm going back memory lane and porting some previously plugins. So this time up is my plugin for finding non used images in the global assets folder and you can read the old blog post from 2017 over <a href="/link/127945d0edab4aa2aeafde6581e907e6.aspx">here</a>.</p>
<p>I decided I wanted to update it a bit so it could look for blocks as well. It's not that much to tell about it but you can choose if you want to look for media and / or blocks and look for orphans and then optionally delete selected or all.</p>
<p>You can grab the code over at my <a href="https://gist.github.com/PNergard/704913111bed24b6a9fdc11fe18f4567">Gist.</a></p>
<p>I have in my tests used the component in a page type I have setup for Blazor testing but if you want to have it as a plugin have a look at Ove Lartelius excellent post about how to run you components in different areas of the Optimizely UI <a href="https://www.epinova.se/en/blog/2024/use-blazor-components-in-optimizely-cms-adminedit-interface/">here</a>.</p>
<p>And it looks like this</p>
<p><img src="/link/1185ebe3f615426cb749edf4a98b8432.aspx" alt="" width="878" height="490" /></p>2025-01-21T07:43:26.0000000ZBlog postOrder tabs with drag and drop - Blazor<p>I have started to play around a little with Blazor and the best way to learn is to reimplement some old stuff for CMS12.</p>
<p>So I took a look at my old blog posts and decided to redo my plugin for drag and drop sorting of tabs since I still don't like that using the [GroupDefinition] attribute forces you do manage the index order in code. <a href="/link/5a6818bd02074b9ea8473dd0ef5711f3.aspx">Old blog post here.</a></p>
<p>My thought with this Blazor component is to have a tools content type with it's own layout which is only for tools and stuff done with Blazor. If feels easier than doing menuproviders or plugins in admin mode.</p>
<p>It's very simple, just a list of the tabs which you can reorder with drang and drop and then save or reset (only currently unsaved order). In the example it's wrapped into another component for a header and navigation but it's not included in the component.</p>
<p>You can find the code and a small readme over at my<a href="https://gist.github.com/PNergard/865a402c0fb41fdc04bac8f67e79e66f"> Gist</a>.</p>
<p><img src="/link/4537b6d723bf4814870f44eb822bab25.aspx" alt="" width="738" height="493" /></p>
<p> </p>
<p> </p>2025-01-14T12:56:20.0000000ZBlog postImageFile alt-description validation attribute<p>A customer wanted to improve their quality of having meta descriptive texts on all their published images but it was ok that it could take some time to get it into place (they are forced to review and republish pages on a regular basis) so thought that a validation attribute would do the trick.<br /><br />I vaguely remebered that I did something like this a long time a go which I had (<a href="/link/0c07f80212834b7ab46f0180ee181c8c.aspx">nov 2015</a>) but that didn't handle images added in Xhtml-properties which was needed in this case. I found a solution that had solved a similiar problem but did handle it on actual rendering which used HtmlAgilitypack to handle the check for xthml-editors.<br /><br />So I updated my validation attribute and I have published it as a Gist. <a href="https://gist.github.com/PNergard/d0accbbc46cc756b04c309257b69c902">ImageValidatorGis</a>t.<br /><br />The validation attribute checks contentreference, ContentArea and XhtmlEditor properties for images and check if they have a description property with value and if not returns an error. Since a image-file added to a XhtmlEditor gets the filename name as alt-text we need to compare the alt-text to the file-name and if equal we interpret that as not set even if the image file it self might have a descripton set.<br /><br /><br /><br /><br /></p>2025-01-07T14:13:03.0000000ZBlog postDeveloper meetup i Göteborg<p>Knowit och Episervers meetup i Malmö var en succé så nu kör vi den även i Göteborg den 3e mars. Så om man är intresserad av att höra mer om vad som är på gång inom .Net core eller lära sig mer om Episervers nya referens arkitektur "Foundation" ska man genast klicka sig vidare till meetup sidan och anmäla sig. Kan ni inte gå just detta tillfälle passa på att gå med i gruppen så att ni inte missar kommande events!</p>
<p><a href="https://www.meetup.com/EPiServer-utvecklare-Goteborg/events/268705786/">https://www.meetup.com/EPiServer-utvecklare-Goteborg/events/268705786/</a></p>
2020-02-14T14:14:42.0000000ZBlog postDeveloper meetup in Malmö<p>After a long slumber in the Episerver Developers Öresund group Knowit and Episerver is kicking off 2020 with a developer meetup in Malmö february 6.</p>
<p>Episerver .Net Core and the new reference project Episerver Foundation is the topics of the evening.</p>
<p>So if you are in the Öresund area come and join us.</p>
<p>See below link to sign up!</p>
<p><a href="https://www.meetup.com/EPiServer-utvecklare-Oresund/events/267933749/">https://www.meetup.com/EPiServer-utvecklare-Oresund/events/267933749/</a></p>2020-01-27T12:45:35.0000000ZBlog postUse a page type as a scheduledjob<p>Scheduledjobs have evolved a bit over the years but they still lack a nice way to have input parameters. If you don't hard code everything I see the following alternatives.</p>
<ul>
<li>Appsettings<br />Works but can only be done by a developer with access to the server environment. Causes a restart of the website.<br /><br /></li>
<li>Properties on a page<br />I really like using a builtuin way to get a nice editorial experience when setting parameters. But having to view logs / status in admin mode and change settings in edit mode feels a bit disconnected. And I think that admin-mode access for non developers should be kept to an absolute minimum.<br /><br /></li>
<li>Extending the builtin views in admin mode<br />Mathias Kunto did a nice implemantation where you can extend the builtin views with the help of control adapters. You can read his blog post <a href="https://blog.mathiaskunto.com/2014/03/21/scheduled-jobs-with-input-parameters-in-episerver-7-5/">here</a>.</li>
</ul>
<p>So hardcoding and using appsettings is out of questions but I really like using builtin editorial features for a smooth experience but mixing edit and admin mode together makes is hard to understand. Mathias way is for sure the most "integrated" way of doing it, but is in admin mode which is still in webforms and for some jobs I would like a more granular control over who can handle specific jobs without giving access to everything in admin mode.</p>
<p>So here is a proof of concept of the solution I came up with: A page type that after initial publish it automatically sets it self for scheduled publishing according to the preffered interval and all work is done during the publishing event.</p>
<p>To get everything up and running we need a specific page type which have all the settings we want and the model will contain all code that do the actual scheduledwork and handling logging. We also need an initalizationmodule hooking up to the PublishingContent and PublishedContent events. And of course the schedulejob handling future publishing of content must be up and running.</p>
<p>The page type is lika any normal page type but it contains one method that will perform all work and log a status message to a IList property:</p>
<pre class="language-csharp"><code>public void DoTheMagic()
{
if (this.HistoryLog == null) this.HistoryLog = new List<Log>();
var message = new Log
{
Date = DateTime.Now.ToString(),
Message = "We did som magic!",
ExecutedBy = "The logged in user"
};
this.HistoryLog.Add(message);
}</code></pre>
<p>In the initaliziationmodule PublishingContent event if the content is of the correct type we call the DoTheMagic method. We need to do it in the publishing event because we are creating a log message and adds it to the logging IList property and we need to have the object in a writable state.</p>
<pre class="language-csharp"><code>private void ToolPageInitializationModule1_PublishingContent(object sender, EPiServer.ContentEventArgs e)
{
var page = e.Content as ToolPage;
if (page != null)
{
page.DoTheMagic();
}
}</code></pre>
<p>To hande setting the new scheduled publish date we need to to it in the PublishedContent event. Trying to change the date in the same event as the DoTheMagic don't work.</p>
<pre class="language-csharp"><code>private void ToolPageInitializationModule1_PublishedContent(object sender, ContentEventArgs e)
{
var page = e.Content as ToolPage;
var writable = page.CreateWritableClone() as ToolPage;
if (page != null)
{
if (page.Interval == "Minute")
{
var date = writable.StartTime = page.StartTime.AddMinutes(page.IntervalValue);
writable.StartPublish = date;
ServiceLocator.Current.GetInstance<IContentRepository>().Save(writable, SaveAction.CheckIn | SaveAction.Schedule, EPiServer.Security.AccessLevel.NoAccess);
}
}
}</code></pre>
<p>So in the editorial interface it looks like this:</p>
<p><img src="/link/fc72859129bc49a4ae9a90764f2feb2e.aspx" /></p>
<p><img src="/link/ae02845bb3474216b1e6f1ef7b62b407.aspx" /></p>
<p>So this is only a simple proof of concept but it does what I set up to do so at this stage Im happy :)</p>2020-01-21T09:55:36.0000000ZBlog postFind and delete content based on type<p>Another blog post and another admin mode plugin..</p>
<p>From time to time I have had the need to delete content for specific types. It could be a cleanup case before using a dev database as UAT or maybe we wan't to discard some content type.</p>
<p>In general content of a specific types tend to be all over the place especially with images and blocks so this can be a tedious process. So I whipped together a small admin mode plugin that lets you select a type and get a list of all content-instances and lets you delete all or selected instances of that type. Nothing fancy but it does it't job.</p>
<p>You can find the code over at my <a href="https://gist.github.com/PNergard/8a1037dcea6918dfc558676bded4e7b9">Gist</a> and it looks lite this.</p>
<p><img src="/link/def33cea04e64ea2add53e51da715fb8.aspx" /></p>2019-06-17T15:47:46.0000000ZBlog postEpiserver CMS 11 certification - tips and comments<p>This week it what that time again where I needed to renew my Episerver CMS certificate. So here is a post with some thoughts, comments and tips that hopefully is to some use for others preparing for the exam.</p>
<p>A lot of things have happened in the Episerver world the last couple of years both with the CMS and other products and not least going into the cloud with the DXC.I think this is reflected in the exam. You really need to have a broad knowledge about Episerver both from a developer perspective but also general product knowledge and editorial skills sprinkled with some Find and DXC to pass the exam.</p>
<p>I've been working with Episerver for a long time (maybe too long) and I'm certified in all versions since CMS 5, and although I try to keep myself updated my professional career has drifted away to doing other stuff than coding so I thought that some reading in the development guide probably was a good idea.</p>
<p>I was pleasently suprised that the <a href="/link/f3882e248540406fa3bc4a6858a3b244.aspx">development guide</a> has been updated and include more code examples than before.Also a big improvement is that new features now are clearly marked from which version that feature is available which is great for seasoned developers that really only need to brush up their knowledge on new stuff. The new improved looks on world also really made reading more easy on the eyes.</p>
<p>I'd say that the development guide is the main place to go for information but the <a href="/link/3aa770bc7f0044fb9175c18048c0d2e7.aspx">user guide</a> is a great place to gain knowledge about ie personalization of blocks, and you can learn som useful stuff around environments, deployment, optional extras and service and health continuity in the <a href="https://www.episerver.com/services/descriptions/episerver-dxc-service-description/">DXC service description</a>. And if you haven' used Episerver Find it can be well spent time to play around with how to do searches using different Find features like best bets, stemming, filtering etc. And don't forget to use the Visual Studio extension creating an Alloy sample project and have a look in the code and maybe try out some of the newer features like projects and notifications.</p>
<p>It's alot of material to read through but if you have the time I would really recomend going through it all since the documentation is quite good and even super experienced Episerver proffessionals will learn something new.</p>
<p>Anders G Nordbys <a href="https://andersnordby.wordpress.com/2018/01/09/knowledge-areas-for-the-episerver-cms-certification/">blog post</a> from 2018 is still a very good writeup with general information and hints. </p>
<p>So with this post and Anders blog posts, in combination with putting in some effort I'm sure that pass you will pass the exam.</p>
<p>Oh and the exam I took was for CMS version 11.</p>
<p>Happy certification!</p>2019-04-13T14:44:20.0000000ZBlog postAllowedTypes for LinkItem collection<p>The other day I heard a discussion about a possible requirement for only allowing specific pages in a LinkItem collection. My first thought was to use a ContentArea property in combination with the AllowedTypes attribute but for some reason the possiblity to have external links was needed.</p>
<p>I googled a bit but I only found a post where a custom validation class handled validation of max number of items in a LinkItemCollection, you can read Allan Thraens blog post <a href="/link/e7723a75c6a24c6a8c5b952386265817.aspx">here</a>.</p>
<p>It seemed like a clean and simple approach so I decided to do a variant that is similiar to AllowedTypes for ContentArea and ContentReference properties.</p>
<p>My solution is a simple validation attribute that takes an array of types that should be allowed to add to a LinkItemCollection property. The attribute ignores linkitems that are not Episerver content.If an Epierver content (page,image) is added to the LinkItemCollection and the underlying type is not inte the allowed types array a error message is displayed and publishing of the page is blocked.</p>
<p>You can find the coder over at my <a href="https://gist.github.com/PNergard/7df2636b45753a5b9a654447cf64461a">gist</a>.</p>2019-04-02T17:29:30.0000000ZBlog postAutomatically create pages for ContentReference properties<p>If you like me have tried to take an existing solution but wanted to start from scratch, maybe for a demo and you just gave up due to the amount of required properties on for example a settings page? Most of them are probably strings and ints that should be pretty easy to fix (or really should have had good defaults). But what about those pesky properties of type ContentReference which excpects a page of a certain type? And I bet those new pages have more pesky required properties as well! Gaah my blood pressure!</p>
<p>So to come closer to my (pipe?) dream of super easy site site setup even from scratch and using a "mature" solution that has developed over some years I decided to go with an attribute and initmodule approach.</p>
<p>Ok so the attribute is very simple it just takes one parameter with the type we want to get automatically created. So in my example here I have three page types: A startpage that needs a reference to a settingspage which have two references to a searchpage and a newsarchivepage.</p>
<p>So my page type looks like this (RequiredDependec is my custom attribute)</p>
<p><code> [RequiredDependency(typeof(Settings))]<br /> [AllowedTypes(typeof(Settings))]<br /> public virtual ContentReference SettingsPage {get; set;}</code></p>
<p>The settingspage looks like this:</p>
<p><code></code></p>
<p><code> [RequiredDependency(typeof(NewsArchive))]</code><br /><code> public virtual ContentReference NewsArchive { get; set; }</code></p>
<p><code></code></p>
<p><code> [RequiredDependency(typeof(ContactCards))]</code><br /><code> public virtual ContentReference ContactCards { get; set; }</code></p>
<p>To fix the automagic creating and setting or properties I did a initmodule that on the onpublish event scans the underlying type with reflection for properties decorated with the new attribute, creates a new page of that type and sets the property to that reference. The created pages are not automatically published since I name them "Automatically created - <pagetypename>" so I guess atleast the name should be changed before they are published. The new pages are created below the ContentReference.StartPage so the startpage need to be created and a site and start page needs to be configured in admin mode.</p>
<p>Ok so what does it look like:</p>
<p><strong>Here we have a unpublished startpage</strong></p>
<p><img src="/link/ceb6e48cd10844ff8d49f30e7d835939.aspx" /></p>
<p>
<p>
<p><strong>Here we have the automatically created settingspage</strong></p>
<p><img src="/link/20c9e74d5de941c9bfe2681681983b1c.aspx" /></p>
<p>
<p><img src="/link/8ba9a5de715044929895224bbb7439ab.aspx" /></p>
<p>
<p><strong>After publishing the settingspage we have a newsarchive and searchpage created</strong></p>
<p><img src="/link/5190bbc3968345be88f1ef2aba4d4c13.aspx" /></p>
<p>The code is what it is and you use it at your own risk but you can find a complete project over at my Pnergard <a href="https://github.com/PNergard/AutoCreateDependency">GitHub</a>. </p>
<p><code></code></p>
<p><code></code></p></p></p></p></p>2019-02-24T10:56:22.0000000ZBlog postWarning before deleting a page that is used in a property decorated with a SelectOne or SelectMany attribute<p>Long title and I hope it made some sense.</p>
<p>The case is that it's quite common that the underlying data for SelectionFactories which is then used with SelectOne and SelectMany attributes is normal Episerver pages. For example this is used to handle contact-cards in the Alloy site.</p>
<p>But since it's pages there is always a risk that someone by mistake deletes such a page causing problems. We would really like to have Episervers built in is this page used somewhere check.</p>
<p>The fix for a SelectOne attribute is as easy as having the underlying property to be of type ContentReference instead of a string. But if you have a SelectMany the underlying property needs to be a string and the chosen values is just added as a comma separated string.</p>
<p>To fix this for SelectMany I have created a custom attribute and a validation attribute class. When you add a SelectMany attribute where the SelectionFactory returns ContentReferences as id's you also add the new custom attribute which specifies an IList<ContentReference> property. The validation attribute then adds / removes references to the IList property automatically. With this when we try to delete a referenced page we get the builtin reference check functionality.</p>
<p><strong>Pseudo code:</strong></p>
<p>SelectMany(typeof(factoryclass))<br />SelectManyListProperty("ListPropertyName")<br />public virtual string SelectManyProp { get; set; }</p>
<p>public virtual IList ListPropertyName {get; set;}</p>
<p><strong>Before</strong></p>
<p><img src="/link/744223f60a83448f8f45485b136a6dc7.aspx" /></p>
<p><strong>After</strong></p>
<p><img src="/link/b85e3e6027c4481081a50e69849ca8e6.aspx" /></p>
<p>Note that the ContentReference property isn't updated until page is published (values are there) and ofcourse it should be hidden under an other tab or atleast disabled for editors.</p>
<p><a href="https://gist.github.com/PNergard/41d38a7daeb0c92845454d55c630f6f3">Code over at my Gist.</a></p>2019-02-19T16:02:14.0000000ZBlog postPlugin for viewing / filtering wastebasket content and delete single content items<!DOCTYPE html>
<html>
<head>
</head>
<body>
<p>From time to time we have the need to delete single content from the waste basket in Episerver. Saddly there is no built in support for this. A year ago <a href="https://gregwiechec.com/2016/06/deleting-single-file-from-trash/">Grzegorz modified</a> the built in waste basket. It's great but I wanted to see some more information about the content and doing a Dojo solution is out of my comfort zone I decided to create yet another admin mode plugin.</p>
<p>It's very simple and uses datatables.js for search / filtering functionality. You can delete all or selected items. See below for what it looks like. Code over at my <a href="https://gist.github.com/PNergard/eba36f8c585419f1b65e27c0bd5f43fe">Gist</a>.</p>
<p><img src="/link/b5890876a6c142c3b6c4b706adb44cfa.aspx" alt="Image wastebasket.jpg" /></p>
</body>
</html>2017-11-09T13:47:53.0000000ZBlog postPlugin for viewing scheduled job run history<!DOCTYPE html>
<html>
<head>
</head>
<body>
<p>A couple of times during the years I have had the need to view the scheduled job history log. In all these cases it has been jobs that are running frequently and therefor I need to use the paging since the default view doesn't display that many rows.</p>
<p>So I did a small plugin that let you choose between all scheduled jobs and display all the history in one table. Might not be the oste useful plugin but since I built it can as wll share it. You can find it over at my <a href="https://gist.github.com/PNergard/743e5cb4e0480be7994789b49490cfea">Gist</a>.</p>
<p><img src="/link/2a817b35c4c4458f9c0d2c5020fb933a.aspx" alt="Image logviewer.jpg" /></p>
</body>
</html>2017-09-14T22:21:44.0000000ZBlog post