← Back to main site

Installation Guide - GrabWP Tenancy

Prerequisites

Before starting, ensure you have:

  • WordPress 5.0 or later
  • PHP 7.4 or later
  • Admin access to WordPress
  • Access to edit wp-config.php
  • Basic WordPress knowledge

Important: Backup First

Always backup your website before making changes:

  • Database backup
  • WordPress files backup
  • Copy of your current wp-config.php

Installing the Plugin

Through WordPress Admin (Recommended)

  1. Go to Plugins → Add New
  2. Search for "GrabWP Tenancy"
  3. Click "Install Now"
  4. Click "Activate"

Manual Upload

  1. Download the plugin ZIP file
  2. Go to Plugins → Add New → Upload Plugin
  3. Choose the ZIP file
  4. Click "Install Now"
  5. Click "Activate Plugin"

Required: wp-config.php Setup

The plugin needs to load early, before WordPress starts. This step is critical.

  1. Find your wp-config.php file in your WordPress root directory

  2. Locate this line:

/* That's all, stop editing! Happy publishing. */
  1. Add this code BEFORE that line:
// GrabWP Tenancy - Early Loading
if ( file_exists( __DIR__ . '/wp-content/plugins/grabwp-tenancy/load.php' ) ) {
    require_once __DIR__ . '/wp-content/plugins/grabwp-tenancy/load.php';
}

Your wp-config.php should look like this:

// ... other wp-config.php settings ...

// GrabWP Tenancy - Early Loading
if ( file_exists( __DIR__ . '/wp-content/plugins/grabwp-tenancy/load.php' ) ) {
    require_once __DIR__ . '/wp-content/plugins/grabwp-tenancy/load.php';
}

/* That's all, stop editing! Happy publishing. */
require_once ABSPATH . 'wp-settings.php';

Verify the Installation

  1. Check Plugin Status

    • Go to Plugins page
    • "GrabWP Tenancy" should show as Active
    • No error messages should appear

  2. Check Admin Menu

    • Look for "Tenancy" in the left sidebar
    • Click it to see the tenant management area

  3. Check Your Website

    • Visit your main website
    • Everything should load normally
    • No error messages should appear

Common Issues

Plugin Menu Not Showing

  • Check if wp-config.php code was added correctly
  • Make sure it's before "That's all, stop editing!"
  • Verify the plugin folder is named exactly "grabwp-tenancy"

File Not Found Error

  • Check if the plugin is in wp-content/plugins/grabwp-tenancy
  • Verify the folder name is exactly "grabwp-tenancy"
  • Make sure all plugin files are present

Website Shows Errors

  • Restore your backup wp-config.php
  • Try adding the code again
  • Check for proper PHP syntax

Can't Edit wp-config.php

  • Try using FTP or file manager
  • Check file permissions (should be 644)
  • Contact your hosting provider for help

Next Steps

After successful installation:

  1. Create your first website
  2. Set up domain names
  3. Test the system