# Background Music for Elementor

Add elegant background music playback capability to your WordPress website using this Elementor widget.

## Features

* **Easy Integration**: Seamlessly adds to your Elementor editor
* **Customizable Player**: Control the look and position of your audio player
* **Audio Settings**: Options for looping and remembering playback position
* **Position Control**: Place the player anywhere on your website
* **Styling Options**: Customize colors, size, and more
* **Volume Control**: Optional volume slider for user control
* **Mobile Friendly**: Responsive design works on all devices
* **Translation Ready**: Fully translatable for international use

## Requirements

* WordPress 5.0 or higher
* Elementor 3.0.0 or higher
* PHP 7.0 or higher

## Installation

1. Upload the plugin files to the `/wp-content/plugins/background-music-elementor` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Use the widget in Elementor by searching for "Background Music"

## Usage

1. Edit any page with Elementor
2. Find the "Background Music" widget in the widget panel
3. Drag and drop it onto your page
4. Upload your audio file and configure settings
5. Save and preview

## Translating the Plugin

The plugin is fully translatable. To create a translation for your language:

1. Use the included POT file in the `languages` folder as a template
2. Create a new PO file for your language (e.g., `background-music-elementor-de_DE.po`)
3. Translate all strings
4. Generate the MO file
5. Place both files in the `languages` folder

## Customization Options

### Audio Settings
- Upload any MP3 audio file
- Loop audio playback
- Remember audio position between page navigations
- Show/hide player button

### Position Settings
- Position type: Default (inline), Fixed (stays in viewport), or Absolute (relative to container)
- Position presets: Top Left, Top Right, Bottom Left, Bottom Right
- Custom horizontal and vertical offset
- Custom z-index

### Style Settings
- Background color
- Icon color
- Button and icon size
- Border style, width, and radius
- Box shadow
- Padding and margin

### Additional Controls
- Show/hide volume control
- Set default volume level

## Changelog

### 1.0.0
* Initial release

## License

This plugin is licensed under the GPL v2 or later.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

## Support

For support, please visit [https://ijonis.com/background-music-elementor](https://ijonis.com/background-music-elementor)

## Author

[IJONIS](https://ijonis.com/)

## Contributors

[https://github.com/IJONIS/](https://github.com/IJONIS/)