কিবলা নির্ণয়
এই অধ্যায়টি এখনও অনুবাদ হয়নি, তাই ইংরেজিতে দেখানো হচ্ছে।
Qibla Finder shows the direction of the Ka‘bah from wherever the visitor is: the bearing in degrees from north, the distance to Makkah in kilometres, a dial with the Ka‘bah marked on it, a live compass on phones and a map with a line from the visitor to Makkah.
It is a free plugin and comes with Quran CMS.
Who it is for
Every Islamic website. Travellers, students abroad and people who have just moved home look for the qibla more often than for almost anything else, and a page that answers in one tap brings them back to your site.
Switching it on
Admin → Plugins, turn Qibla Finder on. The page is at /qibla and appears on the Islamic tools page (/tools) as Qibla direction. Put it in a menu under Appearance → Header & menus if you like.
What the visitor sees
The place
The page uses the same place as the prayer times: a place the visitor chose before, otherwise a rough guess from their connection (no question asked), and the default city of your site while it waits. At the top of the card:
- Use GPS asks the browser for the exact position.
- Change lets them search for a city anywhere in the world and pick it.
The place is shared with the prayer times page, so choosing it once is enough for both.
The dial and the figures
The dial has north at the top and the Ka‘bah marked at the qibla bearing. Below it:
- ° from north — the bearing, for use with any ordinary compass;
- km to Makkah — the distance along the earth's surface.
The direction is calculated along the great circle, the shortest path over the globe, from the visitor's coordinates to the Ka‘bah (21.4225° N, 39.8262° E). The page says so in its How to use box, together with four short steps.
The live compass (phones)
On a phone, Start the live compass turns the dial with the phone. The visitor holds the phone flat and turns until the Ka‘bah is at the top; the page then says You are facing the qibla. On an iPhone the browser asks for permission to use motion first.
When a device has no compass, or the visitor refuses motion access, the page says so plainly and they can still use the degrees and the map. When the compass seems wrong, it suggests moving the phone in a figure-8 to calibrate it, and the help box reminds them to keep away from metal and magnets.
The map
A map shows the visitor (You), the Ka‘bah and a dashed golden line between them along the great circle. The map uses Leaflet and OpenStreetMap tiles, loaded from public servers; it can be switched off.
Settings
Admin → Plugins → Qibla Finder → Settings:
| Setting | What it does |
|---|---|
| Show the map with a line to Makkah | On by default. Turn it off for a lighter page with only the dial and the figures. |
| Page address | qibla by default. Change it to, say, qibla-direction and the page moves there. |
There is nothing else to set: the plugin has no admin pages and keeps no data on your server.
Tips
- The live compass needs a secure page: run your site on https (every modern browser hides motion sensors from plain http pages).
- The default city under Settings → Prayer times is what visitors see before their own place is found, so set it to your own city.
- If your audience is mostly on phones, put the page among the first items of your main menu (it then shows in the phone menu that opens from More in the bottom bar) — it is one of the pages people open while standing up to pray.