WP Sound Actions – Features Overview

1️⃣ Multiple Class-Based Sound Rules

• Users can define multiple CSS classes in the backend.

• Assign a different sound file (MP3) for each class.

• Select the event type for each class: Hover or Click.

• Add or remove rows dynamically in the admin panel.

• JavaScript ensures sounds are only played on elements with the selected class.

2️⃣ Global Sound for All Buttons

• Option to enable “Apply sound to all buttons” across the website.

• Assign a global sound file that will play on:

  • <button> elements

  • <a> links

  • Elementor buttons .elementor-button

  • Input buttons (type="button" and type="submit)

• Click sound is reliable for all buttons site-wide.

3️⃣ Frontend JavaScript Handling

• Preloads audio files for faster playback.

• Plays sound on Hover (mouseenter) or Click, depending on user selection.

• Resets currentTime = 0 to allow rapid repeated plays.

• Supports multiple class rules and the global button sound simultaneously.

4️⃣ Simple Backend UI (Table Repeater)

• Table layout for Class Name, Sound File URL, and Event Type.

• Users can add or remove rows dynamically.

• Inline JavaScript handles row operations smoothly.

• Instruction below Class Name input:
  *Please add the dot (.) before the class name, e.g., .my-class

5️⃣ Plugin Branding

• Admin settings page displays:
  Plugin by Azeem Akhtar

• Clickable link to your website.

• Positioned directly below the “Save Changes” button.

6️⃣ Hover Sound Best Practices

• Recommended: short MP3 files (0.1–0.3 seconds) for better user experience.

• Hover sound only plays on elements with the assigned class.

• Click sound can be applied globally or per class.

7️⃣ Reusable & Expandable

• Users can add unlimited rules.

• JavaScript dynamically applies sounds without editing theme files.

• Fully compatible with any WordPress theme.

🔊 Add “Sound On/Off” Toggle (Frontend Switch)

🧩 How it will work

✔ A toggle button will appear on the website
✔ When clicked, it will instantly mute or unmute all sounds
✔ User choice will be saved in LocalStorage, so it remembers on page reload
✔ Works with all current plugin sounds (hover + click + global buttons)

💡 Future Enhancements

1. Built-in Media Uploader for sound files (no need to paste URLs).

2. Custom volume control for each sound.

3. Option for Hover + Click sound simultaneously for one class.

4. Preview sound button in admin before saving changes.

5. Premium admin panel styling (icons, color coding, better UX).