mirgcire

stianlik

<p>This plugin hooks into the media manager and generates a thumbnail everytime a<br />
PDF is uploaded. Generated thumbnail is an image of the first page in the<br />
uploaded document and is named <code>PDFNAME-thumbnail</code>, where <code>PDFNAME</code> is replaced<br />
by uploaded document filename.</p>
<p>Generated thumbnails are equivalent to <a href="https://codex.wordpress.org/Post_Thumbnails" rel="nofollow ugc">featured<br />
images</a> so that common thumbnail<br />
functions like <code>get_post_thumbnail_id()</code> can be used for PDF attachments. See<br />
<a href="https://codex.wordpress.org/Post_Thumbnails" rel="nofollow ugc">Post Thumbnails</a> for information<br />
on how you can use thumbnails efficiently.</p>
<p>Integration with the javascript media API is not yet implemented, therefore, you<br />
may need to reload the page before you can see generated thumbnail after an<br />
upload.</p>
<h4>Shortcodes</h4>
<p>It is possible to display a thumbnail linking to an uploaded PDF using the <code>[pdf_thumbnails_link]</code><br />
shortcode. The following attributes are supported:</p>
<ul>
<li><code>id</code> – Attachment ID (required)</li>
<li><code>size</code> – <a href="https://codex.wordpress.org/Post_Thumbnails#Thumbnail_Sizes" rel="nofollow ugc">Thumbnail size</a> (optional)</li>
<li><code>title</code> – <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#attr-title" rel="nofollow ugc">Anchor title attribute</a> (optional)</li>
<li><code>target</code> – <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-target" rel="nofollow ugc">Anchor target attribute</a> (optional)</li>
<li><code>download</code> – <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-download" rel="nofollow ugc">Anchor download attribute</a> (optional)</li>
</ul>
<p>Example 1: Display link to PDF with ID = 172 using <a href="https://codex.wordpress.org/Post_Thumbnails#Thumbnail_Sizes" rel="nofollow ugc">default thumbnail size</a></p>
<pre><code>[pdf_thumbnails_link id="172"]
</code></pre>
<p>Example 2: Display link to PDF with ID = 172 using thumbnail size (default 150×150)</p>
<pre><code>[pdf_thumbnails_link id="172" size="thumbnail"]
</code></pre>
<p>Thanks to <a href="https://wordpress.org/support/profile/mirgcire" rel="ugc">mirgcire</a> for providing the first<br />
version of the <code>[pdf_thumbnails_link]</code> shortcode.</p>
<h4>Developer API</h4>
<p>In most cases it should be sufficient to use built-in thumbnail functions from<br />
the WordPress API (<code>get_post_thumbnail</code> and similar). If you need to modify the<br />
way thumbnails are generated, you can override image generation with<br />
the <code>pdf_thumbnails_generate_image_blob</code> filter.</p>
<p>Example 1: Increase resolution for all generated PDF thumbnails</p>
<pre><code>// $blob is the current image blob (defaults to null, can be used for chaining)
// $filename is the PDF filename
add_action('pdf_thumbnails_generate_image_blob', function ($blob, $filename) {
    $imagick = new Imagick();
    $imagick->setResolution(200,200);
    $imagick->readImage($filename);
    $imagick->setIteratorIndex(0);
    $imagick->setImageFormat('jpg');
    return $imagick->getImageBlob();
}, 10, 2);
</code></pre>
<p>It is possible to modify generated thumbnail links using the <code>pdf_thumbnails_link_shortcode</code><br />
filter. The following attributes are available:</p>
<ul>
<li><code>$html</code> – Generated HTML code to be displayed</li>
<li><code>$attachmentId</code> – Sanitized ID of the PDF attachment</li>
<li><code>$size</code> – Sanitized thumbnail size</li>
<li><code>$atts</code> – <a href="https://codex.wordpress.org/Shortcode_API#Handling_Attributes" rel="nofollow ugc">Shortcode attributes (not sanitized)</a></li>
<li><code>$content</code> – Shortcode content (not sanitized)</li>
</ul>
<p>Example 2: Wrap thumbnail link in figure and append caption</p>
<pre><code>add_filter('pdf_thumbnails_link_shortcode', function ($html, $attachmentId, $size, $atts, $content) {
    return "<figure>$html <caption>Click to open image $attachmentId</caption></figure>";
}, 10, 5);
</code></pre>
<h3>TODO</h3>
<p>Add generated image to media browser after upload.</p>
<p>Outline of an implementation based on the javascript media API:</p>
<pre><code>// New uploads
wp.Uploader.queue.on('add', function (attachment) {

    if (attachment.subtype !== 'pdf') {
        return;
    }

    findThumbnailFor(attachment.ID).then(function (data) {

        // Add attachment thumbnail to browser
        var attachment = wp.media.model.Attachment.get(id)
        attachment.fetch().done(function () {
            wp.media.editor.open().state().get('library').add(generated attachment)
        });

    });
});
</code></pre>
<p>Filter: ajax_query_attachments_args</p>


PDF Thumbnails

The plugin does just what it says and the author is very helpful.  My only suggestion would be to add a short code that would insert a clickable thumbnail into a webpage.  Clicking on that would open the PDF in a viewer.
For example: [pdf-thumbnail id="1234" size="medium"]
... naturally this functionality would require host support for imagick.



Nice Job

Works just like it should. Can't believe this functionality isn't in the WP core. Thanks!

Excellent

This plugin generates a thumbnail everytime you upload a PDF attachment. Generated thumbnail is an image of the first page in uploaded document.

Ronald Huereca

binarymoon

Kevin Leary

<p>Use the <code>[browser-shot]</code> shortcode to automate the process of taking website screenshots. An icon is also added to the TinyMCE editor to make the shortcode creation process easy.</p>
<p>The plugin uses the ‘mshots’ functionality, from WordPress.com, to automatically take screenshots of websites. This function is free for non-commercial use.</p>
<p>The images are stored on the wordpress.com servers and are not saved onto your own website. The images are cached for roughly 24 hours before being generated again.</p>
<h4>Shortcode Preview</h4>
<pre><code>// basic shot 600px wide
[browser-shot url="https://link-to-website" width="600"]

// shot with link to other website
[browser-shot url="https://link-to-website" width="700" link="https://www.binarymoon.co.uk/"]

// shot with caption (uses default WordPress caption styles)
[browser-shot url="https://link-to-website" width="700"]Add Caption[/browser-shot]
</code></pre>
<h4>Available Parameters</h4>
<ul>
<li>url (required) – the url of the link to shorten</li>
<li>width – the width of the image</li>
<li>height – the height of the image</li>
<li>alt – the image alt text</li>
<li>link – where the image links. Left blank it will point to the website where the screenshot is being taken</li>
<li>target – browser target. Set to _blank to open in a new window</li>
<li>class – add a class to the browsershots wrapper</li>
<li>image_class – change the default browsershots image class from alignnone to your chosen class</li>
<li>display_link (true or false – default true) to display a link in your screenshot</li>
<li>post_links (true or false – default false) to link to the permalink of the post the screenshot is on</li>
</ul>
<h4>Generating Screenshots with code</h4>
<p>If you want to create screenshots in a theme using this plugin then you can do so using the <code>BrowserShots::get_shot</code> method.</p>
<p>For example:</p>
<pre><code><img src="<?php echo BrowserShots::get_shot( 'https://prothemedesign.com', 600, 450 ); ?>" />
</code></pre>
<p>Keep in mind that the plugin must be installed and activated for this to work.</p>
<p>The get_shot method has 3 parameters.</p>
<ol>
<li>The url.</li>
<li>The width.</li>
<li>The height.</li>
</ol>
<p>The other parameters, from the shotcode, can be implemented manually when outputting the html.</p>
<h4>Multisite Compatibility</h4>
<p>The <em>Browser Shots</em> plugin is compatibly with WordPress Multisite, just use the <a href="https://codex.wordpress.org/Create_A_Network#WordPress_Plugins" rel="nofollow ugc">Network Activate</a> feature to enable the shortcode on every site. If you only want to enable the shortcode for a specific site, activate the plugin for that site only.</p>
<h4>More…</h4>
<ul>
<li>The code can be found on <a href="https://github.com/BinaryMoon/browser-shots" rel="nofollow ugc">Github</a></li>
<li>You can reach out to me with questions or problems on <a href="https://twitter.com/binarymoon" rel="nofollow ugc">Twitter</a></li>
</ul>


Browser Screenshots

I was recently blessed to help contribute a Gutenberg block to Browser Shots. The shortcode, and now the block, are amazing additions.

Thanks, Ben, for this great plugin. 

Browser Shots is Amazing

Automate the process of taking website screenshots.

PDF Thumbnails vs Browser Screenshots