=== Urlbox Screenshots ===
Contributors: urlbox, cjroebuck, Ankur Gurha
Author: urlbox
Author URI: https://urlbox.io
Plugin URI: https://urlbox.io
Tags: screenshot,screenshots,snapshot,snapshots,webpage screenshot,webpage screenshots,browser screenshot,headless screenshot,headless chrome,headless chromium,firefox,chrome,safari,url2png,browshot,screenshotmachine,screenshotlayer,gallery,inspiration,website screenshots,retina screenshots,responsive screenshots,wordpress,plugin,integration
Requires at least: 2.7
Tested up to: 4.6.1
Stable tag: 1.0.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Take screenshots of websites and display them on your wordpress site using urlbox.io
== Description ==
Ever wanted to automate the generation and display of webpage screenshots on your wordpress site? Now it is easier than ever with the Urlbox Screenshots wordpress plugin. Simply specify a URL, and choose your screenshot options such as viewport width/height, retina resolution or full page screenshots and Urlbox will return a highly accurate PNG or JPEG image snapshot of the website and display it right inside your post.
Using the plugin is as simple as writing out the shortcode
[urlbox url=example.com]
*That's all there is to it!*
= What do you need =
* Wordpress, duh!
* A [Urlbox.io](https://urlbox.io) Account (You can sign up for free)
* Your Urlbox API Credentials (API key and secret)
In order to use this plugin you will need to [sign up for a urlbox account](https://urlbox.io) at urlbox.io to get your API key and secret.
= Once Activated =
1. Visit 'Settings > Urlbox' and fill in your Urlbox API Key and Secret. You will need to [sign up for free at urlbox.io](https://urlbox.io) in order to get these.
2. Set your default screenshot options on the Urlbox Screenshots settings page. For example, if you want all of your screenshots to be thumbnailed to 400px wide, set the **Thumbnail Width** option here to 400.
= Once Configured =
Using the plugin is **super** easy..
Wherever you want to display a screenshot in a post or other piece of content, use the `[urlbox]` shortcode like so:
[urlbox url=google.com] // this will generate a screenshot of google.com
If you want to override any of the defaults you setup, simply pass the relevant option into the shortcode:
[urlbox url=google.com full_page=true thumbnail_width=400] // displays a full_page screenshot of google, thumnailed down to 400px wide
The plugin wraps the `` tag inside a `