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

---

搜索插件

**该插件尚未通过WordPress的最新3个主要版本进行测试**。 当与较新版本的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://cn.wordpress.org/plugins/roaver-widget/#description)
 * [评价](https://cn.wordpress.org/plugins/roaver-widget/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/roaver-widget/#installation)
 * [开发进展](https://cn.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⌉⌊Search widget with basic colors⌉[

Search widget with basic colors

[⌊Booking widget showing campervan search results⌉⌊Booking widget showing campervan
search results⌉[

Booking widget showing campervan search results

## 区块

该插件提供了 1 个区块.

 *   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 或更高版本 **
 *  已测试的最高版本为 **6.7.5**
 *  PHP 版本 ** 7.0 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/roaver-widget/)
 * 标签
 * [block](https://cn.wordpress.org/plugins/tags/block/)[Embeds](https://cn.wordpress.org/plugins/tags/embeds/)
   [shortcode](https://cn.wordpress.org/plugins/tags/shortcode/)[widget](https://cn.wordpress.org/plugins/tags/widget/)
 *  [高级视图](https://cn.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/)