Cloud2PNG captures snapshots of any website using the Cloudinary URL2PNG add-on
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets
inc
languages
lib
.codeclimate.yml
.eslintignore
.eslintrc
.gitattributes
.travis.yml
CHANGELOG.md
Gruntfile.js
README.md
cloud2png.php
package.json
phpcs.xml
readme.txt

README.md

Cloud2PNG

Build Status Code Climate

Capture snapshots of any website using Cloudinarys URL2PNG add-on.

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(), 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} filter:


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

Prerequisites

Download

The plugin is available in the WordPress plugin directory

Installation

When you have the prerequisites:

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

It will add the Cloud2PNG admin menu entry at Settings->Cloud2PNG

Go to Settings->Cloud2PNG, and in Settings add cloud name, api key and api secret. You'll find them in the Cloudinary Dashboard

In the Cloud2PNG Settings you can also enable a link to Cloud2PNG Customizer from the Admin Bar.

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.

I'm following the WordPress Coding Standards with one exception, I'm using the PSR-4 autoloader 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:

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/.