Browser Screenshots

外掛說明

使用 [browser-shot] 短代碼便能自動完成擷取網站螢幕擷圖的程序。如果使用的是 TinyMCE 編輯器 (傳統編輯器),會在編輯器工具列上顯示對應圖示按鈕,簡化使用短代碼建立螢幕擷圖的程序。

這個外掛使用 WordPress.com 的 mshots 功能,它能自動擷取網站的螢幕擷圖。這個功能可免費使用於非商業用途。

擷取的網站螢幕擷圖會儲存於 WordPress.com,而不會儲存於使用這個外掛的網站。在再次產生網站螢幕擷圖前,現有的螢幕擷圖會快取保留大約 24 個小時。

短代碼使用範例

// basic shot 600px wide
[browser-shot url="http://link-to-website" width="600"]

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

// shot with caption (uses default WordPress caption styles)
[browser-shot url="http://link-to-website" width="700"]Add Caption[/browser-shot]

可用參數

  • url (必要參數):擷取螢幕擷圖的目標網址。
  • width:螢幕擷圖圖片寬度。
  • height:螢幕擷圖圖片高度。
  • alt:螢幕擷圖圖片替代文字。
  • link:螢幕擷圖圖片連結。如不設定這項參數,螢幕擷圖圖片會連結至擷取螢幕擷圖的網站網址。
  • target:連結開啟方式。設定為 _blank 便會在新視窗開啟連結。
  • class:為 browsershots 新增包裝函式類別。
  • image_class:將 browsershots 圖片類別從預設的 alignnone 變更為自選類別。
  • display_link:參數值為 truefalse,預設值為 true,用於在螢幕擷圖中顯示連結。
  • post_links:參數值為 truefalse,預設值為 false,用於將螢幕擷圖連結至文章的永久連結。

使用程式碼產生螢幕擷圖

使用外掛提供的 BrowserShots::get_shot 方法,便可以在佈景主題中使用這個外掛建立網站螢幕擷圖。

程式碼片段範例:

<img src="<?php echo BrowserShots::get_shot( 'https://prothemedesign.com', 600, 450 ); ?>" />

請注意,如果要達成這個目的,必須安裝外掛並完成啟用。

get_shot 方法有 3 個參數:

  1. url
  2. width
  3. height

短代碼的其他參數,可以在外掛輸出 HTML 程式碼時手動輸入。

多站網路相容性

Browser Shots 與 WordPress 多站網路相容,請使用 [於多站網路中啟用] 功能為全部網站啟用外掛的短代碼。如果僅需要為特定的網站啟用外掛短代碼,請在個別網站啟用外掛。

相關資訊

  • 如需取得外掛程式碼,可以前往 GitHub 存放庫取得。
  • 如果有任何使用上的問題,請前往 Twitter 詢問。

螢幕擷圖

  • 區塊編輯器/Gutenberg 區塊
  • 外掛搭配 WordPress TinyMCE 傳統編輯器的使用方式
  • 外掛產生的螢幕擷圖在網站前端的格式化檢視

適用於區塊編輯器

這個外掛提供 1 個可供 Gutenberg/區塊編輯器使用的區塊。

  • Browser Shots

安裝方式

  1. 在 WordPress 管理後台的 [外掛] 頁面自動安裝,或下載外掛安裝套件並解壓縮檔案,將解壓縮所得的 browser-shots 資料夾及其全部檔案上傳至 /wp-content/plugins/ 目錄。
  2. 在 WordPress 管理後台的 [外掛] 選單中啟用外掛。

使用者評論

2021 年 1 月 27 日
Awesome plugin, ideal for automatic websites. Using the php manual implementation combined with custom fields is amazing and saves a ton of time.
2019 年 6 月 12 日
I would like to thank everyone involved for the great work. The fast response time and the helpful support are unique. The adaptation to my special wishes saved me weeks of working time. Thank you very much for that.
2019 年 6 月 11 日
I love this plugin. I used to use ShrinkTheWeb but the support was rubbish and it was costing me $5 per month. This is so much more customisable. I can change the sizes, put in backgrounds, add captions and links. So pleased I found this plugin it works great on my site.
2019 年 6 月 9 日
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.
閱讀全部 16 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈Browser Screenshots〉的開發相關工作。

參與者

Browser Screenshots 外掛目前已有 6 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將 Browser Screenshots 外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

1.7.6 – 18th June 2021

  • Fix possible XSS vulnerability as reported by WPScan.

1.7.5 – 27th January 2021

  • Fix variable comparison that could cause errors in some situations.
  • Add missing text domain for translations.

1.7.4 – 15th July 2019

  • Add a $shortcode parameter to the shortcode_atts function call so that the shortcode properties can be filtered.
  • Added option to allow screenshot to link to the post’s URL.
  • Make get_shots static so it can be used outside of the shortcode/ gutenberg block.

1.7.3 – 12th June 2019

  • Add PERMALINK as a link property. If you set the link url to PERMALINK then the url will point to the currrent page or post.
  • Improve the default alt text. Previously it would display the url for the screenshot, but this could be messy, and is not actually useful. Now displays “Screenshot from domain-name”.

1.7.2 – 11th June 2019

  • Ensuring display_link is a boolean in the shortcode.
  • Code formatting and cleanup.

1.7.1 – 11th June 2019

  • Add a new parameter display_link that allows you to disable the link around the screenshot. Defaults to true. Set to false to remove the link.
  • Add some placeholder text to the input fields to make it clearer what is expected.
  • Change the rel link property to a toggle for one click changes.

1.7 – 8th June 2019

  • Add Gutenberg block for including Browser Shots.
  • Fix image alignment so that it works properly :).

1.6 – 30th May 2019

  • Add rel property to shortcode so that links can include rel=”nofollow” or similar.
  • Fix output of target attribute.
  • Tidy codes.

1.5.2 – 7th January 2017

  • Improve output html to reduce likelihood of html being modified by a plugin
  • Swap urlencode for rawurlencode
  • Switch to yoda conditions

1.5.1

  • add two new class properties. One for the container, one for the image
  • lots of code tidying, and refactoring. Simpler, faster, and more secure
  • new tinymce icon that fits the style of the editor much better 🙂

1.5

  • update localisation strings so that things can be translated more easily

1.4

  • Update the website screen capture path. This ensures the code will work properly on secure domains
  • Add some additional value escaping for extra security

1.3.2

  • Fix a couple of small javascript bugs (thanks again to Ciprian Dracea)

1.3.1

  • Fix a couple of small bugs with the visual editor and add support for all shortcode parameters

1.3

  • Make the visual editor work again (thanks to Ciprian Dracea for the report and the code help!)
  • add a new pop up box for the shortcode properties in visual editor mode

1.2

  • Add ‘link’ attribute. Allows you to change the url that the screenshot links to
  • Sanitize the height attribute and fix a small height related PHP error
  • Add support for captions
  • Add target attribute for opening links in new windows

1.1

  • Add ‘height’ attribute to the TinyMCE prompts
  • Allow users to override ‘height’ attribute in [browser-shot] shortcode

1.0

  • Initial public release to the WordPress plugin repository