mister-bk / craft-plugin-mix by misterbk

Helper plugin for Laravel Mix in Craft CMS templates
153,651
51
8
Package Data
Maintainer Username: misterbk
Maintainer Contact: info@mister-bk.de (mister bk! GmbH)
Package Create Date: 2017-04-21
Package Last Update: 2024-04-09
Home Page:
Language: PHP
License: MIT
Last Refreshed: 2024-04-23 03:06:26
Package Statistics
Total Downloads: 153,651
Monthly Downloads: 1,340
Daily Downloads: 50
Total Stars: 51
Total Watchers: 8
Total Forks: 9
Total Open Issues: 3

Requirements

This plugin requires Craft CMS 3.0.0-RC1 or later.

Installation

To install the plugin, follow these instructions.

  1. Open your terminal and go to your Craft project:
cd /path/to/project
  1. Then tell Composer to load the plugin:
composer require misterbk/mix
  1. In the Craft Control Panel, go to Settings → Plugins and click the "Install" button for Mix.

Configuration

To configure Mix go to Settings → Plugins → Mix in the Craft Control Panel.

The available settings are:

  • Public Path - The path of the public directory containing the index.php
  • Asset Path - The path of the asset directory where Laravel Mix stores the compiled files

NOTE: Both Public Path and Asset Path get trimmed to allow all kind of path combinations.

  • /web/ + /assets//web/assets/
  • web + assets/web/assets/
  • / + assets/assets/
  • /web + //web/

Usage

Find a versioned CSS file.

<link rel="stylesheet" href="{{ mix('css/main.css') }}">

Find a versioned JavaScript file.

<script src="{{ mix('js/main.js') }}"></script>

Lazily find a versioned file and build the tag based on the file extension.

{{ craft.mix.withTag('js/main.js') | raw }}

Alternatively include the content of a versioned file inline.

{{ craft.mix.withTag('css/main.css', true) | raw }}

License

Craft Mix is open-sourced software licensed under the MIT license.