This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Paragraphs

1: 1 Column
2: 2 Columns
3: 3 Columns
4: 4 Columns
5: All Amenities
6: Banner
7: Blog Posts Listing
8: Branches Popup (All)
9: Branches Popup (Class)
10: Categories Listing
11: Class Location
12: Class Sessions
13: Classes Listing
14: Code
15: Featured Blog Posts
16: Featured Content
17: Featured Highlights
18: Featured News Posts
19: Gallery
20: Grid columns
21: Grid Content
22: Group Schedules
23: Latest Blog Posts
24: Latest Blog Posts (Branch)
25: Latest Blog Posts (Camp)
26: Latest News Posts
27: Latest News Posts (Branch)
28: Latest News Posts (Camp)
29: Limited Time Offer
30: Location finder
31: Location Finder Filters
32: Membership Information Paragraph
33: Microsites Menu
34: News Posts Listing
35: Program Registration (Daxko)
36: Promo Card
37: Schedule search form
38: Schedule search list
39: Secondary Description and Sidebar
40: Session Time
41: Simple Content
42: Small Banner
43: Social Post Listing
44: Social Share Icons
45: Story Card
46: Teaser
47: Webform

Welcome to YMCA Website Services Paragraphs.

Paragraphs are content components, aligning with component-based design principles. Within the YMCA Website Services architecture, paragraphs are based on the Paragraphs Drupal module. This module enables the creation of Paragraphs entities.

The core idea is to provide a user-friendly widget for adding predefined content blocks directly within a page or other content item, without needing to reference external entities. It’s important to note that paragraphs are not intended as reusable content types. For reusable content, consider using blocks or other entities within Drupal.

Paragraphs enhance the user experience by offering a convenient and structured way to build content. They allow content editors to create unique layouts for their pages. Each paragraph represents a distinct content section, complete with its own styling, functionality, and fields.

Here’s a breakdown of key aspects:

Paragraphs Module: Facilitates the creation of paragraph entities within Drupal.
Component-Based Design: Paragraphs align with the principle of building interfaces from independent, reusable components.
User Experience (UX): Paragraphs are designed to make content creation more intuitive and efficient.
Non-Reusable Types: Paragraphs are not designed to be reused across multiple content items. Instead, look at Drupal blocks or entities.
Paragraphs Types: Paragraphs are pre-defined sets of fields that are made available to the content editors. These are configured under Structure > Paragraphs Types.

To get started with Paragraphs:

Install the Paragraphs module.
Create Paragraphs types.
Add a Paragraph field to a content type.
Begin creating content and adding paragraphs.

1 - 1 Column

The 1 Column paragraph type allows you to create a single-column layout within your content.

Fields

Name	Machine name	Required	Description
Line Above	field_prfg_display_line_above	No	Display a line above the column.
Column	field_prgf_1c_column	No	Enter the main content for the single column. This field typically supports rich text.
Paragraph Title	field_prgf_1c_title	No	Enter a title to display at the top of the 1-column paragraph.
Paragraph Description	field_prgf_1c_description	No	Enter a description to display below the paragraph title.

2 - 2 Columns

The 2 Columns paragraph type allows you to create a paragraph with two columns for content. This is useful for displaying related information side-by-side or creating visually appealing layouts.

Fields

Name	Machine name	Required	Description	Notes
Line Above	field_prfg_display_line_above	No	Display a horizontal line above the columns.
Left Column	field_prgf_2c_left	No	Content for the left column.	Supports text, images, and other embedded content.
Right Column	field_prgf_2c_right	No	Content for the right column.	Supports text, images, and other embedded content.

3 - 3 Columns

The 3 Columns paragraph type allows you to create a paragraph with three distinct columns of content. This paragraph type is useful for displaying information in a structured and visually appealing manner.

Fields

Name	Machine name	Required	Description
Line Above	field_prfg_display_line_above	No	Display a line above the column.
Left Column	field_prgf_3c_left	No	Enter the content for the left column.
Center Column	field_prgf_3c_center	No	Enter the content for the center column.
Right Column	field_prgf_3c_right	No	Enter the content for the right column.
Paragraph Title	field_prgf_title	No	Enter a title to display at the top of the 3 columns paragraph.

4 - 4 Columns

The 4 Columns paragraph type allows you to create a content block with four columns of information. This is useful for displaying related content side-by-side.

Fields

Name	Machine name	Required	Description	Notes
Line Above	field_prfg_display_line_above	No	Display a line above the column.	Use this to visually separate this paragraph from the content above it.
First Column	field_prgf_4c_1st	No	Enter the content for the first column.	Supports text, images, and other embedded content.
Second Column	field_prgf_4c_2nd	No	Enter the content for the second column.	Supports text, images, and other embedded content.
Third Column	field_prgf_4c_3rd	No	Enter the content for the third column.	Supports text, images, and other embedded content.
Fourth Column	field_prgf_4c_4th	No	Enter the content for the fourth column.	Supports text, images, and other embedded content.
Button	field_prgf_4c_button	No	Button with link to display under the 4-column paragraph.	Use this to add a call to action or link to more information related to the content.
Paragraph Title	field_prgf_title	No	Enter a title to display at the top of the 4-column paragraph.	This provides a clear heading for the entire paragraph.
Paragraph Description	field_prgf_description	No	Enter a description to display under the 4-column paragraph title.	Use this to provide context or an overview of the content within the four columns.

5 - All Amenities

This paragraph displays a list of amenities, typically in a table view. It’s useful for showcasing available features or services.

Fields

Name	Machine name	Required	Description
All amenities	field_field_prgf_amnts_view	No	Predefined reference to a view that displays all amenities. Configure this view to control which amenities are shown and how they are formatted.
Title	field_prgf_title	No	Enter the title that will be displayed at the top of the paragraph. This provides context for the list of amenities.

Important Considerations:

View Configuration: The “All amenities” field relies on a pre-existing view. Ensure this view is properly configured to display the desired amenity information.
Paragraph Usage: This paragraph type is generally intended for use within a larger page structure, like a landing page or a branch details page.
Alternative: Consider using “Branch Amenities” block if you want to show the amenities for the current branch.

6 - Banner

The Banner paragraph type is used to display eye-catching content, often at the top of a page or section. It typically includes a headline, description, image, and a call to action link.

Fields

Name	Machine name	Required	Description	Notes
Headline	`field_prgf_headline`	Yes	The main heading of the banner. This should be concise and attention-grabbing.	Plain text, maximum 255 characters
Color	`field_prgf_color`	Yes	A reference field that allows you to select a color from the “Color” vocabulary. This color is often used as a background or accent color for the banner.	Choose a term from the “Color” vocabulary
Image	`field_prgf_image`	No	An entity reference to a media image. This image should be visually appealing and relevant to the banner’s content.	Single value
Description	`field_prgf_description`	No	A WYSIWYG field where you can add descriptive text to the banner. Use this to provide more context or details about the banner’s topic. It is recommended to avoid using a summary for this field.
Link	`field_prgf_link`	No	A link field that stores both internal and external links. Use this to direct users to relevant pages or resources. This can be a call to action.	Use for internal and external links

7 - Blog Posts Listing

This paragraph is dynamic and renders the latest blog posts, utilizing exposed filters for enhanced content discovery. It’s based on the openy_prgf_blog_listing module.

Key Features:

Filtering: Allows users to filter blog posts based on:
- Location
- Category
- Text (Search Keywords)
Sticky at Top: Supports the “sticky at top” functionality to highlight important posts.
Ordering: Orders blog posts by published date, displaying the newest posts first.
Views Integration: Leverages Drupal’s Views module for flexible content display and filtering. The exposed filters are part of the View configuration.
Infinite Scroll: Supports the views_infinite_scroll module for a better user experience.

Fields

Name	Machine name	Required	Description
Block	`field_prgf_block`	Yes	Block reference to the view/block that provides the blog post listing. It should have a default value and ideally be hidden in the form display to prevent accidental modification. The view should be configured to use exposed filters for Location, Category, and Text.

Module Dependencies:

openy_prgf_blog_listing
views_infinite_scroll

Related Paragraphs:

Latest Blog Posts: Displays blog posts promoted to the front page.
Latest Blog Posts (Branch): Displays blog posts associated with a specific branch.
Latest Blog Posts (Camp): Displays blog posts associated with a specific camp.
News Posts Listing

8 - Branches Popup (All)

This dynamic paragraph renders the locations selection popup, based on the current node. It’s typically used to allow users to select a branch or location from a popup window. This selection can then influence other elements on the page, such as filtering schedules or classes.

Relates to:

[Schedule search list](Schedule search list.md)
[Classes Listing](Classes Listing.md)

Fields

Name	Machine name	Required	Description
Block	`field_prgf_block`	Yes	Block reference to the view/block that provides the location selection options. It should have a default value configured and is typically hidden in the form display to prevent direct user modification. This field is the key to connecting the paragraph to the actual location data.

Usage

This paragraph is often used in conjunction with other paragraphs and blocks to create a location-aware experience. For example, it might be used on a page with a schedule search to allow users to filter the schedule by location.

The openy_branch_selector module is often used to provide the functionality for selecting and saving a user’s preferred branch. The selected branch can then be used to pre-populate location filters and customize the user’s experience.

The specific appearance and behavior of the popup are determined by the view/block referenced in the field_prgf_block field. This allows for a high degree of customization to match the specific needs of the site.

9 - Branches Popup (Class)

This dynamic paragraph renders the location selection popup based on the current node. It’s typically used to allow users to select a location from a list of branches.

Relates to:

[Class Sessions](Class Sessions.md)
[Class Location](Class Location.md)

Fields

Name	Machine name	Required	Description
Block	field_prgf_block	Yes	Block reference to a View or a Block plugin. This field should have a default value configured and is typically hidden in the form display for content editors.

10 - Categories Listing

This is a dynamic paragraph that renders all published categories associated with the current program page.

It typically includes a “sticky at the top” option and orders items based on their published date (newest at the top).

Fields

Name	Machine name	Required	Description
Block	`field_prgf_block`	Yes	Block reference to the view/block. This field should have a default value and is typically hidden in the form display.

Note: The Categories Listing paragraph type displays taxonomy terms. Taxonomy terms are categorized under: plain text, number, reference, date and time and general.

11 - Class Location

This dynamic paragraph renders the location’s “class location” view mode based on the location URL query parameter with a valid ID. This paragraph is typically used on class pages to display location-specific information.

Context:

This paragraph is used to display location information, such as address, phone number, and hours, for a specific class.
The “class location” view mode defines how the location information is displayed.

Relates to [Branches Popup (Class)](Branches Popup (Class).md).

When the page has a location parameter, the Branches Popup paragraph will make an “Edit” link on this paragraph visible. That link triggers the Branches Popup to open, allowing the user to select a different location.

Fields

Name	Machine name	Required	Description
Block	`field_prgf_block`	Yes	Block reference to the view/block. Should have a default value and should be hidden in the form display. This field determines which block is rendered within the paragraph. The referenced block provides the actual content and formatting for the location information. Consider using a view block to display dynamic content related to the location.

12 - Class Sessions

This dynamic paragraph renders class session instances based on the URL query parameter location with a valid ID.

Relates to [Branches Popup (Class)](Branches Popup (Class).md).

Fields

Name	Machine name	Required	Description
Block	`field_prgf_block`	Yes	Block reference to the view/block. Should have a default value and should be hidden in form display.

Displayed Table

The following fields are displayed in a table format:

Location: Displayed unless &location=% is present in the URL, in which case it is hidden.
Time + Date
Registration: A link to the registration page.
Details:
- Online registration information
- Ticket requirement status
- Membership eligibility
Age: Minimum and maximum age range for the class.

Use Cases

These use cases describe the behavior of the Class Sessions paragraph in different scenarios, specifically regarding location filtering.

Use case 3: Class page WITHOUT location popup

Location Specified in URL

1 Location in specified URL
- When a Class page without a location popup is opened.
- And the URL contains location=%.
- The system skips any existing cookie values.
- The class session results are filtered based on the location specified in the URL.
- A location teaser is displayed in the sidebar.

Preferred Branch Empty or Selected, No Location in URL

2 Preferred branch is empty and no location in URL or Preferred branch is selected and no location in URL
- When a Class page without a location popup is opened.
- And either:
  - No preferred branch is selected.
  - A preferred branch is selected, but the URL does not contain location=%.
- The class session results include all branches.
- “All locations…” is displayed in the sidebar.

Use case 4: Class page WITH location popup

Location Specified in URL

1 Location in specified URL
- When a Class page with a location popup is opened.
- And the URL contains location=%.
- The system skips any existing cookie values.
- The class session results are filtered based on the location specified in the URL.
- A location teaser is displayed in the sidebar.
- The location teaser in the sidebar includes an “Edit” link that opens the location popup.

Preferred Branch Empty or Selected, No Location in URL

2 Preferred branch is empty and no location in URL or Preferred branch is selected and no location in URL
- When a Class page with a location popup is opened.
- And either:
  - No preferred branch is selected.
  - A preferred branch is selected, but the URL does not contain location=%.
- The class session results include all branches.
- “All locations…” is displayed in the sidebar.
- The location popup is displayed, unless only one location is associated with the class.

13 - Classes Listing

Displays published classes and provides filtering options.

The Classes Listing paragraph displays all published classes, grouped by activity.

The Classes Listing Filters provide a filter form with the following fields:

Location
Program
Sub-program
Activity

Relates to [Branches Popup (All)](Branches Popup (All).md).

Fields

Name	Machine name	Required	Description
Block	`field_prgf_block`	Yes	Block reference to the view/block. A default value should be set, and this field should be hidden in the form display.

Use Cases

1.1 Preferred branch is selected and no location in URL

When I open a Program subcategory page with the Classes Listing paragraph WITHOUT a location popup on the page.
And I have a preferred branch set (via cookie).
And I don’t have location=% in the URL.
Then the filter by location should be pre-defined based on the cookie value.
And the results should be filtered accordingly.

1.2 Preferred branch is empty and no location in URL

When I open a Program subcategory page with the Classes Listing paragraph WITHOUT a location popup on the page.
And I don’t have a preferred branch set (cookie is empty).
And I don’t have location=% in the URL.
Then the filter by location should show “All”.
And the results should be shown for all branches.

1.3 Location specified in URL

When I open a Program subcategory page with the Classes Listing paragraph WITHOUT a location popup on the page.
And I have location=% in the URL.
Then the preferred branch cookie should be ignored, regardless of its value.
And the filter by location should show the branch from the URL.
And the results should be filtered accordingly.

2.1 Preferred branch is selected and no location in URL

When I open a Program subcategory page with the Classes Listing paragraph WITH a location popup on the page.
And I have a preferred branch set (via cookie).
And I don’t have location=% in the URL.
Then the location popup shouldn’t be shown.
And the filter by location should be pre-defined based on the cookie value.
And the results should be filtered accordingly.

2.2 Preferred branch is empty and no location in URL

When I open a Program subcategory page with the Classes Listing paragraph WITH a location popup on the page.
And I don’t have a preferred branch set (cookie is empty).
And I don’t have location=% in the URL.
Then the filter by location should show “All”.
And the results should be shown for all branches.
And the location popup should be shown.

2.3 Location specified in URL

When I open a Program subcategory page with the Classes Listing paragraph WITH a location popup on the page.
And I have location=% in the URL.
Then the preferred branch cookie should be ignored, regardless of its value.
And the location popup shouldn’t be shown.
And the filter by location should show the branch from the URL.
And the results should be filtered accordingly.

14 - Code

The Code paragraph type allows you to embed code snippets, or even embed content from other websites such as YouTube videos. It leverages the Code block type for its functionality.

Fields

Name	Machine name	Required	Description
Code	field_prgf_code_block	Yes	Block reference to a Code block. You can create a new Code block directly from the paragraph edit screen, or select an existing one from the library. The Code block will determine the actual content displayed.

15 - Featured Blog Posts

The “Featured Blog Posts” paragraph type displays a listing of featured blog posts. It utilizes the openy_prgf_featured_blogs module.

Fields

Name	Machine Name	Required	Description
Headline	`field_prgf_headline`	No	Headline of the banner. This is a simple text field.
Blog Posts	`field_fblog_posts`	Yes	Multiple values. A reference field that links to Blog posts. The blog posts are sourced from nodes of the “Blog” content type.

Module Information

Module: openy_prgf_featured_blogs
Description: Provides a dynamic paragraph that renders a featured blog posts listing.
Dependencies:
- drupal:field
- drupal:node
- openy_node_blog:openy_node_blog
- openy_prgf:openy_prgf
- paragraphs:paragraphs

Templates

The appearance of this paragraph can be customized via Twig templates. The following templates are used by default, and can be overridden in your theme:

themes/contrib/openy_rose/templates/paragraph/paragraph--featured-blogs--default.html.twig
themes/contrib/openy_lily/templates/paragraphs/paragraph--featured-blogs--default.html.twig
themes/contrib/openy_carnation/templates/paragraph/paragraph--featured-blogs--default.html.twig

16 - Featured Content

The Featured Content paragraph type is used to create dynamic listings of content with various grid layouts. It’s part of the openy_prgf_featured_content module.

Fields

Name	Machine name	Required	Description
Headline	`field_prgf_headline`	No	Headline of the featured content.
Description	`field_prgf_description`	No	Text area for the description/body with WYSIWYG, without summary.
Link	`field_prgf_link`	No	Link field that supports internal and external URLs.
Style	`field_prgf_grid_style`	Yes	Select list defining the number of items per row: `2`: 2 items, `3`: 3 items, `4`: 4 items.
Column description	`field_prgf_fc_clm_description`	No	Multiple values. Text area for column descriptions with WYSIWYG, without summary.

17 - Featured Highlights

The Featured Highlights paragraph type provides a way to display specific content blocks in a grid layout, with options for 2, 3, or 4 blocks per row.

Fields

Name	Machine name	Required	Description
Title	`field_prgf_title`	No	Optional paragraph title displayed above the grid of blocks.
Style	`field_prgf_grid_style`	Yes	Determines the number of blocks displayed per row. A select list with the following values: `2`: 2 items per row, `3`: 3 items per row, `4`: 4 items per row.
Featured Highlights block	`field_prgf_block_ref_unlim`	Yes	References blocks to be displayed in the grid. You can create a new block or select an existing block. Allowed block types: Featured Highlight Block, Basic Block, Simple Block, and Date block. The “Featured Highlight Block” provides a title, link, image, and description for each item.

18 - Featured News Posts

The Featured News Posts paragraph type displays a set of news articles. It allows content editors to highlight timely and relevant news items on a page. This paragraph leverages the openy_prgf_featured_news module.

Fields

Name	Machine name	Required	Description
Headline	`field_prgf_headline`	No	Headline for the featured news section. This will appear above the linked news posts.
News Posts	`field_fnews_posts`	Yes	Multiple values. References existing News posts (nodes of type “News”). The referenced news posts will be displayed in this section.

Usage

When creating or editing a page or content type that supports paragraphs, select the “Featured News Posts” paragraph type.
Enter a “Headline” for the section (optional).
In the “News Posts” field, select one or more existing News posts. Use the autocomplete functionality to search for news posts by title.
Save the paragraph and the parent content.

The selected news posts will now be displayed on the page, under the specified headline. The display of each news post will use the “teaser” view mode.

19 - Gallery

The Gallery paragraph type is used to display a collection of images, often with accompanying text and links.

Fields

Name	Machine Name	Required	Description
Headline	`field_prgf_headline`	Yes	Headline of the gallery. Plain text.
Description	`field_prgf_description`	No	WYSIWYG field without summary. Allows for rich text formatting to describe the gallery.
Link	`field_prgf_link`	No	Link field for internal and external URLs. Can be used to link to more information.
Images	`field_prgf_images`	No	Entity reference to media images. Supports multiple images in the gallery.

20 - Grid columns

This paragraph type is used for the field_grid_columns within the Grid Content paragraph. It defines the structure and fields for individual columns within a grid layout.

Fields

Name	Machine name	Required	Description
Description	`field_prgf_grid_clm_description`	No	Textarea for the column’s description or body content. Supports WYSIWYG editing, but does not include a summary field.
Headline	`field_prgf_clm_headline`	No	Headline for the grid content within the column.
Icon	`field_prgf_clm_icon`	No	Entity reference to a media asset, typically an image. Recommended to allow uploading of SVGs for scalability.
Icon class	`field_prgf_clm_class`	No	Input field for adding Font Awesome icon classes (e.g., `flag`, `car`, `info`). Overrides the image specified in the Icon field.
Link	`field_prgf_clm_link`	No	Link field that supports both internal and external URLs.

21 - Grid Content

The Grid Content paragraph type is used to create grid layouts within stories.

Fields

Name	Machine name	Required	Description
Style	field_prgf_grid_style	Yes	Select list with the following values: `2`: 2 items per row, `3`: 3 items per row, `4`: 4 items per row. This determines the number of columns in the grid.
Content	field_grid_columns	Paragraph	Grid columns. This field references the `Grid columns` paragraph type, allowing you to add individual columns to the grid.
Description	field_prgf_grid_clm_description	No	Textarea for the column description/body. Supports WYSIWYG editing, but without a summary option.
Headline	field_prgf_clm_headline	No	Headline for the grid content column.
Icon	field_prgf_clm_icon	No	Entity reference to a media asset, typically an SVG image. Allows uploading of new SVG files.
Icon class	field_prgf_clm_class	No	Input field for adding Font Awesome icon classes (e.g., `flag`, `car`, `info`). This will override the image Icon.
Link	field_prgf_clm_link	No	Link field that supports both internal and external URLs.

22 - Group Schedules

This is a dynamic paragraph that renders group schedules from the GroupEx Pro system. It leverages the openy_prgf_group_schedules module. This paragraph type allows content editors to embed schedules directly within content, providing users with up-to-date class and activity information.

Fields

Name	Machine name	Required	Description
Block	`field_prgf_block`	Yes	Block reference to the view/block that displays the GroupEx Pro schedule. A default value should be set and is configurable in the form display.

23 - Latest Blog Posts

This paragraph is a dynamic element that displays the most recent blog posts. It’s designed to showcase content that is promoted to the front page.

Key features:

Sticky at the top: This ensures the most important blog posts remain visible.
Order: Items are ordered by published date, with the newest posts appearing first.

Fields

Name	Machine name	Required	Description
Block	field_prgf_block	Yes	This field holds a block reference to the view/block that provides the blog post listing. It is intended to have a default value set and is typically hidden from the form display to simplify content creation and prevent accidental modification of the listing source.

24 - Latest Blog Posts (Branch)

This dynamic paragraph renders the latest blog posts associated with a specific branch. It displays posts in chronological order, with the newest posts at the top, and utilizes the “sticky at the top” option to highlight important content.

Functionality

This paragraph type automatically filters and displays blog posts based on the branch context in which it is placed. For example, if this paragraph is added to a “Downtown YMCA” branch page, it will only display blog posts associated with the “Downtown YMCA” branch. If placed on a non-branch page, only the headline will be visible.

Fields

Name	Machine name	Required	Description
Block	field_prgf_block	Yes	Block reference to the view/block. This field should have a default value and be hidden in the form display. It determines the view or block used to render the blog posts.

25 - Latest Blog Posts (Camp)

This paragraph dynamically renders the latest blog posts associated with a specific camp. It displays posts in reverse chronological order (newest first).

Functionality

Filtering: Displays only blog posts associated with the current camp. If placed on a non-camp page, only the title will render.
Ordering: Blog posts are ordered by published date, with the newest posts appearing at the top.
Styling: Blog posts are displayed in a card format.

Usage

This paragraph is typically used in the content area or bottom area of a Camp page to showcase relevant blog content. To use it, select “Latest Blog Posts (Camp)” from the paragraphs dropdown, and enter a header title.

Supported Content Types

Camp

Fields

Name	Machine name	Required	Description
Block	`field_prgf_block`	Yes	Block reference to the view/block. This field should have a default value and is typically hidden in the form display.

26 - Latest News Posts

This paragraph type dynamically renders the latest news posts. It is typically used to display news promoted to the front page, ordering them by published date with the newest at the top. The “sticky at the top” option can be used to highlight certain posts.

This paragraph leverages a block reference to display content.

Fields

Name	Machine name	Required	Description
Block	`field_prgf_block`	Yes	A block reference to a view or block. A default value should be configured, and the field should be hidden in the form display. This block will contain the actual list of news posts.

27 - Latest News Posts (Branch)

The “Latest News Posts (Branch)” paragraph type is a dynamic element that displays the most recent news articles associated with a specific branch location. It’s designed to highlight timely and relevant information, ensuring that users are presented with the newest content first.

This paragraph automatically orders news items by their published date, with the most recent articles appearing at the top. Additionally, it utilizes a “sticky at the top” feature, which can be configured in the associated View to keep specific, important news posts prominently displayed.

Fields

Name	Machine name	Required	Description
Block	`field_prgf_block`	Yes	This field is a block reference to a View block that lists news posts. The View should have a default value set and is typically hidden in the form display to simplify content editing. The view should filter by branch.

Module Dependencies

This paragraph type is provided by the openy_prgf_news_branch module, which has the following dependencies:

field: Part of Drupal core.
node: Part of Drupal core.
openy_loc_branch: Open Y Branch Location module.
openy_node_news: Open Y News Node module.
openy_prgf: Open Y Paragraphs base module.
paragraphs: Paragraphs module for creating structured content.
plugin: Part of Drupal core.
user: Part of Drupal core.
views: Part of Drupal core.
views_infinite_scroll: Views Infinite Scroll module for paginating results.

28 - Latest News Posts (Camp)

This paragraph type dynamically renders the latest news posts associated with a specific camp. It displays news articles in reverse chronological order (newest first) and can utilize a “sticky” option to highlight certain posts at the top of the list.

Functionality

This paragraph is designed to be placed on a Camp page. When placed on a Camp page, it will display only news posts associated with that specific camp. If placed on a non-Camp page, it will display only the title (if one is configured).

Fields

Name	Machine name	Required	Description
Block	`field_prgf_block`	Yes	Block reference to the view/block that displays the news posts. A default value should be configured for this field, and it should typically be hidden in the form display to prevent accidental modification.

29 - Limited Time Offer

This Paragraph type is used to add a limited-time offer section to a page, often the home page, and is based on a Landing Page Content Type.

Fields

Name	Machine name	Required	Description
Subtitle	field_lto_subtitle	No	Enter the subtitle for the limited-time offer.
Link	field_lto_link	No	Add a link for the limited-time offer.
Title	field_lto_title	Yes	Enter the title for the limited-time offer.

30 - Location finder

This paragraph describes the Location finder paragraph type, which renders a block.

The Location finder block displays locations such as branches, camps, and facilities using a map and associated views. It may also include a filter block. For the Location finder block and Location finder filter block, see the Open Y Map documentation.

Fields

Name	Machine name	Required	Description
Location finder	field_prgf_location_finder	No	Block reference to the `location_finder` block. It should have a default value and be hidden in the form display. This block renders the location map.

31 - Location Finder Filters

This paragraph renders the Location Finder map with pins and filters. It allows users to filter locations displayed on the map based on tags or other criteria.

Fields

Name	Machine name	Required	Description
Location Finder	field_prgf_location_finder	No	Block reference to the `location_finder` block. This field should have a default value and be hidden in the form display to prevent direct user modification.
Tags Style	field_prgf_lf_tags_style	Yes	Determines the style of tags used for the map tags filter. Options include: - Checkboxes (default) - Multiselect widget with checkboxes.

32 - Membership Information Paragraph

This document describes the “Membership Information” paragraph type, which is used to display membership details such as location, link, fees, and rates. This paragraph is intended for use in the Membership content type.

Fields

Name	Machine name	Required	Description
Location	`field_mbrshp_location`	No	Select list with locations (branches). Single value.
Link	`field_mbrshp_link`	No	Link field to provide the membership redirect URL.
Join Fee	`field_mbrshp_join_fee`	No	Dollar value representing the one-time fee to join.
Monthly Rate	`field_mbrshp_monthly_rate`	No	Dollar value representing the recurring monthly membership fee.

33 - Microsites Menu

This paragraph type provides a microsites menu block.

Fields

Name	Machine name	Required	Description
Menu Block	`field_prgf_block_ref`	Yes	Block reference to the view/block. Create a new one or select an existing menu block. See the Blocks documentation for more information.
Hide Main Menu	`field_prgf_ms_menu_hide_menu`	No	Determines whether to hide the main website menu when this microsites menu is displayed.

34 - News Posts Listing

This dynamic paragraph renders the latest news posts and utilizes exposed filters, allowing users to refine the displayed content.

The available filters are:

Location
Category
Text

The News Posts Listing also features a “sticky at the top” option, ensuring important news remains visible. Items are ordered by published date, with the newest posts appearing first. This functionality relies on the Views module.

Fields

Name	Machine name	Required	Description
Block	field_prgf_block	Yes	Block reference to the View block. This should have a default value configured in the Paragraph type and hidden in the form display.

35 - Program Registration (Daxko)

This paragraph renders the Programs Search Block.

The Programs Search Block provides a form to search programs from Daxko.

Related topics: Daxko

Important: The Daxko and Program Registration (Daxko) configurations must be set up before the Program Registration paragraph will work.

Configuration settings are located at /admin/config/development/daxko/programs-search. You must have the administer daxko permission to configure these settings. See the Daxko settings documentation for more information on configuring the connection to Daxko.

Fields

Name	Machine name	Required	Description
Program registration block	field_prgf_reg_block	No	Block reference to the `programs_search_block` block. Should have a default value and should be hidden in the form display.

36 - Promo Card

The Promo Card is a Paragraph type used to create promotional content. It is often used in sidebars or other secondary areas of a page.

Fields

Name	Machine name	Required	Description
Title	`field_prgf_title`	No	Optional title for the Promo Card. Displayed above the Headline.
Headline	`field_prgf_headline`	Yes	Headline of the Promo Card. Displayed below the Title.
Description	`field_prgf_description`	No	A WYSIWYG field for the main content of the Promo Card. Does not support summaries.
Link	`field_prgf_link`	No	A link field for internal and external links. Supports a call to action.

37 - Schedule search form

This paragraph renders the session instance filters for the [Schedule search list](Schedule search list.md). It provides a dynamic form allowing users to filter session instances based on various criteria. The form is rendered using the SchedulesSearchFormBlock plugin, which utilizes the SchedulesSearchForm form.

Fields

Name	Machine name	Required	Description
Block	field_prgf_block	Yes	Block reference to the view/block. This field stores a reference to a block, typically a view or another block, that provides the search form. It should have a default value and should be hidden in form display. The default value should be the `schedules_search_form_block` plugin.

Usage

This paragraph is typically used in conjunction with the [Schedule search list](Schedule search list.md) paragraph to provide a filtering mechanism for session instances. It is rendered using the SchedulesSearchFormBlock plugin.

Technical Details

Plugin ID: schedules_search_form_block
Class: Drupal\openy_schedules\Plugin\Block\SchedulesSearchFormBlock
Form: Drupal\openy_schedules\Form\SchedulesSearchForm

38 - Schedule search list

This dynamic paragraph renders the session instances based on URL parameters and/or filters from the [Schedule search form](Schedule search form.md).

Relates to [Branches Popup (All)](Branches Popup (All).md).

Fields

Name	Machine name	Required	Description
Block	field_prgf_block	Yes	Block reference to the view/block. Should have a default value and should be hidden in the form display.

Use Cases

1.1 Preferred branch is selected and no location in URL

When I open the Schedule search list page WITHOUT a location popup on the page
And I have a preferred branch
And I don’t have location=% in the URL
Then the filter by location should be predefined based on the cookie
And the results should be filtered

1.2 Preferred branch is empty and no location in URL

When I open the Schedule search list page WITHOUT a location popup on the page
And I don’t have a preferred branch
And I don’t have location=% in the URL
Then the filter by location should show “All”
And the results should be shown for all branches

1.3 Location specified in URL

When I open the Schedule search list page WITHOUT a location popup on the page
And I have location=% in the URL
Then we skip the cookie, whether it is empty or exists
And the filter by location should show the branch from the URL
And the results should be filtered

2.1 Preferred branch is selected and no location in URL

When I open the Schedule search list page WITH a location popup on the page
And I have a preferred branch
And I don’t have location=% in the URL
Then the location popup shouldn’t be shown
And the filter by location should be predefined based on the cookie
And the results should be filtered

2.2 Preferred branch is empty and no location in URL

When I open the Schedule search list page WITH a location popup on the page
And I don’t have a preferred branch
And I don’t have location=% in the URL
Then the filter by location should show “All”
And the results should be shown for all branches
And the location popup should be shown

2.3 Location specified in URL

When I open the Schedule search list page WITH a location popup on the page
And I have location=% in the URL
Then we skip the cookie, whether it is empty or exists
And the location popup shouldn’t be shown
And the filter by location should show the branch from the URL
And the results should be filtered

39 - Secondary Description and Sidebar

The Secondary Description and Sidebar paragraph type is designed for content layouts featuring a left column (secondary description) and a right column (sidebar). Both columns utilize blocks for flexible content placement.

Fields

Name	Machine Name	Required	Description
Left Column	field_prgf_left_column_block	No	A block reference field for the left column, often used for a secondary description. You can select from existing blocks or create a new one. Supported block types: Basic Block, Code Block, Date Block, or Simple Block.
Right Column	field_prgf_right_column_block	No	A block reference field for the right column, typically used as a sidebar. You can select from existing blocks or create a new one. Supported block types: Basic Block, Code Block, Date Block, or Simple Block.

Note: Blocks provide a modular way to organize and display content within the columns. Consider using Basic Blocks for standard text and media, Code Blocks for displaying code snippets, Date Blocks for event dates, and Simple Blocks for streamlined content elements. You can create these blocks in the “Blocks” section of the administrative interface. The “Block Content” module allows you to manage block types and content blocks. The block description is an identification name for a block, which is shown in the administrative interface and not displayed on the site. The block title is the heading that is optionally shown to site visitors when the block is placed in a region.

40 - Session Time

The Session Time paragraph is used within the Session content type to define the schedule for a session. It allows you to specify the date and time range, as well as the days of the week the session repeats.

Fields

Name	Machine name	Required	Description
Date & Time	field_session_time_date	No	This field uses the Datetime Range module to create a date/time field with start and end date/time options. This defines the period when the session is active. For example, January 1, 2024, to January 1, 2025.
Days	field_session_time_days	No	Checkboxes to select the days of the week the session repeats. Available options: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday. If a date range and a day are selected, the session will occur on that day of the week within the specified date range.
Session time override	field_session_time_override	No	Use this field to override the session time to text.

41 - Simple Content

The Simple Content paragraph type is used for adding formatted text to pages. It provides a WYSIWYG editor for rich text input.

Fields

Name	Machine name	Required	Description
Content	`field_prgf_description`	Yes	WYSIWYG editor for formatted text content.

42 - Small Banner

The Small Banner paragraph type is used to display banner content in a compact format.

Fields

Name	Machine name	Required	Description	Notes
Color	field_prgf_color	Yes	Reference field for choosing a color from the “Color” vocabulary.	Used for the banner’s background color.
Headline	field_prgf_headline	Yes	Headline of the Small Banner.	Plain text, maximum 255 characters.
Image	field_prgf_image	No	Entity reference to a media image.	Single value. Recommended image dimensions: [TBD].
Description	field_prgf_description	No	WYSIWYG field for the banner’s description, supports rich text formatting.	No summary option. Use sparingly to maintain a clean banner appearance.

43 - Social Post Listing

This paragraph type renders the latest social posts imported from social networks and displays them in a masonry grid. It leverages a View block to select and format the posts.

Fields

Name	Machine name	Required	Description
Title	field_prgrf_sl_title	No	Title for the social posts block. This is a plain text field.
Description	field_prgrf_sl_description	No	Description for the social posts block. This field supports longer text and can be used for introductory content.
Social List	field_prgrf_sl_block	No	Reference to a View block. This block is configured to select social posts and display them.

Details about the Social List (field_prgrf_sl_block) View Block:

View: social_posts_view
Block Display: social_posts_block
This view selects nodes of the social_post content type.
The view provides an administrative interface at admin/social-posts to manage social posts.
The view displays the platform, ID, post content, and posted date for each social post.

44 - Social Share Icons

This paragraph type was used to add social media share icons, leveraging the AddThis service.

Important: The AddThis service has been deprecated as of May 31, 2023. This paragraph type no longer functions. See Using AddToAny for its replacement.

See more How to configure AddThis

Fields

Name	Machine name	Required	Description	Notes
Title	field_prgrf_sl_title	No	Block title.	You can add text here if your block needs a title.
Description	field_prgrf_sl_description	No	Block Description.	You can add text here if your block needs a description.
Block	field_prgrf_sl_block	Yes		Select a social sharing plugin.

45 - Story Card

The Story Card is a Paragraph type designed for use in sidebars, featuring a title, headline, and a link that turns the entire card into a call to action. This paragraph type is commonly used to highlight specific information or direct users to related content.

Fields

Name	Machine name	Required	Description
Title	`field_prgf_title`	No	Title of the Story Card.
Headline	`field_prgf_headline`	Yes	Headline of the Story Card. A quotation mark will be displayed to the left of your headline in the Lily and Rose themes.
Link	`field_prgf_link`	No	Link field that stores an internal or external URL. The entire card becomes the link, so use link text that encourages users to click.

Usage Notes

Themes: The Story Card Paragraph renders with specific styling in the Lily and Rose themes, including a border. It may not have the same visual emphasis in other themes like Carnation.
Best Practices: To enhance usability, consider adding a > or other special character to the link text to visually indicate it’s a clickable link.
Content Types: Story Cards are primarily designed for use in the sidebar region of content types, including:
- Landing Page
- News Post
- Blog Post
- Facility
- Program
- Program Subcategory

Advanced

Custom CSS: To disable the quotation mark in the headline area (Lily and Rose), use the following CSS:
```
.story-card .quote svg {
  display: none;
}
```

46 - Teaser

The Teaser paragraph type is used to create visually engaging previews of content, often linking to more detailed information. It typically includes a title, image, short description, and a link.

Fields

Name	Machine name	Required	Description
Title	field_prgf_title	No	The title of the teaser. This is often displayed prominently.
Image	field_prgf_image	No	A reference to a media image. This field accepts a single image to visually represent the teaser content.
Description	field_prgf_description	No	A WYSIWYG field (What You See Is What You Get) allowing formatted text input for a brief description of the teaser content. A summary is not supported for this field.
Link	field_prgf_link	No	A link field that stores internal and external URLs. This allows the teaser to link to other content within the site or external resources.

Usage

Teaser paragraphs are commonly used on landing pages, content hubs, and in listing pages to promote specific articles, products, or sections of a website. They provide a concise overview and encourage users to explore further. The field_prgf_link will take the user to the page that the Teaser is promoting.

Best Practices

Image Dimensions: Use appropriately sized images to ensure optimal display and page load times.
Concise Descriptions: Keep descriptions brief and focused on highlighting the key benefits or features of the linked content.
Clear Call to Action: The link text should clearly indicate the destination and encourage user interaction (e.g., “Read More,” “Learn More,” “View Details”).

47 - Webform

This is a paragraph type used for embedding webforms within content. It allows you to add existing webforms to a page.

Prerequisites

You must have already created your webform using the Webform module before embedding it. This paragraph type does not create a new webform.
Consider reviewing the Drupal Webform Tutorials (by Jacob Rockowitz) for comprehensive guidance on creating and managing webforms.

How to Use the Webform Paragraph

Add the Webform Paragraph: Select “Webform” from the available paragraph types when editing a content item.
Select the Webform: Choose the desired webform from the “Embedded Webform” field. This field displays a list of available webforms created using the Webform module.
Configure Webform Status: Use the “Webform status” field to control the webform’s availability:
- Open: Allows users to submit the webform.
- Closed: Prevents new submissions. Existing submissions remain accessible.
- Scheduled: Set open and close dates for the webform.
Default Webform Submission Data (Optional): The “Default webform submission data (YAML)” field allows you to pre-populate webform fields with default values.
- Enter YAML code to define the default values.
- This is useful for providing guidance or setting common values for users.
- Consult the YAML specification for correct syntax.

Fields

Name	Machine name	Required	Description
Embedded Webform	`field_prgf_webform`	No	Webform entity reference field. Select the webform you want to embed.
Default webform submission data (YAML)	`field_prgf_webform_default_data`	No	YAML code to pre-populate webform fields with default values.
Webform status	`field_prgf_webform_status`	No	Controls the availability of the webform. Options: Open, Closed, or Scheduled.

Paragraphs

1 - 1 Column

Fields

2 - 2 Columns

Fields

3 - 3 Columns

Fields

4 - 4 Columns

Fields

5 - All Amenities

Fields

6 - Banner

Fields

7 - Blog Posts Listing

Fields

8 - Branches Popup (All)

Fields

Usage

9 - Branches Popup (Class)

Fields

10 - Categories Listing

Fields

11 - Class Location

Fields

12 - Class Sessions

Fields

Displayed Table

Use Cases

Class Page WITHOUT Location Popup

Location Specified in URL

Preferred Branch Empty or Selected, No Location in URL

Class Page WITH Location Popup

Location Specified in URL

Preferred Branch Empty or Selected, No Location in URL

13 - Classes Listing

Fields

Use Cases

Use case 1: Classes Listing paragraph on a Program subcategory page WITHOUT location popup paragraph

Use case 2: Classes Listing paragraph on a Program subcategory page WITH location popup

14 - Code

Fields

15 - Featured Blog Posts

Fields

Module Information

Templates

16 - Featured Content

Fields

17 - Featured Highlights

Fields

18 - Featured News Posts

Fields

Usage

19 - Gallery

Fields

20 - Grid columns

Fields

21 - Grid Content

Fields

22 - Group Schedules

Fields

23 - Latest Blog Posts

Fields

24 - Latest Blog Posts (Branch)

Functionality

Fields

25 - Latest Blog Posts (Camp)

Functionality

Usage

Supported Content Types

Fields

Related Paragraphs

26 - Latest News Posts

Fields

27 - Latest News Posts (Branch)

Fields

Module Dependencies

28 - Latest News Posts (Camp)

Functionality

Fields

29 - Limited Time Offer