=== IslamSource ===
Contributors: GregoryMorse
Donate link: http://www.islamSource.info/
Tags: Islam,Quran,calligraphy,phrases,verses
Requires at least: 3.0.1
Tested up to: 4.3.1
Stable tag: trunk
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Islam Source Plugin to insert Quranic verses and calligraphy of Islamic phrases easily and simply.
== Description ==
Islam Source Quranic Verse and Islamic Phrase Plugin - Allows for Quranic chapters, verses even specified down through the word to be inserted easily by using formats {a🅱️c-x:y:z} where b, c, x, y and z are optional depending on if a chapter, verse or particular word of a verse is desired or a range is desired so it could be in forms {a:b-y} or {a:b-x:y} such as the opening chapter which could be specified as {1:1-7}. The Arabic is automatically displayed when posts are viewed. It also allows for various calligraphy and Unicode Islamic words or phrases to be easily inserted through a button on the visual editor which are displayed when the posts are later viewed.
== Installation ==
1. Automated installation through the plugin menu, at which point the icon will appear in the Visual editor and any matching tags will be shown.
2. Manual installation: Difficulties due to the large size of the plugin for the metadata, translation and Quran resources may require adjusting the web server at least temporarily to upload the plugin: PHP in php.ini: post_max_size = 128M and upload_max_filesize = 128M, IIS in applicationhost.config or web.config: configuration -> system.webServer -> security -> requestFiltering -> add or change `<requestLimits maxAllowedContentLength="134217728" />`
3. Extract `http://www.islamsource.info/IslamSource.zip` to the `/wp-content/plugins/` directory.
4. Activate the plugin through the 'Plugins' menu in WordPress.
== Frequently Asked Questions ==
What parameters can be set?
{a🅱️c-x:y:z;parameter=value;parameter}
e.g. {1:1-2;W4W;TranslitStyle=RuleBased;TranslitScheme=PlainRoman;Translation=en.pickthall}
"Header"
Turn on the Ruku, Surah, Ayah header display.
"W4W"
Enable Word-for-Word mode.
"W4WNum"
Enable Word-for-Word mode showing the number of each word in the verse.
"NoArabic"
Disable the Arabic as well as transliteration.
"TranslitStyle"="Literal"|"RuleBased"|"LearningMode"
Literal is a character by character transliteration, rule based applies tajweed rules and learning mode applies tajweed rules showing options for stopping/continuing
"TranslitScheme=<name from list below>"
Name Transliteration
ExtendedBuckwalter Extended Buckwalter
IPAValues IPA Values
RomanTranslit Roman Transliteration
HansWeir Hans Weir
HansWeir4thEdition Hans Weir 4th Edition
PlainRoman Plain Roman
InternetArabic Internet Arabic
"Translation="
default to en.sahih Saheeh International (Saheeh International)
"Translation=<name from list below>"
Name Translation
en-maulana_ali Maulana Muhammad Ali (Maulana Muhammad Ali)
en.asad Muhammad Asad (Asad)
sq.nahi Hasan Efendi Nahi (Efendi Nahi)
sq.mehdiu Feti Mehdiu (Feti Mehdiu)
sq.ahmeti Sherif Ahmeti (Sherif Ahmeti)
ber.mensur Ramdane At Mansour (At Mensur)
ar.jalalayn Jalal ad-Din al-Mahalli and Jalal ad-Din as-Suyuti (تفسير الجلالين)
ar.muyassar King Fahad Quran Complex (تفسير المیسر)
am.sadiq Muhammed Sadiq and Muhammed Sani Habib (ሳዲቅ & ሳኒ ሐቢብ)
az.mammadaliyev Vasim Mammadaliyev and Ziya Bunyadov (Məmmədəliyev & Bünyadov)
az.musayev Alikhan Musayev (Musayev)
bn.hoque Zohurul Hoque (জহুরুল হক)
bn.bengali Muhiuddin Khan (মুহিউদ্দীন খান)
bs.korkut Besim Korkut (Korkut)
bs.mlivo Mustafa Mlivo (Mlivo)
bg.theophanov Tzvetan Theophanov (Теофанов)
zh.jian Ma Jian (Ma Jian)
zh.majian Ma Jian (Ma Jian (Traditional))
cs.hrbek Preklad I. Hrbek (Hrbek)
cs.nykl A. R. Nykl (Nykl)
dv.divehi Office of the President of Maldives (ދިވެހި)
nl.keyzer Salomo Keyzer (Keyzer)
nl.leemhuis Fred Leemhuis (Leemhuis)
nl.siregar Sofian S. Siregar (Siregar)
en.ahmedali Ahmed Ali (Ahmed Ali)
en.ahmedraza Ahmed Raza Khan (Ahmed Raza Khan)
en.arberry A. J. Arberry (Arberry)
en.daryabadi Abdul Majid Daryabadi (Daryabadi)
en.hilali Muhammad Taqi-ud-Din al-Hilali and Muhammad Muhsin Khan (Hilali & Khan)
en.itani Talal Itani (Itani)
en.maududi Abul Ala Maududi (Maududi)
en.pickthall Mohammed Marmaduke William Pickthall (Pickthall)
en.qarai Ali Quli Qarai (Qarai)
en.qaribullah Hasan al-Fatih Qaribullah and Ahmad Darwish (Qaribullah & Darwish)
en.sahih Saheeh International (Saheeh International)
en.sarwar Muhammad Sarwar (Sarwar)
en.shakir Mohammad Habib Shakir (Shakir)
en.transliteration English Transliteration (Transliteration)
en.wahiduddin Wahiduddin Khan (Wahiduddin Khan)
en.yusufali Abdullah Yusuf Ali (Yusuf Ali)
fr.hamidullah Muhammad Hamidullah (Hamidullah)
de.aburida Abu Rida Muhammad ibn Ahmad ibn Rassoul (Abu Rida)
de.bubenheim A. S. F. Bubenheim and N. Elyas (Bubenheim & Elyas)
de.khoury Adel Theodor Khoury (Khoury)
de.zaidan Amir Zaidan (Zaidan)
ha.gumi Abubakar Mahmoud Gumi (Gumi)
hi.farooq Muhammad Farooq Khan and Muhammad Ahmed (फ़ारूक़ ख़ान & अहमद)
hi.hindi Suhel Farooq Khan and Saifur Rahman Nadwi (फ़ारूक़ ख़ान & नदवी)
id.indonesian Indonesian Ministry of Religious Affairs (Bahasa Indonesia)
id.muntakhab Muhammad Quraish Shihab et al. (Quraish Shihab)
id.jalalayn Jalal ad-Din al-Mahalli and Jalal ad-Din as-Suyuti (Tafsir Jalalayn)
it.piccardo Hamza Roberto Piccardo (Piccardo)
ja.japanese Unknown (Japanese)
ko.korean Unknown (Korean)
ku.asan Burhan Muhammad-Amin (تهفسیری ئاسان)
ms.basmeih Abdullah Muhammad Basmeih (Basmeih)
ml.abdulhameed Cheriyamundam Abdul Hameed and Kunhi Mohammed Parappoor (അബ്ദുല് ഹമീദ് & പറപ്പൂര്)
ml.karakunnu Muhammad Karakunnu and Vanidas Elayavoor (കാരകുന്ന് & എളയാവൂര്)
no.berg Einar Berg (Einar Berg)
fa.ghomshei Mahdi Elahi Ghomshei (الهی قمشهای)
fa.ansarian Hussain Ansarian (انصاریان)
fa.ayati AbdolMohammad Ayati (آیتی)
fa.bahrampour Abolfazl Bahrampour (بهرام پور)
fa.khorramdel Mostafa Khorramdel (خرمدل)
fa.khorramshahi Baha'oddin Khorramshahi (خرمشاهی)
fa.sadeqi Mohammad Sadeqi Tehrani (صادقی تهرانی)
fa.fooladvand Mohammad Mahdi Fooladvand (فولادوند)
fa.mojtabavi Sayyed Jalaloddin Mojtabavi (مجتبوی)
fa.moezzi Mohammad Kazem Moezzi (معزی)
fa.makarem Naser Makarem Shirazi (مکارم شیرازی)
pl.bielawskiego Józefa Bielawskiego (Bielawskiego)
pt.elhayek Samir El-Hayek (El-Hayek)
ro.grigore George Grigore (Grigore)
ru.abuadel Abu Adel (Абу Адель)
ru.muntahab Ministry of Awqaf, Egypt (Аль-Мунтахаб)
ru.krachkovsky Ignaty Yulianovich Krachkovsky (Крачковский)
ru.kuliev Elmir Kuliev (Кулиев)
ru.kuliev-alsaadi Elmir Kuliev (with Abd ar-Rahman as-Saadi's commentaries) (Кулиевас-Саади)
ru.osmanov Magomed-Nuri Osmanovich Osmanov (Османов)
ru.porokhova V. Porokhova (Порохова)
ru.sablukov Gordy Semyonovich Sablukov (Саблуков)
sd.amroti Taj Mehmood Amroti (امروٽي)
so.abduh Mahmud Muhammad Abduh (Abduh)
es.asad Muhammad Asad - Abdurrasak Pérez (Asad)
es.bornez Raúl González Bórnez (Bornez)
es.cortes Julio Cortes (Cortes)
es.garcia Muhammad Isa García (Garcia)
sw.barwani Ali Muhsin Al-Barwani (Al-Barwani)
sv.bernstrom Knut Bernström (Bernström)
tg.ayati AbdolMohammad Ayati (Оятӣ)
ta.tamil Jan Turst Foundation (ஜான் டிரஸ்ட்)
tt.nugman Yakub Ibn Nugman (Yakub Ibn Nugman)
th.thai King Fahad Quran Complex (ภาษาไทย)
tr.golpinarli Abdulbaki Golpinarli (Abdulbakî Gölpınarlı)
tr.bulac Alİ Bulaç (Alİ Bulaç)
tr.transliteration Muhammet Abay (Çeviriyazı)
tr.diyanet Diyanet Isleri (Diyanet İşleri)
tr.vakfi Diyanet Vakfi (Diyanet Vakfı)
tr.yuksel Edip Yüksel (Edip Yüksel)
tr.yazir Elmalili Hamdi Yazir (Elmalılı Hamdi Yazır)
tr.ozturk Yasar Nuri Ozturk (Öztürk)
tr.yildirim Suat Yildirim (Suat Yıldırım)
tr.ates Suleyman Ates (Süleyman Ateş)
ur.maududi Abul A'ala Maududi (ابوالاعلی مودودی)
ur.kanzuliman Ahmed Raza Khan (احمد رضا خان)
ur.ahmedali Ahmed Ali (احمد علی)
ur.jalandhry Fateh Muhammad Jalandhry (جالندہری)
ur.qadri Tahir ul Qadri (طاہر القادری)
ur.jawadi Syed Zeeshan Haider Jawadi (علامہ جوادی)
ur.junagarhi Muhammad Junagarhi (محمد جوناگڑھی)
ur.najafi Ayatollah Muhammad Hussain Najafi (محمد حسین نجفی)
ug.saleh Muhammad Saleh (محمد صالح)
uz.sodik Muhammad Sodik Muhammad Yusuf (Мухаммад Содик)
== Screenshots ==
1. The visual editor showing the toolbar, popup and style of tags.
2. The rendered result when viewing the post.
== Changelog ==
= 1.6 =
Updated metadata system for latest changes involving learning mode and contiguity and some efficiency enhancements.
= 1.3 =
Better organization, error checking, fixes and ability to add Arabic text.
= 1.2 =
Speed optimizations.
= 1.1 =
Fixes and translations.
= 1.0 =
Initial version.
== Upgrade Notice ==
None