Skip to content

mherchel/drupal-quicklink

Repository files navigation

QUICKLINK DRUPAL MODULE

INTRODUCTION

The Drupal Quicklink module loads the Quicklink library and provides a Drupal administrative interface to configure it.

REQUIREMENTS

This module is tested on Drupal 8.6 and above.

INSTALLATION

MANUAL INSTALLATION

  1. Download the Drupal module and extract it to your modules folder.
  2. Because of licensing restrictions, the Quicklink JavaScript library cannot be hosted on Drupal.org.

By default this module will load the Quicklink JavaScript library from a CDN at https://unpkg.com/quicklink@1.0.0/dist/quicklink.umd.js.

If you place a copy of this file into your local filesystem at /libraries/quicklink/dist/quicklink.umd.js, this module will serve the local copy instead of the CDN copy.

COMPOSER (RECOMMENDED)

If you manage your site with composer, and would like to install this module with it, please verify the following steps. If you used the Drupal composer template to setup your project, you most likely have this set up already.

  1. Add or verify that asset-packagist is in the repositories section of your composer.json file:
    "repositories": [
        {
            "type": "composer",
            "url": "https://packages.drupal.org/8"
        },
        {
            "type": "composer",
            "url": "https://asset-packagist.org"
        },
    }
  1. Add or verify that type:npm-asset is in the extra > installer-path > web/libraries/{$name} section of your composer.json file:
    "extra": {
        "installer-paths": {
            "web/libraries/{$name}": [
                "type:drupal-library",
                "type:bower-asset",
                "type:npm-asset"
            ],
        }
    }
  1. Add or verify that you have npm-asset in the extra > installer-types section of your composer.json file:
    "installer-types": ["npm-asset", "bower-asset"],
  1. Save your composer.json file.

  2. Back at the command line, install the library with composer require oomphinc/composer-installers-extender npm-asset/quicklink

  3. Install the module with composer require drupal/quicklink

  4. Enable the module at admin/modules or by running drush en -y quicklink

CONFIGURATION

The Quicklink module admin interface is located at admin/config/development/performance/quicklink, and can be accessed from a tab on the development / performance settings page.

After enabling, the Quicklink module will work properly for most sites. The options and descriptions within the configuration form should be self-explanatory. However, full documentation is available on Drupal.org.

BROWSER SUPPORT

Without polyfills, Quicklink supports: Chrome, Firefox, and Edge.

With Intersection Observer polyfill: Safari.