Merge pull request #73 from froboy/dec-release-prep

docs: Dec release prep

content/en/blog/releases/release-ds-10.3.1.1.md

@@ -0,0 +1,91 @@
+---
+title: "Digital Services Release 10.3.1.1"
+description: Annotated release notes. Full changelog on [GitHub](https://github.com/YCloudYUSA/yusaopeny/releases/tag/10.3.1.1)
+date: 2023-12-12
+---
+
+## Updates & New Features
+
+### Promotion Content Type
+
+**Promotions** are pieces of content with scheduled start and end dates that can be used for displaying internal marketing and ad campaigns. Content editors can easily schedule, manage and place multiple promotions throughout their website via the Drupal admin interface.
+
+The first version of this content type allows content editors to place promotions inside the Card component (for Layout Builder) and as interstitial content within Activity Finder.  [Learn more in our docs.](https://ds-docs.y.org/docs/user-documentation/content-types/promotion/)
+
+### Layout Builder Updates
+
+Continuing general cleanup, updated documentation, and improvements to the content editing experience for new Layout Builder components and content types.
+
+[Learn more in our docs](https://ds-docs.y.org/docs/user-documentation/layout-builder/).
+
+* Moved [Program](https://ds-docs.y.org/docs/user-documentation/content-types/program/#customizing-with-layout-builder) & [Program Sub-category](https://ds-docs.y.org/docs/user-documentation/content-types/program/#customizing-with-layout-builder) Content Types into Layout Builder. (#806)
+* Facility Content Type - Updated the behavior of Contact / Hours fields so that content editors can include custom contact and hour information for a facility. (#1057)
+* Facility Content Type - Included ability to add custom hours on Facilities, currently it is inherited from Branch CT. (#1119)
+* LB Location Finder - ‘Get Directions’ link on a Branch card should link to the Google Map of the location. (#1132)
+* Removed a dependency on lb_branch_hours_block. (#1071)
+    * _Credit - Andy Fowlston_
+* LB Menus & Navigation - Clarified header / footer region display names so that each region has a unique, easy to understand title. (#1055)
+* LB Mega menu - Resolved hierarchical issues, making top level pages clickable and including indicators for parent / child relationships. (#1196)
+* Cleaned up error messages that were blocking content entry in the Layout Builder sidebar. (#827)
+* Resolved an issue with LB content types being excluded from the Default sitemap in the ‘Simple XML Sitemap’ module configurations. (#1197)
+    * _Credit - Jeremy Weedman_
+* LB UX - Fixed display of Drupal admin warnings and messages. (#828)
+* Made vertical spacing between components more consistent. (#1167)
+* LB Cards - De-duplicated code in twig templates. (#1135)
+* Included Home Branch, Icon Grid, LB Facility and LB Camp in default standard install. (#1061)
+
+### Core, Security & Performance Updates
+
+* Update to Drush v12. (#807)
+* Allowed plugin definitions caching to resolve a caching performance issue. (#1220)
+    * _Credit: Andrey Maximov_
+
+### CKEditor 5
+
+* Upgraded from png to svg icons for CKEditor 5 compatibility. (#1194)
+
+### Admin / Content Editor Enhancements
+
+* Migration from old block + paragraph approach to block + block sub-item approach for Layout Builder. (#’s 301-306, #1087)
+* Replaced AddThis with AddToAny. (#1028)
+    * _Note: [AddThis terminated all services](https://www.addthis.com/) on May 1, 2023, which impacts all Website Services sites using the service._
+* Removed duplicated code from twig templates for the LB Hero. (#1134)
+
+### SEO
+
+* Added cross-domain tracking module to ensure cross-domain tracking works with Google Analytics 4. (#280)
+
+### Accessibility
+
+* Resolved accessibility issues found in audits from Summer 2023:
+    * WAVE browser tool
+    * Keyboard accessibility
+    * Screen Reader
+
+### Design System - Y Styles
+
+“Y Styles” helps site builders customize their sites in an accessible and brand-compliant manner.
+
+[Documentation for Y Styles](https://ds-docs.y.org/docs/user-documentation/layout-builder/advanced-options/)
+
+* Updated H1-H6 tags to match colorway styles. (#666)
+* Canadian Colorway - Canadian Y Associations can now select from a set of brand-compliant colors to use with Layout Builder components. (#589)
+
+## Documentation
+
+* Videos from the Open Y channel that are referenced in code had their URLs updated to the new YUSA YouTube channel. (#834)
+* Document workaround for missing [CKEditor 5 button button](https://ds-docs.y.org/docs/user-documentation/text-editor/adding-links/#using-button-classes). (#1147)
+* Added documentation for [Home Branch selector](https://ds-docs.y.org/docs/user-documentation/content-types/branch/#home-branch-selector) and how to disable it. (#1162)
+* Documented how to [troubleshoot missing configurations](https://ds-docs.y.org/docs/development/development-faq/#upgrade-troubleshooting) after upgrading to Drupal 10. (#1124)
+* Added [Content type clarification](https://ds-docs.y.org/docs/user-documentation/content-types/). (#1239)
+* Made [donate support](https://ds-docs.y.org/docs/user-documentation/layout-builder/donate/) more prominent. (#1239)
+* Added [header menu length recommendations](https://ds-docs.y.org/docs/user-documentation/layout-builder/header-footer/#main-navigation). (#1239)
+* Included documentation for [installing Solr site search](https://ds-docs.y.org/docs/development/googlecustomsearchconfiguration/#layout-builder-and-google-search) and [Google Search Configuration](https://ds-docs.y.org/docs/development/googlecustomsearchconfiguration/#layout-builder-and-google-search) in Layout Builder. (#1198)
+* Updated documentation for how to set up a [Layout Builder site from scratch](https://ds-docs.y.org/docs/howto/set-up-lb/). (#1241)
+* Added documentation for how to [display amenities in the filter](https://ds-docs.y.org/docs/user-documentation/layout-builder/location-finder/#hierarchical-parentchild-amenities) on the LB Location Finder page. (#1252)
+
+## Bug Fixes
+
+* Fixed an issue with Layout Builder content types causing errors on Search or Webforms. (#1205)
+* Resolved an issue with Alert Rearrange not actually rearranging alerts. (#1228)
+    * _Credit: Serhii Zherebchuck_

content/en/blog/releases/release-vy-1.8.18.md

@@ -0,0 +1,12 @@
+---
+title: Virtual Y 1.8.18
+description: Annotated release notes. Full changelog on [GitHub](https://github.com/YCloudYUSA/yusaopeny_gated_content/releases/tag/1.8.18)
+date: 2023-12-12
+---
+
+## Bug Fixes
+
+* Fixed an issue with YV Logs using the old instructor name field. (#903)
+* Fixed the Header (utility menu and main nav) so that it does not overlap the content below. (#1076)
+* Fixed the empty description on Live Stream/Virtual Meeting causing the page to fail. (#1240)
+    * _Credit: Sathya Raja_

content/en/docs/content-structure/content-types/promotion.md

@@ -0,0 +1,24 @@
+---
+title: Promotion
+description:
+---
+
+Promotions are timed pieces of content that allow content editors the flexibility to create a single item that can be placed in multiple locations on the site, without having to duplicate or manage content in multiple locations.
+
+## Fields
+
+| Name                       | Machine name                 | Field type             | Required? |
+|----------------------------|------------------------------|------------------------|-----------|
+| Title                      | title                        |                        | yes       |
+| Subtitle                   | field_subtitle               | Text (plain)           |           |
+| CTA / link                 | field_link                   | Link                   | no        |
+| Description                | field_promo_description      | Text (formatted, long) | no        |
+| Image                      | field_promo_media            | Entity reference       | yes       |
+| Pages                      | field_promo_visibility_pages | Text (plain, long)     |           |
+| Promotion Category         | field_promo_category         | Entity reference       | no        |
+| Promotion Priority         | field_promo_priority         | List (text)            | yes       |
+| Promotion visibility state | field_promo_visibility_state | List (text)            | yes       |
+
+## URL pattern
+
+No URL pattern. This content should not be visible on its own.

content/en/docs/user-documentation/content-types/branch/_index.md

@@ -132,7 +132,7 @@ The Branch Menu is a single-level sub-menu that displays within a branch page (a
 
 Beginning in [Website Services 9.2.13]({{% relref "release-ds-9.2.13.md" %}}) content editors have the option of customizing the Branch page with [Layout Builder](../../layout-builder). You can migrate from using Paragraphs to using Layout Builder on a branch-by-branch basis to ease the transition.
 
-The **Use Layout Builder** checkbox on the Branch edit page non-destructively switches between Paragraphs and Layout Builder.
+The **Use Layout Builder** checkbox on the Branch edit page non-destructively switches between Paragraphs and Layout Builder. If the checkbox does not appear, ensure the **Y Branch** (`y_branch`) module is installed at **Admin** > **Extend** (`/admin/modules`).
 
 ### Layout Builder Blocks
 

content/en/docs/user-documentation/content-types/camp/_index.md

@@ -86,7 +86,7 @@ Use the bottom area for anchoring elements on your page. The following paragraph
 
 Beginning in Website Services 9.3, content editors have the option of customizing the Camp page with [Layout Builder](../../layout-builder). You can migrate from using Paragraphs to using Layout Builder on a camp-by-camp basis in order to ease the transition.
 
-The **Use Layout Builder** checkbox on the Camp edit page non-destructively switches between Paragraphs and Layout Builder.
+The **Use Layout Builder** checkbox on the Camp edit page non-destructively switches between Paragraphs and Layout Builder. If the checkbox does not appear, ensure the **Y Camp** (`y_camp`) module is installed at **Admin** > **Extend** (`/admin/modules`).
 
 ### Camp Menus
 

content/en/docs/user-documentation/content-types/facility/_index.md

@@ -53,6 +53,6 @@ Use [Paragraphs](../../paragraphs) to add content to your Facility page.
 
 Beginning in [Website Services 10.3.0]({{% relref "release-ds-10.3.0.md" %}}) content editors have the option of customizing the Facility page with [Layout Builder](../../layout-builder). You can migrate from using Paragraphs to using Layout Builder on a facility-by-facility basis in order to ease the transition.
 
-The **Use Layout Builder** checkbox on the Facility edit page non-destructively switches between Paragraphs and Layout Builder.
+The **Use Layout Builder** checkbox on the Facility edit page non-destructively switches between Paragraphs and Layout Builder. If the checkbox does not appear, ensure the **Y Facility** (`y_facility`) module is installed at **Admin** > **Extend** (`/admin/modules`).
 
 The migration process is identical to [Migrating Branches to Layout Builder](../branch/#migrating-to-layout-builder).

content/en/docs/user-documentation/content-types/program-subcategory/_index.md

@@ -71,3 +71,17 @@ The Sidebar Area will change the layout of the page into two columns once you en
 ### Bottom Area
 
 Use the Bottom Area for anchoring elements, such as [small banners](../../paragraphs/small-banner) and [webforms](../../paragraphs/webform).
+
+## Customizing with Layout Builder
+
+Beginning in [Website Services 10.3.1.1]({{% relref "release-ds-10.3.1.1.md" %}}) content editors have the option of customizing the Program Subcategory page with [Layout Builder](../../layout-builder). You can migrate from using Paragraphs to using Layout Builder on a program-by-program basis to ease the transition.
+
+The **Use Layout Builder** checkbox on the Program Subcategory edit page non-destructively switches between Paragraphs and Layout Builder. If the checkbox does not appear, ensure the **Y Program Subcategory** (`y_program_subcategory`) module is installed at **Admin** > **Extend** (`/admin/modules`).
+
+### Layout Builder Blocks
+
+Program Subcategory pages do not utilize any specialized blocks. See [Layout Builder](../../layout-builder) for the list of all components.
+
+### Migrating to Layout Builder
+
+Migrating Program pages to Layout Builder uses the same process as [building a new Landing Page](../../layout-builder/#creating-a-new-page). See [How to migrate to Layout Builder](../../../howto/migrate-to-lb/#prepare-your-content) for information about preparing for the migration.

content/en/docs/user-documentation/content-types/program/_index.md

@@ -71,3 +71,28 @@ For aside pieces of content, such as side navigations, promotional cards and con
 
 * The *Description* field always displays above the paragraphs you enter.
 * There is no bottom area for you to add an anchoring element.
+
+## Customizing with Layout Builder
+
+Beginning in [Website Services 10.3.1.1]({{% relref "release-ds-10.3.1.1.md" %}}) content editors have the option of customizing the Program page with [Layout Builder](../../layout-builder). You can migrate from using Paragraphs to using Layout Builder on a program-by-program basis to ease the transition.
+
+The **Use Layout Builder** checkbox on the Program edit page non-destructively switches between Paragraphs and Layout Builder. If the checkbox does not appear, ensure the **Y Program** (`y_program`) module is installed at **Admin** > **Extend** (`/admin/modules`).
+
+### Layout Builder Blocks
+
+Program pages can take advantage of the [Categories Listing](../../paragraphs/categories-listing) block to list child Program Subcategory pages. To add the block:
+
+- Click the **Layout** tab at the top of your page.
+- Scroll to the location on the page where you want to add the block (usually the **Body** section).
+- Click **Add block**.
+- In the sidebar, expand **All system blocks**.
+- Search for "Categories Listing" or scroll to **Lists (Views)** > **Categories Listing**.
+- Click on **Categories Listing**.
+- Check **Override title** to add a title to the block.
+- Click **Add block**.
+
+> NOTE: As of version 10.3.1.1 (December 2023) the **Categories Listing** block styles have not been updated to be in line with the [Design System](../../layout-builder/designs/#design-system). They will be updated as of the March 2024 release. Keep an eye on [y_program releases](https://www.drupal.org/project/y_program/releases) for details.
+
+### Migrating to Layout Builder
+
+Migrating Program pages to Layout Builder uses the same process as [building a new Landing Page](../../layout-builder/#creating-a-new-page). See [How to migrate to Layout Builder](../../../howto/migrate-to-lb/#prepare-your-content) for information about preparing for the migration.

content/en/docs/user-documentation/content-types/promotion/_index.md

@@ -0,0 +1,47 @@
+---
+title: Promotion
+description: Flexible content that can be inserted into components as advertisements.
+---
+
+Promotions are timed pieces of content that allow content editors the flexibility to create a single item that can be placed in multiple locations on the site, without having to duplicate or manage content in multiple locations.
+
+Version 1 of the Promotion functionality was released in [version 10.3.1.1]({{< relref "release-ds-10.3.1.1.md" >}}) (December 2023). This version supports swapping promos into:
+
+- Activity Finder
+  - by enabling the `ws_promotion_activity_finder` module.
+- Cards
+  - by enabling the `ws_promotion_cards` module.
+- Modals
+  - by enabling the `ws_promotion_modal` module.
+
+Version 2 is planned for March 2024 and will support more components with more granular placement criteria.
+
+## Creating a Promo
+
+Go to **Admin** > **Content** > **Add Content** > **Promotion** (`/node/add/promo`)
+
+Fill in the content fields:
+
+- **Title** (required)
+- **Subtitle**
+- **Description**: The body text of the promo.
+- **Image** (required): Choose an existing image from the library or upload a new one.
+- **CTA/link**: Add a call to action to your promo.
+- **Promotion Category**: Choose one item from the Activities [Taxonomy](../../taxonomy) to link the promo with related components (see below).
+- **Promotion Priority**: Set how often the promo will appear. This setting will only have an effect _if multiple promotions can appear on a page_.
+- **Visibility pages**: This field is not yet in use.
+
+Use the **Scheduling options** section in the sidebar to set a **Publish on** and **Unpublish on** time for your Promo (this requires `cron` to be running on your server - check with your hosting partner).
+
+## Placing a Promo
+
+### Version 1
+
+In version 1, creating a Promotion and setting it as **Published** will automatically enable the promo in any available components (corresponding to the modules enabled above).
+
+To filter a component to only a certain set of Promotions, edit a Layout Builder block and set the new **Promotion Category** field.
+
+![A screenshot of the promotion category field.](promo--promo-category.png)
+
+- If **Promotion Category** _is not_ set on a block, then the block will be overridden by _any available (published) promo_.
+- If **Promotion Category** _is_ set on a block, then the block will be overridden by _only matching promos_ that have the same category set.