jordesign

<p>Scrobbled Blocks brings your Last.fm listening history to your WordPress site using native Gutenberg blocks. Whether you’re a music blogger, podcaster, DJ, or just want to share your musical tastes with your audience, this plugin makes it simple.</p>
<h4>Two Powerful Blocks</h4>
<p><strong>Now Playing Block</strong><br />
Display the track you’re currently listening to, or the most recent track you’ve played. Perfect for sidebars, footers, or anywhere you want to show off your current musical mood.</p>
<p><strong>Recently Played Block</strong><br />
Show a list or grid of your recent scrobbles. Configurable from 1-20 tracks, with flexible layout options to match your site’s design.</p>
<h4>Key Features</h4>
<ul>
<li><strong>Live Editor Preview</strong> – See your actual Last.fm data while editing in Gutenberg</li>
<li><strong>Flexible Layouts</strong> – Choose between list and grid views for the Recently Played block</li>
<li><strong>Customisable Display</strong> – Toggle artwork, timestamps, and Last.fm links on or off</li>
<li><strong>Smart Caching</strong> – Minimises API calls while keeping data fresh (1 min for Now Playing, 5 min for Recently Played)</li>
<li><strong>Graceful Degradation</strong> – If the API is unavailable, cached data is served; if no cache exists, blocks simply don’t render</li>
<li><strong>Theme-Friendly Styling</strong> – Uses CSS custom properties so you can easily match your theme</li>
<li><strong>Responsive Design</strong> – Looks great on all screen sizes</li>
<li><strong>Custom Placeholder</strong> – Upload your own placeholder image for tracks without artwork</li>
</ul>
<h4>External Services</h4>
<p>This plugin connects to the Last.fm API (<code>https://ws.audioscrobbler.com/2.0/</code>) to retrieve your public listening history and display it on your WordPress site.</p>
<p><strong>What the service is used for:</strong></p>
<p>This plugin uses the Last.fm API to fetch your recent scrobbles (listening history) so they can be displayed on your WordPress site using the Now Playing and Recently Played blocks.</p>
<p><strong>What data is sent:</strong></p>
<ul>
<li>Your Last.fm username</li>
<li>Your Last.fm API key</li>
<li>The number of tracks to retrieve</li>
</ul>
<p><strong>When data is sent:</strong></p>
<ul>
<li>When the Now Playing or Recently Played blocks are displayed on a page</li>
<li>Data is cached locally to minimise API requests (1 minute for Now Playing, 5 minutes for Recently Played)</li>
</ul>
<p><strong>Service provider:</strong></p>
<p>This service is provided by Last.fm Ltd.</p>
<ul>
<li><a href="https://www.last.fm/legal/terms" rel="nofollow ugc">Last.fm Terms of Service</a></li>
<li><a href="https://www.last.fm/legal/privacy" rel="nofollow ugc">Last.fm Privacy Policy</a></li>
</ul>
<p>No personal data from your site visitors is collected or sent to Last.fm. Only your configured Last.fm username and API key are transmitted to retrieve your public listening data.</p>
<h3>CSS Customisation</h3>
<p>The plugin uses CSS custom properties (CSS variables) for easy theming. Add these to your theme’s CSS to override the defaults:</p>
<pre><code>:root {
    /* Artwork sizes */
    --scrobble-artwork-size: 64px;
    --scrobble-artwork-size-grid: 100%;

    /* Spacing */
    --scrobble-gap: 1rem;

    /* Typography */
    --scrobble-font-size-track: inherit;
    --scrobble-font-size-artist: 0.875em;
    --scrobble-font-size-timestamp: 0.75em;

    /* Colours */
    --scrobble-color-text: inherit;
    --scrobble-color-text-secondary: inherit;
    --scrobble-color-link: inherit;
}
</code></pre>
<h4>Example: Larger Artwork</h4>
<pre><code>:root {
    --scrobble-artwork-size: 100px;
}
</code></pre>
<h4>Example: Custom Colours</h4>
<pre><code>:root {
    --scrobble-color-text: #333;
    --scrobble-color-text-secondary: #666;
    --scrobble-color-link: #1db954;
}
</code></pre>
<h3>Additional Notes</h3>
<h4>Requirements</h4>
<ul>
<li>WordPress 6.0 or higher</li>
<li>PHP 7.4 or higher</li>
<li>A Last.fm account (free)</li>
<li>A Last.fm API key (free, get one at last.fm/api)</li>
</ul>
<h4>Source Code</h4>
<p>This plugin uses build tools to compile JavaScript for the block editor. The compiled files are located in the <code>build/</code> directory.</p>
<p>The original, human-readable source code is available in the <code>src/</code> directory and on GitHub:<br />
<a href="https://github.com/jordesign/scrobbled-blocks" rel="nofollow ugc">https://github.com/jordesign/scrobbled-blocks</a></p>
<p>To build from source:</p>
<ol>
<li>Clone the repository</li>
<li>Run <code>npm install</code> to install dependencies</li>
<li>Run <code>npm run build</code> to compile the blocks</li>
</ol>
<h4>Support</h4>
<p>For bug reports and feature requests, please visit the <a href="https://github.com/jordesign/scrobbled-blocks/issues" rel="nofollow ugc">GitHub repository</a>.</p>
<h4>Contributing</h4>
<p>Contributions are welcome! Please see the <a href="https://github.com/jordesign/scrobbled-blocks" rel="nofollow ugc">GitHub repository</a> for development guidelines.</p>


Scrobbled Blocks

Display your Last.fm listening activity on your WordPress site with native Gutenberg blocks.

Sarah Norris

<p>GrooveLog Blocks for Last.fm adds block-based Last.fm listening data to your WordPress site.</p>
<p>The plugin currently includes a Recently Played Tracks block that displays the latest tracks from a Last.fm user. Add a username, choose how many tracks to show, and optionally include artwork and links back to Last.fm.</p>
<h4>Features</h4>
<ul>
<li>Display 1 to 50 recently played tracks.</li>
<li>Show track names and artist names.</li>
<li>Link tracks to their Last.fm pages.</li>
<li>Add optional artwork using default, vinyl, cassette, or CD styles.</li>
<li>Configure your Last.fm API key once for all blocks.</li>
<li>Cache Last.fm responses for five minutes to reduce repeat API requests.</li>
</ul>
<h4>Recently Played Tracks</h4>
<p>Use this block to show a list of recently played tracks from a Last.fm profile.</p>
<p>Block settings:</p>
<ul>
<li>Last.fm Username: the Last.fm username to fetch tracks for.</li>
<li>Number of Tracks: the number of tracks to display. Defaults to 1.</li>
<li>Include Album Art: whether to include artwork for each track. Disabled by default.</li>
<li>Artwork Type: default, vinyl record, CD, or cassette tape.</li>
<li>Include Link to Track: whether to link each track to Last.fm.</li>
</ul>
<p>Set the Last.fm API key once in Settings > GrooveLog Blocks for Last.fm, then add your Last.fm username in the block sidebar.</p>
<h3>External Services</h3>
<p>This plugin connects to the <a href="https://www.last.fm/api" rel="nofollow ugc">Last.fm API</a> to fetch recently played track data. When a page containing the Recently Played Tracks block is rendered, the plugin sends the saved Last.fm API key, the configured Last.fm username, and the requested number of tracks to <code>https://ws.audioscrobbler.com/2.0/</code>.</p>
<p>The response can include track names, artist names, Last.fm track URLs, and artwork URLs. When track artwork is enabled, visitors’ browsers may request the returned artwork image URLs directly. Responses are cached in WordPress transients for five minutes. The plugin stores the Last.fm API key in the WordPress options table and stores the Last.fm username in block attributes.</p>
<p>Last.fm service links:</p>
<ul>
<li><a href="https://www.last.fm/api" rel="nofollow ugc">Last.fm API documentation</a></li>
<li><a href="https://www.last.fm/api/tos" rel="nofollow ugc">Last.fm API Terms of Service</a></li>
<li><a href="https://www.last.fm/legal/privacy" rel="nofollow ugc">Last.fm Privacy Policy</a></li>
</ul>
<h3>Source Code</h3>
<p>The distributed plugin includes compiled block assets in the <code>build</code> directory. The human-readable source code and build tools are available on <a href="https://github.com/mikachan/groovelog-blocks-for-last-fm" rel="nofollow ugc">GitHub</a>.</p>
<p>To build the plugin assets from source, run <code>npm install</code> and <code>npm run build</code>.</p>


GrooveLog Blocks for Last.fm

Display Last.fm listening activity in WordPress blocks, starting with recently played tracks.

Scrobbled Blocks vs GrooveLog Blocks for Last.fm