Code Snippets

外掛說明

✂ Code Snippets 提供能輕鬆加增強 WordPress 網站的方式。

🚀 升級至 Code Snippets Pro便能使用完整 CSS、JavaScript、區塊編輯器、Elementor 及雲端同步整合供能。立即提升程式碼片段的使用體驗

告別修改佈景主題的 functions.php 檔案及下載無數外掛的日子,Code Snippets 可以大幅簡化這個流程。

程式碼片段可視為 WordPress 網站的迷你外掛,可以提供額外的功能,卻不會導致雜亂無章。

與其他能將程式碼加入網站的 functions.php 檔案的解決方案不同,Code Snippets 提供直覺式的圖形使用者介面,可以無縫整合並即時執行。管理程式碼片段就跟啟用、停用外掛一樣簡單,而且不會像外掛般體積龐大並耗損大量效能。

🎥 觀看 Imran Siddiq 所製作的快速概觀影片:

☁️ Code Snippets 每一份使用授權,都與社群導向 Code Snippets Cloud 平台完全整合,可輕鬆存取大量可立即調整及加強 WordPress 網站的程式碼片段。

🌐 聯絡方式

🌟 如果喜歡這個外掛,或外掛對網站確實有幫助,請在 WordPress.org 為它進行評等。使用者意見反應對我們將來的發展相當重要。

🌍 我們十分感激那些貢獻出色本地化譯文的社群成員,他們讓 Code Snippets 能夠提供不同的語言介面。本地化貢獻人員完整清單

螢幕擷圖

  • 管理現有的程式碼片段
  • 新增程式碼片段
  • 編輯程式碼片段
  • 從匯出檔匯入程式碼片段

安裝方式

自動安裝

  1. 登入 WordPress 網站管理後台
  2. 點擊 [外掛]
  3. 點擊 [安裝外掛]
  4. 搜尋「Code Snippets」
  5. 點擊 Code Snippets 外掛中的 [立即安裝]
  6. 啟用外掛

手動安裝

  1. 下載外掛安裝套件 ZIP 壓縮檔
  2. 解壓縮外掛的 ZIP 壓縮檔
  3. 將解壓縮外掛的 ZIP 壓縮檔所得的 code-snippets 資料夾上傳至 WordPress 網站的 wp-content/plugins/ 目錄
  4. 在 [外掛] 頁面中啟用 Code Snippets 外掛

在多站網路控制台中為多站網路啟用 Code Snippets 外掛,會顯示一個特殊介面,用於標示執行於整個多站網路的程式碼片段。

常見問題集

請參考 help.codesnippets.pro 以取得常見問題集的完整清單。

在執行有程式碼錯誤的程式碼片段導致網站無法正常執行後,如何復原網站?

網站管理員可以啟用 Code Snippets 的安全模式以復原網站。請參考 https://help.codesnippets.pro/article/12-safe-mode 以了解啟用安全模式的方式。

如果變更佈景主題或升級 WordPress,現有的程式碼片段是否會失效?

不會。在這個外掛中輸入的程式碼片段,均會儲存於資料庫中,既獨立於佈景主題之外,也不受 WordPress 更新的影響。

這個外掛是否能完整解除安裝?

如果在外掛的設定頁面中啟用 [完整解除安裝] 設定,在 WordPress 的 [外掛] 選單中刪除 Code Snippets 時,並會清除全部資料。請注意,這項設定會清除包含儲存於資料庫中的程式碼片段的全部資料。如需保留之前建立的程式碼片段,請先執行匯出程序。

是否能使用已為其他 WordPress 網站建立的程式碼片段?

可以。在 [全部程式碼片段] 頁面中,網站管理員可以使用程式碼片段名稱下方的 [匯出] 連結匯出個別程式碼片段,或是使用 [批次操作] 功能批次匯出多個程式碼片段。已匯出的程式碼片段稍後可以在其他網站透過 [匯入程式碼片段] 頁面,上傳程式碼片段檔案並匯入。

能將現有的程式碼片段匯出為 PHP 程式碼,以供未採用 Code Snippets 外掛的網站使用嗎?

可以。點擊想要匯出的程式碼片段旁的核取方塊,然後從 [批次操作] 選單中選取 [匯出為 PHP] 並點擊 [套用],這項操作產生的 PHP 檔案會包含匯出的程式碼片段,以及名稱及內容說明。

能為多站網路中的全部網路執行同一份程式碼片段嗎?

在多站網路控制台中,可以透過多站網路啟用功能將某份程式碼片段啟用於多站網路中的全部網站;多站網路管理員能將 Code Snippets 外掛啟用於全部網站,也能在個別網站啟用外掛。

程式碼片段都儲存在 WordPress 網站資料庫的哪個位置?

程式碼片段儲存於 WordPress 網站資料庫的 wp_snippets 資料表中。請注意,這個資料表的名稱實際上可能略有不同,主要取決於安裝網站時的資料表前置詞設定。

在何處可以提出新功能建議?

請在 Code Snippets 外掛的 WordPress 技術支援論壇GitHub 存放庫回報程式碼錯誤、新功能建議及改進意見。

如何參與 Code Snippets 外掛的開發?

先感謝你有這樣的意願。每個人都可以為外掛的 GitHub 存放庫進行版本分支,並提出提取要求。

發現外掛的安全性程式碼錯誤,該在何處回報?

使用者可以透過 Patchstack 漏洞揭露計畫回報在外掛原始程式碼中發現的任何安全性程式碼錯誤。Patchstack 團隊會協助使用者進行驗證及 CVE 指派,並負責通知外掛的開發者。

使用者評論

2024 年 9 月 11 日
Having worked with these guys on helping them discover the advantages of AI and now using Code Snippets extensively across all my agency websites. I have to say, What a team! I’ve just noticed that they have exceeded 1 million active installs – just wow! As a plugin owner myself that is no small achievement and instills a sense of trust and honestly, a little envy. It’s not easy running a plugin business and these guys do it standing on their head. Onwards and upwards helping people use less and less small plugin solutions to help speed up website development across the board. #Kudos
2024 年 9 月 10 日
Calling Code Snippets essential doesn’t quite capture its impact. It’s truly a cornerstone of our workflow. Say goodbye to plugins and hello to snippets. As you advance with WordPress, you’ll discover the platform’s incredible flexibility, especially when paired with Code Snippets. Make the web yours.
2024 年 9 月 10 日
Code Snippers is literally the first plugin we install when building websites. From keeping things clean like CSS, Functions and creating shortcodes easily… its a foundation that only makes the Wordpress ecosystem a thousand times better.
2024 年 8 月 16 日 2 則留言
Update broke site. A quick search shows that it did this for MANY other people as well. It doesn’t appear any efforts have been made to fix the issue despite dozens of people reporting it. A major issue like this going unaddressed for a year and not even noted on the download page is troubling. I would recommend using a different plugin.
閱讀全部 448 則使用者評論

參與者及開發者

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

參與者

〈Code Snippets〉外掛目前已有 23 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈Code Snippets〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

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

變更記錄

3.6.5 (24 May 2024)

  • Added: New admin menu providing useful resources and updates on the Code Snippets plugin and community.

3.6.4 (15 Mar 2024)

  • Fixed: Minor type compatability issue with newer versions of PHP.
  • Improvement: Increment the revision number of CSS and JS snippet when using the ‘Reset Caches’ debug action. (PRO)
  • Fixed: Undefined array key issue when initiating cloud sync. (PRO)
  • Fixed: Bug preventing downloading a single snippet from a bundle. (PRO)
  • Added: AI generation for all snippet types: HTML, CSS, JS. (PRO)
  • Fixed: Translations not loading for strings in JavaScript files.
  • Improved: UX in generate dialog, such as allowing ‘Enter’ to submit the form. (PRO)
  • Added: Button to create a cloud connection directly from the Snippets menu when disconnected. (PRO)

3.6.3 (13 Nov 2023)

  • Fixed: Import error when initialising cloud sync configuration. (PRO)
  • Improved: Added debug action for resetting snippets caches.

3.6.2 (11 Nov 2023)

  • Fixed: Error when attempting to save shared network snippets marked as active.
  • Fixed: Type error when rendering checkbox fields without a stored or default value.
  • Fixed: Removed automatic encoding of code content.
  • Fixed: Label for snippet sharing input incorrectly linked to input field.
  • Fixed: Error when attempting to download export files from Edit menu.
  • Fixed: Issue loading Freemius string overrides too early. (PRO)
  • Fixed: Fix redirect URL when connecting with OAuth on subdirectory or HTTPS sites. (PRO)
  • Fixed: Import error when attempting to completely uninstall the plugin.

3.6.1 (07 Nov 2023)

  • Fixed: Issue accessing fields on Snippets class.

3.6.0 (07 Nov 2023)

  • Updated minimum PHP requirement to 7.4.

  • Added: Ability to authenticate with Code Snippets Cloud using OAuth. (PRO)

  • Added: Integration with GPT AI for generating snippets. (PRO)
  • Added: Ability to generate line-by-line descriptions of snippet code with GPT AI. (PRO)
  • Added: Ability to generate tags and description text from existing snippet code with GPT AI. (PRO)

  • Improved: Ensure that the URL of the edit snippet page changes when adding a new snippet.

  • Improved: Snippet tags will automatically be added when focus is lost on the tags field.
  • Improved: Added debug settings menu for manually performing problem-solving actions.
  • Fixed: Moved active status border on edit name field to left-hand side.
  • Added: Filter to disable scroll-into-view functionality for edit page notices.
  • Fixed: New notices will not scroll if already at top of page.
  • Fixed: Potential CSRF vulnerability allowing an authenticated user to reset settings.

3.5.1 (15 Sep 2023)

  • Fixed: Undefined array key error when accessing plugin settings page. (PRO)
  • Fixed: Issue registering API endpoints affecting edit post screen. (PRO)

3.5.0 (14 Sep 2023)

  • Added: Support for the Code Snippets Cloud API.
  • Added: Search and download public snippets.
  • Added: Codevault back-up and synchronisation. (PRO)
  • Added: Synchronised local snippets are automatically updated in Cloud. (PRO)
  • Added: Bulk actions – ‘update’ and ‘download’.
  • Added: Download snippets from public and private codevaults. (PRO)
  • Added: Search and download any publicly viewable snippet in Code Snippet Cloud by keyword or name of codevault. (PRO)
  • Added: Deploy snippets to plugin from Code Snippets Cloud app. (PRO)
  • Added: Bundles of Joy! Search and download Snippet Bundles in one go direct from Code Snippets Cloud. (PRO)
  • Fixed: Error when attempting to update network shared snippets after saving. [#]
  • Improved: Redirect to snippets table when deleting snippet from the edit menu.
  • Improved: Scroll new notices into view on edit menu.

3.4.2 (05 Jul 2023)

  • Fixed: Issue causing export process to fail with fatal error. [#]
  • Fixed: Type issue on the_posts filter when no posts available. [#]

3.4.1 (29 Jun 2023)

  • Fixed: Undefined array key error. [#]
  • Fixed: Potential type issue when loading Prism. [#]
  • Improved: Added better debugging when calling REST API methods from the edit menu.
  • Improved: Escape special characters when sending snippet code through AJAX to avoid false-positives from security modules. [#]
  • Improved: Only display the latest update or error notice on the edit page, instead of allowing them to stack.
  • Fixed: Potential type issue when sorting snippets. [#]
  • Fixed: Issue preventing asset revision numbers from updating correctly. (PRO) [#]

3.4.0 (17 May 2023)

  • Added: Proper WordPress REST API support for retrieving and modifying snippets.
  • Improved: Better compatibility with modern versions of PHP (7.0+).
  • Improved: Converted Edit/Add New Snippet page to use React.
    • Converted action buttons to asynchronously use REST API endpoints through AJAX.
    • Load page components dynamically through React.
    • Added action notice queue system.
    • Replaced native alert dialog with proper React modal.
  • Improved: Catch snippet execution errors to prevent site from crashing.
  • Improved: Display recent snippet errors in admin dashboard instead.
  • Improved: Updated editor block to use new REST API endpoints. (PRO)
  • Improved: Change colour of upgrade notice in Pro plugin. (PRO)
  • Improved: All available snippet data is included in export files.
  • Improved: Only import specific fields from export file, even if additional fields specified.
  • Fixed: Issue preventing editor colorpicker from loading correctly. (PRO)
  • Improved: Added help links to content snippet options.
  • Improved: Pass additional attributes specified in [code_snippet] content shortcode to shortcode content.
  • Improved: Make shortcode attributes available as individual variables.
  • Improved: Allow boolean attributes to be passed to code snippets shortcodes without specifying a value.
  • Improved: Replace external links to Pro pricing page with an upgrade modal.
  • Fixed: Issue preventing linting libraries from loading correctly in the code editor.

3.3.0 (09 Mar 2023)

  • Fixed: Do not enqueue CSS or JS snippet file if no snippets exist. (PRO)
  • Improved: Added additional editor shortcuts to list in tooltip.
  • Added: Filter for changing Snippets admin menu position. See this help article for more information.
  • Added: Ability to filter shortcode output. Thanks to contributions from Jack Szwergold.
  • Fixed: Bug causing all snippets to show in site health information instead of those active.
  • Fixed: Unnecessary sanitization of file upload data causing import process to fail on Windows systems.

3.2.2 (17 Nov 2022)

  • Fixed: Plugin lacking a valid header error on activation.

3.2.1 (05 Oct 2022)

  • Fixed: Issue making survey reminder notice not dismissible.
  • Added: Ctrl+/ or Cmd+/ as shortcut for commenting out code in the snippet editor.
  • Added: Additional hooks to various snippet actions, thanks to contributions made by ancient-spirit.
  • Added: Fold markers, additional keyboard shortcuts and keymap options to snippet editor,
    thanks to contributions made by Amaral Krichman.
  • Improved: Removed duplicate tables exist query. (#).
  • Improved: Enabled ‘add paragraphs and formatting’ option by default for newly inserted content snippets.
  • Added: WP-CLI commands for retrieving, activating, deactivating, deleting, creating, updating, exporting and importing snippets.
  • Fixed: Path to iron visible when updating the pro plugin.

The full changelog is available on GitHub