# Scheduled publication
✋ CAUTION
This guide might not be up-to-date with Strapi v4. We are currently reworking the "Guides" section as most of the features they cover are now part of Strapi's core.
This guide will explain how to create an article schedule system.
# Introduction
What we want here is to be able to set a publication date for an article, and at this date, switch the draft
state to published
.
# Example
For this example, we will have to add a publish_at
attribute to the Article Content Type.
- Click on the Content-type Builder link in the left menu
- Select the Article Content Type
- Add another field
date
attribute namedpublish_at
withdatetime
type
And add some data with different dates and state to be able to see the publication happen.
Make sure to create some entries with a draft state and a publish_at
that is before the current date.
The goal will be to check every minute if there are draft articles that have a publish_at
lower that the current date.
# Create a CRON task
To execute a function every minutes, we will use a CRON task.
Here is the full documentation of this feature. If your CRON task requires to run based on a specific timezone then do look into the full documentation.
Path — ./config/functions/cron.js
module.exports = {
'*/1 * * * *': () => {
console.log('1 minute later');
},
};
Make sure the enabled cron config is set to true in ./config/server.js
file.
💡 TIP
Please note that Strapi's built in CRON feature will not work if you plan to use pm2
or node based clustering. You will need to execute these CRON tasks outside of Strapi.
# Business logic
Now we can start writing the publishing logic. The code that will fetch all draft
Articles with a publish_at
that is before the current date.
Then we will update the published_at
of all these articles.
Path — ./config/functions/cron.js
module.exports = {
'*/1 * * * *': async () => {
// fetch articles to publish
const draftArticleToPublish = await strapi.api.article.services.article.find({
_publicationState: 'preview', // preview returns both draft and published entries
published_at_null: true, // so we add another condition here to filter entries that have not been published
publish_at_lt: new Date(),
});
// update published_at of articles
await Promise.all(draftArticleToPublish.map(article => {
return strapi.api.article.services.article.update(
{ id: article.id },
{ published_at: new Date() }
);
}));
},
};
And tada!