DocAccessible
Checking account
Documentation
All documentation

Website monitoring

Install the website script on Drupal or Joomla

Add DocAccessible through the active CMS theme or asset manager, preserve the site-key attribute, clear caches, and verify rendered source.

For
Drupal and Joomla developers, site builders, and platform teams
Typical time
20-40 minutes
Copy your website script

Before you start

  • Development and deployment access to the active CMS theme or extension
  • A tested rollback path before changing production templates
  • The exact generated installation code for the connected domain

Procedure

Step by step

  1. Identify the active public theme

    Confirm which theme or template renders anonymous front-end pages. Admin themes and inactive templates do not affect public page source.

  2. Copy the generated installation values

    From DocAccessible Installation, copy the complete tag. Preserve both the service URL and data-site-key when translating it into the CMS asset configuration.

  3. Register the external script globally

    Use Drupal's library system or Joomla's Web Asset Manager in the active theme or a site-owned extension. Set async and the custom data-site-key attribute.

  4. Deploy and rebuild caches

    Deploy through the site's normal release process, then clear Drupal or Joomla caches, template caches, reverse proxies, and the CDN.

  5. Verify anonymous page source

    Open a public page as a logged-out visitor and search its source for the exact key. Do not rely only on an authenticated toolbar or developer-mode response.

  6. Confirm the website connection

    Load the public page once, return to Installation, and confirm Script connected before enabling scheduled operations or approved visitor mappings.

Drupal 10 and 11

Define an external script in the active theme's libraries.yml with async and data-site-key attributes, then attach that library globally from the theme info file or a site-owned module. Replace the example namespace and key with your real values.

your_theme.libraries.yml
docaccessible:
  js:
    https://docaccessible.com/site/v1.js:
      type: external
      attributes:
        async: true
        data-site-key: YOUR_SITE_KEY
your_theme.info.yml global library
libraries:
  - your_theme/docaccessible

Joomla 4 and 5

Register and use the external script through the Web Asset Manager from the active template or a site-owned extension. Keep the custom site-key attribute on the final script element.

Active template or extension example
$wa = $this->getWebAssetManager();
$wa->registerAndUseScript(
    'docaccessible.site',
    'https://docaccessible.com/site/v1.js',
    [],
    ['async' => true, 'data-site-key' => 'YOUR_SITE_KEY']
);

CMS cache and aggregation checks

Asset aggregation can alter loading order, but it must not remove the data-site-key attribute or replace the external URL with a client-only loader. Verify the final anonymous HTML after every optimization change.

  • Clear CMS render and asset caches.
  • Purge reverse-proxy and CDN HTML caches.
  • Confirm the script is attached to the public theme, not only an admin theme.
  • Check multisite or multilingual domains individually when they use different hosts.

Official CMS references

Use the official asset APIs for maintainable theme and extension changes. Exact namespaces and deployment conventions remain specific to your site.

Related guides