Title: insert
Author: ryanve
Published: <strong>2014 年 1 月 30 日</strong>
Last modified: 2014 年 1 月 30 日

---

搜尋外掛

這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個
外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。

![](https://s.w.org/plugins/geopattern-icon/insert.svg)

# insert

 由 [ryanve](https://profiles.wordpress.org/ryanve/) 開發

[下載](https://downloads.wordpress.org/plugin/insert.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/insert/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/insert/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/insert/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/insert/#developers)

 [技術支援](https://wordpress.org/support/plugin/insert/)

## 外掛說明

### Usage

Use the `[insert]` shortcode inside posts or anywhere else that processes [shortcodes](https://codex.wordpress.org/Shortcode_API).

#### `[insert]` shortcode attributes

 * query – sets up a new [`WP_Query`](https://codex.wordpress.org/Class_Reference/WP_Query)
   via [`get_posts()`](https://codex.wordpress.org/Template_Tags/get_posts)
 * data – data to pass to actions
 * action – action to run, runs for each post if applicable
 * filter – filter to run, runs for each post if applicable
 * template – template to load via [`locate_template()`](https://codex.wordpress.org/Function_Reference/locate_template)

All attributes are optional and can be used in combination to yield powerful abilities.

### Abilities

Possibilities with `[insert]` are endless. Practical uses include:

 * Insert posts into posts
 * Insert hooks into posts
 * Insert posts into widgets
 * Run action hooks via widgets
 * Load templates via widgets

### Examples

#### Insert a template

    ```
    `
    ```

[insert template=”branding.php”]
 `

#### Insert an action

    ```
    `
    ```

[insert action=”dostuff”]
 `

#### Pass data to an action

    ```
    `
    ```

[insert data=”field=slug&value=example&tax=category” action=”dostuff”]
 `

The action receives data as an array.

    ```
    `
    ```

add_action(‘dostuff’, ‘print_r’);
 `

#### Insert a page via template

    ```
    `
    ```

[insert query=”name=about&post_type=page” template=”entry.php”]
 `

#### Insert a page via action

This sets up the query and triggers the action.

    ```
    `
    ```

[insert query=”name=about&post_type=page” action=”dostuff”]
 `

WP template tags are available inside the action.

    ```
    `
    ```

add_action(‘dostuff’, ‘the_title’);
 `

### Github

 * [github.com/ryanve/insert](https://github.com/ryanve/insert)

## 安裝方式

Requires: PHP 5.3+

 1. Upload to the `/wp-content/plugins/` directory
 2. Activate through the Plugins menu in WordPress

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

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

參與者

 *   [ ryanve ](https://profiles.wordpress.org/ryanve/)

[將〈insert〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/insert)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/insert/)、查看
[SVN 存放庫](https://plugins.svn.wordpress.org/insert/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/insert/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/insert/)。

## 中繼資料

 *  版本 **0.1.0**
 *  最後更新 **12 年前**
 *  啟用安裝數 **10+**
 *  WordPress 版本需求 ** 2.7.0 或更新版本 **
 *  已測試相容的 WordPress 版本 **3.8.0**
 *  語言
 * [English (US)](https://wordpress.org/plugins/insert/)
 * 標籤:
 * [insert](https://tw.wordpress.org/plugins/tags/insert/)[shortcode](https://tw.wordpress.org/plugins/tags/shortcode/)
 *  [進階檢視](https://tw.wordpress.org/plugins/insert/advanced/)

## 評分

這個項目尚無任何評論記錄。

[Your review](https://wordpress.org/support/plugin/insert/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/insert/reviews/)

## 參與者

 *   [ ryanve ](https://profiles.wordpress.org/ryanve/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/insert/)

## 贊助

想要支援這個外掛的發展嗎？

 [ 贊助這個外掛 ](http://gittip.com/ryanve)