=== MP3 Quran Translations All Languages ===
Contributors: truemuslims
Donate link: https://www.truemuslims.net/
Tags: quran, mp3 quran, quran audio, quran translation, quran recitation, islam, muslim, audio
Requires at least: 5.2
Tested up to: 6.9.3
Requires PHP: 7.2
Stable tag: 1.1.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add Quran MP3 translation and recitation playlists to WordPress posts and pages using the [mp3Quran] shortcode.

== Description ==

MP3 Quran Translations All Languages helps site owners add Quran audio playlists to WordPress pages and posts. The plugin provides shortcode-based playlists for Quran translations and recitations hosted by TrueMuslims.net.

Use the shortcode with a supported translation or reciter name:

`[mp3Quran]English[/mp3Quran]`

`[mp3Quran]Abdul Rahman Alsudaes[/mp3Quran]`

Current local plugin data includes 52 Quran translation playlists and 53 reciter playlist shortcodes.

= Support =

For support, Quran audio resources, and MP3 Quran updates, visit [TrueMuslims.net](https://www.truemuslims.net/).

= Plugin Video =

https://www.youtube.com/watch?v=qzIZlzJqW4g

= Features =

* Quran MP3 translation playlists using a shortcode.
* Quran recitation playlists using a shortcode.
* 114-surah playlist output with custom play and pause controls.
* Responsive playlist layout for desktop, tablet, and mobile screens.
* Safer shortcode handling for invalid or empty shortcode values.
* Front-end assets load only when the shortcode is used.

= Example Translation Shortcodes =

* `[mp3Quran]Arabic[/mp3Quran]`
* `[mp3Quran]Bangla[/mp3Quran]`
* `[mp3Quran]English[/mp3Quran]`
* `[mp3Quran]Filipino[/mp3Quran]`
* `[mp3Quran]French[/mp3Quran]`
* `[mp3Quran]German[/mp3Quran]`
* `[mp3Quran]Hindi[/mp3Quran]`
* `[mp3Quran]Indonesian[/mp3Quran]`
* `[mp3Quran]Somali[/mp3Quran]`
* `[mp3Quran]Tagalog[/mp3Quran]`
* `[mp3Quran]Urdu[/mp3Quran]`
* `[mp3Quran]Yoruba[/mp3Quran]`

= Example Reciter Shortcodes =

* `[mp3Quran]Abdul Rahman Alsudaes[/mp3Quran]`
* `[mp3Quran]Abdulbasit Abdulsamad[/mp3Quran]`
* `[mp3Quran]Abdur Rashid Sufi[/mp3Quran]`
* `[mp3Quran]Ahmed Al Ajmi[/mp3Quran]`
* `[mp3Quran]Maher Al Muaiqly[/mp3Quran]`
* `[mp3Quran]Mishary Al Afasy[/mp3Quran]`
* `[mp3Quran]Saad Al Ghamdi[/mp3Quran]`
* `[mp3Quran]Saud Al Shuraim[/mp3Quran]`
* `[mp3Quran]Yahya Hawa[/mp3Quran]`
* `[mp3Quran]Zaki Daghistani[/mp3Quran]`

== Installation ==

1. Upload the `mp3-quran` folder to the `/wp-content/plugins/` directory, or install the plugin from WordPress.org.
2. Activate the plugin through the WordPress Plugins screen.
3. Go to the MP3 Quran admin page to view available shortcode examples.
4. Add a shortcode such as `[mp3Quran]English[/mp3Quran]` to a page or post.

== Frequently Asked Questions ==

= Does the plugin store Quran audio files on my WordPress server? =

No. The audio files are loaded from TrueMuslims.net when visitors play the playlist.

= Can I use older shortcodes from the previous plugin version? =

Yes. The `[mp3Quran]Name[/mp3Quran]` shortcode format is preserved.

= What happens if an unsupported language or reciter is entered? =

The plugin now falls back safely instead of throwing PHP notices or broken output.

== Privacy ==

This plugin loads Quran MP3 audio files from TrueMuslims.net. When a visitor plays audio, their browser connects directly to TrueMuslims.net to request the MP3 file. TrueMuslims.net may receive standard web request information such as IP address, user agent, referrer, requested URL, and request time through normal server logs.

The plugin itself does not create WordPress user accounts, does not store visitor personal data in the WordPress database, and does not set tracking cookies.

== Third Party Services ==

The Quran audio files are served by TrueMuslims.net:

* Service: TrueMuslims.net Quran audio hosting
* Purpose: deliver MP3 Quran translation and recitation files used by the shortcode player
* Service URL: https://www.truemuslims.net/
* Privacy policy: https://www.truemuslims.net/privacy-policy.html

== Screenshots ==

1. Front-end Quran audio playlist generated by the shortcode.
2. MP3 Quran admin shortcode examples.

== Changelog ==

= 1.1.5 =
* Removed duplicate Saud Al Shuraim reciter entry from the shortcode data and admin shortcode list.
* Prepared next local release candidate after checking the live WordPress.org version.
* References the owner-provided plugin video: https://www.youtube.com/watch?v=qzIZlzJqW4g

= 1.1.4 =
* Replaced legacy download.php MP3 links with direct TrueMuslims.net MP3 file URLs.
* Restored shortcode playlist output to use custom play and pause controls instead of visible native audio controls.

= 1.1.3 =
* Fixed shortcode attribute handling and invalid playlist fallback.
* Escaped generated playlist titles, links, audio URLs, and attributes.
* Replaced deprecated PHP regex execution with a safe callback.
* Made player JavaScript safer when audio elements are missing or playback is blocked by the browser.
* Loaded front-end CSS and JavaScript only when the shortcode is used.
* Updated WordPress.org readme text, privacy/service disclosure, and screenshot captions.

= 1.1.2 =
* Initial public plugin release.




