=== Cloud2PNG ===
Contributors: PerS
Donate link: http://example.com/
Tags: webshot, screenshot, snapshot, cloudinary, url2png
Requires at least: 4.6
Tested up to: 4.7
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Capture snapshots of any website using the Cloudinary URL2PNG add-on.

== Description ==

Capture snapshots of any website using the [Cloudinary URL2PNG add-on](https://cloudinary.com/console/addons#url2png).

= Use =

Add link to the site you'd like to create a snapshot of, by using the `[cloud2png]` shortcode, eg:

`
[cloud2png url="https://wordpress.org"]
`

**Customize the snapshots**

Using the Cloud2PNG Customizer you can change the size and border of the snapshots.

**Shortcode parameters**

You can override the Cloud2PNG Customizer using the shortcode parameters, they are (with defaults):

- url=home_url( '/' )
- width=430
- height=225
- border_width=0
- border_radius=0
- border_color=#000000

`
[cloud2png url="https://wordpress.org" width="300" height="400" border_width="5"]
`

**Adding Cloud2PNG to a theme**

Using [do_shortcode()](https://developer.wordpress.org/reference/functions/do_shortcode/), you can add Cloud2PNG to a theme:

`

echo do_shortcode( 'url="https://wordpress.org" width="300" height="400" border_width="5' );

`

or using the [shortcode_atts_{$shortcode}](https://developer.wordpress.org/reference/hooks/shortcode_atts_shortcode/) filter:

`

add_filter ('shortcode_atts_cloud2png', 'add_url', 10, 3);
function add_url ($out, $pairs, $atts ) {
    $out['url'] = 'https://soderlind.no';
    return $out;
}

`

== Installation ==

= Prerequisites =

- PHP 5.6 (I use PHP 7.x on my development server)
- A [Cloudinary account](https://cloudinary.com/signup)
- Enable the [Cloudinary URL2PNG add-on](https://cloudinary.com/console/addons#url2png)

When you have the prerequisites:

1. In Plugins->Add New, search for Cloud2PNG
1. Click Install Now
1. When the plugin is installed, activate it.

== Screenshots ==

1. Demo
2. Get the settings from the Cloudinary Dashboard

== Changelog ==

= 1.0.3 =
* Fix cloudinary radius bug. Cloudinary draws a radius even though the radius = 0, so don't send radius parameter when it's 0.

= 1.0.2 =
* Harden shortcode attributes

= 1.0.1 =
* Added to the WordPress plugin directory

= 1.0.0 =
* Initial release


== Sidenote ==

I code for fun, and I code to learn. I've tried to do this plugin using OOP at my best effort. There will be couplings that could be looser and not everything is DRY. I will update the plugin as I learn more and I will fix [issues that are reported](https://github.com/soderlind/cloud2png/issues/new).

I'm following the [WordPress Coding Standards](https://github.com/WordPress-Coding-Standards/WordPress-Coding-Standards) with one exception, I'm using the [PSR-4 autoloader](http://www.php-fig.org/psr/psr-4/) and I've disabled the following rules:
`
<rule ref="WordPress-Core">
	<exclude name="Generic.Files.LowercasedFilename" />
	<exclude name="WordPress.Files.FileName" />
	<exclude name="WordPress.Files.FileName.UnderscoresNotAllowed" />
</rule>
`


= Credits =
Cloud2PNG is using:

- The [Plugin Customizer](https://github.com/soderlind/plugin-customizer) framework.
- The [WordPress Customizer Range Value Control](https://github.com/soderlind/class-customizer-range-value-control).
- The [PHP extension for Cloudinary](https://github.com/cloudinary/cloudinary_php)
- The [PSR-4 Autoloader](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-4-autoloader-examples.md#class-example)
- The jQuery [boxShadow cssHooks](https://github.com/brandonaaron/jquery-cssHooks/blob/master/boxshadow.js), Copyright (c) 2010 Burin Asavesna (http://helloburin.com)
    - I use CSS box-shadow to create [Better Rounded Borders](http://blog.teamtreehouse.com/css-tip-better-rounded-borders)

= Copyright and License =
Cloud2PNG is copyright 2017 Per Soderlind

Cloud2PNG is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

Cloud2PNG is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with the Extension. If not, see http://www.gnu.org/licenses/.
