MIGRATION.md

Migration Guide

This document describes the changes that need to be made to migrate from one version of the blog to another.

8.0 to 9.0

Support / Donation section

If you used the sponsor/donation mechanism in the appsettings.json like this:

{
  ...
  "KofiToken": "TokenHere",
  "GithubSponsorName": "namehere",
  "PatreonName": "namehere",
}

These moved to their own respective subsection:

{
	"SupportMe": {
	  "KofiToken": "TokenHere",
      "GithubSponsorName": "namehere",
      "PatreonName": "namehere",
	  "ShowUnderBlogPost": true,
	}
}

The ShowUnderBlogPost is needed to indicate that the part will be shown under each blog post. We also added more possibilities to customize this:

"SupportMe": {
	"KofiToken": "ABC123",
	"GithubSponsorName": "your-tag-here",
	"PatreonName": "your-tag-here",
	"ShowUnderBlogPost": true,
	"ShowUnderIntroduction": true,
	"ShowInFooter": true,
	"ShowSupportMePage": true,
	"SupportMePageDescription": "Buy my book here: [My Blazor Book](https://google.com) or please contribute to my open-source project here: [My Awesome Repo](https://github.com) . This can be **markdown**."
}

Use true or false to choose where you want the donation buttons to appear and also a support me page can optionally be added to the nav menu. Checkout the Donation section in the documentation.

Shortcodes

Shortcodes, a form a templating that can be adjusted dynamically, are introduced in this version. The following table has to be added to the database:

CREATE TABLE Shortcodes
(
	Id [NVARCHAR](450) NOT NULL,
	Name [NVARCHAR](512) NOT NULL,
	MarkdownContent NVARCHAR(MAX) NOT NULL,
)

ALTER TABLE Shortcodes
ADD CONSTRAINT PK_Shortcodes PRIMARY KEY (Id)

Similiar blog posts

A new SimilarBlogPost table is introduced to store similar blog posts.

CREATE TABLE SimilarBlogPosts
(
	Id [NVARCHAR](450) NOT NULL,
	SimilarBlogPostIds NVARCHAR(1350) NOT NULL,
)

ALTER TABLE SimilarBlogPosts
ADD CONSTRAINT PK_SimilarBlogPosts PRIMARY KEY (Id)

Add the following to the appsettings.json:

{
	"SimilarBlogPosts": true
}

Or false if you don't want to use this feature.