Press This (發佈至網站)

外掛說明

[發佈至網站] 書籤小工具能夠輕鬆擷取網頁內容並建立新文章，它還提供選擇頁面上圖片或影片的功能，以便在文章中使用。使用 [發佈至網站] 書籤小工具，就能夠以快速簡便的方式摘錄網路上其他頁面的內容。

2.0 版開始支援區塊編輯器

Press This 2.0 為書籤小工具彈出式訊息導入了新式 WordPress 區塊編輯器體驗，使用者現在可以使用 [段落]、[標題]、[圖片]、[引文]、[清單] 及 [嵌入內容] 等熟習的區塊撰寫文章。

全新功能：

• 區塊編輯器：完整的區塊編輯器整合，提供一致的 WordPress 編輯體驗
• 智慧型文章格式建議：依據內容自動建議視訊、引文或連結等文章格式
• 經過強化的內容擷取：使用支援 JSON-LD 結構資料的加強式擷取
• 僅用戶端擷取：全部內容擷取僅會在使用者瀏覽器中進行，以便獲得更好的隱私權及安全性
• 支援精選圖片：可將擷取內容中的任何圖片設定為文章的精選圖片
• 改進的媒體格狀排列：對嵌入內容中支援的視訊及音訊提供更好的縮圖顯示

開發者需要了解的篩選器

Press This 2.0 用於自訂的全新篩選器：

• press_this_allowed_blocks：自訂編輯器中可用的區塊
• press_this_post_format_suggestion：修改自動建議的文章格式

參閱下方的〈開發者說明文件〉以進一步了解。

為外掛貢獻心力

如需提報程式碼錯誤及提取要求，請前往這個外掛的 GitHub 存放庫。

開發者說明文件

2.0 版中的全新勾點及篩選器

press_this_allowed_blocks

在 Press This 編輯器中自訂可用哪些區塊。

add_filter( 'press_this_allowed_blocks', function( $blocks ) {
    // Add the gallery block
    $blocks[] = 'core/gallery';

    // Remove the embed block
    $blocks = array_filter( $blocks, function( $block ) {
        return $block !== 'core/embed';
    } );

    return $blocks;
} );

預設區塊：core/paragraph、core/heading、core/image、core/quote、core/list、core/list-item 及 core/embed

press_this_post_format_suggestion

修改或覆寫依據內容自動建議的文章格式。

add_filter( 'press_this_post_format_suggestion', function( $suggested_format, $data ) {
    // If the URL contains 'podcast', suggest audio format
    if ( ! empty( $data['u'] ) && strpos( $data['u'], 'podcast' ) !== false ) {
        return 'audio';
    }

    return $suggested_format;
}, 10, 2 );

$data 陣列所擷取的內容包含下列項目：
– u：來源網址
– s：選取的文字
– t：頁面標題
– _images：圖片網址陣列
– _embeds：嵌入內容網址陣列
– _meta：中繼資料標籤資料
– _jsonld：JSON-LD 結構化資料

保留自之前 1.x 版中的勾點

現有可繼續使用的全部勾點：

• press_this_redirect_in_parent：控制文章儲存重新導向行為
• press_this_save_post：儲存前篩選文章資料
• press_this_save_redirect：儲存後篩選重新導向網址
• enable_press_this_media_discovery：開啟/關閉媒體擷取
• press_this_data：篩選完整擷取的資料陣列
• press_this_suggested_html：篩選預設內容範本
• shortcut_link：自訂書籤小工具網址

外掛開發源由

WordPress 從相當早期的版本開始，就提供了擷取其他網站內容片段供網站作者發佈新文章的方式。

在 WordPress 2.5 版移除舊版的 [發佈至網誌] 功能後，隨即在 WordPress 2.6 版加入新版的 [發佈至網誌] 功能。一直到 WordPress 4.2 版這個重大更新前，這個功能幾乎沒有任何改進。

從 WordPress 4.9 版起，[發佈至網站] 成為一個正規外掛，即 WordPress.org 的官方外掛。所有的網站都可以安裝及使用這個外掛，同時也簡化了 WordPress 核心之外的重要功能，就如同之前完成的各個匯入程式一樣。

Press This 2.0 已改用新式的區塊編輯器，以便與 WordPress 新式編輯體驗保持一致，同時與外掛過去產生的項目保持回溯相容性。