AICreativa Music Player
| 开发者 | samoilradinski |
|---|---|
| 更新时间 | 2026年8月20日 22:23 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
AICreativa Music Player is a modern, innovative audio player for WordPress, built for DJs, producers, labels and musicians who care how their music is presented. Real waveform analysis, a live frequency analyzer and two very different skins, in a plugin that stays fast and adds nothing you did not ask for.
Two skins, one player
- Skin 1 — inline player. Sits inside your content as a single track or a full playlist with artwork, waveform and track list.
- Skin 2 — docked bar. A slim bar fixed to the bottom of the screen, with a collapsible playlist and analyzer panel. Put it on a single page with a shortcode, or on every page from Settings, and let it carry on playing as visitors move around the site.
- Modern and fast — no page builder, no framework, no jQuery on the front end. Just the player, rendered from a shortcode.
- Precise analyzer — a real-time frequency spectrum with logarithmic frequency mapping, spectral tilt compensation and peak-hold lines. It reads like studio metering, not a decorative animation.
- Real waveform — the actual amplitude of your audio file, analysed in the browser with the Web Audio API. Not a generic placeholder shape.
- Custom colors — set the accent, background and text colors and the whole player follows: waveform, knobs, transport icons, playlist and the BUY/DL buttons.
- Beautifully designed — flat transport controls, arc knobs for volume and sensitivity, hairline dividers and the Inter typeface throughout.
- Keeps playing — the docked bar remembers the track, position and volume and picks them back up on the next page. Visitors who would rather not listen can dismiss it, and a small play button stays in the corner in case they change their mind.
- Lightweight — one PHP file, CSS and JavaScript loaded only where a player will actually appear.
- Drag & drop — reorder tracks in the admin playlist builder, and let visitors reorder their own view on the front end.
- Download option — offer your audio for download, or switch the button off globally in one click.
- 100% free — every feature, no paid tier, no upsells, no account required.
- Real waveform visualization with click-to-seek
- Live frequency spectrum analyzer with a sensitivity control (Skin 2)
- Broad format support — plays MP3, WAV, FLAC and OGG across modern browsers (lossless-ready for labels), plus AIFF uploads
- Album artwork display, uploaded directly via the Media Library
- Previous / Play / Next transport controls
- Shuffle and repeat modes: off, repeat one, repeat all
- Arc knobs for volume and analyzer sensitivity — drag, scroll, or double-click to reset
- Media Session support: lock screen artwork and hardware media keys
- Drag & drop track reordering, in the admin builder and on the front end
- Optional autoplay: on first interaction, or instant and muted
- Optional download button, disabled globally from Settings
- BUY button with a custom label for Bandcamp, Beatport or any store
- Playlist support with track list, track counter and collapsible list
- Dashboard with play, completion and download stats per track — privacy-first, aggregate counts only, no visitor tracking
- Adjustable player width, 400px to 1400px
- Site-wide docked bar, from a playlist you choose in Settings
- Continuous playback, so the bar picks the track back up on the next page
- Dismissible bar, with a corner button to bring it back mid-track
- Adjustable Skin 2 opacity, with a blur behind the translucent bar
- Optional Inter webfont, which you can switch off to avoid any external request
- Simple shortcodes: [aicmp_track id="X"] and [aicmp_playlist id="X"], with skin="2" for the docked bar
- Shortcode displayed and copyable directly from the Track/Playlist edit screen
- Musicians and producer portfolios
- DJ promo and mix pages
- Label release pages
- Music blogs and radio shows
- Anyone who wants a player that looks like it belongs on the page
安装:
- Download the plugin ZIP file
- Go to WordPress Admin > Plugins > Add New > Upload Plugin
- Select the ZIP file and click Install Now
- Click Activate Plugin
- Go to AICreativa Music Player > Add Track to add your first track
- Fill in the title, artist, upload your MP3 and artwork
- Add a BUY link (optional - leave empty to hide the button)
- Publish the track and copy the shortcode from the sidebar
- Paste the shortcode in any Page, Post or Custom HTML block
屏幕截图:
常见问题:
How do I add a track?
Go to AICreativa Music Player > Add Track, fill in the details, upload your MP3 and artwork, then publish. Copy the shortcode from the sidebar and paste it anywhere on your site.
How do I create a playlist?
First add individual tracks. Then go to AICreativa Music Player > Add Playlist, check the tracks you want to include, publish, and copy the shortcode [aicmp_playlist id="X"].
Can I reorder tracks in a playlist?
Yes, in two places. In the admin playlist builder, drag rows to set the saved order. On the front end, each track also has a drag handle so visitors can reorder their own view. The player updates automatically.
How does the waveform work?
The player fetches your MP3 file and analyses the actual audio amplitude using the Web Audio API. The waveform displayed is a real representation of your track. If your MP3 is hosted on an external server with CORS restrictions, a consistent pseudo-waveform is shown instead.
Can autoplay start music when the page loads?
Browsers block audible autoplay until the visitor interacts with the page. AICreativa Music Player offers two honest modes in Settings: "On first interaction" starts playback at the first click, scroll or key press anywhere on the page, and "Instant, muted" starts immediately without sound and unmutes on first interaction. Autoplay applies to the first player on the page.
Can I hide the download button?
Yes. Go to AICreativa Music Player > Settings and uncheck the Download Button option. This disables it globally on all players.
Which skin should I use?
Skin 1 renders inside your content, so it suits a release page or a post where the player belongs next to the text. Skin 2 is a bar docked to the bottom of the window that keeps playing while visitors move around the site, which works well for a label front page or an artist site. You choose the skin per shortcode.
Can I keep the music playing while visitors browse?
Yes. Under Settings, pick a playlist for the Site-wide bar so Skin 2 appears on every page, then switch on Continuous playback. The bar remembers the track, position and volume and picks them back up after each page load. There is a short gap while the page arrives, and some browsers will not restart audio without a tap, in which case the bar waits at the right spot. Nothing about your pages is modified, so this cannot affect your layout.
Can visitors get rid of the docked bar?
Yes. The X on the bar closes it and stops the music for the rest of their browsing session. A small play button stays in the corner, and pressing it brings the bar back exactly where it left off.
Can I change the player colors?
Yes. Go to AICreativa Music Player > Settings where you can change the accent color (waveform) and background color.
Does it work with Elementor, Gutenberg, etc.?
Yes. Use the Custom HTML block in Gutenberg or the HTML widget in Elementor, and paste the shortcode.
Where can I get support?
Visit https://aicreativa.mk for support and documentation.
更新日志:
3.6.5
- Single tracks and playlists now sit the same way in the page. A single track used to be pushed to the left edge while a playlist filled its column
- Trimmed about 16% off the height of the single-track player on Skin 1, with the artwork resized to match
- The waveform now uses a perceptual curve, so quieter passages read clearly instead of leaving the panel looking half empty. Peaks are unchanged
- Rebuilt the single-track layout on phones: a smaller cover sits beside the track details, and the waveform and controls each run the full width beneath them instead of being squeezed into a narrow column. About 20% shorter overall
- New site-wide docked bar: pick a playlist in Settings and Skin 2 appears on every page, so visitors can keep listening wherever they go
- Continuous playback: the bar remembers the track, position and volume and picks them back up after each page load. Off by default
- Visitors can dismiss the bar with a close button, and a small play button stays in the corner to bring it back mid-track
- New Skin 2 opacity setting: the docked bar can be made translucent, with a blur so the text stays readable over whatever scrolls beneath it
- The Skin 2 track title now sizes to its text, so the waveform sits symmetrically between the title and the counter. Titles also have more room before they truncate
- Previous, play and next sit closer together on both skins, and Skin 1 shuffle and repeat moved beside the playlist button at a matching size
- Fixed the close button jumping to the far left of the bar on tablets
- Fixed the track counter crowding the transport buttons on Skin 1 playlists on phones
- Tested with WordPress 7.1
- Hardened the input handling on the new opacity setting
- Fixed the track counter and time crowding the transport buttons on Skin 1 playlists on phones
- The Skin 2 waveform is now part of the opacity setting instead of staying opaque
- New Skin 2 opacity setting: the docked bar can now be made translucent, with a blur so the text stays readable over whatever scrolls beneath it
- Previous, play and next sit closer together on both skins
- Skin 2 track titles have more room and truncate less
- Skin 1 shuffle and repeat moved next to the playlist button, all three the same size
- Removed the Stop button from both skins
- The analyzer sensitivity knob now sits beside the volume knob in the Skin 2 bar, appearing when the analyzer is open
- New default palette: a cyan accent, a near-black player background and a soft blue for titles and buttons
- Every neutral shade in the player is now derived from your background color, so a light background no longer leaves near-black waveform bars, borders and placeholders behind
- Rebuilt the Settings screen: the three colors sit together in one control, fields are grouped under Appearance and Behavior, and every field explains what it does
- The Settings reference column no longer stretches across wide monitors, and the duplicated autoplay explanation is gone
- Added a welcome panel to the dashboard with quick links to add a track or playlist, open Settings, or reach support
- Fixed the Export CSV and Reset statistics buttons stacking instead of sitting side by side
- The description in the WordPress plugins screen now matches the one on WordPress.org
- Fixed CSV export on the dashboard, which was writing the whole admin page into the downloaded file instead of the statistics
- Exported files are now named with the date they were generated
- Added a dismissible review request on the plugin dashboard, shown only after the plugin has been installed a week and has logged at least 25 plays
- Rewritten plugin description and refreshed tags on WordPress.org
- Set an explicit version on the Inter webfont stylesheet so browser caches invalidate correctly on update
- Skin 2 play, previous, next and stop are 15% larger, on their own size token so the mode buttons stay compact
- The Skin 2 volume knob now takes its colour from the Text Color setting and changes with it
- Skin 2 bar reworked into tight control clusters separated by hairline dividers, freeing roughly 180px of horizontal space
- The waveform absorbs all of it and now runs about a third longer on a typical laptop screen
- The waveform and the analyzer now sit on the player background colour instead of a fixed near-black panel
- Volume and Sensitivity are now arc knobs — drag up/down, scroll, or double-click to reset
- Shuffle, repeat, visualizer and playlist buttons sit flat on the player background, with no highlighted circle
- The playlist button on Skin 1 is now a three-line menu icon, matching Skin 2
- Redesigned transport controls on both skins to match the AICreativa desktop player: flat outlined play/pause, previous, next and a new Stop button
- Shuffle, repeat, visualizer and playlist toggles are now round pill buttons that light up in your text colour when active
- Playlist rows share one uniform background; the track that is playing is marked by its accent-coloured text instead of a highlighted row
- Smaller, tighter BUY and DL buttons
- The player now uses the Inter typeface, with an optional toggle in Settings for loading the webfont
- New audio-reactive visualizer on Skin 2 — a real-time frequency bars panel with a Sensitivity control and peak-hold, opening above the bar like the playlist
- Slimmer desktop volume slider and song title for a wider waveform
- Media Session support — lock-screen artwork/title and hardware media keys (headphones, keyboard, car Bluetooth) now control the player
- New Skin 2 — a slim, bottom-docked player bar for tracks and playlists: add skin="2" to any shortcode
- Responsive by design: single-row bar on desktop/tablet, stacked layout on phones
- Orange ☰ toggle slides the playlist open/closed above the bar
- Both skins share the same colour settings; default text colour is now brand orange
- Shortcode boxes now show a one-click Copy button (playlist shows both skins)
- Existing [aicmp_playlist id="X"] players are unchanged (default skin="1")
- Documented the expected table cleanup on uninstall (Plugin Check clean — 0 errors, 0 warnings)
- Hardened all custom-table queries to use $wpdb->prepare() with %i identifier placeholders (Plugin Check clean)
- Documented the CSV export output-stream handler
- Requires WordPress 6.2 or later
- Added a collapse/expand toggle next to the volume control to hide or show the playlist (smooth animation, keyboard accessible)
- Dashboard now shows the date range the statistics cover
- Added a Reset statistics button (with confirmation) to clear all counts
- Cleaner admin menu order — Dashboard first, followed by Tracks, Playlists and Settings
- New: Dashboard with play, completion and download statistics per track
- Privacy-first — only aggregate counts are stored, no visitor data, no IP addresses, no tracking cookies
- Export stats to CSV
- A play counts after 5 seconds of listening; a completion counts past 80% of the track
- New: broader audio format support — MP3, WAV, FLAC and OGG (FLAC and AIFF uploads now allowed)
- Performance: player waveform now analyses only when it scrolls into view, easing load on pages with several players and on mobile
- Settings moved to its own submenu under the new Dashboard
- Fix: waveform was cut off on phones and other narrow screens — the bar count now adapts to the available width so the whole track is always visible
- Waveform now renders at device pixel ratio, so it stays sharp on high-DPI and mobile screens
- Responsive polish: smaller artwork, tighter padding and a compact volume slider below 600px
- Shortcodes renamed to [aicmp_track] and [aicmp_playlist] so every identifier uses the plugin's unique
aicmpprefix - Player CSS is now a single class-based stylesheet enqueued in the document head (built once from Settings) for reliable rendering across all themes
- Player assets load only on singular views that contain a player shortcode
- Playlist now follows the player theme: the track list uses the player background color and the currently playing track is highlighted 10% lighter
- Play button now uses the Text Color (the play icon auto-adjusts for contrast) and stays in sync when you change the text color
- BUY and DL buttons now sit on the player background with a border and label in the Text Color, changing together with it
- Renamed to AICreativa Music Player (slug: aicreativa-music-player) for WordPress.org naming compliance; updated display name, plugin headers, text domain, shortcodes and all internal identifiers
- Review compliance: all front-end and admin CSS/JS is now delivered through wp_register/wp_enqueue with wp_add_inline_style / wp_add_inline_script — no raw script or style tags anywhere
- Hardened settings sanitization (hex color fallbacks, bounded player width) and extended uninstall cleanup
- New: Shuffle mode in playlist player (works with next button and auto-advance; Repeat One still wins)
- UI: Volume moved to the left of the bottom bar; redundant waveform timestamps removed (time lives in the top-right counter)
- Default waveform accent is now light blue (#70e7ff); BUY button matches the DL button style
- UI polish: BUY and DL buttons equal size, larger repeat icon, brighter timestamps and track text for readability, wider volume slider
- New: Admin playlist builder with drag & drop ordering — the saved order now drives the front-end player
- New: Autoplay setting with two modes: on first interaction (click / scroll / key) or instant muted with unmute on interaction
- Improved: Compact volume slider
- Accessibility: aria-label on volume sliders (well-formed accessibility tree for screen readers and AI agents)
- Initial release as AICreativa Music Player
- Real waveform analysis using Web Audio API (actual MP3 amplitude)
- Mirrored waveform display (top + bottom reflection) with 300 bars
- Drag & drop track reordering in playlists
- Seeded pseudo-waveform fallback for external/CORS-restricted MP3 files