Lyrics Finder

Lyrics Finder WordPress Plugin A WordPress plugin that allows users to search for and display song lyrics using the MusicXMatch API.

Features Search for lyrics by artist and song title Display lyrics with proper attribution and copyright notices AJAX-powered search with no page reloads Responsive design that works on all devices Caching mechanism to improve performance and reduce API calls Fully customizable via shortcode parameters Compliance with MusicXMatch copyright requirements Requirements WordPress 5.0 or higher PHP 7.2 or higher WordPress REST API enabled Installation Manual Installation Download the plugin zip file from the releases page Login to your WordPress admin panel Navigate to Plugins > Add New Click on the "Upload Plugin" button Click "Choose File" and select the downloaded zip file Click "Install Now" After installation completes, click "Activate Plugin" Usage Search Form Shortcode [lyrics_search_form] This shortcode displays a form where users can search for lyrics by artist and/or song title.

Optional Parameters:

placeholder_artist: Placeholder text for the artist input (default: "Artist name") placeholder_song: Placeholder text for the song input (default: "Song title") button_text: Text for the search button (default: "Search Lyrics") Example with custom parameters:

[lyrics_search_form placeholder_artist="Enter artist" placeholder_song="Enter song" button_text="Find Lyrics"] Lyrics Display Shortcode [lyrics_display artist="Artist Name" song="Song Title"] This shortcode directly displays lyrics for the specified artist and song.

Required Parameters:

artist: The artist name song: The song title At least one of these parameters must be provided.

Example:

[lyrics_display artist="Adele" song="Skyfall"] Configuration Go to Settings > Lyrics Finder Configure the cache duration (in seconds) - default is 86400 (1 day) Save changes Screenshots Lyrics search form Lyrics display Admin settings page Frequently Asked Questions How does this plugin work? This plugin uses the MusicXMatch API to search for and retrieve lyrics. It implements a PHP version of the MusicXMatch API wrapper.

Are there any API rate limits? The plugin includes caching to minimize API calls. By default, lyrics are cached for 24 hours, but you can adjust this in the plugin settings.

Can I customize the design? Yes, the plugin includes default CSS, but you can override it with your own styles in your theme or using a custom CSS plugin.

Does this plugin comply with copyright laws? Yes, the plugin displays lyrics with proper attribution and copyright notices as required by MusicXMatch. It's designed for educational purposes only.

Copyright and Attribution This plugin uses the MusicXMatch API to retrieve lyrics. All lyrics are copyrighted by their respective owners and MusicXMatch. The plugin includes appropriate copyright notices and attribution.

For more information about MusicXMatch copyright policy, please visit https://about.musixmatch.com/copyright.

Disclaimer This plugin is provided for educational purposes only. Any misuse or abuse of this information that contradicts this purpose is strictly prohibited and may constitute a violation of applicable laws and regulations.

License This plugin is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments MusicXMatch API for providing lyrics data Strvm/musicxmatch-api for the Python API wrapper that inspired this plugin