You are here

class SnippetBuilder in Hotjar 8

Same name and namespace in other branches
  1. 8.2 src/SnippetBuilder.php \Drupal\hotjar\SnippetBuilder

Class SnippetBuilder.

@package Drupal\hotjar

Hierarchy

Expanded class hierarchy of SnippetBuilder

1 string reference to 'SnippetBuilder'
hotjar.services.yml in ./hotjar.services.yml
hotjar.services.yml
1 service uses SnippetBuilder
hotjar.snippet in ./hotjar.services.yml
Drupal\hotjar\SnippetBuilder

File

src/SnippetBuilder.php, line 19

Namespace

Drupal\hotjar
View source
class SnippetBuilder implements SnippetBuilderInterface, ContainerInjectionInterface {
  use StringTranslationTrait;

  /**
   * State storage.
   *
   * @var \Drupal\Core\State\StateInterface
   */
  protected $state;

  /**
   * Config factory.
   *
   * @var \Drupal\Core\Config\ConfigFactoryInterface
   */
  protected $configFactory;

  /**
   * Hotjar settings.
   *
   * @var \Drupal\hotjar\HotjarSettingsInterface
   */
  protected $settings;

  /**
   * Module handler.
   *
   * @var \Drupal\Core\Extension\ModuleHandlerInterface
   */
  protected $moduleHandler;

  /**
   * JS collection optimizer.
   *
   * @var \Drupal\Core\Asset\AssetCollectionOptimizerInterface
   */
  protected $jsCollectionOptimizer;

  /**
   * Messenger.
   *
   * @var \Drupal\Core\Messenger\MessengerInterface
   */
  protected $messenger;

  /**
   * SnippetBuilder constructor.
   *
   * @param \Drupal\Core\State\StateInterface $state
   *   Store storage.
   * @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory
   *   Config factory.
   * @param \Drupal\hotjar\HotjarSettingsInterface $settings
   *   Hotjar settings.
   * @param \Drupal\Core\Extension\ModuleHandlerInterface $module_handler
   *   Module handler.
   * @param \Drupal\Core\Asset\AssetCollectionOptimizerInterface $js_collection_optimizer
   *   JS assets optimizer.
   * @param \Drupal\Core\Messenger\MessengerInterface $messenger
   *   Messenger service.
   */
  public function __construct(StateInterface $state, ConfigFactoryInterface $config_factory, HotjarSettingsInterface $settings, ModuleHandlerInterface $module_handler, AssetCollectionOptimizerInterface $js_collection_optimizer, MessengerInterface $messenger) {
    $this->state = $state;
    $this->configFactory = $config_factory;
    $this->settings = $settings;
    $this->moduleHandler = $module_handler;
    $this->jsCollectionOptimizer = $js_collection_optimizer;
    $this->messenger = $messenger;
  }

  /**
   * {@inheritdoc}
   */
  public static function create(ContainerInterface $container) {
    return new static($container
      ->get('state'), $container
      ->get('config.factory'), $container
      ->get('hotjar.settings'), $container
      ->get('module_handler'), $container
      ->get('asset.js.collection_optimizer'), $container
      ->get('messenger'));
  }

  /**
   * {@inheritdoc}
   */
  public function pageAttachment(array &$attachments) {
    $uri = 'public://hotjar/hotjar.script.js';
    $query_string = $this->state
      ->get('system.css_js_query_string') ?: '0';
    $query_string_separator = strpos($uri, '?') !== FALSE ? '&' : '?';
    $url = file_url_transform_relative(file_create_url($uri));
    $attachments['#attached']['html_head'][] = [
      [
        '#type' => 'html_tag',
        '#tag' => 'script',
        '#attributes' => [
          'src' => $url . $query_string_separator . $query_string,
        ],
      ],
      'hotjar_script_tag',
    ];
  }

  /**
   * {@inheritdoc}
   */
  public function createAssets() {
    $result = TRUE;
    $directory = 'public://hotjar';
    if (!is_dir($directory) || !is_writable($directory)) {
      $result = file_prepare_directory($directory, FILE_CREATE_DIRECTORY | FILE_MODIFY_PERMISSIONS);
    }
    if ($result) {
      $result = $this
        ->saveSnippets();
    }
    else {
      $this->messenger
        ->addWarning($this
        ->t('Failed to create or make writable the directory %directory, possibly due to a permissions problem. Make the directory writable.', [
        '%directory' => $directory,
      ]));
    }
    return $result;
  }

  /**
   * Saves JS snippet files based on current settings.
   *
   * @return bool
   *   Whether the files were saved.
   */
  protected function saveSnippets() {
    $snippet = $this
      ->buildSnippet();
    $path = file_unmanaged_save_data($snippet, 'public://hotjar/hotjar.script.js', FILE_EXISTS_REPLACE);
    if ($path === FALSE) {
      $this->messenger
        ->addMessage($this
        ->t('An error occurred saving one or more snippet files. Please try again or contact the site administrator if it persists.'));
      return FALSE;
    }
    $this->messenger
      ->addMessage($this
      ->t('Created snippet file based on configuration.'));
    $this->jsCollectionOptimizer
      ->deleteAll();
    _drupal_flush_css_js();
    return TRUE;
  }

  /**
   * Get Hotjar snippet code.
   *
   * @return mixed|string
   *   Hotjar snippet.
   */
  protected function buildSnippet() {

    // Use escaped HotjarID.
    $clean_id = $this
      ->escapeValue($this->settings
      ->getSetting('account'));
    $clean_version = $this
      ->escapeValue($this->settings
      ->getSetting('snippet_version'));

    // Quote from the Hotjar dashboard:
    // The Tracking Code below should be placed in the <head> tag of
    // every page you want to track on your site.
    $script = <<<HJ
(function(h,o,t,j,a,r){
  h.hj=h.hj||function(){(h.hj.q=h.hj.q||[]).push(arguments)};
  h._hjSettings={hjid:{<span class="php-variable">$clean_id</span>},hjsv:{<span class="php-variable">$clean_version</span>}};
  a=o.getElementsByTagName('head')[0];
  r=o.createElement('script');r.async=1;
  r.src=t+h._hjSettings.hjid+j+h._hjSettings.hjsv;
  a.appendChild(r);
})(window,document,'//static.hotjar.com/c/hotjar-','.js?sv=');
HJ;

    // Compact script if core aggregation or advagg module are enabled.
    if ($this
      ->isJsPreprocessEnabled() || $this->moduleHandler
      ->moduleExists('advagg')) {
      $script = str_replace([
        "\n",
        '  ',
      ], '', $script);
    }
    return $script;
  }

  /**
   * Escape value.
   */
  protected function escapeValue($value) {
    return json_encode($value, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_AMP | JSON_HEX_QUOT);
  }

  /**
   * Checks if JS preprocess is enabled.
   *
   * @return bool
   *   Returns TRUE if JS preprocess is enabled.
   */
  protected function isJsPreprocessEnabled() {
    $config = $this->configFactory
      ->get('system.performance');
    return $config
      ->get('js.preprocess', TRUE) === TRUE;
  }

}

Members

Namesort descending Modifiers Type Description Overrides
SnippetBuilder::$configFactory protected property Config factory.
SnippetBuilder::$jsCollectionOptimizer protected property JS collection optimizer.
SnippetBuilder::$messenger protected property Messenger.
SnippetBuilder::$moduleHandler protected property Module handler.
SnippetBuilder::$settings protected property Hotjar settings.
SnippetBuilder::$state protected property State storage.
SnippetBuilder::buildSnippet protected function Get Hotjar snippet code.
SnippetBuilder::create public static function Instantiates a new instance of this class. Overrides ContainerInjectionInterface::create
SnippetBuilder::createAssets public function Prepares directory for and saves snippet files based on current settings. Overrides SnippetBuilderInterface::createAssets
SnippetBuilder::escapeValue protected function Escape value.
SnippetBuilder::isJsPreprocessEnabled protected function Checks if JS preprocess is enabled.
SnippetBuilder::pageAttachment public function Implements hook_page_attachment(). Overrides SnippetBuilderInterface::pageAttachment
SnippetBuilder::saveSnippets protected function Saves JS snippet files based on current settings.
SnippetBuilder::__construct public function SnippetBuilder constructor.
StringTranslationTrait::$stringTranslation protected property The string translation service. 1
StringTranslationTrait::formatPlural protected function Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals protected function Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation protected function Gets the string translation service.
StringTranslationTrait::setStringTranslation public function Sets the string translation service to use. 2
StringTranslationTrait::t protected function Translates a string to the current language or to a given language.