Title: Roaver Widget
Author: Joshua Graham
Published: <strong>2025 年 3 月 12 日</strong>
Last modified: 2025 年 3 月 27 日

---

搜尋外掛

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

![](https://ps.w.org/roaver-widget/assets/icon-256x256.png?rev=3255054)

# Roaver Widget

 由 [Joshua Graham](https://profiles.wordpress.org/joshuaroaver/) 開發

[下載](https://downloads.wordpress.org/plugin/roaver-widget.1.09.zip)

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

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

## 外掛說明

You can be renting campervans and cars today! The Roaver Widget plugin allows you
to seamlessly add your Roaver integration directly into your WordPress site. This
relies on you having a [Roaver](https://www.roaver.com.au) account. Configure and
display widgets by using drag & drop blocks or entering shortcodes.

If you do not have a Roaver account, [get in touch](https://www.roaver.com.au/contact)!

### Usage

#### Using Shortcode

 * Insert `[roaver_widget widget_type="search" element_id="custom_id" locale="en"]`
   in posts or pages.
 * Attributes:
    - `widget_type`: Specify ‘search’ or ‘book’.
    - `element_id`: Unique ID for the widget container.
    - `locale`: Optional two-letter locale code. If not provided, the browser language
      will be used.
    - `scroll_offset`: Optional integer between 0 and 1000.

#### Using Gutenberg Block

 * Add the Roaver Widget block from the ‘EMBEDS’ category in the block editor.
 * Configure widget type, element ID, locale, and scroll offset via the block inspector
   controls.

### External services

This plugin connects to an API to fetch live search results, create quotes and fulfill
bookings for customers visiting your site.

Visitor sessions initiated when the widget is initialized and may include browser
locale and timezone to ensure relevant information. Customer interactions with the
Roaver widget are relayed to the Roaver service to serve live search results, create
quotes and complete bookings. We do not collect information for marketing and do
not sell customer data.

Cookies are not used for this service, instead a secure session ID identifies customers
and is sent within API requests.

This service is provided by “Roaver Pty Ltd”: [terms of use](https://www.roaver.com.au/terms),
[privacy policy](https://www.roaver.com.au/privacy).Ensure your WordPress installation
is compatible with the block editor for the best experience with this plugin.

## 螢幕擷圖

 * [[
 * Search widget with basic colors
 * [[
 * Booking widget showing campervan search results

## 適用於區塊編輯器

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

 *   Roaver Widget

## 安裝方式

 1. Get the plugin.
     a. Click ‘Add Plugin’ or ‘Install Plugin’ from your wordpress 
    site. b. Select ‘Download’ and manually add the plugin to your wordpress site.
 2. Activate the plugin through the ‘Plugins’ screen in WordPress.
 3. Use the Settings -> Roaver Widget screen to configure the plugin options with your
    affiliate key and optionally set a default locale.
 4. Insert the `[roaver_widget]` shortcode or use the custom Gutenberg block to display
    widgets in your content.

## 常見問題集

### How do I get an affiliate key?

Your affiliate key is provided through your Roaver account. Make sure to enter it
in the plugin settings after installation. Visit our [contact us](https://www.roaver.com.au/contact)
page if you are interested.

### Can I customize the widget’s appearance?

The widget’s appearance is based on your theme configured in [our portal](https://app.roaver.com.au).
Further customization can be achieved by customizing CSS styles in your wordpress
theme or using additional plugins.

## 使用者評論

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

## 參與者及開發者

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

參與者

 *   [ Joshua Graham ](https://profiles.wordpress.org/joshuaroaver/)

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

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

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

## 變更記錄

#### 1.00

 * Initial release with support for shortcodes and Gutenberg blocks.

#### 1.04

 * Added scroll offset option.
 * Improved implementation of locale.

#### 1.06

 * Improved readme with specifics of external service

#### 1.07

 * Added screenshots, icon and tweaked description

#### 1.08

 * Improved usability with message if widget is not configured
 * Better fallback to default value

#### 1.09

 * Improved widget shortcode compatibility with wordpress 6.7

## 中繼資料

 *  版本 **1.09**
 *  最後更新 **1 年前**
 *  啟用安裝數 **少於 10 次**
 *  WordPress 版本需求 ** 5.0 或更新版本 **
 *  已測試相容的 WordPress 版本 **6.7.5**
 *  PHP 版本需求 ** 7.0 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/roaver-widget/)
 * 標籤:
 * [block](https://tw.wordpress.org/plugins/tags/block/)[Embeds](https://tw.wordpress.org/plugins/tags/embeds/)
   [shortcode](https://tw.wordpress.org/plugins/tags/shortcode/)[widget](https://tw.wordpress.org/plugins/tags/widget/)
 *  [進階檢視](https://tw.wordpress.org/plugins/roaver-widget/advanced/)

## 評分

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

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

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

## 參與者

 *   [ Joshua Graham ](https://profiles.wordpress.org/joshuaroaver/)

## 技術支援

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

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