پرش به مستندات
پایگاه دانش

تقویم‌ها از طریق CalDAV

تقویم یک نشانی را با Apple Calendar، Thunderbird، DAVx5 روی Android و هر برنامهٔ CalDAV دیگری همگام نگه دارید، با ورود از طریق گذرواژهٔ برنامه.

تنظیمات

برنامهٔ تقویم با همان نام کاربری و گذرواژهٔ برنامه‌ای که برنامهٔ ایمیل به کار می‌برد وارد می‌شود و به تقویم همان یک نشانی دسترسی پیدا می‌کند.

تنظیممقدار
سرورapi.openemail.uk، درگاه 443، HTTPS
URL کاملhttps://api.openemail.uk/dav/، برای برنامه‌هایی که URL می‌خواهند
نام کاربرینشانی کامل، مانند [email protected]
گذرواژهیک گذرواژهٔ برنامه برای همان نشانی، از همان نوعی که برنامهٔ ایمیل به کار می‌برد
  • برنامه‌های تقویم بقیه را خودشان پیدا می‌کنند: /.well-known/caldav آن‌ها را به /dav/ و از آنجا به تقویم‌های نشانی می‌فرستد.
  • دیدن تقویم به اجازهٔ خواندن آن نیاز دارد، و تغییر رویدادها به اجازهٔ تغییر آن.
  • گذرواژه‌ای که از طریق پیوند راه‌اندازی ساخته شود، علاوه بر نامه‌ها تقویم را هم باز می‌کند، اما هرگز مخاطبان را باز نمی‌کند.
  • تقویم را می‌توان برای یک نشانی با کلید CalDAV آن خاموش کرد، در زبانهٔ «برنامه‌های ایمیل» و در نمای «سرورها».
  • مخاطبان هم به همین شکل از طریق CardDAV، با همان سرور، نام کاربری و گذرواژه، همگام می‌شوند.

Calendar روی iPhone و iPad

  1. «Settings»، سپس «Apps»، بعد «Calendar» و سپس «Calendar Accounts» را باز کنید.
  2. روی «Add Account»، سپس «Other» و بعد «Add CalDAV Account» بزنید.
  3. api.openemail.uk را در «Server»، نشانی کامل را در «User Name»، گذرواژهٔ برنامه را در «Password» و توضیحی مانند «کار» را در «Description» وارد کنید. روی «Next» بزنید.
  4. «Calendars» را روشن بگذارید، «Reminders» را خاموش کنید و روی «Save» بزنید.
  • نمایهٔ زبانهٔ «برنامه‌های ایمیل»، تقویم و Mail را با هم و در یک گام اضافه می‌کند.
  • OpenEmail فقط رویدادها را نگه می‌دارد، پس یادآورها روی دستگاه می‌مانند.

Calendar روی Mac

  1. برنامهٔ Calendar را باز کنید و «Calendar» و سپس «Add Account» را انتخاب کنید.
  2. «Other CalDAV Account» و سپس «Continue» را انتخاب کنید.
  3. «Account Type» را روی «Manual» بگذارید، نشانی کامل را در «User Name»، گذرواژهٔ برنامه را در «Password» و api.openemail.uk را در «Server Address» وارد کنید و «Sign In» را انتخاب کنید.

اگر «Manual» تقویمی پیدا نکرد، به‌جای آن «Advanced» را انتخاب کنید، با «Server Address» برابر api.openemail.uk، «Server Path» برابر /dav/، «Port» برابر 443 و «Use SSL» روشن.

Thunderbird

  1. زبانهٔ «Calendar» را باز کنید و «New Calendar» را انتخاب کنید.
  2. «On the Network» و سپس «Next» را انتخاب کنید.
  3. نشانی کامل را در «Username» و https://api.openemail.uk/dav/ را در «Location» وارد کنید و «Find Calendars» را انتخاب کنید.
  4. وقتی خواسته شد، با گذرواژهٔ برنامه وارد شوید. Thunderbird تقویم‌های نشانی را فهرست می‌کند. تقویم‌هایی را که می‌خواهید تیک بزنید و «Subscribe» را انتخاب کنید.

Android، با DAVx5

  1. DAVx5 را از Google Play یا F-Droid نصب کنید و بازش کنید.
  2. روی دکمهٔ + بزنید و «Login with URL and user name» را انتخاب کنید.
  3. https://api.openemail.uk/dav/ را در «Base URL»، نشانی کامل را در «User name» و گذرواژهٔ برنامه را در «Password» وارد کنید، سپس روی «Login» بزنید.
  4. نشانی کامل را به‌عنوان نام حساب نگه دارید، که DAVx5 آن را به‌عنوان برگزارکنندهٔ رویدادهایی که می‌سازید به کار می‌برد، و روی «Create account» بزنید.
  5. زبانهٔ «CalDAV» حساب تازه را باز کنید و تقویم‌هایی را که باید همگام شوند تیک بزنید. پس از آن، این تقویم‌ها در Google Calendar و هر برنامهٔ تقویم دیگری روی گوشی نمایش داده می‌شوند.

DAVx5 در فاصلهٔ زمانی‌ای که در تنظیمات حساب تعیین شده همگام‌سازی می‌کند، و دکمهٔ همگام‌سازی آن بی‌درنگ همگام می‌کند.

آنچه برنامهٔ تقویم می‌بیند

  • برنامهٔ تقویمی که با یک نشانی وارد شده، رویدادهایی را می‌بیند که آن نشانی برگزار می‌کند یا به آن‌ها دعوت شده است، و نیز رویدادهایی را که خودتان ساخته‌اید. اشتراک‌های شما کنار آن‌ها به‌صورت تقویم‌های فقط‌خواندنی نمایش داده می‌شوند.
  • تقویم در برنامه با نام OpenEmail نشان داده می‌شود. هر اشتراک نامی را که به آن داده‌اید حفظ می‌کند، و تغییر نام آن در برنامه، نامش را در OpenEmail هم تغییر می‌دهد.
  • رویدادهای حدود سه سال پیش تا ده سال آینده همگام می‌مانند. رویدادهای قدیمی‌تر و دیرتر در OpenEmail می‌مانند.
  • هر رویداد می‌تواند تا 1 MB باشد. وظیفه‌ها و یادآورها نگه داشته نمی‌شوند.
  • برنامه‌هایی که زمان آزاد افراد را جست‌وجو می‌کنند، می‌توانند ببینند نشانی‌های دیگر فضای کاری کی مشغول‌اند، هر بار تا 120 روز.
آنچه برنامه می‌خواهدمسیر
کشف خودکار/.well-known/caldav، که به /dav/ هدایت می‌کند
Principal/dav/principals/{principal}/، که در آن {principal} شناسهٔ نشانی است
خانهٔ تقویم/dav/calendars/{principal}/
رویدادها/dav/calendars/{principal}/events/
اشتراک‌ها/dav/calendars/{principal}/sub- به‌همراه شناسهٔ هر کدام، فقط‌خواندنی

دعوت‌ها و پاسخ‌ها

  • دعوت کردن افراد از برنامهٔ تقویم، دعوت‌های واقعی از همان نشانی می‌فرستد، و پاسخ دادن به دعوت در آنجا، مثل دکمه‌های OpenEmail، به برگزارکننده خبر می‌دهد. تغییر رویدادها به اجازهٔ تغییر تقویم نیاز دارد، و فرستادن دعوت‌ها به اجازهٔ فرستادن از آن نشانی.
  • تغییر زمان، مکان یا جزئیات رویدادی که برگزار کرده‌اید برای مهمانان به‌روزرسانی می‌فرستد، و حذف یک مهمان برای همان مهمان پیام لغو می‌فرستد.
  • حذف رویدادی که با مهمانان برگزار کرده‌اید، آن را برای همهٔ آن‌ها لغو می‌کند. حذف دعوتی که دریافت کرده‌اید، آن را رد می‌کند.

Google Calendar و Outlook

Google Calendar و Outlook.com نمی‌توانند به سرور تقویم دیگری وارد شوند، پس به‌جای آن یک پیوند تقویم به آن‌ها بدهید.

اگر کار نکرد

  • برنامه مدام گذرواژه را می‌خواهد: نام کاربری باید نشانی کامل باشد و گذرواژه باید یک گذرواژهٔ برنامه برای آن باشد. OpenEmail به چنین ورودی با پیام «Sign in with your email address and an app password from OpenEmail» پاسخ می‌دهد.
  • برنامه وارد می‌شود اما تقویمی پیدا نمی‌کند: بررسی کنید که سرور api.openemail.uk باشد، نه دامنهٔ نشانی، یا URL کامل https://api.openemail.uk/dav/ را وارد کنید.
  • «This kind of connection is turned off for this address»: کلید CalDAV نشانی خاموش است. از مالک فضای کاری، یا کسی که دامنه‌ها را مدیریت می‌کند، بخواهید آن را روشن کند.
  • رویدادها را نمی‌توان تغییر داد: صاحب گذرواژه فقط می‌تواند تقویم را بخواند، یا رویداد متعلق به یک اشتراک است.
  • باطل کردن گذرواژهٔ برنامه، برنامهٔ تقویم را ظرف حدود پنج دقیقه خارج می‌کند.