Installation Guide

Installation Guide

Installing MagicBlog is quick and straightforward. Follow this step-by-step guide to get your engagement features up and running in just a few minutes.

System Requirements

Before installing MagicBlog, ensure your WordPress site meets these minimum requirements:

WordPress Requirements

• WordPress Version: 6.0 or higher

• PHP Version: 7.4 or higher (PHP 8.0+ recommended)

• MySQL Version: 5.6 or higher (MySQL 8.0+ recommended)

• Memory Limit: 128MB minimum (256MB recommended)

Server Requirements

• Web Server: Apache 2.4+ or Nginx 1.14+

• HTTPS: SSL certificate recommended for security

• File Permissions: Write permissions for uploads directory

Optional Enhancements

• Elementor: 3.18.0+ (for Elementor widgets)

• Object Caching: Redis or Memcached (for performance)

• CDN: CloudFlare or similar (for global performance)

Installation Methods

Choose the installation method that works best for your setup:

Method 1: WordPress Plugin Repository (Recommended)

This is the easiest method for most users.

Step 1: Access Your WordPress Admin

1. Log in to your WordPress admin dashboard

2. Navigate to Plugins → Add New

3. Type "Magicblog" in search bar

4. Install & Activate the Plugin

Method 2: WordPress Admin Dashboard File Upload

This is the easiest method for most users.

Step 1: Access Your WordPress Admin

1. Log in to your WordPress admin dashboard

2. Navigate to Plugins → Add New

Step 2: Upload the Plugin

1. Click Upload Plugin button

2. Click Choose File and select your magicblog.zip file

3. Click Install Now

Step 3: Activate the Plugin

1. Once installation completes, click Activate Plugin

2. You'll see a success message confirming activation

Method 3: FTP Upload

For users who prefer FTP or have upload restrictions.

Step 1: Extract the Plugin

1. Download and extract magicblog.zip on your computer

2. You should have a folder named magicblog

Step 2: Upload via FTP

1. Connect to your website via FTP

2. Navigate to /wp-content/plugins/

3. Upload the entire magicblog folder

Step 3: Activate via Dashboard

1. Go to Plugins → Installed Plugins

2. Find "MagicBlog" in the list

3. Click Activate

Method 3: WordPress CLI (Advanced)

For developers and advanced users using WP-CLI.

# Upload and install the plugin
wp plugin install magicblog.zip --activate

# Or if you have the plugin in wp-content/plugins already
wp plugin activate magicblog

Verification Steps

Confirm your installation was successful:

Check Plugin Status

1. Go to Plugins → Installed Plugins

2. Verify "MagicBlog" shows as Active

3. Version should display as 1.0.0

Access Admin Dashboard

1. Look for MagicBlog in your WordPress admin menu

2. Click it to access the main dashboard

3. You should see engagement statistics (will be empty initially)

Test Block Editor

1. Create a new post or page

2. Click the + button to add a block

3. Search for "MagicBlog" - you should see 5 blocks available

Test Elementor (If Applicable)

1. Edit a page with Elementor

2. Open the widget panel

3. Look for "MagicBlog" category with 4 widgets

Common Installation Issues

Issue: Upload Size Limit

Problem: "The uploaded file exceeds the upload_max_filesize directive" Solution:

• Use FTP method instead

• Or ask your host to increase upload limits

• Or use WordPress CLI method

Issue: Plugin Conflicts

Problem: Site breaks or shows errors after activation Solution:

1. Deactivate MagicBlog immediately

2. Check Plugin Conflicts guide

3. Contact support if issues persist

Issue: Database Creation Failed

Problem: Tables not created during installation Solution:

1. Go to MagicBlog → Tools

2. Click Rebuild Database Tables

3. Check database permissions with your host

Issue: Missing Dependencies

Problem: Elementor widgets not showing Solution:

• Install and activate Elementor (optional)

• MagicBlog works perfectly with just Gutenberg blocks

Post-Installation Checklist

Complete these steps after installation:

✅ Configuration Steps

• [ ] Access MagicBlog admin dashboard

• [ ] Review feature settings

• [ ] Configure rate limiting options

• [ ] Set up engagement preferences

✅ Testing Steps

• [ ] Create a test post with engagement features

• [ ] Test view counting functionality

• [ ] Verify like/rating systems work

• [ ] Check mobile responsiveness

✅ Optimization Steps

• [ ] Run compatibility check in Tools

• [ ] Configure caching exclusions if needed

• [ ] Set up performance monitoring

Next Steps

Now that MagicBlog is installed, you're ready to start engaging your audience!

Immediate Actions

1. Quick Start Guide - Get your first engagement feature running

2. Feature Settings - Enable the features you want

3. Block Overview - Learn about available Gutenberg blocks

Advanced Setup

1. Elementor Widgets - If you use Elementor

2. Performance Optimization - Speed up your site

3. Theme Integration - Customize appearance

Uninstallation

If you ever need to remove MagicBlog:

Safe Removal

1. Export Data: Go to MagicBlog → Tools → Export to backup your engagement data

2. Deactivate Plugin: Go to Plugins and deactivate MagicBlog

3. Delete Plugin: Click Delete to remove all files

4. Database Cleanup: Tables are automatically removed (data will be lost)

Keep Data Option

• Deactivating the plugin keeps all data intact

• Reactivating restores all engagement statistics

• Only deletion removes data permanently

---

Need Help?

If you encounter any issues during installation:

📧 Email Support: [e-mail] 🌐 Contact Page: https://plugins.magicwptools.com/contact/ 📚 Troubleshooting: Common Issues Guide

---

Ready to engage your audience? Let's move to the Quick Start Guide!