Personal page script ( PPscript v11.9.17 )

# Personal Page script ( PPscript v11.9.17 ) — Professional Project Description

## Overview

A complete **Personal Page Platform** built in pure **PHP** without any framework, with a frontend based on native **JavaScript** and custom **CSS**. It allows the owner to publish posts, photos, videos, and products, and visitors to interact via comments, reactions, and replies, with a full system for content, visitor, and advertising management.

---

## Key Features

### 📝 Content Management
- **Multi-media posts**: text, images (single or album), videos, attached files, links, tags.
- **Unified media slider** supporting touch navigation (Swipe) on mobile, with counter and navigation dots.
- **Custom video player** (VPlayer) with full controls: play/pause, progress bar, fullscreen, view counter.
- **Pin posts** to display them at the top.
- **Search and tags**: complete tagging system with dedicated pages (`tags.php`).

### 📸 Photos Tab
- Photo grid in reverse chronological order with infinite scroll.
- **Dedicated popup** for displaying photos at full size with their own comments (independent from post comments).
- Reaction counter and comment counter for each photo.

### 🎬 Videos Tab
- **Tube Channel**-style video display.
- Custom video player with ads (pre/mid/post-roll).
- Tube-style comments with sorting (newest/oldest/most-liked).

### 💬 Comments System
- **Context-independent comments** (`comment_place`): posts, photos, videos — each context has its own comments.
- **Nested replies** to comments with reply counter.
- **Image uploads** with comments and replies (secure validation: MIME + extension + getimagesize).
- **Edit and delete** comments (for admin and comment owner).
- **Pin comments** by admin.
- **Like comments** with likers list display.
- **Approval system** (Pending/Approved) configurable via settings.
- **Spam prevention**: Rate limiting (10 comments/5 minutes per IP) + CSRF protection.

### ❤️ Reactions System
- 5 reaction types: Like, Love, Haha, Wow, Sad — with emojis.
- **Likes popup** to display the list of visitors who reacted, with type breakdown.
- Reactions summary in each post's stats bar.

### 👥 Visitors System
- Visitor login/registration (local or via OAuth).
- Personal visitor profiles with avatar and name.
- **Follow system** for the owner.
- **Activity tracking** (Activity Log) for each visitor.
- **Block/unblock** visitors from the admin panel.

### 🛒 Stores and Products
- Complete product management (add/edit/delete).
- **Independent product comments** (with dedicated `comment_place`).
- **Order system** with integrated payment.
- **Reports** on products.

### 🎨 Admin Control Panel
- **Dashboard**: comprehensive statistics (visitors, comments, logs, security, SEO, system info).
- **Visitor management**: search, filter (active/blocked/follower), block, edit profile.
- **Comment management**: approve/reject, bulk delete, pin, edit.
- **Ads management**: feed ads (between posts), homepage interstitial, video ads.
- **Settings management**: languages, themes, colors, logo, social links.
- **Database manager**: export/import, backups.
- Complete **activity log**.
- **Reports management** for posts, comments, and products.

### 🔒 Security
- **CSRF Protection** on all forms and sensitive requests.
- **Rate Limiting** for comments, login, and other operations.
- **Input sanitization** (`clean_user_text`) to prevent XSS.
- **Prepared Statements** in all database queries (PDO).
- **Secure file uploads**: MIME + extension + getimagesize validation + random filename.
- **Session management** (Sessions + Cookies) for visitors and admin.
- **CAPTCHA** on login and registration.
- **Secure API keys** for external services.

### 🌐 Multi-language Support
- **3 ready-to-use languages**: Arabic, English, French.
- Dynamic translation system via `i18n.js` with language stored in `localStorage`.
- Instant language switching without page reload.
- Automatic RTL/LTR support.

### 📱 Responsive Design
- Fully responsive design (Mobile-first).
- Multiple breakpoints for mobile/tablet/desktop.
- **Responsive popup** that adapts to screen size.
- Touch support for navigating photos and videos.

### 🤖 AI Assistant
- Built-in AI Assistant to help with content management.
- Multi-turn conversation support with context preservation.

---

## Technical Architecture

### Backend
- **PHP** (no framework) — clean, organized code.
- **PDO** for database handling (supports MySQL/MariaDB).
- **Custom storage** system for files (`uploads/`).
- **Separate API endpoints** for each operation (`api/`).

### Frontend
- **Native JavaScript** (Vanilla JS) without heavy libraries.
- **Custom CSS** with CSS Variables for colors and fonts.
- **Chart.js** for charts in the control panel.
- **Font Awesome** for icons.



## Strengths

1. **Lightweight and fast**: does not rely on heavy frameworks, pages load quickly.
2. **Customizable**: CSS variables + theme system in the control panel.
3. **Secure**: multiple layers of protection (CSRF, Rate Limiting, Prepared Statements, input sanitization).
4. **Responsive**: works smoothly on mobile, tablet, and desktop.
5. **Multi-language**: supports 3 ready-to-use languages and is extensible.
6. **Extensible**: modular architecture allows adding new features easily.
7. **No mandatory external dependencies**: works on any shared PHP hosting.

---

## Requirements

- **PHP** 7.4 or higher (8.0+ recommended)
- **MySQL/MariaDB** 5.7+
- **PHP extensions**: PDO, pdo_mysql, mbstring, gd, fileinfo
- Sufficient storage space for uploaded files

---

## Conclusion

The **Personal Page Platform** is an integrated solution for anyone who wants to create their professional personal page with full control over content and interaction. It combines simplicity of use with powerful features, with a focus on security, performance, and user experience across all devices.