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://zh-hk.wordpress.org/plugins/insert/#description)
 * [評價](https://zh-hk.wordpress.org/plugins/insert/#reviews)
 *  [安裝](https://zh-hk.wordpress.org/plugins/insert/#installation)
 * [開發](https://zh-hk.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

## 評價

There are no reviews for this plugin.

## 貢獻者及開發者

“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/)。

## 其它

 *  Version **0.1.0**
 *  Last updated **13 年之前**
 *  Active installations **10+**
 *  WordPress version ** 2.7.0 or higher **
 *  Tested up to **3.8.0**
 *  Language
 * [English (US)](https://wordpress.org/plugins/insert/)
 * Tags
 * [insert](https://zh-hk.wordpress.org/plugins/tags/insert/)[shortcode](https://zh-hk.wordpress.org/plugins/tags/shortcode/)
 *  [進階顯示](https://zh-hk.wordpress.org/plugins/insert/advanced/)

## 評分

No reviews have been submitted yet.

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

[See all reviews](https://wordpress.org/support/plugin/insert/reviews/)

## 貢獻者

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

## 支援

有話想說？需要協助？

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

## 捐贈

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

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