Save as Image Plugin by Pdfcrowd

Description

The “Save as Image” plugin introduces a simple yet powerful feature to your WordPress site by adding a button that enables users to capture and save a screenshot of the current webpage as an image file. This provides the option to keep a visual record of your content and simplifies the process of capturing webpages without the need for external tools or software.

Features

• One-Click Capture: Users can save a screenshot of the webpage with a single click.
• Customizable Button: Tailor the button’s look and placement to fit the aesthetics of your site.
• Versatile Image Support: Captures screenshots as high-quality image files, supporting various formats.
• Shortcode Integration: Seamlessly add the ‘Save as Image’ button anywhere on your site using a shortcode.

Usage

Once activated, the “Save as Image” button will automatically appear on all eligible content according to your settings. Users can click this button to save a screenshot of the current page as an image file (e.g. PNG or JPEG).

To manually add the “Save as Image” button to specific pages or posts, use the following shortcode:

[save_as_image_pdfcrowd]

For additional methods of adding the button to your pages, please refer to the Getting Started Guide.

Customization

The plugin offers various customization options accessible through the WordPress admin panel. You can change the screenshot generation settings and button appearance. For more detailed customization, please refer to the plugin option reference.

Licensing

By default, the plugin operates in demo mode, which, while fully functional, adds a watermark and Pdfcrowd branding to the content.

To remove the demo watermark and Pdfcrowd branding, you can purchase an API license. Activate the license by entering your Pdfcrowd username and API key in the plugin settings under the License tab.

A Pdfcrowd API license is versatile, allowing use across multiple WordPress websites for our plugins. Additionally, the API license grants direct access to the Pdfcrowd API for a broader range of applications.

Basic Troubleshooting

If the default plugin output does not meet your requirements, consider adjusting the following settings individually. You may need to activate the “Expert Settings” option to access some of these features.

• Mode > Conversion Mode: Try switching it to either “Upload” or “Content”.
• Image Output > Screenshot Width: Experiment with different widths to see which yields the best result.

Support

Please contact us or write to [email protected] if you need any help. We will be happy to assist you with configuring the plugin to ensure its output meets your needs.

Plugin links:

• Guide
• Option Reference
• FAQ

About us

The plugin is provided by Pdfcrowd, established in 2009 as a pioneer in the field of online conversion services. Over the years, we have served hundreds of thousands of users worldwide, constantly evolving our technology to meet the needs of our customers.

Installation

1. Upload Plugin: Download the “Save as Image” plugin ZIP file. In your WordPress dashboard, navigate to 'Plugins > Add New > Upload Plugin'. Choose the ZIP file you downloaded and click 'Install Now'.
2. Activate Plugin: After the installation is complete, click Activate Plugin to start using “Save as Image” on your site.
3. Configure Settings: Go to the “Save as Image” settings page to customize the button’s appearance and functionality according to your preference.

FAQ

How can I activate the license?

1. Purchase an API license plan that matches your usage level.
2. Activate the license by entering your Pdfcrowd username and API key in the “License” tab of the plugin settings.

How does the plugin work?

The plugin operates by leveraging the Pdfcrowd HTML to Image API, a service that runs entirely in the cloud. This means that when you use the plugin to capture a web page into an image screenshot, the conversion process is handled on Pdfcrowd’s servers, not on your server or device. This approach has several benefits:

• Performance: Offloading the conversion process to the cloud means that it doesn’t consume your server’s resources, ensuring your website’s performance remains unaffected.
• Scalability: Cloud-based conversion can easily handle spikes in demand without any degradation in service, making it ideal for websites of any size.
• Reliability: Pdfcrowd’s servers are optimized for high availability and reliability, ensuring your conversion needs are met with consistent quality.

In essence, the plugin sends a request to the Pdfcrowd API with either the URL or the HTML content of the page you wish to convert. The API then processes this request, captures the page content as an image screenshot, and returns the image file. This streamlined, cloud-based approach makes adding screenshot capturing functionality to your WordPress site both efficient and effective.

Where can I find more information about the plugin?

• Guide: Provides basic information about the plugin.
• Option Reference: Offers a detailed reference for plugin options, including examples.
• FAQ – An extensive plugin FAQ is available on our website.
• Contact Us – If you need any assistance, we’re here to help!

Reviews

The demo is not free as it looks

Adrian Reich September 18, 2022

After some day installation and figure out how we can use this plugin to make a picture out of a section, the following error comes up. Pdfcrowd API Error 432 Exceeded the limit for demo license. Use the regular API license. The limit for the demo license has been exceeded. Use your personal Pdfcrowd API credentials. Tomorrow we wanted to go live with our website. So now we need another solution, cause the cost for this paid version is to expesive.

Contributors & Developers

Changelog

4.3.0

• New “Converter User Agent” option.
• Minor improvement when a Conversion Mode other than URL is used.

4.2.2

• Fix XSS in the plugin settings.

4.2.1

• Fix Content Viewport Width and Content Viewport Height accepts a numeric value followed by the “px” unit to specify pixels.

4.2.0

• The “Conversion Config” JSON supports odd, even, and last for page definition.
• The “Print Page Range” option supports odd, even, and last for page selection.

4.1.0

• New “Conversion Config” option to define a custom page properties for each page by JSON.
• New “Conversion Config File” option to define a filepath for a conversion config JSON.

4.0.1

• Fix XSS in the plugin settings.

4.0.0

• New converter 24.04 is used by default for new installations. For existing installations, the selected converter is preserved. The upgrade can be performed using the “Auto-upgrade” button in the plugin settings or by manually setting the “Converter Version” option to “24.04.”
• New “Content Viewport Width” option as a replacement for the “Rendering Mode” and “Viewport Width” options for converter 24.04.
• New “Content Viewport Height” option as a replacement for the “Viewport Height” option for converter 24.04.
• New “Content Fit Mode” option as a replacement for the “Smart Scaling Mode” option for converter 24.04.
• New value “all” for the “Remove Blank Pages” option.

3.4.0

• New value “24.04” for the “Converter Version” option allows you to try a beta version of the new converter.

3.3.1

• Minor: Added a link to instructions for resolving an issue with the API license in the plugin settings.

3.3.0

• New: Show the API license error on the plugins dashboard and in the plugin details if this error occurs.
• Fix an issue with entering invalid HTML into the button style options.

3.2.3

• Fix an issue when the error in a plugin option is displayed.
• Updated the readme file.

3.2.2

• Fix an issue with entering invalid HTML into the textarea plugin options.

3.2.1

• Fix XSS in the button preview in the plugin settings.

3.2.0

• Fix XSS in the Custom HTML options of the plugin settings.
• Fix warning in the debug log in case of error.

3.1.0

• New “Max Loading Time” expert option to set the load time for the page and its assets.

3.0.1

• Minor update in the plugin documentation.

3.0.0

• Revamped the plugin settings page, now featuring Basic and Expert modes.
• Added controls to filter options and display only the changed ones.
• Added notification of unsaved changes.

2.17.0

• New “Error Page” option to define custom error page.

2.16.1

• Fix XSS on the Appearance section of the plugin settings.

2.16.0

• New “Custom CSS” option to apply custom CSS to the input HTML document.

2.15.1

• Fix the image callback function can access email_to field.
• Fix deprecation warnings for PHP 8.2.7.

2.15.0

• New “Remove Blank Pages” option to choose which empty pages should be removed from the output PDF.

2.14.1

• Retry conversion on error 503.
• Deprecated string interpolation in PHP code was replaced.

2.14.0

• Removed deprecated options “Auto Use Cookies” and “Use HTTP”.

2.13.0

• New “The whole HTML contents fits the print area of a single page with respect to the page height/width ratio.” mode for “Smart Scaling Mode” option.

2.12.0

• New “readability-v4” mode for “Readability Enhancements” option.
• Minor text update in plugin settings.

2.11.0

• Update: Images can be used as a watermark and a background in Save as PDF plugin.
• New: added “email_to” record to $data[‘options’] argument of Image Created Callback
• Minor Update: text in plugin settings.

2.10.0

• New “readability-v2” and “readability-v3” modes for “Readability Enhancements” option.
• Minor text update in plugin settings.

2.9.4

• Minor update of documentation links.

2.9.3

• Minor update of the text of the error message.

2.9.2

• Minor text update in plugin settings.

2.9.1

• Fix: Auto Use Cookies option is applied to Conversion Mode Content.
• Fix: Use Mobile User Agent option is applied to Conversion Mode Upload.

2.9.0

• New “Enable PDF Forms” option to convert HTML forms to fillable PDF forms.
• Minor update in error messages.

2.8.1

• Improved: Automatic conversion retry on HTTP status codes 429 and 430.

2.8.0

• New “Auto Detect Element To Convert” option to detect the main contents automatically.
• New “Readability Enhancements” option to emphasize the main contents.
• New “pdfcrowd-source-title” CSS class available for header and footer HTML.
• Minor documentation updates.

2.7.1

• Minor update – error messages added for status code 432 and 483.

2.7.0

• New “Use Mobile User Agent” option to use a mobile user agent for the conversion.

2.6.2

• Minor fix – the hyperlinks to the Pdfcrowd API documentation have been updated.

2.6.1

• Minor update in links to the documentation.

2.6.0

• New “URL Lookup” option. It allows to choose how to retrieve URLs for the Conversion Mode-URL.
• New “Diagnostics” option. It allows a developer to print some useful data.
• Minor fix and text updates in plugin settings.

2.5.1

• Fix of the plugin options saving.

2.5.0

• New “Indicator Timeout” option to set the maximum time the conversion indicator is displayed.
• Minor fix in the indicator code.

2.4.1

• “HTTP Auth User Name”, “HTTP Auth Password”, “Cookies”, “Fail On Main URL Error” and “Fail On Any URL Error” options are applied for “Conversion Mode – Upload” too.
• Fixes multiple line warning.
• Minor code cleanup.

2.4.0

• Set the default value of “Conversion Mode” to “URL”.
• “Hide parameters” button added in plugin admin settings.

2.3.0

• New “Email From” option.
• The default value of “Conversion Mode” is “URL”.
• The “Conversion Mode” and “Automatically use cookies” options have been moved to a new “Mode” settings category.

2.2.1

• Predefined header and footer are available in plugin settings.
• Minor documentation and error message changes.

2.2.0

• New “Email Cc” option.
• New “Email Bcc” option.
• New “Button Id” option.
• New “Hide Button in HTML” option.
• Fixes in email button disposition.

2.1.1

• New configuration wizard.

2.1.0

• New “User-Created Drawings” option for the “Content” conversion mode. It helps to capture user-created canvas drawings.
• New “Output Name” option – specifies the output filename directly in plugin settings. It can still be rewritten with a shortcode or PHP function.
• Fixed UTF-8 output filename for MS Edge.
• Fixed error in “Send the image via e-mail”

2.0.0

• New “Converter Version” option – specifies the version of the internal Pdfcrowd converter. Details about Pdfcrowd versioning.
• New “Load Iframes” option – specifies how iframes are handled.
• New “Locale” option – specifies the locale for conversions.
• New value “Send the image via e-mail” added to the “Button Click Action” options. It sends the output file via customized e-mail using these settings:
  • Email Recipient
  • Email Subject
  • Email Message
  • Email Dialogs
• New “Background Color” option – sets an RGBA background color.
  • “Main Document Css Annotation” – adds special CSS classes into header/footer for page number detection.
• New value “inline” for the button position – it is useful for placing the button inside a text.
• More detailed debug log information.
• Improved the plugin localization.

1.11.0

• New “Button Text Translation” option – allows to use translation for the button text.

1.10.0

• New “Change on Mouse Over” option – highlights the button when the mouse pointer is hovering over it.
• Fixed issue with external link to plugin settings section.

1.9.1

• Fixed issue with missing assets in the plugin setup.

1.9.0

• New “Conversion in Progress Indicator” option – a customizable visual indicator is shown when the conversion is in progress.
• Fixed issue with the button appearence in MS Edge.

1.8.1

• Improved the converted page URL detection.

1.8.0

• Fixed the issue with the converted page URL when some third party WP plugins are used.

1.7.0

• New value “open the image in a new browser tab” for the “Button Click Action” option.
• Minor change of descriptions for values in the “Button Click Action” option.

1.6.0

• Added support for parameters in the page URL.
• Added support for missing protocol in links.
• Added function pdfcrowd_save_as_image($options). It’s useful for acccessing Pdfcrowd API directly.

1.5.0

• Added HTML template rendering with custom JSON, XML, YAML and CSV data.

1.4.1

• Button to reset settings to default values was added to plugin settings page.
• Fix demo license usage.

1.4.0

• Added a convertion mode “content” to convert the current HTML contents shown in the browser.
• Minified JavaScript files for faster page load.

1.3.0

• Added an option to convert local file by the shortcode or the function call.
• Fix of multiline shortcode parameters.

1.2.2

• Refactor description in plugin settings.
• Added a flag describing the button creation mode.

1.2.1

• Fix of conversion auto mode.

1.2.0

• New value “auto” for the Conversion Mode.
• New option “Auto Use Cookies” for an automatic use of the current cookies for the conversion.
• Avoid double-click on the conversion button.
• Better error message for error code 452.

1.1.0

• New option “Custom HTML” which allows to specify custom HTML for the conversion button.
• New option “Image Created Callback” which allows to manipulate with the output file.
• New option “Conversion Mode”. The “Run in DEV Mode” option was removed, you can use the “Conversion Mode” values “url” or “development” instead.
• New options: Page Watermark Url, Multipage Watermark Url, Page Background Url, Multipage Background Url.
• Improved conversion of password-protected pages.
• Admin settings reordered.

1.0.1

• Fixed issue with missing input when create_save_as_image_pdfcrowd_button is used.

1.0.0

• Initial version