# Subsites: Technical

# Introduction

When you enable this feature you will get:

  • Subsite Overview
  • Subsite Pages
  • 20+ paragraph components

A Subsite can be used to create a section, campaign or microsite within the site. It allows a flexible layout and a bespoke visual identity.

# Requirements

Drupal core

  • Drupal 8: >= 8.9
  • Drupal 9: >= 9.0

Drupal modules

dependencies:
dependencies:
  - drupal:block
  - drupal:field
  - drupal:image
  - drupal:menu_ui
  - drupal:node
  - drupal:path
  - drupal:text
  - entity_hierarchy:entity_hierarchy
  - entity_hierarchy:entity_hierarchy_breadcrumb
  - field_group:field_group
  - paragraphs:paragraphs
  - layout_paragraphs:layout_paragraphs
  - localgov_subsites:localgov_subsites_paragraphs
  - localgov_core:localgov_core
  - localgov_topics:localgov_topics

# Permissions

By default a person with the news_editor role can publish and unpublish News Articles.

Custom permissions will need to be set up to define which roles can feature News, and create, edit and delete content of the type “Newsroom”.

# Installation

This module is part of the LocalGov Drupal distribution, but is not installed by default.

# Basic Configuration

# General

# Subsite Overview

Name:
Subsite overview

Machine name:
localgov_subsites_overview

Description:
Main subsite landing page.

Menu settings

Available menus:

  • Main navigation

Default menu: Main navigation

Simple XML Sitemap

Included: false

Fields
Field name Machine name Field type
Summary localgov_subsites_summary Text (formatted, long, with summary)
Banner localgov_subsites_banner Entity reference revisions
Page content localgov_subsites_content Entity reference revisions
Hide page menu localgov_subsites_hide_menu Boolean
Visual theme localgov_subsites_theme List (text)

# Subsite page

Name:
Subsite page

Machine name:
localgov_subsites_page

Description:
General subsite pages attached to an overview page.

Menu settings

Available menus:

  • Main navigation

Default menu: <main>

Simple XML Sitemap

Included: false

Fields
Field name Machine name Field type
Summary localgov_subsites_summary Text (formatted, long, with summary)
Banner localgov_subsites_banner Entity reference revisions
Page content localgov_subsites_content Entity reference revisions
Parent localgov_subsites_parent Entity reference hierarchy
Topic term localgov_subsites_topic Entity reference

# Managing content

# Usage

Subsite Overview

  • A Subsite Overview acts as the landing page for the subsite.
  • Set some options here that will affect the rest of the subsite, including whether the menu displays in the sidebar or the visual theme of the subsite (see below for more details)
  • By default the url alias will be [node:title] and the subpages will use this as the base for their alias.
  • Layout builder allows for 1, 2 or 3 page layouts
  • There are upward of 20 Paragraph types that can be added to the Subsite Overview and Subsite Pages.

# Advanced Configuration

# Setting up theme options

By default there are no visual theme options. To add some edit the Field settings at /admin/structure/types/manage/localgov_subsites_overview/fields/node.localgov_subsites_overview.localgov_subsites_theme/storage

To do - what happens next?

# Customising the Paragraph components

There are upwards of 20 paragraph components available to a subsite. It is likely that these will need configuration and design consideration.

# Theming

# Twig templates

https://github.com/localgovdrupal/localgov_subsites/tree/2.x/templates

Todo - check these are actually working

There are also templates in the localgov_base theme.

If you want to use the localgov_subsites feature without the base theme you may want to consider copying those templates.

https://github.com/localgovdrupal/localgov_base/tree/1.x/templates/paragraphs

# Contributors

  • @gosia-mlynarczyk
  • @stephen-cox
  • @adnan-cds
  • @finnlewis
  • @ekes
  • @j4-m
  • @tanc
  • @cjstevens78
  • @andybroomfield