অ্যাপ বিল্ডার
আপনার সাইটকেই মোবাইল, ট্যাব ও স্মার্ট টিভির অ্যাপ বানানো — অ্যাডমিন প্যানেল থেকেই ডিজাইন, বিল্ড ও ডাউনলোড।
The App Builder turns your site into apps — for phones and tablets, and for smart televisions — without a line of code. You choose the name, the colours, the icon and which tabs the app carries; the plugin draws every icon size and writes the whole project for you to download.
It is a premium plugin, and it needs Quran CMS 1.6.0 or newer.
What it makes
| What it is | What you do with it | |
|---|---|---|
| Web app | The site itself, installable | Nothing to build. A visitor opens /app and adds it to the home screen |
| Android | A Kotlin project (WebView) | Build an APK to hand out, or an .aab for Google Play. The same package is the Android TV app |
| iPhone & iPad | A Swift project, laid out by XcodeGen | Open in Xcode and send to the App Store |
| Samsung (Tizen) | A finished web app package | Nothing to compile — Tizen Studio wraps it |
| LG (webOS) | A finished web app package | Nothing to compile — the webOS CLI wraps it |
Every zip carries a GitHub Actions workflow, so an APK can be built on GitHub without installing Android Studio, and a README-BUILD.md with the steps for that platform and its store.
Switching it on
- Your licence must include the plugin. Without it, Admin → Plugins shows App Builder with a lock: Unlock opens the store at lcpanel.com, and a key bought on its own (it starts with
QCMP-) can be added under Admin → License → Plugin & theme keys. Keys bought for your site are usually fitted automatically at the next licence check. - On Admin → Plugins turn App Builder on. It adds no table.
- Five pages appear under Plugins in the menu: App Builder, Tabs & shortcuts, Store listing, Smart TV app and Build & download.
Admin → App Builder
The app
- Name — what shows under the icon and in the stores.
- Short name — used where there is no room, about twelve letters.
- Package / bundle id — like
bd.faruk.quranforme. It is the app's name to Android and to Apple, and it can never be changed once the app is in a store, so settle it before the first upload. - Version — like
1.0.0. Raise it for every store upload. - Opens on — a page of this site, such as
/or/prayer-times. - Held — portrait, landscape or either way. (On a television this is ignored: a television is always landscape.)
Colours and icon
Bar at the top, Background and Opening screen take a colour like #0b6b55.
Icon takes one square picture, 512×512 or larger. Every size a phone, a television or a store asks for — 48, 72, 96, 144, 192, 256, 384, 512 and 1024 — is drawn from it on your own server; nothing is sent anywhere. Left empty, the site logo is used.
How it behaves
- Pull down to reload — on or off.
- Links to other sites open in the browser — off keeps everything inside the app.
The bar along the bottom and the long-press menu have a page of their own.
Once it is in the stores
Put the Google Play address and the App Store address here, and /app offers them to visitors on the right device.
The installable web app
Nothing to build. Anyone who opens your-site/app on a phone can add the site to the home screen, and it opens full screen with your icon and your colours. Check the manifest opens what the phone reads. It needs HTTPS (on localhost it works for testing).
Admin → Tabs & shortcuts
The bar along the bottom
Up to five tabs, and every one of them is yours: add a tab, change its wording in English and Bengali, give it another icon, move it up or down, or remove it. A tab opens a page of this site — Home, Quran, Prayer times, Mosque screen, Hadith, Du‘as, Learn, Listen, Tools, Donate, My account — or, with An address of my own, anything at all: /blog, a page you wrote, even another website.
The phone beside it follows what you type, before you save.
This bar is drawn by the site, so a change shows up at once: in a phone browser, in the web app, and in the Android and iPhone apps already in people's hands. Nothing has to be built again.
The website uses this bar too — on by default. Switched off, the bar above is only for the apps and the website keeps its own five.
The long-press menu
Press and hold the app's icon on the home screen and up to four shortcuts appear, so somebody can go straight to the prayer times or to the mosque screen without opening the app first. Each one has its own wording, address and icon. They go into the installable web app and into the Android project.
Admin → Store listing
The words and addresses Google Play and the App Store ask for, written once here instead of into a store form at two in the morning. Every project you download carries them as store-listing.txt, ready to paste.
- Title in the store — 30 letters on both stores. Empty: the app's name.
- One line about it — Google Play's short description, 80 letters.
- The full description — up to 4,000 letters, plain words. Say what the app does, that the prayer times are worked out on the device, and that it works with no network: Apple turns down apps that are only a website in a frame.
- Category and Keywords (the App Store takes a comma list, 100 letters in all).
- Contact e-mail and Website — the store shows them.
- Privacy policy address — Google Play refuses an app without one. A page of this site will do: write it under Content → Pages and paste its address here.
A count under each box turns red when a store's limit is passed, and the card on the right shows what is still missing.
Admin → Smart TV app
- Build the Android package for televisions too — on by default. The one Android package is then both the phone app and the Android TV app: a television shows it in its own row of apps, a phone shows it as usual.
- Name on the television — left empty, the same name as the phone app.
- Opens on —
/prayer-times/screen?tv=1by default, so the television comes up on the mosque screen in its ten-foot layout. - Let the television sleep — off, because a mosque screen should stay lit. On, the television does what it normally does.
- Banner for the television — the wide picture (1280×720) Android TV shows in its row of apps. Left empty, one is drawn from your icon and your colours.
- Samsung (Tizen) package id — ten letters or numbers; left empty, one is worked out from the package name.
- LG (webOS) app id — usually the same as the package.
What a television shows draws the screen as it will appear, and Open it full size opens the real thing in a new tab.
Which to use
- An Android TV box or television (most are) — the Android package.
- A Samsung television — the Tizen package.
- An LG television — the webOS package.
- Any television with a browser — no app at all: open the copied screen link in it. Copy this screen's link on the screen's own settings sheet gives an address that carries every setting, for a television that cannot sign in.
Admin → Build & download
Each of the four cards builds its project and sends it to you as a zip. Nothing is left on the server: a zip older than an hour is swept away.
The page needs PHP's zip extension; without it the buttons are greyed out and the page says so.
The app file visitors download
Upload an APK here (the one you built) with its version, and /app offers it to Android visitors as a direct download — useful before the app is on Google Play, and for a television you install by USB. Remove it and the offer goes away.
Sending them to the stores
The page spells out what each store wants, and the readme inside each zip repeats it:
- Google Play — a signed
.aab; the Android readme says how, with the keystore and the repository secrets. - App Store — Xcode, a bundle id that matches, screenshots and the review notes. Apple turns down apps that are only a website in a frame, so say what this one does on its own: the prayer times are worked out on the device, and the mosque screen keeps a week by it and works with no network.
- Samsung and LG have their own seller accounts; both packages are ordinary web apps, so there is nothing to compile.
What a visitor sees at /app
your-site/app is a page for visitors: Get the app. It offers, in this order, what is actually available — Google Play or the App Store if you have put the addresses in, the APK if you have uploaded one, and Add to home screen with the steps for that phone. There is also a QR code of the page, to point a phone at from a television or a poster.
Questions
Must I know Android or iOS? No, to hand out an APK: push the Android zip to a GitHub repository and its workflow builds one. For the stores you need a developer account (Google Play once, Apple each year) and, for Apple, a Mac with Xcode.
Does the app work without the internet? The mosque screen does: the prayer times are worked out on the device, and a week of ayahs, notices and weather is kept. The rest of the site needs a connection.
I changed the colours — must I build again? For the web app, no. For the tabs along the bottom, no. For the name, the icon, the colours of the app shell itself and anything the stores see, yes.
Can I edit the project? Yes — it is an ordinary Android or Xcode project. Change what you like before you upload it. Build it again here and your changes are gone, so keep your copy.