StaticWebEpiserverPlugin 1.1.0

StaticWebEpiserverPlugin

Generate static website but still use EpiServer as your CMS for your editors

Introduction

Do you need a crisis web or handling peek load of users on your site? I have started develop a add-on for sites using EpiServer that will take everything you publish and make a static version of it. This way you get the instant publishing of a dynamic website and the performance and scalability of static websites in one go. It should (havn't yet test it) be possible to create the pages directory in your EpiServer site making it fully dynamic for things like search and filtering but static for general information.

Pro

• Reliable serverside response time
• Very easy to scale up
• No database dependency for visitor
• No serverside code requried
• Very secure (hard to hack static pages)

Con/limitations

• No serverside dynamic content can be used
• No serverside personalized content can be used
• Only pages inheriting from PageData will trigger page write
• Only block inheriting from BlockBata will trigger page write
• Only supports following types:
  • css (only support dependencies declared in url())
  • javascript (no dependencies)
  • Web fonts (woff and woff2)
  • Images (png, jpg, jpeg, jpe, gif, webp)
  • documents (pdf)
  • Icons (ico)

What functionality is provided in Plugin?

Below you can read more what StaticWebEpiserverPlugin can do today. If you are missing something or something is not working as expected, please let me know 😃

Generate static pages on publishing of Pages and Blocks

StaticWebEpiserverPlugin uses the PublishedContent event on IContentEvents to listen for changes that are published on your site. This way it will make sure your site is always up to date with what you have published in EpiServer. No need for busting caches or having your website running without cache do always show the lastest information. As long as your pages are inheriting from PageData and your blocks are inheriting from BlockData, StaticWebEpiserver will keep track of your changes.

Generate static pages on running scheduled job

StaticWebEpiserverPlugin are also providing a scheduled job for you to run that will generate alla pages below the home of your website. Pages that are not a child (or a child of a child, and so on) of your startpage it will not be included in the pages generated. To start the job, run the job called "Generate StaticWeb".

Having different views for StaticWeb and normal users

StaticWeb is registering a displaychannel called "StaticWeb" (See Header.cshtml and Header.staticweb.cshtml for examples on how to use it, can be found in EpiServerStaticWebExample repository). It is perfect for removing functionality that can't be used in a static website (like filitering or search). It also makes it possible for you to view how the page will look and work on the static version.

How to ignore page or block type?

By inherit from IStaticWebIgnoreGenerate iterface on a page or block type you will tell StaticWeb NOT to generate a static version of this type when publishing or running the scheduled job.

How to ignore page at runtime?

By inherit from IStaticWebIgnoreGenerateDynamically iterface on a page type you will tell StaticWebEpiServerPlugin that it MAY or MAY NOT generate a static version of this page when publishing or running the scheduled job. StaticWebEpiServerPlugin will call method ShouldGenerate for the page and if it returns true, it will generate a static version of the page when publishing or running the scheduled job. BUT if it returns false, it will not generate page AND also check (by calling ShouldDeleteGenerated) if it should remove any previously generated version of this page. See StandardPage.cs for example on how it can be used.

You can customize it using Events

We want people to be able to modify the use after their own liking. There for we will want to support the following events on the IStaticWebService. They will be called in the order specified below. You can read more on what is available at Issue #2 or see an example in StaticWebMessageInjectionDemoInitialization

Find, download and generate resources

When generating a page, StaticWebEpiserverPlugin will find all client side resources required for the page to work, download them and store them in the output folder along with the pages.

Following markup will searched for resources

• script tag (src attribute)
• link tag (href attribute)
• img tag (src attribute)
• source tag (srcset attribute)

Following resource types will be stored

• css (and resources declared in url())
• javascript (no dependencies)
• Web fonts (woff and woff2)
• Images (png, jpg, jpeg, jpe, gif, webp)
• documents (pdf)
• Icons (ico)

The rest will be ignored.

Requirements

• EpiServer 7.5+
• .Net 4.7.2+
• All pages need to inherit from PageData
• All blocks needs to inherit from BlockData
• Website has to return pages, javascript and css as UTF-8
• Must allow visits with user-agent Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.149 Safari/537.36 StaticWebPlugin/0.1

Installation

NuGet

• Add nuget package https://www.nuget.org/packages/StaticWebEpiserverPlugin/ to your solution.
• added new property StaticWeb:OutputFolder to appSettings section in Web.config (for example a GitHub repository folder). Example: <add key="StaticWeb:OutputFolder" value="C:\inetpub\wwwroot" />
• added new property StaticWeb:InputUrl to appSettings section in Web.config (must allow anonymous access). Example: <add key="StaticWeb:InputUrl" value="http://localhost:49822/" />
• You are ready to go 😃

GitHub Source download

• Copy StaticWebEpiserverPlugin folder and add StaticWebEpiserverPlugin.csproj into your solution.
• added new property StaticWeb:OutputFolder to appSettings section in Web.config (for example a GitHub repository folder). Example: <add key="StaticWeb:OutputFolder" value="C:\inetpub\wwwroot" />
• added new property StaticWeb:InputUrl to appSettings section in Web.config (must allow anonymous access). Example: <add key="StaticWeb:InputUrl" value="http://localhost:49822/" />
• You are ready to go 😃