Installation

Get ThemeRuby Multi Authors up and running on your WordPress site in just a few minutes.

Requirements

Before installing, make sure your server meets these requirements:

Requirement	Minimum Version	Recommended
WordPress	5.8+	Latest version
PHP	7.4+	8.0+
MySQL	5.6+	5.7+

Check Your Requirements

To check your current versions:

1. Go to Tools > Site Health
2. Click Info tab
3. Check Server section

Installation Methods

Method 1: WordPress Admin (Recommended)

The easiest way to install:

1. Login to WordPress Admin

   https://your-site.com/wp-admin

2. Navigate to Plugins

   WordPress Admin > Plugins > Add New

3. Search for Plugin

   • Type "ThemeRuby Multi Authors" in search box
   • Press Enter

4. Install

   • Click Install Now button
   • Wait for installation to complete

5. Activate

   • Click Activate button
   • You'll see "Plugin activated" message

✅ Done! The plugin is now active.

Method 2: Upload ZIP File

If you have the plugin ZIP file:

1. Download Plugin

   • Get easy-multi-authors.zip from source

2. Navigate to Plugins

   WordPress Admin > Plugins > Add New > Upload Plugin

3. Choose File

   • Click Choose File button
   • Select easy-multi-authors.zip
   • Click Install Now

4. Activate

   • Click Activate Plugin

✅ Done! The plugin is now active.

Method 3: FTP/SFTP Upload

For manual installation via FTP:

1. Extract ZIP File

   • Unzip easy-multi-authors.zip
   • You'll get easy-multi-authors folder

2. Upload via FTP

   • Connect to your server via FTP client
   • Navigate to /wp-content/plugins/
   • Upload easy-multi-authors folder

3. Activate in WordPress

   • Go to WordPress Admin > Plugins
   • Find "ThemeRuby Multi Authors"
   • Click Activate

✅ Done! The plugin is now active.

Method 4: WP-CLI

For developers using command line:

# Navigate to WordPress directory
cd /path/to/wordpress

# Install plugin
wp plugin install easy-multi-authors

# Activate plugin
wp plugin activate easy-multi-authors

✅ Done! The plugin is now active.

Post-Installation Steps

1. Verify Activation

Check that the plugin activated successfully:

• Go to Plugins > Installed Plugins
• Look for "ThemeRuby Multi Authors"
• Status should be Active

2. Check Settings

Access plugin settings:

Default location:

WordPress Admin > Settings > ThemeRuby Multi Authors

You should see the settings page with options for:

• Supported post types
• Author box settings
• Archive filtering
• Cache settings

3. Test on a Post

Create or edit a post to verify functionality:

1. Go to Posts > Add New (or edit existing post)
2. Look for "Authors" meta box in the sidebar
3. You should see a list of users to assign as authors

If you see this, installation is successful! 🎉

Troubleshooting Installation

Problem: Can't Find Plugin in Search

Solution:

• Ensure you're connected to the internet
• Try refreshing the page
• Use Method 2 (Upload ZIP) instead

Problem: Installation Failed

Possible causes:

• Insufficient permissions
• Low disk space
• PHP version too old

Solution:

1. Check server requirements
2. Contact your hosting provider
3. Try FTP upload method

Problem: Plugin Activated but Not Working

Check:

1. WordPress version meets requirements (5.8+)
2. PHP version meets requirements (7.4+)
3. No conflicting plugins installed
4. Browser cache cleared

Solution:

# Via WP-CLI
wp plugin deactivate easy-multi-authors
wp plugin activate easy-multi-authors
wp cache flush

Problem: White Screen After Activation

Cause: Usually PHP version incompatibility

Solution:

1. Access your site via FTP
2. Rename plugin folder: easy-multi-authors → easy-multi-authors-disabled
3. Contact support with your PHP version

Problem: Database Error

Cause: Rare installation issue

Solution:

# Via WP-CLI
wp plugin deactivate easy-multi-authors
wp plugin activate easy-multi-authors

This will re-run activation hooks.

Multisite Installation

Network Activation

To activate for entire network:

1. Super Admin Access Required

   Network Admin > Plugins

2. Network Activate

   • Find "ThemeRuby Multi Authors"
   • Click Network Activate

Per-Site Activation

To activate on individual sites:

1. Go to My Sites > Network Admin > Sites
2. Click on a site
3. Go to Plugins tab
4. Activate "ThemeRuby Multi Authors"

Permissions

Required Capabilities

The installing user needs these capabilities:

• install_plugins - To install
• activate_plugins - To activate
• manage_options - To configure settings

File Permissions

If manual installation fails, check file permissions:

# Plugin directory
chmod 755 /wp-content/plugins/easy-multi-authors

# Plugin files
chmod 644 /wp-content/plugins/easy-multi-authors/*.php

Activation Process

What Happens During Activation?

1. Taxonomy Registration

   • Creates ema_author taxonomy
   • Registers with WordPress

2. Default Options

   • Sets default settings
   • Enables post type support
   • Configures cache settings

3. Rewrite Rules

   • Flushes rewrite rules
   • Enables author archives

4. Database Preparation

   • No custom tables created
   • Uses WordPress taxonomy tables

Activation Options Set

Default settings after activation:

ema_enable_archive_filtering       = 1 (enabled)
ema_enable_author_filtering        = 1 (enabled)
ema_enable_author_name_filtering   = 1 (enabled)
ema_enable_author_in_filtering     = 1 (enabled)
ema_enable_author_not_in_filtering = 1 (enabled)
ema_enable_seo_integration         = 1 (enabled)
ema_supported_post_types           = ['post']
ema_enable_author_box              = 0 (disabled)
ema_enable_cache                   = 1 (enabled)

Deactivation

How to Deactivate

If you need to temporarily disable:

1. Go to Plugins > Installed Plugins
2. Find "ThemeRuby Multi Authors"
3. Click Deactivate

What Happens on Deactivation?

• ✅ Settings are preserved
• ✅ Author assignments are preserved
• ✅ Taxonomy data remains
• ✅ Rewrite rules flushed

Nothing is deleted - safe to reactivate later.

Uninstallation

How to Uninstall

To completely remove the plugin:

1. Deactivate First

   • Deactivate the plugin

2. Delete

   • Click Delete link
   • Confirm deletion

What Gets Deleted?

When you delete the plugin:

• ✅ All plugin files removed
• ✅ All settings removed
• ✅ Cache cleared
• ⚠️ Author taxonomy data preserved (to prevent data loss)

Complete Data Removal

To remove ALL data including author assignments:

Via WP-CLI:

# Deactivate plugin
wp plugin deactivate easy-multi-authors

# Delete plugin (runs uninstall.php)
wp plugin delete easy-multi-authors --yes

# Manually remove taxonomy data if needed
wp term list ema_author --format=ids | xargs -I % wp term delete ema_author %

⚠️ Warning: This permanently deletes all author assignments!

Updating

How to Update

Updates are handled through WordPress:

1. Go to Dashboard > Updates
2. Check for plugin updates
3. Click Update next to ThemeRuby Multi Authors
4. Wait for update to complete

Update Safety

Before updating:

• ✅ Backup your site (always recommended)
• ✅ Check changelog for breaking changes
• ✅ Test on staging site if available
• ✅ Ensure WordPress is up-to-date

Auto-Updates

To enable automatic updates:

1. Go to Plugins > Installed Plugins
2. Find "ThemeRuby Multi Authors"
3. Click Enable auto-updates

Next Steps

Now that the plugin is installed:

👉 Quick Start Guide - Get up and running in 5 minutes

👉 Assigning Authors - Learn how to add multiple authors

👉 Configuration - Customize settings

Need Help?

If you encounter installation issues:

• 📖 Troubleshooting Guide
• 📖 FAQ
• 💬 Support Forum