Download the PHP package alleyinteractive/wp-asset-manager without Composer

On this page you can find all versions of the php package alleyinteractive/wp-asset-manager. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of alleyinteractive/wp-asset-manager

Informations about the package wp-asset-manager

WordPress Asset Manager

Asset Manager is a toolkit for managing front-end assets and more tightly controlling where, when, and how they're loaded.

Using Asset Manager in your WordPress Project

To get started, simply download and install this plugin into your plugins directory and activate it on the plugins screen.

Enqueue Functions

The am_enqueue_* functions will enqueue an asset with additional attributes based upon its load_method value. Options can be passed in as an array or individual parameters.

am_enqueue_script

Use am_modify_load_method to modify the load method of an already-enqueued script.

am_enqueue_style

Conditions

The condition parameter determines under which condition(s) the asset should load.

include

string|array

Requires that all conditions be truthy in order for the asset to load.

The include property is implied if the condition parameter is a string or array of strings; otherwise the condition parameter must contain the include property.

include_any

string|array

Allows for any condition to be truthy, instead of requiring that all conditions be.

exclude

string|array

Requires that all conditions be falsey in order for the asset to load. This is skipped if neither include nor include_any are truthy.

Custom Conditions

There are a few default conditions included out-of-the-box:

Name Condition
'global' true
'single' is_single()
'search' is_search()

Use the am_asset_conditions filter to add or replace conditions.

Inline Assets

Use load_method => inline with an absolute src path for either enqueue function to print the contents of the file to the document head.

Print the contents of a file

Print inline global variables

Pass an array of values as the src to print global JavaScript variables to the document head.

The result will be an object added to the window.amScripts[$handle] object:

Use the am_inline_script_context filter to change the global object name.

Enqueue Options

The am_enqueue_* functions use the same parameters as their core WordPress enqueue equivelant, with the exception of the $in_footer parameter for scripts; use 'load_hook' (details below) instead.

Additional options:

Name Description Default
condition The condition for which this asset should load 'global'
load_hook 'wp_head'
  — wp_head Load this asset via wp_head
  — wp_footer Load this asset via wp_footer
load_method 'sync'
  — sync Use the corewp_enqueue function
  — async Adds the async attribute to the enqueue
  — defer Adds the defer attribute to the enqueue
  — async-defer Adds the async and defer attributes (scripts only)
  — inline Prints the asset inline in the document head

Preload Function

Use am_preload for preloading assets of any supported type.

Result:

The am_preload function patches the as and mime_type option values for common use-cases (CSS, JavaScript and WOFF2 fonts), but will throw an error if the as option is missing for any other file type.

From the spec:

The [as] attribute is necessary to guarantee correct prioritization, request matching, application of the correct Content Security Policy policy, and setting of the appropriate Accept request header.

This function will also automatically add the crossorigin attribute for fonts, which is required when preloading fonts, even if they're not actually cross-origin requests.

Preload Options

Name Description Required Default
handle The handle for the asset •
src The URI for the asset •
condition The condition for which this asset should load 'global'
version The asset version '1.0.0'
as The as attribute's value (info) •
mime_type The type attribute's value (info) •
media The media attribute value used to conditionally preload the asset 'all'

SVG Sprite

Allows for fine-grained control over SVG assets in WordPress templates by creating a sprite of registered symbols and providing helper functions for displaying them.

Asset Manager will add an SVG file's contents to the sprite if:

  1. The symbol is registered via am_register_symbol with a unique handle and valid file path
  2. The symbol's condition is truthy

See Conditions for more about Asset Manager's conditions and how to update them.

Setup

The sprite is printed via the wp_body_open hook, so be sure your templates have the wp_body_open() function at the top of the document's <body> element.

Admin pages

Prints the sprite to admin pages via the in_admin_header hook, which is the most similar admin hook to wp_body_open. Symbols registered with condition(s) not matching admin pages will not be added to the sprite.

Registering Symbols

Use the am_register_symbol function to add a symbol to the sprite. Like wp_register_script and wp_register_style, an attempt to re-register a symbol with an existing handle will be ignored.

Symbols should be registered via an action that fires before wp_body_open.

Options can be passed in as an array or individual parameters.

$handle

string

Handle for the asset. Should be unique.

$src

string

Absolute path to the SVG file, or a relative path based on the current theme root. Use the am_modify_svg_directory filter to update the directory from which relative paths will be completed.

$condition

string|array

Loading condition(s) that, when matched, will allow the asset to be added to the sprite.

$attributes

array

An array of HTML attribute names and values to add to the resulting <svg> everywhere it is rendered.

Verifying a symbol is registered

$handle

string

The handle with which the symbol should be registered.

Return

bool

Whether the symbol has been registered.

Changing the SVG directory

Use the am_modify_svg_directory filter to update the directory from which relative paths will be completed.

Default: The current theme root.

Setting Global Attributes

Use the am_global_svg_attributes filter to add global attributes that will apply to all symbols.

Default: []

Update $sprite_allowed_tags

Use the am_sprite_allowed_tags to filter elements and attributes used in escaping the sprite, such as certain deprecated attributes, script tags, and event handlers.

Removing a Symbol

Use am_deregister_symbol to remove a registered a symbol.

This should be added via an action that fires after, or at a lower priority, than the action used for am_register_symbol.

$handle

string

The handle with which the symbol was registered.

Return

bool

Whether the symbol has been deregistered and removed from the sprite. true on success, or if the symbol hadn't been previously registered; false on failure.

Replacing a symbol

Prior to re-registering a symbol, verify the symbol to be replaced is not registered.

Displaying a Symbol

am_use_symbol prints an <svg> element with the specified attributes.

$handle

string

The handle with which the symbol was registered.

$attributes

array

An array of attribute-value pairs to add to the resulting SVG markup.

Override global attributes, or those defined via am_register_symbol, by declaring a new value here; remove it entirely by passing a falsy value.

Notes on SVG sizing

Asset Manager will attempt to establish a default size for each SVG, which will be used to calculate the dimensions if only one, or neither, of height or width is passed to am_use_symbol.

The default size is based on (in order):

  1. The values set in the symbol's am_register_symbol attributes array
  2. The height and width attributes from the SVG
  3. The viewBox attribute values

If Asset Manager cannot determine a symbol's dimensions, both height and width will need to be declared in the attributes array passed to am_use_symbol.

The simplest way to ensure SVGs are sized as expected is to verify each file's <svg> element either has both height and width attributes or a viewBox attribute.

Example:

Output:

Getting a Symbol

am_get_symbol returns a string containing the <svg> element with the specified attributes.

This function uses the same arguments as am_use_symbol.

Example:

Requirements

Downloads and Versioning.

You can view Asset Manager's official releases here.

The develop branch on GitHub contains the "bleeding edge" releases (alpha, beta, RC). The production branch is the latest stable release.

Contributing to Development

Development of Asset Manager happens on Github. Bugs with Asset Manager should be addressed in the Github issue queue, and enhancements or bug fixes should be submitted as pull requests, which are always welcome.

All versions of wp-asset-manager with dependencies

PHP Build Version
Package Version
No informations.
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package alleyinteractive/wp-asset-manager contains the following files

Loading the files please wait ....