https://github.com/bmcclure/drupal-library-mapping

A composer package to assist in installing Drupal libraries from various sources.
https://github.com/bmcclure/drupal-library-mapping

Last synced: about 1 month ago
JSON representation

A composer package to assist in installing Drupal libraries from various sources.

• Host: GitHub
• URL: https://github.com/bmcclure/drupal-library-mapping
• Owner: bmcclure
• Created: 2017-05-04T19:48:12.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2021-11-17T18:09:41.000Z (about 3 years ago)
• Last Synced: 2024-11-08T00:08:39.942Z (about 2 months ago)
• Language: PHP
• Size: 10.7 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# drupal-library-mapping

A helper for installing library assets for Drupal.

By using Asset Packagist, you can already install Drupal assets into the right location.

But, what about packages that aren't named the way a Drupal module is expecting?

This package both includes common name mappings already, and allows you to specify your 

own in composer.json.

Then, it will symlink, copy, or move the mapped assets to the right location whenever 

they are installed or updated.

## How to use the plugin

First, require "bmcclure/drupal-library-mapping".

Enable Asset Packagist support following their instructions.

Configure the following in extra:

    "installer-types": ["library", "drupal-library", "bower-asset", "npm-asset"],

    "installer-paths": {

        "libraries/{$name}": [

            "type:drupal-library",

            "type:bower-asset",

            "type:npm-asset"

        ]

    }

Now simply require assets from Asset Packagist, and they'll be mapped appropriately.

## Customizing the copy type

By default, the mapped plugins are copied.

Add the following to extras to customize the method used for mapping:

    "drupal-library-mapping-type": "symlink"

    

Accepted values are "copy" (the default), "symlink", and "move".

Note that a side effect of using "move" is that composer will reinstall the package every time it runs.

## Customizing the package name map

You may wish to map other library names to common ones.

You can add new mappings to the "drupal-library-mapping" key in extras.

Example:

    "drupal-library-mapping": {

        "jquery-easing-original": "easing"

    }