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

Return to the regular view of this page.

Paragraphs

Welcome to YMCA Website Services Paragraphs.

Paragraphs are bits of content, components, from component based design ideology. In a scope of YMCA Website Services architecture paragraphs are based on Paragraphs Drupal module.

The core idea of paragraphs is to have a nice looking and behaving widget for adding predefined content blocks right in place, without referencing external entities. Keep in mind, that paragraphs are not reusable types. For having reusable type look for blocks or entities in terms of Drupal 8.

Paragraphs were created for making UX better and super convenient.

1 - 1 Column

This is a paragraph type that will be used for implements a paragraph with 1 column.

Fields

NameMachine nameRequiredDescriptionNotes
Line Abovefield_prfg_display_line_aboveNoDisplay a line above the column.
Columnfield_prgf_1c_columnNoEnter column body.
Paragraph Titlefield_prgf_1c_titleNoEnter title to display at the top of 1 column paragraph.
Paragraph Descriptionfield_prgf_1c_descriptionNoEnter description to display under the 1 column paragraph title.

2 - 2 Columns

This is a paragraph type that will be used for implements a paragraph with 2 column.

Fields

NameMachine nameRequiredDescriptionNotes
Line Abovefield_prfg_display_line_aboveNoDisplay a line above the column.
Left Columnfield_prgf_2c_leftNoEnter left column body.
Right Columnfield_prgf_2c_rightNoEnter right column body.

3 - 3 Columns

This is a paragraph type that will be used for implements a paragraph with 3 column.

Fields

NameMachine nameRequiredDescriptionNotes
Line Abovefield_prfg_display_line_aboveNoDisplay a line above the column.
Left Columnfield_prgf_3c_leftNoEnter left column body.
Center Columnfield_prgf_3c_centerNoEnter center column body.
Right Columnfield_prgf_3c_rightNoEnter right column body.
Paragraph Titlefield_prgf_titleNoEnter title to display at the top of 3 columns paragraph.

4 - 4 Columns

This is a paragraph type that will be used for implements a paragraph with 4 column.

Fields

NameMachine nameRequiredDescriptionNotes
Line Abovefield_prfg_display_line_aboveNoDisplay a line above the column.
First Columnfield_prgf_4c_1stNoEnter first column body.
Second Columnfield_prgf_4c_2ndNoEnter second column body.
Third Columnfield_prgf_4c_3rdNoEnter third column body.
Fourth Columnfield_prgf_4c_4thNoEnter forth column body.
Buttonfield_prgf_4c_buttonNoButton with link to display under 4 column paragraph
Paragraph Titlefield_prgf_titleNoEnter title to display at the top of 4 columns paragraph.
Paragraph Descriptionfield_prgf_descriptionNoEnter description to display under the 4 columns paragraph title.

5 - All Amenities

Provide a paragraph with a table view shows list of Branches.

Fields

NameMachine nameRequiredDescription
All amenitiesfield_field_prgf_amnts_viewNoPredefined reference to a view to display all amenities.
Titlefield_prgf_titleNoEnter title which is going to be displayed on top of the paragraph.

6 - Banner

This is a paragraph type that will be used for the banner content.

Fields

NameMachine nameRequiredDescriptionNotes
Headlinefield_prgf_headlineYesHeadline of the banner.Plain text, 255 characters
Colorfield_prgf_colorYesReference field for choosing the term from “Color” vocabulary.
Imagefield_prgf_imageNoEntityreference to media image. Single value.
Descriptionfield_prgf_descriptionNoWYSIWYG field without summary.
Linkfield_prgf_linkNoLink field that should store internal and external links.

7 - Blog Posts Listing

This is dynamic paragraph that renders the latest blog posts and utilizes exposed filters.

  • Location
  • Category
  • Text

It uses sticky at the top option and order items based on published date (newest at the top).

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

8 - Branches Popup (All)

This is dynamic paragraph that renders the locations selection popup, based on current node.

Relates to:

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

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

9 - Branches Popup (Class)

This is dynamic paragraph that renders the locations selection popup, based on current node.

Relates to:

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

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

10 - Categories Listing

This is dynamic paragraph that renders all published categories according to current program page.

It uses sticky at the top option and order items based on published date(newest at the top).

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

11 - Class Location

This is dynamic paragraph that renders the locations class location view mode, based on url query parameter location with a valid id.

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.

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

12 - Class Sessions

This is dynamic paragraph that renders the class session instances, based on url query parameter location with a valid id.

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

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

Displayed table

  • Location(should be displayed in case if &location=% not in the URL. Otherwise should be hiddedn.
  • Time + date
  • Registration(link)
  • Details
    • Online registration
    • Ticket required
    • In membership
  • Age Min - Max

Use cases

Use case 3: Class page WITHOUT location popup 3.1 Location in specified URL

  • When I open Class page WITHOUT location popup on page
  • And I have location=% in the URL
  • We skip cookie whether is empty or exist
  • Results should be filtered based on location from URL
  • In sidebar we should see location teaser

3.2 Preferred branch is empty and no location in URL or Preferred branch is selected and no location in URL

  • When I open Class page WITHOUT location popup on page
  • And I don’t have a preferred branch
  • Or I have a preferred branch
  • And I don’t have location=% in the URL
  • Results should contain all branches
  • In sidebar we should see “All locations….”

Use case 4: Class page WITH location popup 4.1 Location in specified URL

  • When I open Class page WITH location popup on page
  • And I have location=% in the URL
  • We skip cookie whether is empty or exist
  • Results should be filtered based on location from URL
  • In sidebar we should see location teaser
  • Location is sidebar should have “Edit” link that will open location popup

4.2 Preferred branch is empty and no location in URL or Preferred branch is selected and no location in URL

  • When I open Class page WITH location popup on page
  • And I don’t have a preferred branch
  • Or I have a preferred branch
  • And I don’t have location=% in the URL
  • Results should contain all branches
  • In sidebar we should see “All locations….”
  • Location popup should be shown (Unless only one location is associated with the class)

13 - Classes Listing

and classes listing filters

Classes Listing - should display all published classes grouped by activity.

Classes Listing Filters - this paragraph should disply filter form for “Classes Listing” with following fields:

  • Location
  • Program
  • Sub-program
  • Activity

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

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

Use cases

Use case 1: Classes Listing paragraph on a Program subcategory page WITHOUT location popup paragraph 1.1 Preferred branch is selected and no location in URL

  • When I open Program subcategory page with Classes Listing WITHOUT location popup on page
  • And I have a preferred branch
  • And I don’t have location=% in the URL
  • Filter by location should be predefined based on cookie
  • Results should be filtered

1.2 Preferred branch is empty and no location in URL

  • When I open Program subcategory page with Classes Listing WITHOUT location popup on page
  • And I don’t have a preferred branch
  • And I don’t have location=% in the URL
  • Filter by location should show “All”
  • Results should be shown for all branches

1.3 Location in specified URL

  • When I open Program subcategory page with Classes Listing WITHOUT location popup on page
  • And I have location=% in the URL
  • We skip cookie whether is empty or exist
  • Filter by location should show branch from URL
  • Results should be filtered

Use case 2: Classes Listing paragraph on a Program subcategory page WITH location popup 2.1 Preferred branch is selected and no location in URL

  • When I open Program subcategory page with Classes Listing WITH location popup on page
  • And I have a preferred branch
  • And I don’t have location=% in the URL
  • Location popup shouldn’t be shown
  • Filter by location should be predefined based on cookie
  • Results should be filtered

2.2 Preferred branch is empty and no location in URL

  • When I open Program subcategory page with Classes Listing WITH location popup on page
  • And I don’t have a preferred branch
  • And I don’t have location=% in the URL
  • Filter by location should show “All”
  • Results should be shown for all branches
  • Location popup should be shown

2.3 Location in specified URL

  • When I open Program subcategory page with Classes Listing WITH location popup on page
  • And I have location=% in the URL
  • We skip cookie whether is empty or exist
  • Location popup shouldn’t be shown
  • Filter by location should show branch from URL
  • Results should be filtered

14 - Code

Provide paragraph containing a Code block. Can be used to embed Youtube video for instance.

Fields

NameMachine nameRequiredDescription
Codefield_prgf_code_blockYesBlock reference to Code block. Create a new one or pick up an existed Code block.

15 - Featured Blog Posts

This is a paragraph type that will be used for the featured stories.

Fields

NameMachine nameRequiredDescription
Headlinefield_prgf_headlineNoHeadline of the banner.
Blog Postsfield_fblog_postsYesMultiple values. Reference field to Blog posts.

16 - Featured Content

This is a paragraph type that will be used for the featured content.

Fields

NameMachine nameRequiredDescription
Headlinefield_prgf_headlineNoHeadline of the featured content.
Descriptionfield_prgf_descriptionNoTextarea for the description/body with WYSIWYG, without summary.
Linkfield_prgf_linkNoLink field that supports internal and external URLs.
Stylefield_prgf_grid_styleYesSelect list with following values: 2:2 items per row, 3:3 items per row, 4:4 items per row
Column descriptionfield_prgf_fc_clm_descriptionNoMultiple values. Textarea for the column with WYSIWYG, without summary.

17 - Featured Highlights

Provides a paragraph containing blocks of specific types positioned as 2, 3 or 4 blocks per row.

Fields

NameMachine nameRequiredDescription
Titlefield_prgf_titleNoParagraph title.
Stylefield_prgf_grid_styleYesSelect list with following values: 2:2 items per row, 3:3 items per row, 4:4 items per row.
Featured Highlights blockfield_prgf_block_ref_unlimYesCreate a new one or pick up an existing block of given types: Featured Highlight Block, Basic Block, Simple Block, Date block.

18 - Featured News Posts

This is a paragraph type that will be used for the featured news.

Fields

NameMachine nameRequiredDescription
Headlinefield_prgf_headlineNoHeadline of the banner.
News Postsfield_fnews_postsYesMultiple values. Reference field to News posts.

19 - Gallery

This is a paragraph type that will be used for the gallery content.

Fields

NameMachine nameRequiredDescription
Headlinefield_prgf_headlineYesHeadline of the gallery.
Descriptionfield_prgf_descriptionNoWYSIWYG field without summary.
Linkfield_prgf_linkNoLink field that should store internal and external links.
Imagesfield_prgf_imagesNoEntityreference to media image. Multiple values.

20 - Grid columns

This is a paragraph type that will be used for field_grid_columns the in Grid Content paragraph.

Fields

NameMachine nameRequiredDescription
Descriptionfield_prgf_grid_clm_descriptionNoTextarea for the description/body with WYSIWYG, without summary.
Headlinefield_prgf_clm_headlineNoHeadline of the grid content.
Iconfield_prgf_clm_iconNoEntityreference to media asset. Should allow to upload svgs.
Icon classfield_prgf_clm_classNoInput field that allows to add the font-awesome icons needed. Description - “Provide a “Font Awesome” icon mane, e.g. flag, car, info. Overrides image Icon.”
Linkfield_prgf_clm_linkNoLink field that supports internal and external URLs.

21 - Grid Content

This is a paragraph type that will be used for the grid content stories.

Fields

NameMachine nameRequiredDescription
Stylefield_prgf_grid_styleYesSelect list with following values: 2:2 items per row, 3:3 items per row, 4:4 items per row
Contentfield_grid_columnsParagraphGrid columns
Descriptionfield_prgf_grid_clm_descriptionNoTextarea for the description/body with WYSIWYG, without summary.
Headlinefield_prgf_clm_headlineNoHeadline of the grid content.
Iconfield_prgf_clm_iconNoEntityreference to media asset. Should allow to upload svgs.
Icon classfield_prgf_clm_classNoInput field that allows to add the font-awesome icons needed. Description - “Provide a “Font Awesome” icon mane, e.g. flag, car, info. Overrides image Icon.”
Linkfield_prgf_clm_linkNoLink field that supports internal and external URLs.

22 - Group Schedules

This is dynamic paragraph that renders the group schedules from GroupEx Pro.

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and is configurable in form display.

23 - Latest Blog Posts

This is dynamic paragraph that renders the latest blog posts that are promoted to the front page.

It uses sticky at the top option and order items based on published date (newest at the top).

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

24 - Latest Blog Posts (Branch)

This is dynamic paragraph that renders the latest blog posts associated with a branch.

It uses sticky at the top option and order items based on published date (newest at the top).

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

25 - Latest Blog Posts (Camp)

This is dynamic paragraph that renders the latest blog posts associated with a camp.

It uses sticky at the top option and order items based on published date (newest at the top).

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

26 - Latest News Posts

This is dynamic paragraph that renders the latest news posts that are promoted to the front page.

It uses sticky at the top option and order items based on published date (newest at the top).

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

27 - Latest News Posts (Branch)

This is dynamic paragraph that renders the latest news posts associated with a branch.

It uses sticky at the top option and order items based on published date (newest at the top).

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

28 - Latest News Posts (Camp)

This is dynamic paragraph that renders the latest news posts associated with a camp.

It uses sticky at the top option and order items based on published date (newest at the top).

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

29 - Limited Time Offer

This Paragraph add limited time offer for Home Page based on Landing Page CT.

Fields

NameMachine nameRequiredDescription
Subtitlefield_lto_subtitleNoEnter subtitle for Limited time offer.
Linkfield_lto_linkNoAdd link for Latest time offer.
Titlefield_lto_titleNoEnter title for the Limited Time Offer.

30 - Location finder

This is paragraph that renders the Location finder block.

Location finder block contains locations views displays with branches, camps and facilities.

Fields

NameMachine nameRequiredDescription
Location finderfield_prgf_location_finderNoBlock reference to the location_finder block. Should have default value and should be hidden in form display.

31 - Location finder filters

This is paragraph that renders the Location finder map with pins and filters.

Fields

NameMachine nameRequiredDescription
Location finderfield_prgf_location_finderNoBlock reference to the location_finder block. Should have default value and should be hidden in form display.
Tags stylefield_prgf_lf_tags_styleYesTags style that will be used for map tags filter. Default - checkboxes. Second option is multiselect widget with checkboxes.

32 - Membership info

This is a paragraph type that will be used for field_mbrshp_info the in Membership CT.

Fields

NameMachine nameRequiredDescription
Locationfield_mbrshp_locationNoSelect list with locations (branches). Single value.
Linkfield_mbrshp_linkNoLink field to provide the membership redirect URL.
Join Feefield_mbrshp_join_feeNoDollar value for how much someone has to pay to join.
Monthly Ratefield_mbrshp_monthly_rateNoDollar value for the monthly fee of the membership.

33 - Microsites menu

Provide paragraph containing a microsites menu block.

Fields

NameMachine nameRequiredDescription
Menu Blockfield_prgf_block_refYesBlock reference to the view/block. Create a new one or pick up an existed menu block.
Hide Main Menufield_prgf_ms_menu_hide_menuNoWhether to hide or not the main website menu.

34 - News Posts Listing

This is dynamic paragraph that renders the latest news posts and utilizes exposed filters.

  • Location
  • Category
  • Text

It uses sticky at the top option and order items based on published date (newest at the top).

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

35 - Program Registration (Daxko)

This is paragraph that renders the Programs Search Block.

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

Relates to: Daxko

Daxko & Program Registration (Daxko) configuration must be setup before the Program Registration paragraph will work.

Configuration setting at /admin/config/development/daxko/programs-search

Fields

NameMachine nameRequiredDescription
Program registration blockfield_prgf_reg_blockNoBlock reference to the programs_search_block block. Should have default value and should be hidden in form display.

36 - Promo Card

This is a Paragraph type that will be used for the Promo Cards.

Fields

NameMachine nameRequiredDescription
Titlefield_prgf_titleNoTitle of the Promo Card.
Headlinefield_prgf_headlineYesHeadline of the Promo Card.
Descriptionfield_prgf_descriptionNoWYSIWYG field without summary.
Linkfield_prgf_linkNoLink field that should store internal and external links.

37 - Schedule search form

This is dynamic paragraph that renders the session instances filters for [Schedule search list](Schedule search list.md).

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

38 - Schedule search list

This is dynamic paragraph that renders the session instances, based on url parameters, and or filters from [Schedule search form](Schedule search form.md).

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

Fields

NameMachine nameRequiredDescription
Blockfield_prgf_blockYesBlock reference to the view/block. Should have default value and should be hidden in form display.

Use cases

Use case 1: Schedule search list paragraph on a page WITHOUT location popup paragraph 1.1 Preferred branch is selected and no location in URL

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

1.2 Preferred branch is empty and no location in URL

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

1.3 Location in specified URL

  • When I open Schedule search list page WITHOUT location popup on page
  • And I have location=% in the URL
  • We skip cookie whether is empty or exist
  • Filter by location should show branch from URL
  • Results should be filtered

Use case 2: Schedule search list paragraph on a page WITH location popup 2.1 Preferred branch is selected and no location in URL

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

2.2 Preferred branch is empty and no location in URL

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

2.3 Location in specified URL

  • When I open Schedule search list page WITH location popup on page
  • And I have location=% in the URL
  • We skip cookie whether is empty or exist
  • Location popup shouldn’t be shown
  • Filter by location should show branch from URL
  • Results should be filtered

39 - Secondary Description and Sidebar

This is a Paragraph type that will be used for the paragraphs with left (secondary description) and right (sidebar) blocks.

Fields

NameMachine nameRequiredDescription
Left Columnfield_prgf_left_column_blockNoBlock reference to: Basic Block, Code Block, Date block or Simple Block. Create a new one or pick up an existed block.
Right Columnfield_prgf_right_column_blockNoBlock reference to: Basic Block, Code Block, Date block or Simple Block. Create a new one or pick up an existed block.

40 - Session Time

This is a paragraph type that will be used for field_session_time the in Session CT.

Fields

NameMachine nameRequiredDescription
Date & Timefield_session_time_dateNoThis will use Drupal date/time fields & should be a single date field with ’end date’ and ’end time’ option enabled.
Daysfield_session_time_daysNoCheckboxes with following values: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday

41 - Simple Content

Simple Content is used for adding text to the pages.

Fields

NameMachine nameRequiredDescription
Contentfield_prgf_descriptionYesWYSIWYG field without summary.

42 - Small Banner

This is a paragraph type that will be used for the banner content.

Fields

NameMachine nameRequiredDescriptionNotes
Colorfield_prgf_colorYesReference field for choosing the term from “Color” vocabulary.
Headlinefield_prgf_headlineYesHeadline of the Small banner.Plain text, 255 characters
Imagefield_prgf_imageNoEntityreference to media image. Single value.
Descriptionfield_prgf_descriptionNoWYSIWYG field without summary.

43 - Social Post Listing

This is dynamic paragraph that renders the latest social posts that were imported from social networks.

Fields

NameMachine nameRequiredDescription
Titlefield_prgrf_sl_titleNoTitle for block with social posts.
Descriptionfield_prgrf_sl_descriptionNoDescription for block with social posts.
Social Listfield_prgrf_sl_blockNoReference to views block which select posts and show them as masorny grid.

44 - Social Share Icons

This is a paragraph type that will be used for the add social media share. See more How to configure AddThis

Fields

NameMachine nameRequiredDescriptionNotes

45 - Story Card

This is a Paragraph type that will be used for the Story Cards.

Fields

NameMachine nameRequiredDescription
Titlefield_prgf_titleNoTitle of the Story Card.
Headlinefield_prgf_headlineYesHeadline of the Story Card.
Linkfield_prgf_linkNoLink field that should store internal and external links.

46 - Teaser

This is a paragraph type that will be used for the teaser content.

Fields

NameMachine nameRequiredDescription
Titlefield_prgf_titleNoTitle of the Teaser.
Imagefield_prgf_imageNoEntityreference to media image. Single value.
Descriptionfield_prgf_descriptionNoWYSIWYG field without summary.
Linkfield_prgf_linkNoLink field that should store internal and external links.

47 - Webform

This is a paragraph type that will be used for the embedding webforms.

Fields

NameMachine nameRequiredDescription
Embedded Webformfield_prgf_webformNoEmbedded webform entityreference (select). Single value.
Default webform submission data (YAML)field_prgf_webform_default_dataNoYAML code for passing in default values to webform.
Webform statusfield_prgf_webform_statusNoStatus of webform on render. Radio with 2 options, open or closed (Closed prevents further submissions).