XV Random Quotes

XV Random Quotes helps you collect and display random quotes everywhere on your WordPress site. Built with modern WordPress standards using Custom Post Types, Gutenberg blocks, and the REST API.

🎯 Modern WordPress Integration

• Custom Post Type – Quotes are managed as native WordPress posts with full revision history
• Gutenberg Blocks – Three dedicated blocks: Random Quote, Specific Quote, and List Quotes
• REST API – Access quotes programmatically for headless WordPress and custom integrations
• Taxonomy Support – Organize quotes with categories and authors (with URL support)
• Block Editor – Full support with dedicated meta boxes for quote content and source

✨ Key Features

• Multiple Display Methods – Widgets, shortcodes, template tags, and Gutenberg blocks
• AJAX-Powered Widgets – Automatic quote rotation without page reload (configurable timer)
• Category Filtering – Display quotes from specific categories or all quotes
• Author Management – Track quote authors with optional URL links
• Flexible Ordering – Random or sequential quote display
• Native Styling Toggle – Use plugin’s default styling or your theme’s styles
• Complete Backward Compatibility – All legacy shortcodes and template tags still work

📦 Display Options

• Gutenberg Blocks:
  • Random Quote Block – Display one or more random quotes
  • Specific Quote Block – Show a particular quote by ID
  • List Quotes Block – Paginated list of quotes with filtering
• Widgets: Sidebar widget with AJAX refresh and category filtering
• Shortcodes: [stray-random], [stray-id], [stray-all] for posts and pages
• Template Tags: stray_random_quote(), stray_a_quote() for theme integration
• REST API: /wp-json/xv-random-quotes/v1/quote/random for custom integrations

🔄 Automatic Migration

Upgrading from v1.x? The plugin automatically detects the need of migrating your existing quotes to the new Custom Post Type system. The migration is always manual to prevent race conditions and duplicate imports. When the plugin is activated or updated, an admin notice prompts the user to start the migration via a button. The migration then processes quotes in batches via AJAX.

🎨 Customization

• Customize HTML wrappers (before/after quote, author, source)
• Control author and source link formatting
• AJAX loading messages and animations
• Native WordPress styling or custom CSS

See RELEASE_NOTES.md for complete v2.0 features and migration guide.

Credits

• For main development of Stray Quotes, Ico
• For Multi-widget functionality, Millian’s tutorial
• For help in developing user-end AJAX functionality, AgentSmith
• For search functionality and bugfixing, Sergey Sirotkin

Localization

• German, thanks to Markus Griesbach
• Chinese, thanks to WGMking
• Croatian, thanks to Rajic
• Danish, thanks to Georg

Actually, these translations are not updated to the latest version.
I am looking for new localizers, all languages welcome!

Please note: the best way to submit new or updated translations is to send me a direct link to the localization files in the contact page of my website. This way the files are made available to the users sooner, and without waiting for a new release.

Please note: If you want to create a localized copy of XV Random Quotes, consider skipping the help page and translate the rest. This will save you quite some time. The help page has a lot of text.

Known Issues

None currently reported for v2.0. If you find an issue, please report it on GitHub.

Automatic Installation

1. Go to Plugins > Add New in your WordPress admin
2. Search for “XV Random Quotes”
3. Click “Install Now” and then “Activate”
4. If upgrading from v1.x, migration will start automatically

Manual Installation

1. Download the plugin zip file
2. Upload to /wp-content/plugins/ directory
3. Activate the plugin through the ‘Plugins’ menu in WordPress
4. Go to Quotes > All Quotes to start adding quotes

After Installation

• New Installation: Go to Quotes > Add New to create your first quote
• Upgrading from v1.x:
  • Small databases (≤500 quotes) migrate automatically on activation
  • Large databases show an admin notice with “Start Migration” button
  • All existing quotes, categories, and settings are preserved
  • See migration guide in RELEASE_NOTES.md for details

Using Gutenberg Blocks

1. Edit any post or page
2. Click the + button to add a block
3. Search for “quote” to find the three quote blocks:
   • Random Quote – Display random quotes with category filtering
   • Specific Quote – Show a particular quote by ID
   • List Quotes – Paginated list with ordering options

Using Widgets

1. Go to Appearance > Widgets
2. Add “XV Random Quotes” widget to your sidebar
3. Configure categories, display options, and AJAX settings
4. Save and view your site

Using Shortcodes

Add to any post or page content:
– [stray-random] – Display a random quote
– [stray-random categories="inspiration,wisdom"] – Random quote from specific categories
– [stray-id id="123"] – Display a specific quote
– [stray-all] – Display all quotes with pagination

See the Help page (Quotes > Help) for complete documentation.