Books Project

Custom Arabic-first WordPress platform for book discovery, author publishing, and reader engagement.

Books is a custom-built WordPress platform designed to transform how books and authors are managed and discovered online. Instead of treating books as ordinary blog posts, the platform introduces a structured content system with dedicated dashboards, secure downloads, SEO tooling, external importers, and an AI-powered Arabic discovery assistant.

Project Overview

• Project Type: Custom WordPress Platform
• Timeline: 2024 – 2025
• Role: Full-stack WordPress Development
• Focus: Structured content, reader engagement, author workflows, secure digital delivery

The Problem

Traditional WordPress websites are built around posts and pages, which makes them a poor fit for a serious books platform. This project needed books and authors to behave like first-class content entities with their own metadata, relationships, templates, URLs, and discovery flows.

The platform also had to support three different user groups at the same time: readers looking for discovery and personal tools, authors needing controlled self-service publishing, and administrators who required moderation, SEO control, import workflows, and platform oversight.

On top of that, the entire experience had to be Arabic-first, RTL-friendly, scalable, and flexible enough to grow beyond a simple content directory.

The Solution

I developed a custom WordPress theme and product layer that transforms WordPress into a structured books platform. Books and authors are modeled as dedicated entities instead of generic blog content, supported by custom dashboards, advanced filtering, secure file delivery, and AI-assisted discovery.

The public-facing experience focuses on discovery through featured sections, archive filtering, author pages, related content, live search, and rich single-book layouts. Behind the scenes, the platform includes moderation-aware author publishing, reader dashboards, secure downloads, automation tools, and a catalog-aware Arabic chatbot.

Key Features

Custom Content Architecture

• Custom post types for books and authors
• Custom taxonomies for genre, series, tags, author country, and author type
• Rich metadata fields for ISBN, publisher, language, publication date, page count, format, awards, SEO overrides, social links, and author-to-user linking
• Dedicated archive and single templates for books, authors, genres, and dashboard routes

Discovery-Focused Experience

• Custom homepage with featured books, latest books, popular titles, featured authors, and category browsing
• Arabic-first live search with overlay interface and mixed book/author results
• Archive filters for genre, format, and sorting by newest, oldest, views, rating, and title
• Rich single-book and single-author pages built around metadata, relationships, and related content

Reader Features

• Custom reader role with a dedicated front-end dashboard
• Reading list states such as want to read, reading, and finished
• Book rating system stored in a dedicated custom database table
• Author follow system with persistent counts and dashboard views
• Profile management and download history tracking

Author Dashboard

• Custom author role with limited capabilities
• Front-end registration and login flow
• Author dashboard for profile editing, book submissions, downloads, and article publishing
• Moderation-friendly workflow where authors can submit content without direct publishing access
• Author-linked editorial posts for thought leadership and related content

Secure Digital Delivery

• Token-based download URLs instead of direct file links
• Logged-in access rules and token expiry
• Rate limiting, MIME validation, and audit logging
• Download tracking for both readers and authors
• Support for PDF, EPUB, and MOBI files

SEO and Structured Data

• Custom meta titles and descriptions for books, authors, and site pages
• Open Graph and Twitter metadata
• Structured data for Book, Person, breadcrumbs, organization, and collection pages
• Sitemap support for key post types and taxonomies
• Internal linking between books and authors to improve discovery and indexability

Operations and Automation

• Importer tools for external catalog sources
• Source tracking and image import handling
• Scheduled imports through WP-Cron
• Configurable email templates for onboarding and notifications
• Admin settings for AI assistant and importer behavior

AI-Assisted Discovery

• Arabic chatbot powered by DeepSeek
• Context-aware responses based on actual catalog data
• Prompt rules that restrict answers to available book records
• Book-page awareness for contextual reader support

Technical Highlights

• Built as a custom WordPress theme in PHP 8
• Tailwind CSS with a local build pipeline
• Vanilla JavaScript for lightweight interactions
• Custom database tables for ratings, follows, files, and download logs
• Homepage query caching with transients
• Security measures including nonce checks, sanitization, capability checks, and rate limiting
• SSRF-aware URL validation in importer workflows
• Custom rewrite rules and dashboard routing for product-like user flows

Challenges

Turning WordPress Into a Product

The biggest challenge was moving WordPress beyond its default blog structure. Books and authors needed custom relationships, structured metadata, user-specific flows, and dashboard-driven experiences. I solved that by combining custom post types, taxonomies, metadata, rewrite rules, custom tables, and front-end templates into a cohesive application-like system.

Balancing Author Freedom With Editorial Control

Authors needed enough flexibility to manage profiles and submit books, but not enough access to bypass moderation or affect site quality. This was solved through restricted user roles, front-end submission tools, pending-review workflows, and controlled file handling.

Supporting Modern Features Without Theme Bloat

The platform includes live search, dashboards, ratings, follows, downloads, importers, and AI discovery. To keep it maintainable and performant, I separated features into modular systems and supported them with lightweight JavaScript and selective caching.

Designing for Arabic-First UX

This was not a translated site added later. The platform was planned around Arabic reading behavior and RTL layout from the beginning, including search interaction, content structure, archive flow, and dashboard experience.

Outcome

The final product feels much closer to a specialized books platform than a standard WordPress content site. Readers get a stronger discovery experience, authors get a controlled publishing workflow, and administrators get the tools needed to manage and scale the catalog responsibly.

More importantly, the platform creates a strong technical foundation for future growth. With structured content models, interaction data, account systems, imports, and SEO infrastructure already in place, it can expand into premium content, subscriptions, community features, and advanced recommendation systems without requiring a full rebuild.

Tech Stack

• WordPress
• PHP 8
• MySQL
• Tailwind CSS
• Vanilla JavaScript
• Font Awesome
• Composer
• PHPCS / WordPress Coding Standards
• DeepSeek API
• WP-Cron