Installation #
- Place the url2png folder inside your craft/plugins folder
- Go to settings/plugins and install URL2PNG.
- Get your API key and secret from url2png.com (signup with promo code CRAFT to get $40 credit.)
- Add the key/secret under URL2PNG settings
Usage #
Image embed #
{{ craft.url2png.img({
url: 'http://buildwithcraft.com',
width: 500
}) | raw }}
Remember to include the raw filter. There is no current option to prevent Craft autoescaping the HTML returned from plugin templates in the frontend.
URL #
{% set img = craft.url2png.url({
url: 'http://buildwithcraft.com',
thumbnail_max_width: 500
}) %}
<div style="background-image: url({{ img }}); width: 500px; height: 500px;"></div>
Complete list of options #
Name | Description | Default |
---|---|---|
url | The url of the webpage you want to fetch | |
thumbnail_max_width | Constrain screenshot based on width. i.e. 500 | 1:1 |
viewport | Set viewport dimensions, adjust to your hearts content. i.e. 500x500 | 1480x1037 |
fullpage | Will attempt to capture entire document canvas. | false |
unique | Forces a fresh screenshot by varying this value. i.e. a timestamp. | |
user_agent | Pass a custom user user agent | |
accept_languages | Override the default HTTP Accept-Language header. | en-US,en;q=0.8 |
custom_css_url | Fetches a CSS stylesheet and injects it. | |
say_cheese | Delay screenshot until <div id='url2png-cheese'></div> is available. |
|
ttl | Set the TTL or "time to live" value for a screenshot in seconds. | 2592000 (30 days) |
alt | Sets the img alt attribute | |
class | Sets the img class attribute | |
width | Sets the img width attribute | |
height | Sets the img height attribute |
Releases
- Added: Initial release
Currently available for Craft consulting and custom plugin development
Contact me