FAIR

Federated and Independent Repositories

Animated Raffle Winner

Plugin Banner

Animated Raffle Winner

by Rafael Funchal

Download
Description

The Animated Raffle Winner block allows you to create engaging raffle experiences on your WordPress site. With smooth animations and exciting visual effects, this block is perfect for promotions, events, contests, and any situation that requires random number selection.

Key Features:

  • Set a custom number range (start and end)
  • Number rolling animation for 5 seconds before revealing the result
  • Highlighted display of the drawn number
  • Animated fireworks to celebrate the result
  • Simple and intuitive interface
  • Fully responsive

How to Use:

  1. Add the “Animated Raffle Winner” block to your content
  2. Configure the starting number in the settings panel
  3. Configure the ending number in the settings panel
  4. Publish or preview the page
  5. Click the “Draw” button to start the raffle!

The block is perfect for:
– Raffles at events and promotions
– Random selection of participants
– Games and interactive activities
– Educational demonstrations about randomness
– Any application that needs random selection with visual impact

Source Code & Build Instructions

The source code for this plugin is included directly within the src/ directory.

To build the plugin from source:
1. Ensure you have Node.js and npm installed.
2. Install the dependencies: npm install
3. Build the assets: npm run build

  1. Upload the plugin files to the /wp-content/plugins/animated-raffle-winner directory or install directly through the WordPress plugins screen
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Add the “Animated Raffle Winner” block to any page or post using the Gutenberg editor
  1. Block in the editor showing the range settings

    Block in the editor showing the range settings

  2. Initial state of the block on the frontend before the raffle

    Initial state of the block on the frontend before the raffle

  3. Animation in progress with numbers rolling

    Animation in progress with numbers rolling

How do I configure the number range?

In the block editor, select the Animated Raffle Winner block. In the right sidebar (Inspector), you will see two fields: “Starting Number” and “Ending Number”. Enter the desired values.

Can I use negative numbers?

Yes! The block accepts any integer, including negative numbers.

Does the animation work on mobile devices?

Yes, the block is fully responsive and works perfectly on smartphones and tablets.

Can I customize the animation duration?

Currently, the animation has a fixed duration of 5 seconds to provide a consistent and exciting experience.

Is the raffle truly random?

Yes, we use JavaScript’s Math.random() function, which generates pseudo-random numbers suitable for most raffle applications.

1.0

  • Added background image selector from Media Library
  • Added background/overlay color opacity control (0-100)
  • Added text size presets (Extra Small, Small, Medium, Large, Extra Large)
  • Updated front-end button label to “Draw again” after each result
  • Added accessibility improvements: live result announcements and reduced-motion support
  • Added fullscreen exit via Escape key and automatic celebration stop

0.1.0

  • Initial release
  • Raffle with configurable range
  • 5-second animation
  • Celebratory fireworks
  • Responsive interface
Back to top