Skip to content

Latest commit

 

History

History
74 lines (47 loc) · 2.64 KB

README.md

File metadata and controls

74 lines (47 loc) · 2.64 KB
Raw

UNL Multisite Module for Drupal 8/9/10

Provides a web interface to run a Drupal multisite setup so additional sites can exist in subdirectories such as http://example.unl.edu/site2.

Installation

  1. Insert the following line into index.php after $request is initialized:

require_once './modules/contrib/unl_multisite/bootstrap.inc';

Your index.php file should look like:

$request = Request::createFromGlobals();
require_once './modules/contrib/unl_multisite/bootstrap.inc';
$response = $kernel->handle($request);

  1. Copy .htaccess-subsite-map.txt.sample to the web root and rename to .htaccess-subsite-map.txt

  2. Set the location of your config directory in sites/default/settings.php - See Drupal.org for help

$settings['config_sync_directory'] = '../config/sync';
  1. Copy sites/example.sites.php to sites/sites.php and add this to the end of the file:
  /**
   * Stub for the unl_multisite module to generate site aliases.
   */
  # THIS SECTION IS AUTOMATICALLY GENERATED
  # DO NOT EDIT!!!!

  # %UNL_CREATION_TOOL_STUB%

  # END OF AUTOMATICALLY GENERATED AREA
  1. Add this to .htaccess at the web root (inside the block).
  # START unl_multisite SECTION
  # Add the following line to your httpd.conf where <DRUPAL_ROOT> is the file system path to the Drupal web root.
  # RewriteMap drupal_unl_multisite txt:<DRUPAL_ROOT>/.htaccess-subsite-map.txt
  # Do not uncomment the previous line.
  RewriteRule .*/cron.php cron.php
  RewriteRule .*/update.php update.php
  RewriteRule ^(.*?/(core\/assets|core\/misc|core\/modules|core\/themes|libraries|modules|sites|themes))(.*) ${drupal_unl_multisite:$1|$1}$3 [DPI]

  RewriteCond ${drupal_unl_multisite://%{HTTP_HOST}%{REQUEST_URI}|NOT_FOUND} !^NOT_FOUND$
  RewriteRule (.*) ${drupal_unl_multisite://%{HTTP_HOST}%{REQUEST_URI}|$1} [R,L]
  # END unl_multisite SECTION
  1. Add the following line to your Apache's configuration file (httpd.conf) where <DRUPAL_ROOT> is the file system path to the Drupal web root. Restart Apache afterward.
  RewriteMap drupal_unl_multisite txt:<DRUPAL_ROOT>/.htaccess-subsite-map.txt

  1. Set up a cron job on the server to execute unl_multisite/cron.php on a regular basis.

  2. Ensure the MYSQL database user for the default site has privileges to create new databases.

Troubleshooting

  • Drush and MariaDB 10.7+ don't work with a database port set if the host is localhost. If you are using localhost for the host, clear the port setting in settings.php.