Extend WordPress > WordPress Plugins

JSM Screenshot Machine Shortcode

JS Morisset

Version Information

  • Plugin Name: JSM Screenshot Machine Shortcode
  • Stable Version: 3.0.0
  • Author: JS Morisset
  • Description: Shortcode to include images from Screenshot Machine in your content.
  • License: GPLv3
  • Requires PHP: 7.4.33 or newer
  • Requires WordPress: 5.9 or newer
  • Tested Up To WordPress: 6.7.1
  • Last Updated: 4 days ago

Shortcode to include images from Screenshot Machine in your content.

`ssm` shortcode required arguments

  • key="{customer key}" (required)
  • url="{url}" (required)

You can find the {customer key} on your Screenshot Machine customer profile.

The {url} is the web page URL you want to capture in the screenshot.

`ssm` shortcode optional arguments

  • dimension="{width x height}" (default is 120x90)
  • device="{desktop|phone|tablet}" (default is desktop)
  • format="{jpg|png|gif}" (default is jpg)
  • days="{cache expiration}" (default is 14)
  • wait="{ms}" (default is 200)
  • zoom="{percentage}" (default is 100)
  • click="{css selector}" (example: .button-close)
  • hide="{css selectors}" (example: .add-banner1,.add-banner2)
  • cookies="{semicolon list}" (example: name1=value1;name2=value2)
  • language="{locale}" (example: en-US)
  • agent="{user agent}"
  • select="{css selector}" (example: table.table:nth-child(3) > tbody:nth-child(2) > tr:nth-child(15))
  • crop="{x,y,width,height}" (example: 100,0,800,300)
  • title="{title}"
  • link="{yes|no}" (default is yes)
  • target="{name}" (default is _blank)
  • refresh="{yes|no}" (default is yes)

dimension="{width x height}" examples:

  • dimension="320x240" - screenshot size 320x240 pixels.
  • dimension="800x600" - screenshot size 800x600 pixels.
  • dimension="1024x768" - screenshot size 1024x768 pixels.
  • dimension="1920x1080" - screenshot size 1920x1080 pixels.
  • dimension="1024xfull" - full page screenshot with width equals to 1024 pixels (can be pretty long).

days="{cache expiration}" is a number of days that a screenshot should be used before a new one is created (default is 14).

wait="{ms}" is a number of milliseconds to wait before capturing the screenshot (default is 200).

click="{css selector}" , hide="{css selectors}", and select="{css selector}" values are CSS class and/or id selectors. For example:

  • click=".button-close" - click this CSS class container before taking a screenshot.
  • hide=".add-banner1,.add-banner2" - hide this CSS class container before taking a screenshot.
  • select="table.table:nth-child(3) > tbody:nth-child(2) > tr:nth-child(15)" - take a screenshot only of this CSS container.

The title="{title}" is a text string for the image alt and anchor title attributes.

The link="{yes|no}" value will determine if the image is linked to the web page URL or not.

The target="{name}" opens the link in that target (default is "_blank"). An empty string, "_self", "_top", "_parent", or an HTML frame are other possible values.

The refresh="{yes|no}" value includes javascript to retry the image every second until it's available (for a maximum of 10 seconds).

example shortcode

[ssm key="abc123" url="https://google.com/" dimension="800x600"]
Find this content useful? Share it with your friends!

3 comments on “JSM Screenshot Machine Shortcode”

  3. Rated 5 out of 5

    I’ve been looking for a great screenshot plugin for some time. The ones that are on here are commonly blocked by the websites I need a picture of. Couldn’t have been easier to get it set up and works flawlessly. Keep up the great work!

Leave a Review