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

Return to the regular view of this page.

Page/Content Types

YMCA Website Services features many different kinds of pages, or content types. Choosing the right content type will ensure your collect the right information and allow you the flexibility to create layouts.

There are two different kinds of Content Types in the distribution:

  • “Standalone types” are content that is displayed directly to users, like Landing Pages and Branches. They may also be displayed in views or other groupings.
  • “Helper types” are content that is never displayed on its own to users. It is displayed in aggregate or as part of a supporting application like Activity Finder or Membership Calculator.

Standalone Content Types

These content types are built for Layout Builder or are Layout Builder-compatible when the supporting module is enabled:

These content types use the legacy Paragraphs page builder:

Helper Content Types

These content types help are not displayed on their own, but are used in supporting applications:

1 - Article (Layout Builder)

The Article content type combines all news-related content into a single content type.

This gives content editors the ability to vary the layout and views display depending on the type of article created (news item, blog post, or press release). This way, if an association wants to display news items on a news page, and blog posts on a blog page, they can differentiate based on where they would like the article to display on the site.

Article also allows content editors to include Layout Builder components within the page.

Designs: Mobile | Desktop

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden;">
  <iframe allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen="allowfullscreen" loading="eager" referrerpolicy="strict-origin-when-cross-origin" src="https://www.youtube.com/embed/FBtQmfy9C7Q?autoplay=0&amp;controls=1&amp;end=0&amp;loop=0&amp;mute=0&amp;start=0" style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border:0;" title="YouTube video"></iframe>
</div>

Creating an Article

Go to Admin > Content > Add Content > Article (Layout Builder)

Fill in the content fields:

  • Title (required)
  • Subtitle
  • Type: Select “Blog”, “News”, or “Press Release”. Each type has the same fields, but allows admins to group articles for display on different pages (i.e. Blog types will display on a Blog page, Press Releases on a Press Release page, etc.)
  • Header image: This image is displayed on the Article page and in listing views.
  • Tags: References terms in the Tags vocabulary. See Taxonomy for more information on tags.
  • Body (required): Add text with the WYSIWYG editor
  • Locations: If the Article relates to a Branch then select it here so that the Article shows in listings on the Branch page.
  • Published Date (required): Defaults to today. This is the date that will be displayed on the Article page, used for sorting, and in listings.

Customizing Articles

Once you create an Article you can customize the layout with Layout Builder. These components are built specifically to work with the Article content type:

2 - Event (Layout Builder)

Updated Event content type that allows for Layout Builder components to be included within an event page.

Designs:

Creating an Event

Go to Admin > Content > Add Content > Event (Layout Builder)

Fill in the content fields:

  • Title (required)
  • Subtitle
  • Location info: Select the event location either by choosing from your list of locations or adding the address manually. You must either fill out the Event location OR Address fields.
    • Event Location: A list of Branch, Camp, and Facilities. Select any number of these.
    • Address: If your event does not happen at an existing location, you can add the address directly. Any content in this field will cause the Event Location to be overridden. To clear out the field, reset Country to “- None -”.
    • Directions: By default, a link with directions is auto-generated using the address field of either the Event Location or Address. Use this field to substitute your own directions link.
  • Event Date(s): Add a start and end date and time for the event. If the event does not have an end time, choose the start time for both the start and end.
    • As of March 2023, this field supports recurring events.
    • To create a recurring event:
      • set the Repeats option,
      • choose the Number of recurrences and when to End, then
      • expand the Advanced options to select specific days.
        The event recurrence configuration.
    • Once you save the event, Manage Instance will allow you to customize or remove individual instances.
    • To select multiple dates for your event that do not fit a regular rule, use Add another item below the date selector.
  • Header image: This image is displayed on the Article page and in listing views.
  • Tags: References terms in the Tags vocabulary. See Taxonomy for more information on tags.
  • Body (required): Add text with the WYSIWYG editor
  • Locations: If the event relates to a Branch then select it here so that the event shows in listings on the Branch page.

Customizing Events

Once you create an Event you can customize the layout with Layout Builder. These components are built specifically to work with the Event content type:

3 - Activity, Class, and Session

Format data from third parties (e.g. Daxko, Personify, or ActiveNet), for display in Activity Finder.

Content editors rarely, if ever, enter information directly into these content types on a day-to-day basis. However, it is important to know how they work and how they relate to manually-entered content.

Example - Swim Lessons

  • Swimming and Aquatics (Program Page, manually entered)
  • Swim Lessons (Program Subcategory Page, manually entered)
  • Youth Group Swim Lessons (Activity, mapped from CRM or custom automation)
  • Stage 3 (Class, mapped from CRM)
  • Monday/Wednesday/Friday 9:30-10 a.m. at Franklin Family YMCA (Session, mapped from CRM)

Note: This is an example only. Depending on your CRM and any customizations you make, your setup for Swim Lessons or any program may look different that the example listed above.

Activity

Often used as the top-level filter in Activity Finder and Repeat Schedules, Activity consists of three fields:

  • Title: The name of the Activity (and the filter in Activity Finder).
  • Program subcategory: An entity reference to or tag for a Program Subcategory. Maps the Activity to higher-levels of user-entered content. *Description: A description for the Activity. Usually pulled from a description in a CRM through an API.

Class

A narrower selection of Program Offerings. Not an individual instance, but a smaller selection of instances.

Classes have three ields that map into Activity Finder and Repeat Schedules: a description, a title and entity reference/tag to an Activity.

Class also contains Areas for content editors to add paragraphs; however, depending on how your CRM and the number of programs your Y runs, it may not be practical use these fields.

Session

An individual program offering. Contains fields for pricing, session date/time, instructor, ages and a registration link. This are the individual rows/instances in Repeat Schedules and Activity Finder.

4 - Alert

Displays timely information in a thin banner across your site, just below the header or above the footer.

An alert

Unlike most content types in YMCA Website Services, you don’t use Alert to create pages. Instead, Alerts display as a rendered entity or a section of content on other pages.

Alerts also don’t use Paragraphs or Layout Builder. By design, the layout of Alerts are rigid; however, the text editor and the color options listed below allow content editors some flexibility.

When Should You Use an Alert?

  • Timely updates for centers, such as when your hours change or facilities close.
  • Marketing promotions, such as for membership campaigns or even promotions.

How to Use an Alert

Go to Admin > Content > Add Content > Alert (/node/add/alert).

  • Title: Displays as the headline for your alert.
  • Description: The main body of your alert. Sentences should be short and minimally styled in this section. Uses the Text Editor.
  • Alert Style: Choose from the Classic Alert style which enables the Color Fields below or a set of styles that are pre-configured for you to match the YMCA colorways.
    • Urgent options use a colored background with dark or light text.
    • Info options use a grey background with colored text.
      Screenshot depicting 8 different style options.
  • Color Fields: These three dropdown fields control different aspects of color in your alert. All three dropdowns reference the color vocabulary.
    • Background Color: The color of your alert.
    • Text Color: Stick to using either black or white for accessibility.
    • Icon Color: Changes the appearance of the icon to the left of the title.
  • Link: Adds a button with a call to action to the alert on the right. The button color defaults to black.
  • Placement: Choose “Header” to show your alert above your main content or “Footer” to show below your main content.

The alert admin fields

Setting visibility

  • Visibility pages: This is where you control where the alert displays on your site. In the large text field, you write the relative path of the pages where you want this to appear or not appear. Enter each path on a new line. Each path should start with a slash, /.

    You also have the option to use an asterisk character * as a wildcard so you don’t have to enter a large number of relative paths. For example, if you wanted to add an alert to a /health-and-fitness section, you would enter /health-and-fitness* in the text area.

    The alert visibility dialog

    What is a relative path? A relative path is the part of your URL after your domain name.

    At https://example.com/community, for example, the domain name is example.com, while the relative path is /community.

    Using the Alert visibility state radio buttons at the bottom, you can either show or hide your alert from the page paths listed in the text area above.

  • Location: This field provides additional flexibility for controlling where the Alert will display. Selecting a Location from this field will display the alert on the Location page and any related page (blog posts, news, landing pages) that has the corresponding Location selected.

Rearranging alerts

Alerts can be rearranged to control the order in which they display if multiple appear on a page. The Alerts Rearrange page can be accessed via its link on the Content page or at Admin > Content > Alerts Rearrange (/admin/content/alerts-rearrange). The link might not appear in the Admin menu prior to version 10.3.1.

A screenshot of the Rearrange Alerts display with labels corresponding to the below steps

To rearrange alerts:

  • Go to the Alerts Rearrange page
  • Rearrange alerts with the drag handle () or the “Show row weights” option.
  • Save order when finished.

Alert visibility examples

Figuring out exactly how to show an alert on the right pages can be a challenge. The Visibility pages, Alert visibility state, and Location selectors work together to control where an alert is displayed. Here are some tips on how to get just what you want.

To show an alert only on a single Location page:

  • Visibility pages: add the path to the Location, like /locations/downtown-ymca
  • Alert visibility state: “Show for the listed pages”
  • Location: “None”

To show an alert on a location and any related pages:

  • Visibility pages:
  • Alert visibility state:
  • Location: select the Location, or select more than one using Shift or Command/Ctrl.

“Related pages” in this case means any page with a specific location selected in its Location field.

On groups of pages

The wildcard * can be used to specify any page in a section of the site.

To show an alert on every page on the site:

  • Visibility pages: *
  • Alert visibility state: “Show for the listed pages”
  • Location: “None”

To show an alert on every swimming page:

  • Visibility pages: /programs/swimming*
  • Alert visibility state: “Show for the listed pages”
  • Location: “None”

The position of the * wildcard is important. Consider /programs/swimming* versus /programs/swimming/*:

Show for /programs/swimming*:

  • /programs/swimming
  • /programs/swimming/drop-in
  • /programs/swimming/swim-lessons

Show for /programs/swimming/*:

  • /programs/swimming
  • /programs/swimming/drop-in
  • /programs/swimming/swim-lessons

On the home page

You can use / OR <front> to show an alert on the home page. <front> is a special token and should always be listed on its own line.

  • Visibility pages: / OR <front>
  • Alert visibility state: “Show for the listed pages”
  • Location: “None”

With exceptions

Sometimes you want to show an alert on all pages except a few. Maybe you have an alert for a fundraising campaign but don’t want to show it on the “Join” or the “Give” page. The Hide for the listed pages option can help in this case.

To show an alert on all pages except “Join” and “Give”:

  • Visibility pages:
    /join
    /give
    
  • Alert visibility state: “Hide for the listed pages”
  • Location: “None”

5 - Blog Post

Timely content, articles and news pieces tagged with one or more physical locations.

Note: This Content Type is similar to the News Post content type.

An example of a blog post page

Blog posts in YMCA Website Services allow you the flexibility to both create simple posts using only the text editor and more robust layouts with paragraphs.

When Should I Use a Blog Post?

When you decide to use a blog post depends greatly on your Association’s content strategy. However, blog posts are designed so you can post timely pages and list them throughout your site. Examples of blogs may include:

  • Member Stories
  • Workouts and Recipes
  • Updates about a Center/Branch
  • Promotions and Contests
  • Press Releases

How Do I Use a Blog Post?

There are three fields that appear above the accordion tabs below:

  • Title: The name of the blog. Displays in the header area on your blog post and in the cards that display in a list of blogs.

  • Locations: An option select for you to tag a post with one or more locations (Camp or Branch). Use Ctrl+Click (Windows) or Cmd⌘+Click (Mac) to select multiple locations.

Each time you create a new Branch Page or Camp Page it populates into the locations field automatically

  • Category: An entity reference to the Blog Category vocabulary. Type in the name of the category and select from the options that appear, or create a new category/term by typing in a new one.

Selecting a category in the blog post admin

Style

This dropdown changes the style of the post’s card when it appears in a listing format. This dropdown does not affect any layouts on the page.

The blog post style dropdown

Story Card

CarnationLily
A blog story card in Carnation
A blog story card in Lily

Photo Card

CarnationLily
A blog photo card in Carnation
A blog photo card in Lily

News Card

A blog news card in Carnation

Color Card

When choosing color card, you are presented with two styling options in dropdowns. Both are entity references to the Color vocabulary:

  • Background color: Changes the color of the card.
  • Text color: Changes the color of the text. It’s recommended you only use white or black.
CarnationLily
A blog color card in Carnation
A blog color card in Lily

Content Area

The content area is the main body of your page. You can use the default fields entered below for a simple block post or build a more robust layout using paragraphs.

The sidebar area also allows you embed paragraphs below a section that links to the centers tagged in the post, the categories and a Related Content field that allows you to promote other Blog Posts by tagging them with the autocomplete widget.

Layouts

While you have the option to build layouts in blog posts using paragraphs, all blog posts are strictly two-column layouts. The Content Area displays on the left while the Sidebar Area displays on the right.

6 - Branch

One of the first places members go when they visit a Y website is to their local Y’s page.

Branch pages contain multiple data fields that work together to help members find the right location, hours, and amenities that fit their needs.

Designs:

Creating a Branch

Go to Admin > Content > Add Content > Branch

Fill in the content fields:

General Info

  • Title (required): This is the name of your branch which will display as your page title and the title on the location card. If your branch has a longer formal name we recommend using the shorter, more common name for readability.
  • Neighborhood: An optional reference to specify which neighborhood your Y is located in. Start typing and select from the list. To add a new neighborhood, add it to the “Area” vocabulary under Structure > Taxonomy (see Taxonomy).
  • Coming Soon: This flag indicates a newly opening branch on the Locations page.
    Screenshot of a page showing “Downtown YMCA” with a “Coming Soon” flag.
  • Temporary URL: Overrides the “Branch info” link on the Locations page, allowing you to link to a different internal or external page.

Contact Info

  • Address: The physical address of your location. Be sure to include all address fields.

  • Branch Coordinates (required): This field pins your branch on the locations map.

    To get your branch's coordinates:

    ( with Google Maps)

    • Search for your Y location
    • Right-click the location on the map.
      Screenshot of Google Maps showing the right-click menu with the latitude/longitude item selected.
    • To copy the coordinates, left-click on the latitude and longitude.
    • Paste the lat, long into one of the fields, then cut and paste to separate them.
      Screenshot of the Drupal Branch admin screen with the latitude and longitude separated into different fields.
  • Phone (required): The main phone line for your branch. Will be displayed as it is entered and linked to allow mobile users to tap to call.
  • Fax: Optional.
  • Email: We recommend you use a main contact email, such as info@example.com, rather than the email for an individual staff member.
  • Directions: By default, a link with directions is auto-generated using the Address field. Use this field to substitute your own directions link.

Branch Hours

Add the main hours for your facility. These are displayed in the header and on the Locations page.

  • Custom hours label: The title that is displayed in the “All hours” dropdown. Clearing this field will hide the section from the Branch page.
  • Mon, Tue, …: Add the hours for each day of the current week.
    • Most formatting like <open time> <separator> <end time> should work, but we recommend something like 7am-5pm
    • Leaving a day empty will show the hours as “Closed” but you can enter any other text as well, like “Wednesday: ‘Temporarily closed’”
  • Branch Holiday Hours: Add special hours for any upcoming holidays. These will be displayed on the site when the holiday is less than two weeks away. Add as many holiday entries as you like.
    • Holiday Title: The displayed title of the holiday.
    • Holiday Hours: The displayed hours for the holiday.
    • Date: The date of the holiday. When this day is in the current week …
  • More Hours Link: A link to show additional location hours information, like another page or a PDF.

Screenshot of the Branch Hours popup in the Branch Header

Header Area

This section is not displayed when “Use Layout Builder” is selected.

There is no image field for the Branch content type, so you will need to add one of the following paragraphs to add an image and title at the top of your page:

Content Area

This section is not displayed when “Use Layout Builder” is selected.

The Branch Content Type only has one layout option—one column—and no description field. Paragraphs will form the body of the page.

The following paragraph types integrate directly with Branch pages:

Bottom Area

This section is not displayed when “Use Layout Builder” is selected.

Use the bottom area for anchoring elements on your page. The following paragraphs are great for this area:

Branch Amenities

  • Branch Amenities
  • Closed Amenities

Type in and select which amenities are available or not available at your branch using the autocomplete field.

Screenshot showing the Branch amenities field with autocomplete dropdown.

If you embed a Branch Amenities with the Icons paragraph or Branch Amenities block on your page, the amenities will be displayed in your content. The Amenities will also serve as filters for branches on your locations page.

Screenshot showing the branch amenities block with open emenities and closed amenities labeled.

If you don’t see an option available or would like to rename a branch amenity, go to Structure > Taxonomy > Amenities. See Taxonomy for more info.

The Branch Menu is a single-level sub-menu that displays within a branch page (and sub-pages) that allows users to drill down to additional content specific to that branch. The Branch Menu always shows “Branch Home” as its first link.

  • Menu links: A list of menu links to be displayed in the menu. Allows unlimited items but we recommend a maximum of 6-8 depending on the Link text length.

Screenshot of the branch menu block.

Customizing with Layout Builder

Beginning in Website Services 9.2.13 content editors have the option of customizing the Branch page with 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. If the checkbox does not appear, ensure the Y Branch (y_branch) module is installed at Admin > Extend (/admin/modules).

Layout Builder Blocks

Branch pages have several specialized components that utilize the structured data (fields) that already exist on your branch page in newly designed Layout Builder Blocks.

In addition to using many of the standard Layout Builder components, Branch pages also use several components that display the fields described above.

These blocks are available via All system blocks in Layout Builder:

  • Branch Hours: Combines the branch title, contact information, hours, and more into a dynamic page header.
  • Branch Amenities: Displays open and closed amenities in an easy-to-read grid.
  • Branch Menu: Displays the Branch Menu links.
    • Designs:
    • Can be placed on a Landing Page to show the Branch Menu for a specific branch. Choose a branch in the Location field. This can be useful if you are creating sub-pages for a branch.
      • Added in the December 2024 release.

One additional component is available that requires additional information:

Designs:

This component allows you to place up to 6 social media links on a branch page.

  • Add the Branch Social Links block to the pre-configured Social links section of your page using the standard process.
  • Add up to 6 links in the Links field. Icons for each social media platform will be populated automatically.
    • Currently supported platforms include Facebook, Instagram, Linkedin, Twitter, and YouTube. Request a new platform if you need.
  • After adding or updating the block, be sure to save and publish your branch.

Home Branch Selector

This feature allows users to select a single branch location as their home / preferred branch so that they can easily access branch-specific content across the site.

A screenshot of the Home Branch selector with a label and a n arrow pointing to a downward-pointing chevron with the label “Link to bring back the popup”

The Home Branch selector popup will appear to users who arrive at the site and:

  • are new to the site,
  • have not selected a Home Branch, and
  • have not checked the “Do not ask me again” checkbox in the modal.

Users can select a Home Branch by:

  • choosing a branch from the modal popup,
  • using the “Set Preferred Branch” link in the Utility menu,
  • choosing “My preferred branch” on a Branch page or in Location Finder.

Users can remove a Home Branch by:

  • summoning the popup with the down arrow next to the set branch in the Utility menu, or
  • unchecking “My preferred branch” on a Branch page or in Location Finder.

Selecting a home branch will:

  • add a link to the Branch’s home page to the user’s utility menu,
  • show the Branch as the Home Branch on Branch Pages and Location Finder, and
  • populate the Branch options in other sections of the site like the Membership Apps and Schedules (coming soon).

Disabling the Home Branch Selector

If you want to completely remove the Home Branch selector from your site you will need to disable it via the command line. DO NOT disable the module via the admin UI as this will result in an error.

drush pmu ws_home_branch openy_home_branch

Migrating to Layout Builder

Migrating Branches to Layout Builder involves recreating some content on the page. The process is similar to building a new Landing Page with Layout Builder but with a lot of the work done for you!

Once you are ready to migrate a Branch:

  1. Either clone the page or open it in a separate tab so that it’s easier to compare content.
  2. Prepare the Branch for Layout Builder:
  • Edit the Branch,
  • Add links in the Menu section if you’d like,
  • click Use Layout Builder,
  • if you’d like, uncheck Published while you migrate to hide the page temporarily, then
  • Save.
    Screenshot of the Branch edit screen.
  1. Your Branch will now display a set of default blocks: Hours (and header), Menu, Social Links, and Amenities.
  2. From here, you can use Layout Builder to move your old content from Paragraphs into Blocks. Review the full list of designs or the list of components if you need help deciding how to place things. Your old content will still be available to reference in the Edit tab in the old Header/Content/Footer sections.
  3. When you’re finished, Save the layout and Publish the Branch!

7 - Camp

Physical locations where outdoor camp programming takes place.

While YMCA Branches may offer some form of summer day camp, they differ from facilities that primarily host programs related to outdoor camps. The Camp content type also enables editors to create sub-sites or “microsites” using a separate menu structure.

Designs:

When Should I Use Camp?

If you are an independent YMCA camp or you’re an Association with one or more locations dedicated to outdoor camp, the Camp Content Type serves well as a landing page for those locations.

What about Branch Day Camps?

There are several considerations for Branches that host Day Camps in the center:

  • The Branch content type is intended to be the home page for branches.

  • Adding a Branch listing and a Camp listing for the same physical location creates duplicate listings for your center and could have search implications.

  • Camp pages don’t have fields for operating hours or amenities.

  • Branch Day Camps, unlike outdoor camps, tend to be listed in the same CRM as other branch-based programs, and therefore could integrate into Activity Finder, provided the CRM’s compatibility.


Recommended Content Types for Branch Day Camps

Creating a Camp

General Info

  • Title (required): This is the name of your branch, which will display as your page title and the title in the location card.
    • There is no separate field for the full name of your facility (e.g., Joe C. Davis YMCA Outdoor Center) versus the common name (Camp Widjiwagan). The best practice would be to use the shorter, more common name for readability.
  • Menu Links (required): Add in the URL or name of the content you want to link your Camp Menu to (you must use the Camp Menu paragraph for this to work). This field is not used with Layout Builder.
    The camp menu links field
    Read more about Camp Menu ⇒

Contact Info

  • Address (required): The physical address of your location. Be sure to include all address fields.
  • Camp coordinates (required): This field pins your camp on the locations map.
    • See Branch for details on how to find your camp coordinates.
  • Phone (required): The main phone line for your branch. Will be displayed as it is entered and linked to allow mobile users to tap to call.
  • Fax: Optional.
  • Email: We recommend you use a main contact email, such as info@example.com, rather than the email for an individual staff member.
  • Directions: By default, a link with directions is auto-generated using the Address field. Use this field to substitute your own directions link.

Header Area

There is no image field for the Camp content type, so you will need to add one of the following paragraphs to add an image and title at the top of your page:

Below your header image, add in a Camp Menu paragraph for a secondary, full-width navigation.

Content Area

The Camp Content Type only has one layout option—one column—and no description field. Add in almost any paragraph you want into the body of you page.

The following paragraph types integrate directly with Camp:

Bottom Area

Use the bottom area for anchoring elements on your page. The following paragraphs are great for this area:

Customizing with Layout Builder

Beginning in Website Services 9.3, content editors have the option of customizing the Camp page with 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. If the checkbox does not appear, ensure the Y Camp (y_camp) module is installed at Admin > Extend (/admin/modules).

Camp Menus

The Camp page is often used as a landing page for a microsite with additional information - schedules, packing lists, and other camp-specific pages.

We have two camp-specific menus that help build this structure.

  • Camp Menus allow you to provide a two-level menu in the header of each Camp page and subpage.
    A screenshot of the Camp Menu design
  • Camp Quick Links provide a single-level utility menu for additional camp information.
    A screenshot of the Camp Quick Links design

After setting Use Layout Builder for your Camp page, navigate to the Layout tab. You need to configure the Camp Quick Links in two blocks in order for them to properly display on desktop and tablet/mobile.

Configure the first block
  • In the Configure Camp Header section, you will see placeholders for each of the menu blocks that say Please select the menu to display in this Camp Quick Links block.
    The camp page admin with menu placeholders
  • Using the on the first Camp Quick Links block, click Configure.
    The camp menu block edit menu.
  • In this menu, you can create a new menu or add an existing one that you’ve made in the Menus administration (/admin/structure/menu). To create a new menu, fill in these fields:
    • Title (required) - the title of the Quick Links menu to be displayed in the Utility Navigation.
    • Display title - must be checked in order for the Quick links to display properly.
    • Click Add new menu, then set up the new menu:
      • Menu Title (required) - the administrative name of the menu. Like Camp Coleman Quick Links.
      • Menu Name (required) - the machine name of the menu, using only lowercase letters, numbers, and hyphens. Like camp-coleman-quick-links.
      • Administrative summary - is optional and only used in the menu admin.
        The camp quick links fields admin
    • Click Create menu, then click Edit links to add items to the menu.
    • In the Edit links popup you can add and reorder links in the menu.
      The “Edit links” dialog in the Camp admin
      The “Add new link” dialog"
      • For each new link:
        • Click Add new link
        • Menu link title is the text displayed.
        • Link is the internal page or external url that the link points to.
        • Enabled allows you to temporarily hide a menu item.
        • Show as expanded should be checked for any parent items. There is no harm in always checking this.
        • Other fields can be ignored.
        • Save when you are finished.
      • Use the drag handles to rearrange or nest menu items.
        • Note: Parent items must have Show as expanded checked in order to display child items.
    • When you are finished adding and rearranging menu links, Save.
  • Finally, save all the changes with Update.
Configure the second block
  • Find the second place that says Please select the menu to display in this Camp Quick Links block in the Header Section.
  • Using the on this block, click Configure.
  • As before, configure the block:
    • Add the same Title as the first block.
    • Ensure Display title is checked.
    • Click Add existing menu then start typing the name of the menu you created in the previous block and select it in the autocomplete dropdown.
      A screenshot displaying the above steps.
    • Click Add menu to save the selection.
  • Once the existing menu has been added, you will see the Edit, Remove, and Edit Links options. Once you see those, you can Update to save these changes.
    A screenshot showing the completed “Add existing menu” dialog

Once you have completed the process you will see your Quick Links menu displayed in two sections of the Header. This will ensure that the menu is displayed properly across all displays.

camp–quick-links-success.png

Camp Menu

  • Find the final placeholder that says ... Camp Menu ...
  • Configure the block.
  • Create a new menu or choose an existing one using the steps above.
  • Update, then Save Layout at the top of the page.
  • Now your Camp page is populated with all of its menus!

A screenshot showing the expanded Camp Quick Links menu and Camp Menu

Camp Landing Pages

The Camp Subpage (formerly “Camp Landing Page”) content type allows you to create internal pages for your camp section or microsite. Once you’ve created the parent Camp page, you are ready to creat additional Camp Subpage pages.

  • Go to Content > Add Content > Camp Subpage
  • Set the Title
  • In the Camp field, begin typing the name of the Camp page that will be the parent page, then select the item from the autocomplete dropdown.
    The Camp Subpage admin fields
  • Click Save and edit layout.
  • You will now see the Layout Builder editor with the menus from your Camp page pre-populated in the layout.
    The Camp Subpage layout builder interface
  • Add additional content using Layout Builder, then click Save layout

Note: The menu references on Camp Subpages are copied to the header when the page is created. Any updates to those menus (new items, reordering) will be reflected on all subpages, but later changes to the blocks (removing the menu altogether, changing the linked menu) will need to be made on both Camp and Camp Landing Page pages separately.

Camp Subpage are not automatically added to the Camp Menu of their corresponding Camp. Be sure to add the newly created Camp Subpage to the Camp Menu so that it’s properly linked.

Layout Builder Blocks

Camp pages have a number of specialized components that utilize the structured data (fields) that already exist on your branch page in newly designed Layout Builder Blocks.

In addition to using many of the standard Layout Builder components, Camp pages also use a number of components that display fields described above.

Camp Info Block

The Camp Info Block is automatically added to the Body section of each Camp page. It displays content from the Contact Info section. It can be rearranged on the page but is not otherwise configurable.

Camp Header Layout

When you create a new Camp page or switch an existing one to use Layout Builder, it will come with a pre-set Camp Header Section, which enables the configuration steps above. If you find some of those blocks are missing, you can restore them manually.

To completely start over, use the x to the left of Configure Camp Header to delete the section. Add a new Section and choose the WS Camp Header layout. Then, add the following blocks by selecting Add block in the corresponding region.

A screenshot of the Camp Header Layout Builder configuration with labels for the Utility menu at the top and the Main Menu in the center

The default configuration for a the Camp Header block should be:

  • Utility Menu
    • Left
      • All system blocks > Camp blocks > Camp Back Link
    • Right
      • Create custom block > Camp Quick Links
      • All system blocks > OpenY > Open Y Google Translate (optional)
  • Main Menu
    • Left
      • All system blocks > Common blocks > Site Logo Block
    • Right
      • Create custom block > Camp menu
      • Create custom block > Camp quick links

8 - Facility

Locations that house YMCA programming outside of a Branch.

The Facility content type is used for locations where programming might take place that are not a full YMCA Branch. This might be a childcare facility, a shared-use space, or an office.

Designs:

Facilities share their design with the Branch content type.

Creating a Facility

General info

  • Title (required): This is the name of your branch, which will display as your page title and the title in the location card.
  • Neighborhood: If it is used, select an item from the Neighborhood Taxonomy.
  • Type: Choose from a predefined list of types.
    A screenshot listing the preset Type options
  • Facility Branch - Using autocomplete, select the Branch that this facility is associated with.

Contact Info

  • Address: The physical address of your location. Be sure to include all address fields.
    • If you do not set an address (or clear the address by resetting Country to “- None -”) then the facility will display the address of its associated Branch. (Added in version 10.3.1, December 2023.)
  • Facility coordinates (required): This field pins your facility on the locations map.
    • See Branch for details on how to find your facility coordinates.
  • Phone (required): The main phone line for your facility. Will be displayed as it is entered and linked to allow mobile users to tap to call.
  • Fax: Optional.
  • Email: We recommend you use a main contact email, such as info@example.com, rather than the email for an individual staff member.
  • Directions: By default, a link with directions is auto-generated using the Address field. Use this field to substitute your own directions link.
  • Facility Hours: Set the hours for the Facility. (Added in version 10.3.1, December 2023.)
    • This field follows the same rules as Address - if it is empty, the associated Branch hours will be displayed.
    • See Branch Hours for details on how to set the Facility Hours.

For aside pieces of content, such as side navigations, promotional cards and content related to the main part of your page.

Content

These sections are not displayed when “Use Layout Builder” is selected.

Use Paragraphs to add content to your Facility page.

  • Sidebar Area
  • Content Area

Customizing with Layout Builder

Beginning in Website Services 10.3.0 content editors have the option of customizing the Facility page with 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. 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.

9 - Landing Page

Flexible content types that use regions and paragraphs to build content.

Fields in Landing Page

Title (Required)

This is what you will see in your admin portal as your content’s name. it will also show as the page title in the Header unless you add a paragraph in the Header Area.

Layout (Required)

Landing Pages come with four basic layouts for desktop. For mobile, all layouts display in a single column, with the Sidebar Area stacking below the Content Area.

One Column Layout

The one column landing page layout

One Column (Full Width)

The one column (full width) landing page layout

Two Columns

The two column landing page layout

Two Columns (Fixed Sidebar)

The two column (fixed sidebar) landing page layout

Paragraph Areas

You can use any number of Paragraphs in these fields.

  • Header Area: Used for inserting banners, small banners and galleries. Date blocks are also great in this area for scheduled content.
  • Content Area: The main body of your content.
  • Sidebar Area (Two Column Layouts Only): For aside pieces of content, such as side navigations, promotional cards and content related to the main part of your page.
  • Bottom Area: Add an anchoring element to your page, such as a promotional banner or webform.

10 - Landing Page (Layout Builder)

A flexible content type that uses Sections and Blocks, managed with Layout Builder, to build content.

This page is the base for building pages with Layout Builder.

Creating a Landing Page

Go to Admin > Content > Add Content > Landing Page (Layout Builder)

Fill in the content fields:

  • Title (required): The title of the page. It will not be added to the page and should be added manually with a block in the Banner section.
  • Metadata: This content is used to provide context to search engines and page previews. For the best user experience create clickable titles, write a compelling description, and add a descriptive image.
    • Meta description: A brief and concise summary of the page’s content that is a maximum of 160 characters in length.
    • Meta image: Choose or upload an image to be used as a thumbnail for social sharing and preview cards.
    • Meta tags: Advanced meta tag configuration. This section should not be edited unless you know what you’re doing.

Customizing a Landing Page

Once you create a Landing Page you can customize it with Layout Builder.

Landing Pages come with these pre-configured sections:

  • Header
  • Banner: An edge-to-edge, no gutters section that works best with a single Banner or Carousel.
  • Body: A section with left and right margins. This can contain the bulk of your page content.
  • Footer

Sections can be edited, reordered, or removed to configure your page as you like. You can even remove the header and footer altogether if you need to create content for a digital display or other embedded system.

11 - Membership Content Type

Membership items are the building blocks of the Membership Calculator and are only displayed within the Membership Calculator Paragraph.

See Membership Calculator.


Membership Fields

General Information

  • Title: The title of the membership type to be displayed on the first step of the Membership Calculator.
  • Description: A short description to be displayed on the first step of the Membership Calculator.
  • Image: A reusable image field to be displayed on the first step of the Membership Calculator.

A screenshot with the Membership content title, image, and description.

Membership Info

The Membership Info Paragraph lists detailed membership information per location. Add one “Membership Info” section for each location that your membership applies to. If a location does not offer a membership type, you can leave it out.

  • Location: A reference to an already-existing Branch. If the branch does not exist, you’ll need to create it first.
  • Link:
    • URL: The link a member should be taken to to sign up for this membership at this location. See below for tips on finding this URL.
    • Link Text: This field is not used.
  • Join Fee: Dollar value for how much someone has to pay to join.
  • Monthly Rate: Dollar value for the monthly fee of the membership.

A screenshot labeling the membership info section fields.

Every membership management system will have different ways of linking in for members to complete their registration. Here are a few we know about. If you have tips for a MMS not listed here, feel free to leave them in the comments.

Daxko Operations

Navigate to: Membership > Membership Types > Edit > Online Settings. This provides the deep link to the specific membership types.

A screenshot showing the General Information screen of Daxko Operations

12 - News Post

Designed for timely content, articles and news pieces tagged with one or more physical locations.

Note: This Content Type is similar to the Blog Post content type.

An example news post page

News posts in YMCA Website Services allow you the flexibility to both create simple posts using only the text editor and more robust layouts with paragraphs.

When Should I Use a News Post?

When you decide to use a news post depends greatly on your Association’s content strategy. However, news posts are designed so you can post timely pages and list them throughout your site. Examples of news posts may include:

  • Member Stories
  • Workouts and Recipes
  • Updates about a Center/Branch
  • Promotions and Contests
  • Press Releases

How Do I Use a News Post?

The news posts category field

There are three fields that appear above the accordion tabs below:

  • Title: The name of the news post. Displays in the header area on your news post and in a list view of news posts.

  • Locations: An option select for you to tag a post with one or more locations (Camp or Branch). Use Ctrl+Click (Windows) or Cmd⌘+Click (Mac) to select multiple locations.

    Each time you create a new Branch Page or Camp Page, that location’s name populates into the locations field automatically

  • Category: An entity reference to the News Category vocabulary. Type in the name of the category and select from the options that appear, or create a new category/term by typing in a new one.

Content Area

The content area is the main body of your page. You can use the default fields entered below for a simple block post or build a more robust layout using paragraphs.

The sidebar area also allows you embed paragraphs below a section that links to the centers tagged in the post, the categories and a Related Content field that allows you to promote other News Posts by tagging them with the autocomplete widget.

Layouts

While you have the option to build layouts in news posts using paragraphs, all news posts are strictly two-column layouts. The Content Area displays on the left while the Sidebar Area displays on the right.

Other Settings

In the right column, make sure the “promoted to front page” item is checked, so it will appear in any listings.

13 - Program

A generic category page for program offerings.

An example of a program page

The Program content type is a high-level page that directs people to more specific program offerings.

An example of a Program in YMCA Website Services would be a Swimming & Aquatics page that directs people to more specific offerings, such as swim lessons or clinics.


When Should I Use a Program?

Programs are pages that should link to more specific offering pages. Most often in YMCA Website Services sites, they are the main program pages in an YMCA Website Services mega menu setup.

The site mega menu with program pages indicated


How to Use Program

Header Area

  • Icon: An image field that displays an icon (jpg/png) inline with the title.
  • Image: An optional image field for a picture to display in the header.
  • Color: A background color for the header.
  • Paragraph Section: Area to enter paragraphs in the Header, such as a Gallery, Small Banner or Microsites menu. Paragraphs entered in this area replace the image/background color

Standard Title with Light Blue

A program page with a light blue banner

Standard Title with Purple

A program page with a purple banner

Small Banner

A program page with a small banner and an image background

Content Area

  • Description: Displays above the main body of your content and serves as a tease for your Program page when it’s displayed as part of a list on another page. Minimal styling and short lengths are recommended.

  • Content: The main body of your content. Use paragraphs to build your page layout. Designed to integrate with the Categories Listing paragraph, but that is not required.

For aside pieces of content, such as side navigations, promotional cards and content related to the main part of your page.

Layouts

Similar to landing pages, Program pages are designed for flexible layouts, with a couple key differences:

  • Program pages are designed for integration with the Categories Listing paragraph type. Program subcategory pages are tagged with a Program, and those subcategories are displayed as long cards on that Program page.

  • There is no layout dropdown. How your content displays depends on your theme.

    • Lily/Rose will always display Programs in a two-column layout in desktop.
    • Carnation will display desktop in One Column without content in the Sidebar Area and in Two Columns with content in the Sidebar Area.

Carnation: Without Content in the Sidebar

A program page without content in the sidebar

Carnation: Desktop With Content in the Sidebar

A program page with content in the sidebar

  • 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 content editors have the option of customizing the Program page with 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 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. They will be updated as of the March 2024 release. Keep an eye on 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. See How to migrate to Layout Builder for information about preparing for the migration.

14 - Program Subcategory

Subcategory pages refine broad Programs into more concrete options.

A subset of a Program, Program Subcategory pages list different types of program offerings, grouped into Activities.

An example of a program subcategory page

Whereas a Program page would describe a Y’s Health & Fitness offerings in general, a Program Subcategory would break that down into subcategories such as …

  • Personal Training
  • Group Exercise Classes
  • Pilates

When Should I Use Subcategory?

Most Ys have opted to use Program pages as the top-level categories in their Programs mega menu. Subcategories are then the items underneath each category.

The mega menu with program subcategory items indicated

Subcategories, likewise, appear as horizontal cards on Program pages.

The program subcategories as displayed on program pages

Learn about the Categories Listing Paragraph ⇒

How Do I Use the Program Subcategory Content Type?

Start by adding a Title for your Program Subcategory and tag it with a Program.

The program subcategory fields

The Program tag will pull your Program Subcategory in as a horizontal card on a Program page. You can only tag a Subcategory with one Program.

Header Area

  • Image: Using an image field, select an image from the media browser. Displays in the header and as a thumbnail in Categories Listing.

  • Color: A dropdown to select a background color for your header.

    -> Note: The background color does not display on desktop in Carnation unless you do not have an image selected.

You have the option to add paragraphs in the Header Area. However, these paragraphs display below the below the image and title you enter above.

For example, if you add a banner in the Header Area, it will display below the title and image entered in those Header Area fields.

Subcategory was originally designed to work with the Classes Listing Filters paragraph in the Header Area and the Classes Listing paragraph in the Content Area.

View Subcategory Demo on YMCA Website Services Sandbox ⇒


With the integration of Activity Finder into YMCA Website Services, Classes Listing and Classes Listing Filters are becoming less popular among YMCA Website Services sites.

Content Area

The Content Area includes a Description that displays full-width just below the Header Area.

When your Subcategory is showed in a Categories Listing on a Program page, the Description is the text inside the card.

You can embed content inside the Content Area, all of which will display below the Description.

YMCA of Greater Brandywine Example

An example of program listings

The Sidebar Area will change the layout of the page into two columns once you enter content.

Bottom Area

Use the Bottom Area for anchoring elements, such as small banners and webforms.

Customizing with Layout Builder

Beginning in Website Services 10.3.1.1 content editors have the option of customizing the Program Subcategory page with 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 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. See How to migrate to Layout Builder for information about preparing for the migration.

15 - Promotion

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 (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 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.

  • 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.