Installation

We recommend using Composer to install this module. In your project root, run:

composer require drupal/smart_content_cdn

This will install the Smart Content module, Smart Content CDN and pantheon-systems/pantheon-edge-integrations -- a PHP library that is required by Smart Content CDN. Smart Content CDN will not function properly without the pantheon-edge-integrations library.

Post-Installation

Navigate to the Configuration > System > Smart Content CDN Configuration page at /admin/config/system/smart-content-cdn.
Enable the Vary Header toggle.
Set default Geo value to a 2-letter country code in all uppercase (e.g. US). This should match the default segment in Step 8 of the Geolocation section.
Save the configuration.

For detailed instructions on how to install and set up Smart Content CDN, see the Edge Integration Guide.

API

It is possible to retrieve header information using Smart Content CDN within your own custom module. This can be used in any class context or procedural context in any hook.

Include the library with the use statement.

use Pantheon\EI\HeaderData;

Use the snippet below to obtain the header data object

 // Get header data.
 $smart_content_cdn = new HeaderData();
 $p_obj = $smart_content_cdn->returnPersonalizationObject();

Drupal Event Subscriber Vary Header

It is possible to set a Vary header within a Drupal Event Subscriber, giving the possibility of customizing content on a per-user basis.

/**
 * This method is called when the kernel.response is dispatched.
 *
 * @param \Symfony\Component\HttpKernel\Event\FilterResponseEvent $event
 *   The dispatched event.
 */
public function onRespond(FilterResponseEvent $event) {
  $config = \Drupal::configFactory()->get('smart_content_cdn.config');

  // Check if Vary Header should be set.
  if ($config->get('set_vary') ?? TRUE) {
    $response = $event->getResponse();

    // Header keys to add to Vary header.
    $vary_headers = ['Audience', 'Interest', 'Role'];

    // Retrieve and set vary header.
    $smart_content_cdn = new HeaderData();
    $response_vary_header = $smart_content_cdn->returnVaryHeader($vary_headers);
    $response->headers->add($response_vary_header);
  }
}

Recommended modules/libraries

There are a few different ways to extend the capabilities of the Smart Content CDN module.

Smart Content Preview

Use the Smart Content Preview to allow previewing different segments that you have set up.

Smart Content SSR

The Smart Content SSR module adds a server-side rendering Decision block, based on the Decision block that the Smart Content module provides. Use this if you're looking to improve speed on the site, along with consistency.

Community Documentation

Pantheon Edge Integrations Drupal SDK

RTBC issues for Smart Content CDN

Filters