โ† Back to BlogProduct News

Bezalel 1.1: a PHP CMS for blogs, magazines, online stores and company websites (live preview, download and install guide)

A
Adebo Adegboye David
Nov 16, 2026 ยท 17 min read
Bezalel 1.1: a PHP CMS for blogs, magazines, online stores and company websites (live preview, download and install guide)

Bezalel is a lightweight PHP content management system built by Adewebs Technologies. One script runs a luxury entertainment blog, a tech magazine, a travel and lifestyle journal, a full company website, or a complete online store. It installs on ordinary shared hosting in a couple of minutes, writes its own database, and gives you an editor, SEO tools, traffic statistics, comments, sharing and a shop for physical goods, services and digital downloads.

Version 1.1 adds two ready-made store themes, a WordPress and WooCommerce importer, one-click signed updates, ad and analytics connections, email notifications and a built-in security layer. This guide shows what it does, lets you try it live, and walks you through downloading it from our server and installing it, step by step.

Try the live preview   Switch between all the themes with the "Try another theme" button, and open the read-only admin to look around.

Bezalel's public site. Light by default, with a dark-mode toggle for every visitor.
Bezalel's public site. Light by default, with a dark-mode toggle for every visitor.

Why we built Bezalel

For well over a decade, WordPress has carried the web. It has served countless companies, publishers and shops, in Africa and far beyond, and it deserves real respect for that.

But look at where the tools we rely on come from. Almost all of them were designed somewhere else, for someone else, and shipped to us. We have adapted, patched and worked around them for years. We have made them work, but they were not made with us in mind.

Our terrain is different. Many of our customers browse on phones and on slow, expensive data. Many businesses run on affordable shared hosting. WhatsApp is how stories travel, and how customers talk to the people they buy from. Payments run through Paystack, Flutterwave and IdentifyOrg, not only the gateways that Western tools take for granted. Sellers need to take orders and collect payment in naira, with cash on delivery and bank transfer as ordinary options, not afterthoughts.

At Adewebs Technologies, one of our core beliefs is that we should always build with Africa in mind. Nobody can tell our stories like we can, and nobody understands our terrain well enough to build for it like we do. So instead of waiting for the next imported tool to fit us a little better, we built our own.

Bezalel is a content management system made in Africa, for African businesses, and for anyone who wants a fast, honest, easy-to-own website. It installs on the hosting you can already afford, loads quickly on a phone, puts WhatsApp sharing first, and connects to the payment providers our customers actually use. It is ours, so we keep improving it for the people who use it.

This is only the beginning. If you build, publish or sell from Africa, we would love you to try it, tell us what is missing, and help shape what comes next.

What you get

  • A WordPress-style editor with headings, quotes, links, images and video (YouTube, Vimeo or files on your own server), drafts and scheduling.
  • Yoast-style SEO checks for the focus keyphrase, title, meta description and readability, plus a Google preview. Every page also ships with canonical links, social cards, structured data, a sitemap, a Google News sitemap and an RSS feed.
  • Traffic statistics without cookies or third parties: views, visitors, countries, referrers, search keywords, devices and share clicks, with filters and CSV export.
  • Comments and likes with nested replies, moderation and spam checks.
  • Sharing to WhatsApp, Facebook, X, Telegram, LinkedIn and more, with a sticky share bar on phones.
  • A full online store: physical goods, services and downloads with categories, sizes, colours, variants, stock, coupons, delivery methods, reviews and customer accounts, paid through IdentifyOrg (on by default), Paystack, Flutterwave, bank transfer or cash on delivery.
  • Thirteen themes, including complete designs for tech blogs, lifestyle sites, company websites and two online stores, with editable text, colours, fonts and images.
  • WordPress migration that keeps your posts, pages, comments, images and Google rankings.
  • Ads and analytics: Google Analytics, AdSense and other networks, with places to put your own code.
  • Email notifications through your own Gmail or SMTP account, and automatic attack blocking with optional two-step sign-in.
  • Your own HTML pages: paste any design into a page and edit it freely.
The admin dashboard with the traffic chart. The numbers shown are demo data.
The admin dashboard with the traffic chart. The numbers shown are demo data.
A story page with WhatsApp-first sharing buttons.
A story page with WhatsApp-first sharing buttons.

Step-by-step: download and install Bezalel

Before you start

You need web hosting (shared hosting, a VPS or a dedicated server) with PHP 8.1 or newer. Almost every host already has the PHP extensions Bezalel uses: SQLite or MySQL, cURL, fileinfo, mbstring and DOM. The installer checks all of this for you and tells you what to fix. If your host lets you choose the PHP version (in cPanel it is called Select PHP Version or MultiPHP Manager), pick 8.1 or higher for your domain first.

Step 1. Download the package

Download Bezalel 1.1 (11.0 MB)

The file is bezalel-1.1.zip, stored on our server at https://api.adewebstech.ng/media/downloads/bezalel-1.1.zip. To confirm your download is complete and untouched, its SHA-256 fingerprint is:

65d538dfdab511d5a7310400e1733acaa86930dc40a38fc88721835a1317655f

On a Mac or Linux computer you can check it with shasum -a 256 bezalel-1.1.zip. On Windows use certutil -hashfile bezalel-1.1.zip SHA256.

Step 2. Upload it to your hosting

Choose whichever suits you:

  1. cPanel File Manager (easiest). Log in to cPanel and open File Manager. Go into the folder of your website (usually public_html; for a sub-folder such as yourdomain.com/blog, create that folder and open it). Click Upload, choose bezalel-1.1.zip, wait for it to finish, then right-click the file and choose Extract.
  2. FTP (FileZilla or similar). Extract the zip on your computer, then upload everything inside the bezalel folder to your website folder. Remember the hidden file .htaccess must be uploaded too.
  3. SSH on a VPS or dedicated server. Run these commands inside your site folder:
    wget https://api.adewebstech.ng/media/downloads/bezalel-1.1.zip
    unzip bezalel-1.1.zip
    cp -a bezalel/. . && rm -rf bezalel bezalel-1.1.zip

After extracting, make sure the files are directly in your site folder (you should see index.php, .htaccess and the folders app, install, themes, uploads, data and storage there), not inside an extra bezalel folder. If they are, select everything inside it and move it up one level.

Step 3. Check folder permissions

Bezalel must be able to write to three folders: data, uploads and storage. On most hosts this already works. If the installer later reports a folder is not writable, set its permission to 755 (or 775) in File Manager by right-clicking the folder and choosing Change Permissions.

Step 4. Open the installer

In your browser, go to https://yourdomain.com/install/. You will see the Bezalel installer with a server check: a list of ticks. Everything should be green. If something is red, the installer tells you how to fix it. Fix it, refresh the page, and continue.

The installer: server check, database choice, site details and a starting design.
The installer: server check, database choice, site details and a starting design.

Step 5. Choose your database

  • Automatic (recommended). Pick this if you do not have, or do not want to set up, a database. Bezalel creates its own SQLite database inside the data folder. There is nothing else to configure.
  • MySQL / MariaDB. Enter the database name, user, password and host from your hosting panel (the host is usually localhost). If the database does not exist yet, the installer tries to create it for you. Some shared hosts do not allow that. In that case create an empty database in cPanel under MySQL Databases, add your database user to it with all privileges, and enter those details.

Step 6. Name your site and pick a design

Enter your site name (it is filled in as Bezalel; change it to yours) and an optional tagline. Then choose a starting design. Each one comes with sample stories, pages, team members and photos so your site never looks empty. You can edit or delete all of it later:

  • Entertainment and celebrity news: breaking ticker, red-carpet stories, video and books.
  • Tech blog: the Circuit design for gadgets, AI, startups and security.
  • Travel, food, fashion and lifestyle: the Wanderlust design.
  • Company website: the Corporate design with services, team and testimonials.
  • Online store: fashion boutique: the Atelier design with 20 sample products, sizes and colours.
  • Online store: marketplace: the Market design for goods, services and downloads, with deals and filters.
  • Blank site: start from nothing.

Step 7. Create your administrator account

Enter your name, your email address (this is your login) and a password of at least 8 characters, choose your timezone, then press Install Bezalel. Near the button there is one optional tick box that lets us email you about important security and update notices; it is off unless you tick it. Within a few seconds you will see Your site is ready with your admin login details.

Step 8. Delete the install folder

This step is important. Leaving the installer on your server is a security risk. On the final screen press Delete the install folder for me. If that button cannot remove it on your host, delete the install folder yourself with File Manager or FTP. Until it is gone, the admin dashboard keeps showing a warning with the same delete button.

Step 9. Sign in and make it yours

Open https://yourdomain.com/admin and sign in. Then work through this short list:

  1. Settings > Logo & branding: upload your logo, favicon and default share image.
  2. Settings > Address & contact and Social: add your address, phone, email, WhatsApp number and social links. They appear across every page.
  3. Appearance: preview and activate a theme, choose your brand colour, light and dark backgrounds, and heading font. The + Sample content button adds a theme's sample content at any time.
  4. Customise theme: change every headline, tagline, service, testimonial and image the theme uses.
Appearance: thirteen themes with preview, one-click sample content and colour controls.
Appearance: thirteen themes with preview, one-click sample content and colour controls.
The Corporate theme, a complete company website you can edit without code.
The Corporate theme, a complete company website you can edit without code.

Step 10. Publish your first story

Go to Stories > New story. Write the headline, use the toolbar for headings, quotes, links, images and video, choose a category and featured image, and write a short excerpt. Type your focus keyphrase in the SEO panel and watch the SEO and readability lights turn green as you improve the text. Press Save draft to keep it private, or Publish. Choose a future date to schedule it.

The SEO and readability panel with a live Google preview.
The SEO and readability panel with a live Google preview.

Submit your sitemap (yourdomain.com/sitemap.xml) in Google Search Console, and add your verification code under Settings > SEO.

Step 11. Start selling (optional)

Open Payments. IdentifyOrg is switched on by default; paste your secret API key from your IdentifyOrg dashboard (Dashboard > API keys), press Save, then Test connection. Copy the webhook address shown on the page into the Webhooks section of your IdentifyOrg dashboard and paste the signing secret back. Use test keys first, then swap in live keys. Paystack and Flutterwave work the same way, and each card on the page lists the exact steps. Then add a product under Products (see the store section below), set a price and publish. Note that IdentifyOrg needs your site to run on HTTPS.

Step 12. Watch your traffic and talk to your readers

The dashboard shows views and visitors over 7 days, 30 days, 90 days or 12 months. Traffic opens the full report, where you can filter by country, referrer, page or keyword and export to CSV. Under Comments you approve, reply to and remove what readers say.

The traffic report. Click any row to filter, or use View more for the full list.
The traffic report. Click any row to filter, or use View more for the full list.
Phones get a sticky share bar with WhatsApp first.
Phones get a sticky share bar with WhatsApp first.

Try it live first

You do not need to install anything to see Bezalel in action. The live preview at bezalel.adewebstech.ng runs six complete demo sites: entertainment news, a tech blog, travel and lifestyle, a company website and both store themes. Use the Try another theme button at the bottom left to switch between them, and Admin demo to explore the dashboard. The preview is read-only and resets every day.

The live preview: one button switches the whole site to another theme.
The live preview: one button switches the whole site to another theme.

Build an online store

Choose Online store: fashion boutique (Atelier) or Online store: marketplace (Market) in the installer, or activate either theme later from Appearance. Every other theme can sell too: turn the shop on and it appears in the menu.

Atelier: an editorial luxury boutique. Every banner, headline and image is editable.
Atelier: an editorial luxury boutique. Every banner, headline and image is editable.
Market: deals, category icons, filters and fast browsing for a general store.
Market: deals, category icons, filters and fast browsing for a general store.

Add products

  1. Open Product categories and create your categories (for example Men, Women, Shoes). Categories can have a parent.
  2. Open Products > Add product. Choose the type: Physical (shipping and stock), Service (no shipping) or Digital download (upload a PDF or file that buyers receive after paying).
  3. Add the name, description, price and an optional sale price, then upload the photos. The first one is the main picture and the rest form the gallery. You can replace any image later.
  4. For clothing, shoes and similar items add options such as Size (S, M, L, XL) and Colour. Bezalel builds every combination as a variant with its own price, stock and SKU. Buyers must pick every option before they can add to the cart.
  5. Turn on Track stock to reduce stock automatically when an order is paid and show a "low stock" or "sold out" label. Cancelling an order puts the stock back.
  6. Press Publish. Mark a product as Featured or give it a badge such as New or Sale to place it on the home page.
A product page: gallery, size and colour pickers, reviews and delivery information.
A product page: gallery, size and colour pickers, reviews and delivery information.
Admin > Products with search, filters, bulk actions and stock at a glance.
Admin > Products with search, filters, bulk actions and stock at a glance.

Everything else a store needs

  • Delivery: create delivery methods with a price, an estimated time and a free-delivery threshold.
  • Coupons: percentage or fixed discounts with a minimum order, expiry date and usage limit. The demo includes WELCOME10 and FREESHIP.
  • Orders: see every order, mark it paid or shipped, print a packing slip, and email the customer automatically.
  • Customers: shoppers can create an account, see their orders and reset a forgotten password by email.
  • Reviews: star ratings with moderation, shown on product pages and in search results.
  • Payments: payments are always confirmed with the gateway on the server before anything is released or shipped.

Bring your products from WooCommerce

Open Import from WordPress > WooCommerce products (.csv). In WooCommerce go to Products > Export, tick Export all columns, and upload the CSV here. Names, descriptions, prices, sale prices, stock, SKUs, categories, images and size or colour variations come across. Images are downloaded into your media library in small batches.

Move your WordPress site to Bezalel

Bezalel can take over an existing WordPress site and keep your content, your images and your search rankings. Follow these steps in order.

Admin > Import from WordPress.
Admin > Import from WordPress.
  1. Install Bezalel on the new hosting or in a new folder, using the steps above. Do not point your domain at it yet. You can pick the Blank starter so no sample content gets in the way.
  2. Export from WordPress. Sign in to the old site and go to Tools > Export. Choose All content and press Download Export File. You get a .xml file. If you also sell with WooCommerce, tick Products too.
  3. Import into Bezalel. Open Import from WordPress, choose the Export file (.xml) tab, upload the file, choose what to bring over (posts, pages, categories and tags, comments and product variations) and press Import. If your host limits upload size, copy the file into the storage/import folder by FTP and choose it from the list. No export file? Use the From website address tab and type your old site's address: Bezalel reads its public data directly.
  4. Let the images download. Images are fetched from the old site into your media library in small batches. Keep the old site online until the image counter finishes.
  5. Check your content. Look through Stories, Pages and Comments. Threaded replies, featured images, YouTube embeds and the SEO title and description from Yoast or Rank Math are kept. Unsafe code in old posts is removed automatically.
  6. Keep your rankings. Every old address is saved as a permanent (301) redirect to its new home, so visitors and Google follow the link to the right page. You can review, add or delete redirects in the Redirects tab.
  7. Switch over. When you are happy, point your domain to the new hosting. Tell Google by submitting yourdomain.com/sitemap.xml in Search Console.

Users and passwords are not copied for security. Add your team under Users and ask them to sign in with the new passwords.

Ads, analytics and other tools

Ads and integrations: paste an ID and Bezalel adds the right code for you.
Ads and integrations: paste an ID and Bezalel adds the right code for you.

Open Ads & integrations. Paste only the ID from each service and Bezalel places the correct code on every page:

  • Google Analytics 4: paste the Measurement ID (starts with G-) from Analytics > Admin > Data streams.
  • Google Tag Manager, Meta (Facebook and Instagram) pixel, TikTok pixel, Microsoft Clarity, Hotjar, Pinterest, LinkedIn Insight and Bing verification work the same way.
  • Google AdSense: paste your publisher ID (ca-pub-...). Bezalel serves the correct ads.txt for you, and you can place ad units at the top, inside stories, above the footer or as a sticky banner.
  • Any other network (Media.net, Ezoic, Taboola, affiliate scripts, chat widgets): use Other scripts to paste the code and choose where it loads. Add as many as you like.
  • Cookie notice: turn it on to load tracking only after a visitor agrees, which you need for visitors in the EU and UK.

Set up email notifications

Admin > Email: choose Gmail or SMTP, test it, and pick which alerts you want.
Admin > Email: choose Gmail or SMTP, test it, and pick which alerts you want.

Bezalel sends no email until you connect your own account, so nothing leaves your site without your say. Until you do, the dashboard shows a reminder. To connect:

  1. Open Email and choose Gmail (or your host's SMTP, Outlook, Zoho, Brevo, Mailgun and more; the page fills in the right server details).
  2. For Gmail, switch on 2-Step Verification in your Google account, then create an App password (Google Account > Security > App passwords). Paste that 16-character password here, not your normal one.
  3. Press Save, then Send test email. If it fails the page tells you why and what to change.
  4. Choose what you want to be told about: new comments, new orders, new customers, contact messages, new subscribers and blocked attackers. Customers also receive order confirmations and password-reset emails.

Updates, without the stress

Updates: signed by Adewebs Technologies, backed up first, rolled back if anything goes wrong.
Updates: signed by Adewebs Technologies, backed up first, rolled back if anything goes wrong.

Open Updates and press Check for updates (Bezalel also checks by itself once a day). When a new version is available, press Update now. Bezalel downloads it, verifies its checksum and Adewebs Technologies' digital signature, backs up your files, shows a short "updating" page to visitors, installs it, and restores the backup automatically if anything fails. Your content, uploads and settings are never touched.

Privacy: the check sends only your site address, site name, Bezalel version, PHP version, theme and a random install ID, never your visitors, customers or content. If you tick the optional box at install, we can also email you about important security updates. You can switch the check off in config.php.

Security built in

Admin > Security: a health check, blocked addresses and an activity log.
Admin > Security: a health check, blocked addresses and an activity log.
  • Attackers are blocked automatically. Scanners looking for wp-login.php, .env, .git or phpMyAdmin, SQL-injection and traversal attempts, known hacking tools and visitors who trigger dozens of missing pages are shut out. You see every action in Security and can unblock or add addresses yourself.
  • Brute-force protection. Sign-in is limited per address and per account, so one account cannot be guessed from many places. Comments, likes, contact, checkout, reviews and downloads are rate-limited too.
  • Two-step sign-in. Open Your profile and choose Set up two-step sign-in. Scan or type the key in Google Authenticator, Authy or 1Password. A stolen password is then no longer enough.
  • Safe sessions. Team members are signed out after two idle hours, and a session that suddenly changes browser is ended.
  • Hardened by default. Security headers, safe redirects, scanned uploads, and email links built from a saved address so a forged web address cannot hijack a password reset. Errors go to a private log, never to visitors.

The Health check on the Security page tells you in plain words if anything needs attention, such as HTTPS, a leftover install folder or an outdated version.

Prefer the command line?

On a server where you have SSH access you can install without the browser. Run this inside your site folder (leave out the database flags to use the automatic SQLite database):

php install/cli.php --name="My Site" --email=you@example.com --password='ChooseAStrongOne' --starter=tech
# MySQL instead (the database is created if it does not exist):
php install/cli.php --name="My Site" --email=you@example.com --password='ChooseAStrongOne' \
    --db=mysql --db-name=mysite --db-user=dbuser --db-pass=dbpass
rm -rf install

The starters are entertainment, tech, lifestyle, company, store-atelier, store-market and blank.

Troubleshooting

  • "500 Internal Server Error" straight after uploading. Check the PHP version is 8.1 or higher. If your host runs Nginx instead of Apache, ask them to route all requests to index.php (the guide in the package's README has the exact lines).
  • Pages other than the home page show "Not found". Apache's mod_rewrite must be on, and the hidden .htaccess file must have been uploaded.
  • The installer says a folder is not writable. Set data, uploads and storage to permission 755 or 775.
  • Uploading a large video fails. Your host limits upload size. Raise upload_max_filesize and post_max_size in your PHP settings, or paste a YouTube or Vimeo link instead.
  • Emails (comment alerts, order confirmations) do not arrive. Open Email, connect Gmail or SMTP, and press Send test email. The page shows the exact reason if it fails. Also check the spam folder.
  • I locked myself out after too many attempts. Wait 15 minutes, or ask your host to delete the blocked_ips and rate_limits table rows in your database. Add your own address under Security > Never block these addresses once you are in.
  • You see a white page. Copy config.sample.php to config.php, remove the // in front of 'debug' => true, reload, and read the message. Switch it off again when you are done.

Backups

Copy the data (database), uploads and storage folders and the config.php file. That is your entire site.

Need a hand, or a custom build?

If you would like us to install Bezalel for you, set up your payments, or build a custom website or software product, talk to Adewebs Technologies. We also build mobile apps, business platforms and integrations for businesses across Nigeria and beyond.

Share this article:WhatsAppXFacebookLinkedIn

Comments

Be the first to comment.

Bezalel 1.1 PHP CMS: live preview, WordPress import and install guide | Adewebs Technologies