A WordPress Gutenberg block plugin that displays randomly selected child blocks on every page load. Perfect for testimonials, CTAs, and dynamic content rotation.

Features

• Universal Block Support - Works with any Gutenberg block (core, custom, third-party)
• Multiple Display Options - Show one or multiple random blocks at once
• Shuffle Control - Optional randomization of display order
• Server-Side Rendering - Cache-friendly, SEO-friendly randomization
• Zero Configuration - Simple drag-and-drop interface, no coding required

Use Cases

• Rotating testimonials and customer reviews, or any other blocks
• A/B testing CTAs and promotional messages
• Random product showcases (WooCommerce blocks compatible)
• Banner and advertisement rotation
• Daily tips, quotes, and educational content
• Team member spotlights

Development

Setup

# Install dependencies as per the package-lock.json file
npm ci

# Start development build (watch mode)
npm start

# Production build
npm run build

# Create plugin ZIP for distribution
npm run plugin-zip

Code Quality

# Format code (WordPress standards)
npm run format

# Lint JavaScript
npm run lint:js

# Lint CSS/SCSS
npm run lint:css

Contributing

Contributions are welcome! Here's how to get started:

Reporting Issues

• Use the GitHub Issues tracker
• Search existing issues before creating new ones
• Include WordPress version, PHP version, and reproduction steps
• Provide relevant error messages or screenshots

Pull Requests

1. Create a GH issue in this repository describing your proposed changes
2. Fork the repository
3. Create a feature branch (git checkout -b 42-your-feature-name where 42 is the issue number)
4. Make your changes following WordPress coding standards
5. Run linting and formatting (npm run format && npm run lint:js && npm run lint:css)
6. Test thoroughly in a WordPress environment
7. Commit with clear, descriptive messages
8. Push to your fork and submit a pull request

Development Guidelines

• Follow WordPress Coding Standards
• Maintain backward compatibility with the oldest supported WordPress version (see Requires at least: in the readme.txt file)
• Add comments for complex logic
• Update readme.txt changelog for user-facing changes
• Test with popular caching plugins and block themes

Areas for Contribution

• Performance optimizations
• Accessibility improvements
• Unit and integration tests
• Documentation enhancements
• Internationalization (i18n) improvements
• Bug fixes and security patches
• New features and enhancements

Links

• Author's blog
• WordPress.org Plugin Page
• Support Forum