eleventy-plugin-future-post v0.0.2

Eleventy Plugin Future Post

An Eleventy Plugin that allows you to set a future publishing date for one or more posts and not generate (publish) them until you build the site after the selected date.

The Eleventy Base Blog project has a drafts feather that allows you to work on a post within an Eleventy project without publishing it. You essentially assign a draft state to the post and Eleventy doesn't publish it during the build process until you remove the draft state.

For my use case, I wanted something different, I didn't want to manage the state of the document, I wanted the document to publish based on metadata in the post (the post date property). The Joomla CMS has this feature, you simply set the publish date and time in the post and it miraculously appears at the selected date and time. WordPress allows you to do both, set a published state and a date to publish it.

To accomplish this, I created this plugin; you can read more about it in Hiding Future Posts in Eleventy.

Processing Scope

The plugin processes all the files in an Eleventy site (Home, About, etc.); I could have added code to ignore them, but as long as those pages don't have a date front matter property since none of those pages should have a future save date, the plugin will automatically publish them (they won't be ignored during the Eleventy site build process).

Installation

To install the plugin, open a terminal window or command prompt to an Eleventy project and execute the following command:

npm install eleventy-plugin-future-post

At the top of the project's eleventy.config.js file, add the following line:

const futurePost = require('eleventy-plugin-future-post');

Inside the module.exports section of the file, load the plugin as shown in the following example:

module.exports = eleventyConfig => {

  // stuff

  eleventyConfig.addPlugin(futurePost);  

  // other stuff
  
};

You can also configure the plugin to send a bunch of extra data to the console as it executes by enabling debugMode:

eleventyConfig.addPlugin(futurePost, { debugMode: true });

With that in place, console output looks something like the following:

[Eleventy-Plugin-Future-Post] Debug mode enabled
[Eleventy-Plugin-Future-Post] Current Date: Wed Jan 10 2024 20:38:07 GMT-0500 (Eastern Standard Time), Offset: 18000000
[Eleventy-Plugin-Future-Post] Blunderer Molasses Deviant: Date: Thu Jan 11 2024 00:00:00 GMT-0500 (Eastern Standard Time)
[Eleventy-Plugin-Future-Post] Clause Ecosystem Deluxe: Date: Wed Jan 31 2024 00:00:00 GMT-0500 (Eastern Standard Time)
[Eleventy-Plugin-Future-Post] Coeditor Recess Senior Bonanza: Date: Wed Jan 10 2024 00:00:00 GMT-0500 (Eastern Standard Time)
[Eleventy-Plugin-Future-Post] Modified Crayfish Ending: Date: Sun Dec 03 2023 00:00:00 GMT-0500 (Eastern Standard Time)
[Eleventy-Plugin-Future-Post] Placate Reacquire: Date: Tue Nov 14 2023 00:00:00 GMT-0500 (Eastern Standard Time)
[Eleventy-Plugin-Future-Post] Home: Date: Mon Jan 08 2024 03:12:08 GMT-0500 (Eastern Standard Time)

For some reason, and I haven't spent any time looking into this, each post entry logs to the console twice. Perhaps I'll fix that some day.

If this code helps you, please consider buying me a coffee.