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

Return to the regular view of this page.

How to integrate with social media

Embedded social feeds or posts can help share your message with users.

    Social media is a great platform for communicating with your Y community, and it’s often helpful to embed feeds or posts on a page to share topical content with users.

    The distribution has used several methods over the years to add social content to sites, but all of them are dependent on the specific platforms maintaining open APIs. Unfortunately, many social networks are now locking down and restricting their APIs.

    How to embed social content in your YMCA website (in 2023)

    Currently, we recommend using embed codes from the specific platform to embed social posts or feeds on your YMCA Website Services website.

    Find the embed code

    Each platform has its own way of doing embeds. For posts, you can often find an “Embed” button in the options or share menu. For feeds, you often need to use a separate builder. Here are some options we’ve found:

    Note: Social platforms may break these embeds at their whim. Use at your own risk.

    Embeds using Paragraphs

    • Navigate to a content page on your site, then click Edit.
    • Add a Code Paragraph to the section where you’d like to do the embed.
    • Paste in the embed code generated above.
    • Save the page.

    Embeds using Layout Builder

    • Navigate to a content page on your site, then click Layout.
    • Add a Code Blockto the section where you’d like to do the embed.
    • Paste in the embed code generated above.
    • Save the block, then Save layout on the page.

    Alternatively, try Social Feeds Fetcher

    The Social Feeds Fetcher module that comes with the distribution allows your site to import social media content for syndication.

    To configure fetching:

    • Open the configuration page at /admin/config/social_feed_fetcher_settings or Configuration > Web Services > Social Feed Fetcher Settings
    • Select the checkbox for your chosen social networks and add additional settings. Every social network has its own API and requires different configuration.
    • When all settings are completed, click Run Cron. The import is started and if the configuration is correct, items will appear in the content list.

    How to share content from your site to social media

    All mobile browsers — Firefox, Edge, Safari, Chrome, Opera Mini, UC Browser, Samsung Internet — make it easy to share content directly from their native platforms.

    UX Considerations for Web Sharing

    Using AddToAny

    According to their introductory blog post:

    AddToAny is the perfect drop-in replacement for AddThis.

    A screenshot of the AddToAny popup.

    As of December 2023, the AddToAny module is included in the YMCA Website Services distribution. It is not enabled out of the box, but if you need to supplement native platforms’ sharing services, here’s how:

    • Go to Admin > Extend (/admin/modules) and enable the AddToAny module.
    • Configure the module at Admin > Configuration > Web Services > AddToAny (/admin/config/services/addtoany)

    Full documentation on AddToAny is available on Drupal.org and AddToAny’s Drupal Sharing Customization.

    AddToAny with Layout Builder

    To integrate AddToAny with the Layout Builder Design System:

    • Set the following configuration options for AddToAny:
      • Icon size: 36 pixels
      • Service Buttons: Change to any number of standalone service buttons that you would like.
      • Additional JavaScript: Add this code to have the buttons follow the configured colorway:
        a2a_config.icon_color = "var(--wsPrimaryColor),white";
        
      • Save the configuration
    • Add the AddToAny share buttons to the default Layout Builder display.
      • Edit a single Page Layout or the Content Type Layout.
      • Decide where to add the share block. We recommend the right side of the footer, above or below the “Stay Connected” block, but any section of the page would work.
      • In Layout Builder, Add block, then choose All system blocks > AddToAny share buttons.
        • Set a Title like “Share this”.
        • Choose to Display title.
        • Leave other configuration as their defaults.
        • In the Style settings, expand Spacing and add a top or bottom margin of 32px to ensure the block is spaced properly from the block above or below it.
    • Save the Block and the Layout.

    A screenshot of the AddToAny share block in the footer of a page.

    Using AddThis

    This Social Share Icons paragraph and the AddThis module ceased functioning on May 31, 2023, with the discontinuation of AddThis services.