E-Paper CMS - Complete Documentation

Get E-Paper CMS Now!

Professional digital newspaper & magazine publishing system

Purchase License View Demo

📋 Overview

E-Paper CMS is a modern, feature-rich Content Management System designed for creating and managing digital newspaper and magazine editions. Built with PHP, JavaScript, and AJAX, it provides a comprehensive solution for publishing interactive digital publications with hotspot functionality.

🎯 Key Features

  • PDF to JPEG Conversion
  • Interactive Hotspots with 6-point resizing
  • Multi-Location Support
  • Responsive Design
  • AJAX Navigation
  • Role-Based User Management
  • Social Media Integration
  • Mobile-Friendly Interface
  • Custom Branding Options
  • WordPress Widget Integration

⚙️ System Requirements

Server Requirements
  • PHP: 7.4 or higher
  • Database: MySQL 5.7+ or MariaDB 10.2+
  • Web Server: Apache/Nginx with mod_rewrite
  • Storage: Minimum 500MB free space
PHP Extensions Required
  • PDO (PHP Data Objects)
  • PDO MySQL
  • GD (Image processing)
  • Imagick (PDF conversion)
  • Fileinfo, Session, JSON support

🚀 Installation Guide

Step 1: Create Database
  1. Login to your hosting control panel (cPanel, Plesk, etc.)
  2. Create a new MySQL database
  3. Create a database user with full privileges
  4. Note down database name, username, and password
Step 2: Upload Files
  1. Extract the script files from the zip archive
  2. Upload all files to your web server via FTP or cPanel
  3. Access http://yourdomain.com/install/ to run the installation script
  4. Enter your database credentials in the installation wizard
  5. Follow the setup wizard to complete installation automatically
  6. Start uploading your first edition!
Note: You only need to create the database manually. The installation script handles all table creation and directory permissions automatically!

👥 User Guide

Managing Edition Places

Edition places allow you to organize content by location:

  1. Navigate to SettingsEdition Places
  2. Click Add Edition Place
  3. Enter place name and upload optional image
  4. Set status and save
Uploading Editions
  1. Go to Upload Edition
  2. Fill in title, date, description
  3. Select edition place (required)
  4. Upload PDF file
  5. System automatically converts to JPEG images
Creating Interactive Hotspots
  1. Click Hotspot button on any edition
  2. Select page from dropdown
  3. Click Add Top/Bottom/Middle
  4. Drag to position, resize using handles
  5. Double-click to edit title and URL
  6. Click Save All

🛠️ Detailed Troubleshooting

Issue: PDF files not converting to JPEG images

Causes & Solutions:

  • Imagick not installed: Install php-imagick extension on your server
  • Memory limit: Increase PHP memory_limit to 512M or higher
  • Execution time: Increase max_execution_time to 300 seconds
  • File permissions: Ensure uploads directory is writable (755/777)
  • PDF corruption: Try with a different PDF file

Check: PHP error logs at /var/log/apache2/error.log or cPanel Error Logs

Issue: Hotspots appearing in wrong positions

Solutions:

  • Clear browser cache: Hard refresh (Ctrl+F5) or clear all browser data
  • Check image dimensions: Verify actual vs display image sizes in browser console
  • Coordinate scaling: Ensure coordinate system matches between editor and viewer
  • CSS conflicts: Check for custom CSS affecting image display
  • Browser zoom: Reset browser zoom to 100%

Debug: Open browser developer tools and check console for JavaScript errors

Issue: Files not uploading or upload fails

Solutions:

  • File size limits: Check PHP upload_max_filesize and post_max_size settings
  • Directory permissions: Set uploads folder to 755 or 777 permissions
  • Disk space: Ensure sufficient server disk space available
  • File type restrictions: Verify PDF files are not blocked by server
  • Network timeout: Increase max_input_time for large files

PHP Settings to Check:

upload_max_filesize = 50M
post_max_size = 50M
max_execution_time = 300
max_input_time = 300
memory_limit = 512M

Issue: Cannot connect to database

Solutions:

  • Check credentials: Verify database name, username, password in config.php
  • Database server: Ensure MySQL/MariaDB service is running
  • Host settings: Try 'localhost' instead of '127.0.0.1' or vice versa
  • User permissions: Ensure database user has full privileges
  • Port settings: Check if custom MySQL port is required

Test Connection: Use a simple PHP script to test database connectivity

Issue: Slow loading or timeouts

Optimization Solutions:

  • Image optimization: Reduce PDF file sizes before upload
  • Server resources: Upgrade hosting plan for better performance
  • Caching: Enable browser caching and server-side caching
  • CDN: Use Content Delivery Network for static assets
  • Database optimization: Regular database cleanup and optimization

Ready to Get Started?

Transform your digital publishing experience with E-Paper CMS

Purchase Now Try Demo