Download the PHP package timknight/craft-macro-kit without Composer
On this page you can find all versions of the php package timknight/craft-macro-kit. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download timknight/craft-macro-kit
More information about timknight/craft-macro-kit
Files in timknight/craft-macro-kit
Package craft-macro-kit
Short Description A collection of Twig macros for Craft CMS
License MIT
Informations about the package craft-macro-kit
Macro Kit for Craft CMS
Macro Kit provides several functions that can be imported into your front-end templates for use in Craft CMS.
Requirements
This plugin requires Craft CMS 3.0.0 or later.
Installation
To install Macro Kit, follow these steps:
- Install with Composer using
composer require timknight/craft-macro-kit
- Install the plugin in the Craft Control Panel under
Settings > Plugins
Macro Kit is also available in the Craft Plugin Store available in the Control Panel.
Usage
Macro Kit can be used within your templates simply by importing all of the macros into a template.
Or import individual macros into the current namespace.
You can customize the path to the all.twig
template (_macrokit
by default) by editing the plugin’s “Template Path” setting, or creating a config/macro-kit.php
file with this:
abbrStateName
Given a full US state name this returns the appreviated name of that state.
dateRange
Given two dates within the same month, this returns a formatted date range.
Optionally, you can supply a separator to be used in place of the default –
.
fullStateName
Given an appreviated US state this returns the full state name.
linkToIf
Given a condition this wraps a block within a link if the condition is met.
Pass in a block variable if you'd like:
Optionally, you can set if the link is external which can open a new window and set rel="noopener"
.
You can also assign CSS classes to the generated link:
ordinalNum
Given a number this returns the number with its ordinal suffix: 1 => 1st
randomString
Generates a random string of numbers and letters given a specific length.
summarize
Takes a block of HTML text, strips the tags and trims it to match a given length in characters to act as a summary.
Optionally, add a string to append at the end of the summary. Supports HTML tags and elements.
stripPhone
Takes a formatted phone number string and strips all non-numeric values to return only the numbers. Perfect for those times when you want a stripped value to use within a phone number link (e.g. <a href="tel:{{ mk.stripPhone(entry.phone) }}">{{ entry.phone }}</a>
)