Tips, Troubleshooting & Limitations

Plugins & Theme Dependencies

Some plugins and themes have dependencies. ALL dependencies must be installed in the product template site – your theme/plugin will not be able to download them for each individual site because the shared plugins & themes folder will be read-only.

For example, a Kadence theme might need to install plugins to support some of their functionality. This needs to be installed on the Product Template site.

Cloning Sites – Local Clones

When cloning sites to the same server (standard clones), the Multi-tenant attributes are cloned but with some modifications:

Tenant sites are cloned as a new tenant.
Version sites are tagged as ‘mt_version_clone‘ instead of ‘mt_version‘
Template sites are tagged as ‘mt_template_clone‘

In some cases you might need to change the site type after the clone operation. For example, you might be cloning the Template site to use as the start of a new template. In this case you will want to remove the ‘mt_template_clone‘ designation. You can do this in TOOLS section of the MULTI-TENANT tab.

Cloning Sites To New Servers (Site-Sync / Copy To Server)

When pushing sites to another server, the Multi-tenant attributes are cloned but with some modifications:

Tenant sites are cloned as new tenant sites – but unless the target also contains the appropriate wpcd-mt-versions folder, the site will not work.
Version sites are tagged as ‘mt_version_clone‘ instead of ‘mt_version‘
Template sites are tagged as ‘mt_template_clone‘

In some cases you might need to change the site type after the clone operation. For example, you might be cloning the Template site to use as the foundation for a new template. In this case you will want to remove the ‘mt_template_clone‘ designation. You can do this in TOOLS section of the MULTI-TENANT tab.

Remote Database Servers

One limitation of the default behavior of WPCD Multi-tenant is that the database servers have to be on the same server as the web server.

To use remote databases you will need to utilize our professional services folks to make the change. This is one reason why the Multi-tenant module is only available as part of a professional services contract.

Among other things, remote database servers need proper user permissions configured to allow our scripts to create new databases on the server (each tenant has it’s own database). And, of course, we’ll need to configure our own multi-tenant scripts and such to use the remote server instead of the local servers.

Multisite

Tenant sites cannot be converted to Multisite.

How To View The Real File Location For A Symlink

If you want to see where a link points to, you can run the following command:

su <linuxuser> -c 'readlink -v "<symlink-file>"'

For example, if you want to see where the akismet.php file really points to for domain mydomain.com, you can use:

su <linuxuser> -c 'readlink -v "/var/www/mydomain.com/html/wp-content/plugins/akismet/akismet.php"'

Of course, replace <linuxuser> with a valid Linux user!