ICS 캘린더

설명

간단한 쇼트코드를 사용하여 iCalendar 구독(ICS) 피드(Google 캘린더, Microsoft Office 365, Apple iCloud, Airbnb, Vrbo 등)를 완벽하게 통합되고 자동 업데이트되며 유지 관리가 필요 없는 워드프레스 캘린더로 전환할 수 있습니다.

이미 사용 중인 캘린더 소프트웨어에서 이벤트를 계속 관리하세요! 추가 작업 없이 워드프레스 웹사이트에 자동으로 최신 캘린더가 표시됩니다.

캘린더를 월별, 목록 또는 주별 보기로 표시합니다. 다양한 추가 사용자 지정 옵션을 사용할 수 있습니다. 자세한 내용은 사용자 가이드를 참조하세요.

API 키가 필요하지 않습니다!

공개 아이캘린더 구독 링크를 생성하는 모든 캘린더 소프트웨어와 작동합니다.

실시간 미리보기

당사 웹사이트의 모든 ICS 캘린더 보기에서 자신의 캘린더를 미리 볼 수 있습니다. icscalendar.com/preview

쇼트코드 빌더

새로운 온라인 쇼트코드 빌더(icscalendar.com/shortcode-builder)로 ICS 캘린더 사용을 그 어느 때보다 쉽게 ​​시작할 수 있습니다.

언어 지원

모든 날짜 문자열(요일, 월 등)은 워드프레스 핵심 기능을 사용하여 사이트의 구성된 언어(설정 > 일반 > 언어 아래)와 날짜/시간 형식으로 자동 번역됩니다. 캘린더 자체의 모든 텍스트 콘텐츠는 피드에 있는 그대로 표시됩니다.

플러그인에 의해 생성된 소량의 추가 프런트 엔드 표시 텍스트는 기본적으로 미국 영어로 되어 있지만 중국어, 덴마크어, 네덜란드어, 에스토니아어, 핀란드어, 프랑스어, 독일어, 그리스어, 헝가리어, 이탈리아어, 일본어, 한국어, 라트비아어, 리투아니아어, 노르웨이어, 폴란드어, 포르투갈어, 러시아어, 스페인어 및 스웨덴어.

귀하의 언어에 대한 지원을 추가하려면 저희에게 연락하십시오!

이 플러그인에는 Jonathan Goode, John Grogg 및 Martin Thoma(MIT 라이선스)의 PHP ICS 파서 라이브러리가 포함되어 있습니다.

설치

플러그인이 설치되고 활성화되면 아래의 쇼트코드(인용 부호 사이에 자신의 ICS 피드 URL 추가)를 사용하여 페이지에 달력을 삽입하십시오. 온라인 쇼트코드 빌더를 사용하여 맞춤형 쇼트코드를 쉽게 만들거나 자세한 내용은 사용자 가이드를 참조하십시오.

[ics_calendar url=""]

웹 브라우저에서 캘린더를 보기 위한 URL이 아니라 캘린더 프로그램으로 가져오기 위한 URL(예: 캘린더 구독(ICS))을 사용하고 있는지 확인하세요. 올바른 URL을 가지고 있는지 테스트하려면 브라우저 주소창에 직접 붙여넣으세요. 브라우저에 캘린더가 표시되지 않고 .ics 파일이 다운로드되어야 합니다.

FAQ

캘린더의 ICS 피드 URL은 어떻게 찾나요?

캘린더 시스템마다 피드 URL을 가져오는 방법이 다릅니다. 캘린더 소프트웨어의 설명서를 참조하여 도움을 받아야 할 수도 있습니다. 아래에서 일반적으로 사용되는 캘린더에 대한 지침을 확인하세요.

캘린더가 공개되어 있는지도 확인해야 합니다. 개인 캘린더는 이 플러그인으로 액세스할 수 없습니다.

문서 빠른 링크:

내 페이지에 캘린더를 삽입하려면 어떻게 하나요?

이 쇼트코드를 사용하여 인용 부호 사이에 ICS 피드 URL을 삽입합니다.

[ics_calendar url=""]

웹 브라우저에서 캘린더를 보기 위한 URL이 아니라 캘린더 프로그램으로 가져오기 위한 URL(예: 캘린더 구독(ICS))을 사용하고 있는지 확인하세요. 올바른 URL을 가지고 있는지 테스트하려면 브라우저 주소창에 직접 붙여넣으세요. 브라우저에 캘린더가 표시되지 않고 .ics 파일이 다운로드되어야 합니다.

여러 캘린더를 결합할 수 있나요?

예! url 매개변수에 둘 이상의 피드 URL을 포함하여 여러 캘린더를 결합할 수 있습니다. 캘린더 URL은 하나의 공백 또는 파이프 | 문자로 구분합니다. 다른 구분 문자는 URL의 일부로 해석되므로 포함하지 마십시오.

내 캘린더가 로드되지 않는 이유는 무엇입니까?

이는 서버 구성 때문일 수 있습니다. 이 플러그인을 사용하려면 PHP cURL 확장 또는 allow_url_fopen PHP 설정이 켜져 있어야 합니다. 이것이 문제라고 생각되면 PHP 구성이나 서버 관리자를 확인하십시오. 또한 쇼트코드에 debug="true"를 추가하고 페이지를 확인하여 연결 문제에 대한 추가 세부 정보를 제공할 수 있는 디버깅 출력을 볼 수 있습니다.

내 캘린더가 업데이트되지 않는 이유는 무엇입니까?

성능을 위해 이 플러그인은 워드프레스 트랜지언트를 사용하여 캘린더 소스 서버에 요청할 때마다 검색된 캘린더 데이터를 1시간 동안 저장합니다. 페이지에 표시되지 않는 업데이트된 이벤트가 있는 경우 사이트 관리자의 ICS 캘린더 페이지로 이동하여 캐시된 캘린더 데이터 지우기 버튼을 클릭하세요.

타사 캐싱 플러그인이 ICS 캘린더의 피드 동기화를 방해할 수 있습니다. 캐싱 플러그인을 사용 중인데 캘린더가 업데이트되지 않는 경우 쇼트코드에 AJAX 옵션을 사용해 보세요.

일광 절약 시간제가 시작된 후 이벤트 시간이 1시간 늦는 이유는 무엇입니까?

PHP에는 시간대를 정의하는 두 가지 다른 방법이 있습니다. GMT/UTC에서 오프셋된 시간(예: “UTC-5”) 또는 대륙/도시 조합(예: “America/Chicago”)입니다. UTC 오프셋을 사용하는 시간대는 일광 절약 시간을 올바르게 처리하지 않습니다(PHP 설명서에 설명된 대로). ). WordPress 시간대 설정을 확인하세요(설정 > 일반 > 시간대). UTC 오프셋으로 설정된 경우 동일한 시간대에서 사용자 위치에서 가장 가까운 도시로 변경하십시오. 버전 6.0부터는 tz 매개변수를 사용하여 쇼트코드 내에서 시간대를 설정할 수도 있습니다. (다시 말하지만 UTC 오프셋이 아닌 명명된 지역/도시 시간대를 사용해야 합니다.)

추가 문서 및 지원

사용자 가이드에는 플러그인의 모든 기능에 대한 광범위한 문서가 포함되어 있으며 자주 업데이트되며 에서 지원하는 모든 언어로 번역됩니다. 플러그인.

기능 요청

유료 ICS 캘린더 프로 추가 기능에는 추가 레이아웃 옵션, CSS를 직접 편집하는 것보다 더 쉽게 캘린더 모양을 맞춤설정할 수 있는 도구, 개선된 삽입 도구가 포함되어 있습니다. , 그리고 더. 또한 무료 및 유료 버전 모두에 새로운 기능과 개선 사항을 지속적으로 추가하고 있습니다. 보고 싶은 기능에 대한 제안이나 기타 추가 정보가 있는 경우 관리자 페이지 또는 의 지원 링크를 따라 알려주십시오. WordPress 지원 포럼! 기본 플러그인은 항상 무료로 사용할 수 있습니다.

후기

2024년 11월 11일
I have been using the ICS Calendar plugin for about two years now, and it has been an invaluable asset to my membership site. Since implementing the plugin, member retention and engagement have significantly increased, as I can display all upcoming events in one place, keeping members connected and engaged. The plugin is incredibly powerful, flexible, and well-maintained with regular updates. I can’t say enough good things about the developer. As others have mentioned, his support is outstanding, he goes above and beyond to troubleshoot and resolve issues, even when it’s clear the problem is caused by conflicts from other plugins. Highly, highly recommended
2024년 8월 5일
I use this plugin on three separate websites that have three distinct needs. The flexibility in the setup allows me to accomplish what I need on each site. On the couple of occasions I’ve needed support, it has been extremely prompt and accurate. Highly recommended if you have Google calendars you need to display on your sites.
2024년 6월 23일
Thank you for a great plugin that allows for almost arbitrary customization if you can write some PHP. To top it all, my support question was answered in — drum roll please — just 11 minutes! 🤩
2024년 5월 20일
What a great and useful plugin, the free version is great but the ability to customize is wild with the paid version. I wish I knew sooner how easy it would be to use the paid version. Scott helped me so much with tech support. Really loving this plugin.
모든 66 평가 읽기

기여자 & 개발자

“ICS 캘린더”(은)는 오픈 소스 소프트웨어입니다. 다음의 사람들이 이 플러그인에 기여하였습니다.

기여자

“ICS 캘린더”(이)가 6 개 언어로 번역되었습니다. 기여해 주셔서 번역자님께 감사드립니다.

자국어로 “ICS 캘린더”(을)를 번역하세요.

개발에 관심이 있으십니까?

코드 탐색하기는, SVN 저장소를 확인하시거나, 개발 기록RSS로 구독하세요.

변경이력

11.5.11 – 2025.05.16

  • Event downloads (eventdl):
    • Added “Save to your calendar” text in addition to icon. You can revert to the previous icon-only display by changing the shortcode parameter from eventdl="true" to eventdl="minimal".
    • Fixed output errors in downloaded .ics files when the event includes the EXDATE or RDATE property.
  • Admin page: Updated promotional content.
  • CSS: Removed base64 encoding on embedded SVG background images, to reduce data size and eliminate unnecessary obfuscation.
  • i18n: 번역 문자열을 업데이트했습니다.

11.5.10.1 – 2025.05.09

  • Bug fix: Basic and List views now handle paginationposition="both" correctly.
  • Improved error handling in r34ics_uniqid_url() function and R34ICS::shortcode_defaults_merge() method.

11.5.10 – 2025.05.02

  • Actions and Filters:
    • Added actions to Month and Week view templates: r34ics_display_calendar_after_day_label and r34ics_display_calendar_after_events_list. As the names indicate, these actions allow for custom output after the day label and day events lists for each day in the table in these views. Hooked functions have access to four input parameters: $view, $args, $date and $day_events.

11.5.9.1 – 2025.04.28

  • Modified r34ics_url_tester_result_debug hook to be able to account for situations where the response is empty.
  • Vendors:
    • ics-parser: Changed timezone string mappings for “(UTC+02:00) Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius” and “FLE Standard Time” from “Europe/Kiev” to “Europe/Helsinki”. This is because the ics-parser library uses the spelling “Kiev”, whereas ICS Calendar code uses the spelling “Kyiv”. This discrepancy was causing time calculation issues, specifically for Microsoft source calendars, which use the “FLE Standard Time” designation. “Europe/Helsinki” was chosen to avoid alternate spelling confusion, and also because “FLE” stands for “Finland Latvia Estonia”, making Helsinki a more logical choice than Kyiv. (Both cities share the same timezone rules.)

11.5.9 – 2025.04.24

  • Added wp_get_remote() status check to System Report; refactored System Report to use transients.

11.5.8 – 2025.04.22

  • Removed r34ics_ajax_bypass_nonce option. Nonce has now been removed from ICS Calendar AJAX requests altogether, as the requests do not have the ability to write to the database, making the nonce unnecessary. The nonce has consistently caused issues with AJAX requests in conjunction with third-party caching plugins.
  • CSS tweaks on admin page.
  • i18n:
    • Removed disused translation strings.
    • Removed Norwegian Nynorsk translation files, due to consistent issues with Poedit machine translations.

11.5.7.1 – 2025.04.11

  • Bug fix: Added exception handling to prevent a fatal error if r34ics_date() is passed a timezone string that is not a valid format recognized by the PHP DateTimeZone class.
  • Bug fix: Removed extraneous pagination close tag in list view that may cause the pagination HTML to break if the last item on a “page” is a multi-day event.
  • Changed scope of special date range handling in week view.

11.5.7 – 2025.03.07

  • Modified activation process to jump directly to Getting Started tab of admin page.
  • Redesigned Getting Started tab and sidebar of admin page.
  • i18n: Updated translation files, added missing text strings.

11.5.6.1 – 2025.03.06

  • Updated help text on Settings page.

11.5.6 – 2025.02.26

  • Added none as a valid option for the monthnav parameter, allowing for hiding the month navigation altogether. (Useful when showing month view in a kiosk environment or other settings where the user doesn’t need the ability to switch the view to a different month.)
  • Bumped ‘tested up to’ to 6.7.2.

11.5.5 – 2025.02.24

  • Added support for using HTML color names in the shortcode, in addition to hex colors, via the new r34ics_color_name2hex() function.

11.5.4.2 – 2025.02.18

  • Made calls to php_uname() in System Report conditional; some servers may remove support for this function for security reasons. Also replaced call to phpversion() with PHP_VERSION constant, with a conditional in case the constant is undefined. These changes should resolve issues where the ICS Calendar admin page does not load properly on servers with these security measures in place.
  • Updated copyright terms regarding ICS Calendar name and branding assets.

11.5.4.1 – 2025.02.10

  • Refactored r34ics_date() to use wp_date() after applying its offset and other input standardizations, rather than duplicating the code of wp_date(). This also resolves an issue where in some rare cases, the passed-in timezone may not be handled correctly.
  • Added missing event timezone inputs to r34ics_date() calls in the R34ICS::event_description_html() method and r34ics_multiday_date_label() function. Without timezones, date ranges for multi-day events could be one day “off” in the event descriptions and labels after the aforementioned refactoring of r34ics_date().
  • Fixed incorrect date display issues in R34ICS::event_description_html(). Note: Version 11.5.4 was withdrawn due to this issue, which was discovered a few minutes after its release.
  • Modified event sorting for multi-day events starting on the same date. Now, list-style views (list, basic) will show these events sorted by earliest ending date. Table-style views (month, week), will show the events sorted by the latest ending date, which helps to reduce situations where events “break” between days in the layout when using combinemultiday.

11.5.3.2 – 2025.02.07

  • Bug fix: Resolved possible fatal error caused if new r34ics_i18n_locales() function added in 11.5.3.1 runs on a logged-out front-end page.

11.5.3.1 – 2025.02.06

  • Fixed bug with reverse and pagination on Basic and List views that would cause the wrong “page” to display on load.
  • i18n: Updated translation strings. Added logic to force the plugin’s embedded translation files to take precedence over any downloaded community translation files in the WP_LANG_DIR/plugins directory.

11.5.3 – 2025.02.03

  • Fixed issue with pagination in list view that would include the next single-day event(s) on a “page” when a multi-day event was the correctly counted “last” item on the page.
  • Modified handling of pagination="1" in Basic and List views, to literally mean 1 event, rather than being interpreted as a boolean “true” and defaulting to 5 events per page. Setting pagination="true" will still default to 5 per page. List view also now omits the month/year headers when displaying one event per page.
  • Modified handling of count and pagination parameters to force positive integer values.

11.5.2.1 – 2025.02.03

  • Added r34ics_comparison_string() function to process strings for comparison purposes. Used by features added to R34ICS::r34ics_display_calendar_exclude_event() in 11.5.2 to filter events by category, accounting for possible formatting issues with accented letters.
  • Modified shortcode logic to force certain parameter values to all-lowercase. This allows the input values to be case-insensitive; previously, non-lowercase values would be treated as invalid. Applies primarily to parameters that have defined arrays of accepted values, e.g. columnlabels or extendmultiday.

11.5.2 – 2025.01.31

  • Added category attribute to allow filtering events by category. Multiple categories may be included, using the pipe character | as a delimiter. Category names used must exactly match the category names in the feed (case-insensitive). Currently this feature simply excludes events that are not in one of the designated categories. A future update will add support for color-coded categories, similar to the current support for multiple feeds in one calendar shortcode. Note: This feature requires that your ICS feed data includes the CATEGORIES property, which is not widely supported by most popular calendar software.

11.5.1.3 – 2025.01.22

  • Modified logic for maskinfo that would remove the info hover box on multi-day events with specified start and end times.

11.5.1.2 – 2025.01.20

  • Miscellaneous:
    • Added r34ics_ajax_bypass_nonce status to System Report.

11.5.1.1 – 2025.01.08

  • Bug fixes:
    • Added logic to trim extraneous spaces from the beginning and end of all attribute values when parsing the shortcode, and in sanitization logic in r34ics-ajax.php.
    • Added r34ics_color_key_allowed() function and updated r34ics_select_allowed() to merge custom allowed fields with wp_kses_allowed_html('post'). This resolves issues with the color key (legend) that were introduced with changes in v. 11.5.0 and 11.5.1.
    • Changed r34ics_minify_css() handling of whitespace to resolve issues when output is fed through wp_kses_post().
    • Fixed duplicate description output that may result with ALTREP handling introduced in 11.5.1.
    • Fixed handling of feed parsing failures that would cause a fatal error unless the debug parameter is set in the shortcode.

11.5.1 – 2025.01.07

  • Functional enhancements:
    • Added protected R34ICS::_event_field_handling() method to facilitate complex logic (i.e. too much to fit in one line of code) when assigning values in the $event_item array in R34ICS::display_calendar() and related functions. This includes the new r34ics_event_field_handling filter for additional external processing of event data. (If working with the filter, be aware that it is currently only applied to the eventdesc value.) This functionality was specifically added to accommodate changes needed for the ALTREP property described below, but it is open-ended to support additional future enhancements.
  • iCalendar spec support:
    • Added limited support for Thunderbird’s use of the ALTREP parameter in event descriptions. Thunderbird does not appear to conform to the spec — the ALTREP value is not wrapped in quotation marks. However, since this is our first observation of ALTREP in use, our solution is tailored to the Thunderbird output we have observed. Additional feedback on this feature is welcomed.
  • PHP deprecation notices:
    • Modified the event_description_html(), event_label_html() and event_sublabel_html() methods of R34ICS to return empty strings rather than null or false values when empty.
    • Added ?: '' empty string fallback value to all instances of wp_kses_post() added in version 11.5.0, to work around “Deprecated: preg_replace(): Passing null to parameter #3 ($subject) of type array|string is deprecated” warnings. This should technically be addressed within the WordPress core wp_kses_no_null() function. We have opened a Trac ticket. If the core function is modified to handle null values, the then-superfluous ?: '' will be removed from these function calls in a future update.

11.5.0 – 2025.01.03

  • i18n:
    • 자리 표시자가 포함된 각 번역 문자열에 번역자: 주석을 추가했습니다.
    • WordPress 플러그인 디렉터리 요구 사항에 맞게 텍스트 도메인을 r34ics에서 ics-calendar로 변경했습니다. 플러그인에 포함된 번역 파일은 그에 따라 업데이트되었지만 타사 번역이나 Say What과 같은 플러그인을 사용하는 경우 새 텍스트 도메인으로 업데이트해야 할 수 있습니다.”.
    • %s 번역 문자열 자리 표시자를 %1$s로 바꿨습니다.
    • 이스케이프되지 않은 _e()__() 함수의 사용을 해당 이스케이프 함수 esc_html_e(), esc_html__((esc_attr_e((esc_attr__((
    • 위의 변경 사항을 반영하도록 모든 번역 파일을 업데이트했습니다.
  • Miscellaneous:
    • 설정 페이지와 r34ics-ajax.php에서 양식 입력 처리에 추가 살균 기능을 추가했습니다.
    • 템플릿의 동적 플러그인 출력에 텍스트 이스케이프 기능을 추가했습니다.
    • r34ics_select_allowed() 함수를 추가했습니다.
    • 월별 및 주별 보기에서 주 숫자의 CSS 패딩 문제를 수정했습니다.
    • json_encode(), mt_rand(), parse_url()strip_tags()와 같은 특정 표준 PHP 함수의 사용을 WordPress에 해당하는 것으로 대체했습니다 (예.예: wp_json_encode(), wp_rand(), wp_parse_url()wp_strip_tags()).
    • 시스템 보고서의 서버 변수 처리가 업데이트되었습니다.
  • Vendors:
    • 임베디드 ics-parser 라이브러리를 버전 3.4.1로 업데이트했습니다(플러그인 충돌을 방지하기 위해 네임스페이스 변경, Plugin Check가 코딩 오류로 보고하여 오류 메시지에서 변수를 제거).

Full Changelog

변경 로그는 워드프레스 저장소 요구 사항으로 인해 여기에서 잘렸습니다. 이전 로그는 changelog.txt를 참조하세요.