https://github.com/iqual-ch/iq_multidomain_extensions

Contains extensions, config etc. for a multidomain setup
https://github.com/iqual-ch/iq_multidomain_extensions

Last synced: about 1 month ago
JSON representation

Contains extensions, config etc. for a multidomain setup

• Host: GitHub
• URL: https://github.com/iqual-ch/iq_multidomain_extensions
• Owner: iqual-ch
• Created: 2019-05-27T13:22:47.000Z (over 5 years ago)
• Default Branch: 3.x
• Last Pushed: 2024-10-29T09:58:52.000Z (2 months ago)
• Last Synced: 2024-11-16T02:09:32.473Z (about 2 months ago)
• Language: PHP
• Size: 197 KB
• Stars: 0
• Watchers: 3
• Forks: 2
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# iq_multidomain_extensions

Contains extensions, config etc. for a multidomain setup

Installation guide

1. Install iq_multidomain_extensions

2. add domain records

/admin/config/domain

IMPORTANT NOTES

- Make sure that the pattern ids and template names have to be identical (Pay attention to - and _)

## Upgrade from 2.x

With Drupal 10, domain_site_settings and domain_theme_switch are deprecated and are replaced by domain_config. This causes breaking changes.

- Upgrade to 2.5.y and run update hooks. This will convert favicons and robotstxt settings to use domain_config.

- Recreate theme selection per domain at /admin/appearance if iq_multidomain_domain_theme_switch was used before.

- Remove domain_site_settings and domain_theme_switch from the project

- Upgrade to 3.x

### Theme per domain

Install the iq_multidomain_domain_theme_switch submodule:

    drush en iq_multidomain_domain_theme_switch

Go to /admin/appearance to select the theme per domain.

#### Notes

- The sub module prefixes pattern ids from selected themes with the theme name (except for the global default theme).

- All themes need the same patterns to commonly use views.

- Autogenerated domain specific references to patterns might include the theme name and need to be adjusted on selecting or renaming a theme.

### XML Sitemaps per domain

Install the iq_multidomain_sitemap_extension submodule:

    drush en iq_multidomain_sitemap_extension

Go to /admin/config/search/xmlsitemap to add sitemaps. On each sitemap, there's a new field available to set the domain.

### Favicon

The "iq_multidomain_favicon_extension" has been removed.

### Robots.txt

If you want to register a `robots.txt` file per domain, you must activate iq_multidomain_robotstxt_extension. Install it with

    drush en iq_multidomain_robotstxt_extension

Once installed, robots.txt can be configured at /admin/config/search/robotstxt.

Additionally incoming public requests have to be passed to the module (i.e. PHP) on either the `/robots` or `/robots.txt` path.

#### Kubernetes nginx ingress setup

You also need to add the following annotation to all main domain ingresses:

```yaml

nginx.ingress.kubernetes.io/configuration-snippet: |-

  location = /robots.txt {

    rewrite ^ /robots last;

  }

```

> It is also advised to enable the www-redirect option and to not set the `www` or non-`www` domain in the ingress respectively. (i.e. `nginx.ingress.kubernetes.io/from-to-www-redirect: "true"`)

This rewrites incoming requests to `robots.txt` to the correct dynamic endpoint (`/robots`) bypassing any existing robots file.

#### Nginx example

If you want to pass the request to php directly in your application nginx, you can use an approach like this:

```nginx

location = /robots.txt {

    rewrite ^ /index.php last;

}

```