localgovdrupal / localgov_microsites_base
The base theme for LocalGov Drupal Microsites.
Installs: 7 065
Dependents: 2
Suggesters: 0
Security: 0
Stars: 0
Watchers: 6
Forks: 1
Open Issues: 21
Language:CSS
Type:drupal-theme
Requires
- drupal/twig_tweak: ^3.2
- localgovdrupal/localgov_base: ^1.0.0
- localgovdrupal/localgov_microsites_group: ^4.0.0-alpha3
- 2.x-dev
- 2.0.2
- 2.0.1
- 2.0.0
- 2.0.0-beta17
- 2.0.0-beta16
- 2.0.0-beta15
- 2.0.0-beta14
- 2.0.0-beta13
- 2.0.0-beta12
- 2.0.0-beta11
- 2.0.0-beta10
- 2.0.0-beta9
- 2.0.0-beta8
- 2.0.0-beta7
- 2.0.0-beta6
- 2.0.0-beta5
- 2.0.0-beta4
- 2.0.0-beta3
- 2.0.0-beta2
- 2.0.0-beta1
- 1.x-dev
- 1.0.0-alpha1
- dev-feature/278-extend-event-template
- dev-fix/291-header-site-name-alignment
- dev-fix/282-header-focus-styles
- dev-fix/289-update-stylelint
- dev-fix/285-events-title
- dev-feature/281-microsite-logo-visually-hidden
- dev-feature/281-microsite-logo-alt
- dev-283-missing-image-in-favicons-folder-in-assets
- dev-feature/microsites-base-170
- dev-release-2.x
- dev-feature/275-event-breadcrumbs
- dev-feature/272-summery-field-padding
- dev-fix/193-sub-menu-hover
- dev-feature/2.x/use-shared-workflows
- dev-fix/461/hide-home-page-title
- dev-feature/257-replace-domain-group-resolver
- dev-feature/259-only-update-workflow-test-4x
- dev-feature/259-update-workflow-test-4x
- dev-254/corrects-library
- dev-feature/group_sites
- dev-249/fixes-typo
- dev-247/easier-layouts-for-header-items
- dev-243/better-layout-full-top
- dev-242/print-messages
- dev-230/add-lexend-font
- dev-bug/109-equal-heights-resize
- dev-233/bug/subtheme-creator-drupal-10
- dev-feature/2.x/203-drupal-10-support
- dev-197/bug/breadcrumb-background-colour
- dev-feature/379-microsites-styling
- dev-feature/2.x/responsive-footer/220
- dev-hotfix/2.x/206-run-tests-on-2.x
- dev-feature/2.x/107-remove-breadcrumbs-front
- dev-feature/font-adobe-source-sans
- dev-feature/2.x/hide-breadcrumbs-home-page/207
- dev-feature/2.x/extends-drupal-stylelint/210
- dev-feature/204-maintainers
- dev-feature/2.x/update-readme
- dev-bug/1.x/hide-frontpage-title-via-alias-or-node-id/196
- dev-feature/2.x/quote-library
- dev-feature/2.x/page-section-component-tweaks
- dev-feature/2.x/event-view-fix
- dev-feature/2.x/fix-menu
- dev-feature/2.x/188-off-canvas-conflict
- dev-feature/2.x/pull-out-quote-colours-186
- dev-bug/2.x/events-list
- dev-feature/form-styling
- dev-feature/2.x/footer-padding-182
- dev-bug/2.x/aria-controls-id-181
- dev-feature/2.x/unpublished-styling
- dev-bug/2.x/submenu-icons
- dev-feature/2.x/primary-banner-styles
- dev-bug/2.x/events-styling
- dev-feature/group-3.x
- dev-release-1.x
- dev-bug/sidebar-facets-154
- dev-bug/1.x/main-menu-font-weight/157
- dev-bug/promoted-ia-block-151
- dev-bug/1.x/disappering-submenu-icon/105
- dev-bug/1.x/preheader-shows-at-all-times/148
- dev-bug/1.x/header-search-border/134
- dev-cleanup/1.x/clean-up-and-organise-css/144
- dev-bug/1.x/only-hide-front-page-title/140
- dev-feature/theme-preview
- dev-feature/sidebar-styles
- dev-feature/optional-search-137
- dev-bug/1.x/check-for-off-canvas/135
- dev-feature/1.x/massive-teasers/131
- dev-feature/1.x/favicons-per-site/121
- dev-feature/embed-view-block-event-image
- dev-feature/section-background-colours
- dev-bug/1.x/equal-heights-setTimeout/122
- dev-feature/1.x/events-listing-image-style/62
- dev-feature/blogs
- dev-feature/140-site-name-slogan
- dev-feature/script-to-automate-subtheme
- dev-feature/pre-header-contrast
- dev-feature/1.x/hide-title/111
- dev-bug/footer-menu-hidden
- dev-feature/97-documentation
- dev-feature/1.x/equalise-heights/92
- dev-feature/1.x/link-logo/95
- dev-fix/81-utility-off-canvas
- dev-feature/100-wysiwyg-styles
- dev-feature/95-link-logo-to-home
- dev-feature/1.x/equalise-heights-amend
- dev-feature/update-teaser-for-promo-directory-page
- dev-feature/1.x/news-theming/89
- dev-feature/1.x/paragraphs-field-in-node-template/87
- dev-bug/1.x/update-field-name-for-paragraphs-field/160
- dev-feature/1.x/themes-news-nodes/83
- dev-feature/1.x/menu-tweaks
- dev-feature/1.x/move-template-to-base
- dev-bug/field-rename
- dev-feature/layout-tweaks
- dev-fix/1.x/footer_menu_group_content_menu
- dev-feature/1.x/multi-level-menus/69
- dev-feature/149-promo-directory
- dev-feature/47-footer-tweaks
- dev-feature/47-footer-header-new-fields
- dev-feature/1.x/group-menu-context
- dev-feature/139-preview
- dev-bug/1.x/heading-font-weights-not-applying/45
- dev-feature/1.x/single-column-small-screens/46
- dev-fix/github-workflow-update-2022-06-22
- dev-feature/112-microsite-local-task-block-label
- dev-feature/1.x/design-wash
- dev-hotfix/remove-field
- dev-feature/1.x/classes-for-specific-microsites/36
- dev-feature/1.x/new-fields
- dev-feature/1.x/breakpoint-heading-font-sizes/33
- dev-feature/1.x/menu-styling/24
- dev-feature/1.x/spacing-+70-+72
- dev-feature/1.x/styling-top-section-for-nodes/23
- dev-feature/1.x/fonts-+68
- dev-feature/1.x-set-menus-in-regions
- dev-feature/1.x/footer-menu
- dev-feature/regions-for-menus/16
- dev-feature/1.x/footer-header-layouts
- dev-feature/1.x-tidy-up-header-and-footer-templates/14
- dev-feature/1.x/microsites-local-tasks
- dev-feature/61-regions-blocks
- dev-feature/68-site-design-styleguide
- dev-fix/1.x/only-operate-on-microsites
- dev-feature/70-site-design-headings
- dev-feature/5-active-domain-group
- dev-fix/3-twig-tweak
- dev-feature/composer
This package is auto-updated.
Last update: 2024-11-22 14:05:35 UTC
README
A sub-theme of LocalGov Base. Please read the README there also.
Customising the appearance through the UI
A Microsite Admin has the permission to set a number of css variables through the UI. These override the default variables set in /css/variables.css
Creating a sub-theme of LocalGov Microsites Base
We recommend creating a sub-theme of LocalGov Microsites Base in order to create a custom theme for one or more of your microsites. A Microsite controller is able to install and set a new theme for a microsite.
Quick overview
- Create a new sub-theme of LocalGov Microsite Base (see below)
- Copy the variables you need from localgov_microsites_base/css/variables.css and set the default branding colours, fonts etc
- Enable this theme, using the "Enable" button only, not the "Enable and set as default" button. After this, you can then hit the "Set as default" button. This 2-step process is needed to ensure all the blocks from the default theme get transition to the same block regions in your new theme.
Sub-theme
To create a sub-theme, you simply need to run the sub-theme creation script that is in the /scripts
directory, like so:
cd web/themes/contrib/localgov_microsites_base/
bash scripts/create_subtheme.sh
You need to enter two items when creating a sub-theme:
- The name of the theme, this can be anything and can include spaces, e.g. Super Council
- The machine name for the theme, this must start with a letter and use only lowercase letters and underscores, e.g. super_council
Custom Styles
Hopefully most of the custom styles you will need are set via CSS custom properties in the /css/variables.css
file in your sub-theme.
This is where you set your colours, fonts, spacing, etc. Then you "apply" these variables where needed, like so:
:root { /* Set/Override Variables */ --color-accent: red; --spacing-largest: 5rem; /* Apply Variables */ --color-link: var(--color-accent); --breadcrumbs-background-color: var(--color-accent); --section-spacing-vertical-header: var(--spacing-largest); }
If you need to add any CSS overides, you can create custom CSS files for these and then a library/libraries to attach them to your components.
Maintainers
This project is currently maintained by:
- Mark Conroy https://github.com/markconroy
- Maria Young https://github.com/msayoung