Download the PHP package vanderlee/enricher without Composer
On this page you can find all versions of the php package vanderlee/enricher. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download vanderlee/enricher
More information about vanderlee/enricher
Files in vanderlee/enricher
Package enricher
Short Description Backfill (add only if missing), overwrite and remove classes, style rules and attributes in HTML by using selectors.
License MIT
Homepage https://github.com/vanderlee/Enricher
FAQ
Example:
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 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.
Informations about the package enricher
Enricher
Version 1.0.2
Copyright © 2016 Martijn van der Lee. MIT Open Source license applies.
Introduction
Backfill (add only if missing), overwrite and remove classes, style rules and attributes in HTML by using selectors.
Basic but fast HTML attribute and style modifier for PHP. Similar to Emogrifier with only basic selectors, but added attribute support. It's primary purpose is to change HTML for use in emails, but it is not in any way limited to this particular use case.
Features
- Change styles, attributes and classes.
- Add (if missing), overwrite and remove in one run.
- Select based on tag names, class names, id's and/or presence of attributes.
- Multiple selectors in one run.
- Fast.
Comparison to Emogrifier
Enricher's functionality and purpose has significant overlap with Emogrifier (https://github.com/jjriv/emogrifier), but is different in a few key ways.
- Both have full unittests.
- Both support element selectors. i.e.
a - Both support ID selectors. i.e.
#logo. - Both support class selectors. i.e.
table.mobile. - Both support attribute selectors. i.e.
a[name]. - Both support composite selectors. i.e.
a[name].mobile. - (+) Enricher is much faster than Emogrifier. Upto several orders of magnitude.
- (+) Enricher supports adding and removing attributes.
- (+) Enricher supports adding and removing classes.
- (+) Enricher supports adding, overwriting and removing in one go.
- (-) Emogrifier supports "path" selectors. i.e.
#list a.item. - (-) Emogrifier supports pseudoselectors. i.e.
:nth-child. - (-) Emogrifier supports attribute value selectors. i.e.
[name=anchor]. - (/) Emogrifier requires valid HTML, which may or may not be an issue, depending on usage scenario.
In general; if you need complex selectors such as paths, use Emogrifier. If you need class or attribute changing or complex CSS rewriting, use Enricher. In other cases Enricher will do the same job, but faster.
Future plans
- Support
*as an "all-elements" wildcard. - Support more complex selectors.
Documentation
Here you will find basic instructions to get you started. You can find complete PHPDoc in the /doc directory.
Installation
Get the latest version here: https://github.com/vanderlee/Enricher
Enricher requires atleast PHP 5.3 or HHVM.
Either include the autoloader (for forwards compatibility) or include the
Enricher.php file directly or through your own autoloader.
Constructor
The constructor does nothing.
Methods
reset()
Clear out all selectors, attribute, style and class settings.
addSelector($selector)/addSelectors($selectors)
Add a selectors to specify which elements may be selected.
- Select elements by specifying the tag. i.e.
div. - Select by class by specifying the class. i.e.
div.blue. - Select by id by specifying the id. i.e.
div#body. - Select by attribute by specifying the attribute. i.e.
a[href]. - Combine these to form selectors. i.e.
a[href][target].blue. - You may specify multiple selectors by separating them using a comma (,).
addAttribute($name, $value)/addAttributes($attributes)
overwriteAttribute($name, $value)/overwriteAttributes($attributes)
removeAttribute($name)/removeAttributes($names)
Add (if missing), overwrite or remove attributes.
addStyle($name, $value)/addStyles($styles)
overwriteStyle($name, $value)/overwriteStyles($styles)
removeStyle($name)/removeStyles($names)
Add (if missing), overwrite or remove style rules.
addClass($name)/addClasses($names)
removeClass($name)/removeClasses($names)
Add or remove classes.
enrich($html)
Enrich the HTML according the the settings. If settings are missing, an empty HTML will be returned.
