Citatly – Daily Quote

Citatly (Daily Quote) adds a dedicated custom post type for quotes and automatically displays one of them each day on your website.

The displayed quote changes once per day and is selected deterministically based on the current date — no randomness involved, so every visitor sees the same quote on the same day. Delivery is cache-safe via a REST API endpoint that sends appropriate HTTP caching headers, making it fully compatible with full-page caches and CDNs.

Live demo & documentation: See the plugin in action at https://citatly.com

Für deutschsprachige Nutzer:

Das Plugin „Zitat des Tages” ist vollständig auf Deutsch übersetzt (de_DE). Es zeigt täglich ein neues Zitat aus deiner eigenen Sammlung — cache-sicher, ohne externe Abhängigkeiten und ohne API-Schlüssel. Live-Demo & Dokumentation auf Deutsch: https://citatly.com/de/

Features:

• Custom post type “Quotes” in the WordPress admin
• Fields for quote text, author, and an optional extra field (e.g. source, year, or context)
• Daily quote rotation — consistent for all visitors
• Embed anywhere with the [citatly] shortcode
• Optional class parameter for individual styling: [citatly class="my-style"]
• Gutenberg block support (requires compiled /build directory)
• REST API endpoint /wp-json/citatly/v1/today with HTTP caching headers
• Plain text only — no HTML stored or output, XSS-safe by design
• Auto-generated post title from quote text
• Import and export quotes as JSON (via admin menu)
• Clean uninstall — removes all plugin data when deleted
• Translation-ready (.pot file included)

How the daily quote is selected:

The plugin uses a deterministic algorithm: crc32(date + site_url) maps today’s date to a fixed quote from your collection. A fallback mechanism ensures that the same quote never appears on two consecutive days. This means the quote is stable throughout the day, works correctly even with full-page caching, and does not require any session or cookie.

CSS structure:

The plugin does not style the quote output — all visual styling is left to your theme. The only included CSS handles the skeleton loader during page load.

.citatly — outer wrapper
.citatly__text — the quote text
.citatly__meta — wraps author and source
.citatly__separator — dash before author (default: "— ")
.citatly__author — author name
.citatly__divider — dot between author and source (default: " · ")
.citatly__source — optional extra field

Source Code

The compiled file build/index.js is generated from the human-readable source files in the src/ directory using @wordpress/scripts.

The full source code, including all build tools and configuration, is publicly available at:
https://github.com/dieterDG/citatly-daily-quote

To regenerate the build files:

1. Clone the repository
2. Run npm install
3. Run npm run build