外掛說明

With this plugin, you can easily integrate data from your Recras instance, such as packages and contact forms, into your own website.

To get started, go to the Recras Settings page and enter your Recras domain. For example, if you log in to Recras at https://mycompany.recras.com/ then enter mycompany.recras.com. That’s all there is to it! You can now use widgets to retrieve data. All data is retrieved via a secured connection (HTTPS) to ensure data integrity. Other than the request parameters, no data is sent to the Recras servers.

This plugin consists of the following “widgets”. To use them, you first need to set your Recras domain (see paragraph above).
* Book processes
* Contact forms
* Packages
* Products
* Voucher info

Widgets can be added to your site in three ways. Using Gutenberg blocks (recommended), using the buttons in the “classic editor” (limited functionality), or by entering the shortcode manually (discouraged).

Date picker for contact forms

By default, date pickers in contact forms use the browser date picker. If you want to be able to style the date picker, we recommend to enable the date picker we have included with the plugin. You can enable this on the Recras Settings page.

Note: this setting only applies to standalone contact forms, not to contact forms used in the old online booking of packages integration or in book processes.

Styling

No custom styling is applied by default, so it will integrate with your site easily. If you want to apply custom styling, see css/style.css for all available classes. Be sure to include these styles in your own theme, this stylesheet is not loaded by the plugin!
For styling the date picker, we refer you to the Pikaday repository. Be sure to make any changes in your own theme or using WordPress’ own Customizer.

Cache

All data from your Recras is cached for up to 24 hours. If you make important changes, such as increasing the price of a product, you can clear the cache to reflect those changes on your site immediately.

Google Analytics integration

You can enable basic Google Analytics integration for the booking of packages and voucher sales by checking “Enable Google Analytics integration?” on the Recras Settings page. This will only work if there is a global ga JavaScript object. This should almost always be the case, but if you find out it doesn’t work, please contact us!

Support

We would appreciate it if you use our GitHub page for bug reports, pull requests and general questions. If you do not have a GitHub account, you can use the Support forum on wordpress.org.

We only support the latest plugin of the plugin, on the latest version of WordPress (which you should always use anyway!) and only on actively supported PHP branches.

Credits

Icons from Dashicons by WordPress, released under the GPLv2 licence.
Date picker is Pikaday, released under the BSD/MIT licence.
Country list is by umpirsky, released under the MIT licence.

螢幕擷圖

Example of a programme with the Twenty Fifteen theme
Example of package information, generated from Recras data
The Recras blocks in Gutenberg

安裝方式

Easy installation (preferred)

Install the plugin from the Plugins > Add New page in your WordPress installation.

Self install

Download the zip file containing the plugin and extract it somewhere to your hard drive
Upload the recras-wordpress-plugin folder to the /wp-content/plugins/ directory
Activate the plugin through the ‘Plugins’ menu in WordPress

Using Composer

Type composer require recras/recras-wordpress-plugin in your terminal
The plugin will automatically be installed in the /wp-content/plugins/ directory by using Composer Installers
Activate the plugin through the ‘Plugins’ menu in WordPress

常見問題集

Do you support Elementor, WPBakery/Visual Composer, Brizy, etc. ?: Integrating a book process is possible through Elementor. There are many different page builders but Elementor is the most used one, so we chose to only build this widget for Elementor. Using shortcodes is still possible in all other builders, of course.
Does the plugin support network installations?: Yes it does. You can set different Recras domains (all settings, for that matter) for each site.
Can the plugin be installed as “must use plugin” ?: No. “Must use” plugins don’t appear in the update notifications nor show their update status on the plugins page (direct quote from the WordPress documentation) which is reason enough for us not to support this.

使用者評論

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

參與者及開發者

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

Sander

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

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

對開發相關資訊感興趣？

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

變更記錄

6.5.2

Fix for some contact forms not submitting when loaded in a popup

6.5.1

Gutenberg editor: Add ID to book processes list
Gutenberg editor: sort selectable items by name instead of creation date

6.5.0

Add anti-spam check to contact forms

6.4.3

Fixed error when using an invalid Recras domain
Updated translations

6.4.2

Update “Fix book process datepicker styling” styles to latest version
Fixed some WP compliance issues

6.4.1

Don’t load old script when it’s not needed
Updated “Tested up to” version to 6.9
Update “Fix book process datepicker styling” styles to latest version

6.4.0

Instead of entering your Recras subdomain in the settings, you must now enter the full URL. This is done since Recras members from now on get a subdomain at recras.com instead of recras.nl.
Plugin now requires WP 6.7 or higher

6.3 (highlights)

Update “Fix book process datepicker styling” styles to latest version
Several technical updates
Several small fixes

Older versions

See the full changelog for older versions.