內容簡介
ShootCal Web Calendar 外掛可讓使用者輕鬆將 ShootCal 日曆或其他 iCal 日曆嵌入到 WordPress 網站中，並自動調整顯示高度，提供即時的預訂資訊和可用性。
【主要功能】
• 支援 ShootCal 日曆 ID 嵌入
• 自動調整日曆高度
• 顯示可用性及預訂狀態
• 支援其他 iCal 日曆來源
• 簡化的嵌入過程，無需 HTML 或 JavaScript
外掛標籤
開發者團隊
原文外掛簡介
ShootCal: paste your calendar ID. Add the ShootCal Web Calendar block, choose ShootCal, and paste the WordPress calendar ID from ShootCal > Clients & Booking > Booking, under Put booking on your website > Using WordPress?. Your website displays the live ShootCal calendar or booking page. It automatically adjusts its height when visitors navigate or open booking forms, and follows updates made in ShootCal.
Choose Follow ShootCal settings to show booking when enabled in your account, or Calendar only to always show the month calendar. Your ShootCal timezone, availability, and booking rules remain managed in ShootCal.
Other calendars: paste an iCal feed URL. Choose Other calendar (iCal) for Google Calendar, Apple, Outlook, or another provider. WordPress fetches the feed on your server and draws a month grid, with either free/busy availability or event titles and times. Each block or shortcode can use a different calendar.
Existing embeds keep working. The ShootCal ID field also accepts a ShootCal embed URL, feed URL, iframe snippet, or the official embed.js script snippet. Recognized references are converted into an ID and validated display options. Pasted JavaScript is never executed. Existing shortcodes and blocks using the url attribute remain supported.
Why an ID instead of embed code?
The plugin handles the embedded page and automatic resizing for you. It provides the same iframe and height-listener behavior as the ShootCal script embed, without requiring you to paste HTML or JavaScript into WordPress. The hosted calendar loads from ShootCal when visitors view it, independently of WordPress page caching.
Other iCal calendars
Google Calendar: Settings > Integrate calendar > Secret address in iCal format.
Apple, Outlook, and other providers: use the published HTTP or HTTPS iCal feed URL.
Availability mode shows Available, Limited, or Booked days and busy time windows. Event titles and descriptions are not displayed.
Full calendar mode displays event titles and start times. Use it only for information intended to be public.
Adjust months, week start, timezone, and availability colors in the block or shortcode. ShootCal > Calendar contains site defaults for locally rendered feeds.
Feeds are cached for 10 minutes. Optional Page caching mode refreshes the rendered calendar after page load using a protected request that does not expose the private feed URL in the page markup.
Privacy and external services
A ShootCal calendar ID is a public embed identifier, not your account password or API key. Visitors load the hosted page from api.shootcal.com; ShootCal therefore receives the normal browser request information, including the visitor’s IP address. Booking forms send information entered by visitors directly to ShootCal. See ShootCal terms and privacy information at https://shootcal.com.
For other iCal feeds, requests originate from your WordPress server and go to the provider you configure. The plugin stores the feed URL in your WordPress content and caches the raw feed in your site’s object cache or database. Treat a private feed URL like a password and grant editing access only to trusted users. The plugin renders selected calendar information for visitors; it does not publish the private feed URL as part of the page-caching request.
After upgrading, clear your full-page/CDN caches so old iCal placeholders are replaced with protected requests. Older versions exposed private iCal addresses in Page caching mode; if you used that mode with a private feed, replace its private address with your provider and update your embeds. ShootCal hosted calendar IDs are public and are not affected.
Google Calendar is provided by Google: https://policies.google.com/terms and https://policies.google.com/privacy. For Apple, Outlook, and other feeds, consult the selected provider’s terms and privacy policy. No calendar requests are made until you configure a source.
Shortcode attributes
ShootCal example: [shootcal_web_calendar calendar_id="YOUR_CALENDAR_ID"]
Calendar-only example: [shootcal_web_calendar calendar_id="YOUR_CALENDAR_ID" view="calendar"]
Other iCal example: [shootcal_web_calendar source="ical" url="https://example.com/calendar.ics" mode="availability" months="12"]
calendar_id – ShootCal’s public calendar/embed ID. Recommended for ShootCal.
source – Optional: shootcal or ical. Omit to detect existing URL-based embeds automatically.
url – An iCal feed URL, or a legacy ShootCal embed reference. Existing usage remains supported.
view – ShootCal only: default follows ShootCal settings; calendar always shows the month calendar.
months – Calendar display range, 1-36. ShootCal defaults to 12; other iCal feeds use your saved calendar default (initially 12). Imported month counts are preserved.
first_day – Calendar week start: 0 for Sunday, 1 for Monday.
mode – availability (default) or full. Full shows event titles and times from an iCal feed.
timezone – Local iCal renderer only: an IANA identifier, such as America/New_York. Defaults to your WordPress site timezone.
multi_session_day – Local availability renderer only: 1 (default) shows timed bookings as Limited; 0 marks a day with any booking as Booked.
limited_color, booked_color – Local availability renderer only: optional hex colors.
Imported ShootCal URLs retain validated presentation parameters for compatibility. Their appearance follows the options currently supported by the hosted ShootCal page. Local iCal display settings do not change hosted ShootCal booking rules.
