Title: BookIt for Cal.com
Author: Gael Poffet
Published: <strong>2026 年 3 月 30 日</strong>
Last modified: 2026 年 3 月 31 日

---

搜索插件

![](https://s.w.org/plugins/geopattern-icon/bookit-for-cal-com.svg)

# BookIt for Cal.com

 作者：[Gael Poffet](https://profiles.wordpress.org/garulfo2/)

[下载](https://downloads.wordpress.org/plugin/bookit-for-cal-com.1.0.3.zip)

 * [详情](https://cn.wordpress.org/plugins/bookit-for-cal-com/#description)
 * [评价](https://cn.wordpress.org/plugins/bookit-for-cal-com/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/bookit-for-cal-com/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/bookit-for-cal-com/#developers)

 [支持](https://wordpress.org/support/plugin/bookit-for-cal-com/)

## 描述

**BookIt for Cal.com** is the easiest way to add Cal.com scheduling to your WordPress
site. It provides three integration methods so you can use whichever fits your workflow:

 * **Gutenberg block** — drag the _Cal.com Booking_ block into any page or post.
 * **Elementor widget** — find the _Cal.com Booking_ widget in the _BookIt_ widget
   panel.
 * **Shortcode** — paste `[bookit event="username/slug"]` anywhere.

#### Features

 * Three display modes: **popup button**, **popup text link**, and **inline calendar**.
 * Full **theme support**: light, dark, or auto (follows the visitor’s OS preference).
 * Custom **accent color** per widget or globally.
 * **Smart loading** — the Cal.com embed script is loaded only on pages that actually
   contain a booking widget, keeping all other pages fast.
 * **Pre-fill** logged-in user name and email automatically.
 * **Cal.com API integration** — connect your API key to pick event types from a
   dropdown instead of typing slugs manually. Results are cached for 1 hour.
 * “Refresh event types” button in the admin with one click.
 * Compatible with Elementor **Free** and **Pro**.
 * Full **i18n** support — ships with a French (fr_FR) translation.

#### External services

This plugin connects to external services operated by Cal.com, Inc.:

 * **Cal.com API** (`https://api.cal.com` or `https://api.cal.eu` for the EU region)—
   used to fetch your event types when an API key is configured. Only called from
   the WordPress admin when you save settings or click “Refresh event types”.
 * **Cal.com embed script** (`https://app.cal.com/embed/embed.js` or `https://app.
   cal.eu/embed/embed.js` for the EU region) — loaded on the frontend to render 
   booking widgets. Loaded only on pages that contain a booking widget (smart strategy)
   or on all pages (always strategy), depending on your settings.

The API base URL is configurable in Settings  BookIt. The default is the global 
Cal.com instance (`api.cal.com` / `app.cal.com`). Users on the Cal.com EU instance
should set it to `https://api.cal.eu`.

By using this plugin you agree to Cal.com’s [Terms of Service](https://cal.com/terms)
and [Privacy Policy](https://cal.com/privacy).

### Shortcode reference

Basic usage:
 [bookit event=”username/slug”]

All attributes:
 [bookit event=”username/slug” type=”popup-button” label=”Book now”
height=”600″ theme=”auto” accent=”#0070f3″ hide_details=”0″ prefill=”0″ btn_bg=”#
000″ btn_text=”#fff” btn_radius=”4″]

 Attribute
 Values Default

 `event`
 `username/slug` _(required)_

 `type`
 `popup-button` | `popup-text` | `inline` `popup-button`

 `label`
 any text `Book a meeting`

 `height`
 number (px) `600`

 `theme`
 `global` | `auto` | `light` | `dark` `global`

 `accent`
 hex color global setting

 `hide_details`
 `0` | `1` `0`

 `prefill`
 `0` | `1` `0`

 `btn_bg`
 hex color _(none)_

 `btn_text`
 hex color _(none)_

 `btn_radius`
 number (px) `4`

## 区块

该插件提供了 1 个区块.

 *   Cal.com Booking Embed a Cal.com booking widget — popup button, popup text link,
   or inline calendar.

## 安装

 1. Upload the `bookit-for-calcom` folder to `/wp-content/plugins/`.
 2. Activate the plugin through the **Plugins** screen in WordPress.
 3. Go to **Settings  BookIt** to configure your Cal.com API key and default options.
 4. Add a booking widget using the Gutenberg block, Elementor widget, or `[bookit]`
    shortcode.

## 常见问题

### Do I need a Cal.com account?

Yes. You need a free or paid Cal.com account to get an event slug. An API key is
optional but enables the event type dropdown in the editor.

### Where do I find my API key?

In Cal.com: **Settings  Developer  API Keys**.

### What is the event slug format?

username/event-slug — for example `jane/consultation-30min`.

### Does this work with Elementor Free?

Yes. All core features work with Elementor Free. Typography controls require Elementor
Pro.

### Is the Cal.com embed script loaded on every page?

By default, the **Smart** loading strategy loads the script only on pages that contain
a `[bookit]` shortcode, a _Cal.com Booking_ Gutenberg block, or an Elementor BookIt
widget. Switch to **Always** in settings if you prefer unconditional loading.

### Can I pre-fill the booking form with the logged-in user’s details?

Yes. Enable the “Pre-fill logged-in user data” option per block/widget/shortcode.
The visitor’s display name and email will be sent to Cal.com.

## 评价

此插件暂无评价。

## 贡献者及开发者

「BookIt for Cal.com」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ Gael Poffet ](https://profiles.wordpress.org/garulfo2/)

[帮助将「BookIt for Cal.com」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/bookit-for-cal-com)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/bookit-for-cal-com/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/bookit-for-cal-com/)，或通过[RSS](https://plugins.trac.wordpress.org/log/bookit-for-cal-com/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/bookit-for-cal-com/)。

## 更新日志

#### 1.0.3

 * Fix: Elementor widget showing 404 in Cal.com popup — event slug now correctly
   prefixed with username (Cal.com v2 API nests username under owner/profile/user,
   not at root level). Added username-resolution fallback in render() for slugs 
   saved without prefix.

#### 1.0.2

 * Fix: Shortcode Helper event dropdown not populated on fresh installs — auto-fetches
   event types via AJAX if the cache is cold.

#### 1.0.1

 * Fix: admin JS not loaded on settings page — “Refresh event types” button was 
   unresponsive.

#### 1.0.0

 * Initial release.

## 额外信息

 *  版本 **1.0.3**
 *  最后更新：**4 月前**
 *  活跃安装数量 **20+**
 *  WordPress 版本 ** 6.0 或更高版本 **
 *  已测试的最高版本为 **6.9.4**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/bookit-for-cal-com/)
 * 标签
 * [appointment](https://cn.wordpress.org/plugins/tags/appointment/)[booking](https://cn.wordpress.org/plugins/tags/booking/)
   [calendar](https://cn.wordpress.org/plugins/tags/calendar/)[scheduling](https://cn.wordpress.org/plugins/tags/scheduling/)
 *  [高级视图](https://cn.wordpress.org/plugins/bookit-for-cal-com/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/bookit-for-cal-com/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/bookit-for-cal-com/reviews/)

## 贡献者

 *   [ Gael Poffet ](https://profiles.wordpress.org/garulfo2/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/bookit-for-cal-com/)