Schedule Publication

Über

Das Plugin aktiviert die in Payload v3 integrierte `schedulePublish`-Funktion für ausgewählte Collections und Globals. Redakteure können im Admin-Bereich ein zukünftiges Veröffentlichungsdatum wählen, und der Entwurf geht zum festgelegten Zeitpunkt automatisch live. Das Plugin implementiert die Veröffentlichung nicht neu, sondern schaltet die native Funktion frei, leitet die resultierenden Jobs in eine eigene Queue um und stellt einen HTTP-Endpunkt bereit, den ein Cron-Job nach Zeitplan abarbeitet. Die Konfiguration erfolgt in `payload.config.ts`. Sie übergeben ein Array mit Collection-Slugs und optional Global-Slugs sowie einen Secret-String. Das Plugin fügt jedem konfigurierten Eintrag `versions.drafts.schedulePublish: true` hinzu, ohne bestehende `versions`- oder `drafts`-Einstellungen zu überschreiben. Ein `beforeChange`-Hook auf der Jobs-Collection markiert alle Jobs mit dem `taskSlug` `schedulePublish` mit dem konfigurierten Queue-Namen (Standard: `scheduled-publish`) und hält sie so von anderen Hintergrundprozessen getrennt. Der registrierte Endpunkt `GET /api/scheduled-publish/run` erwartet einen korrekten `Authorization: Bearer <secret>`-Header. Bei gültigem Token ruft der Handler `payload.jobs.run({ queue })` auf und gibt `{ ok: true }` zurück. Ein fehlendes oder falsches Token führt zu HTTP 401, ein Fehler im Runner zu HTTP 500. Sie sind dafür verantwortlich, den Endpunkt mindestens so oft aufzurufen, wie Ihre feinste Planungsgranularität es erfordert. Als Auslöser lassen sich Vercel-Crons über `vercel.json` nutzen, einfache `curl`-Aufrufe oder `node-cron`. Ist das Secret leer oder fehlt, deaktiviert sich das Plugin selbst und gibt eine Warnung aus, ohne den Endpunkt zu registrieren. Eine fehlende Umgebungsvariable bringt den Build also nicht zum Absturz. Die `schedulePublish`-Option übergibt eine `SchedulePublish`-Konfiguration wie etwa `timeIntervals` und steuert damit den Date-Picker im Admin-Bereich. Der Queue-Name ist konfigurierbar, falls es zu Konflikten mit einer anderen Queue kommt.

Paketinformationen

Paketname

@focus-reactive/payload-plugin-scheduling

Neueste Version

1.3.0

Entpackte Größe

24 kB

Lizenz

MIT

Wöchentliche Downloads

362

Zuletzt veröffentlicht

18. Juni 2026