{"id":191,"date":"2023-04-08T14:11:43","date_gmt":"2023-04-08T14:11:43","guid":{"rendered":"https:\/\/docs.joedolson.com\/my-calendar-pro\/?p=191"},"modified":"2025-01-19T23:25:57","modified_gmt":"2025-01-19T23:25:57","slug":"settings-importer","status":"publish","type":"post","link":"https:\/\/docs.joedolson.com\/my-calendar-pro\/settings-importer\/","title":{"rendered":"Settings – Importer"},"content":{"rendered":"\n

Importer is located under My Calendar > My Calendar Pro > Importer.<\/em><\/p>\n\n\n\n

\"My
My Calendar Pro Settings > Importer<\/figcaption><\/figure>\n\n\n\n

Import Events Settings<\/h2>\n\n\n\n

Restrict event import by time<\/strong><\/h3>\n\n\n\n

If you have an import file that contains a wide range of events, you can restrict your import to a subset of those events based on date. <\/p>\n\n\n\n

    \n
  • Ignore events in the past<\/li>\n\n\n\n
  • Ignore events more than a month in the past<\/li>\n\n\n\n
  • Ignore events more than a year in the past<\/li>\n<\/ul>\n\n\n\n

    Import Events from iCal format (.ics)<\/h3>\n\n\n\n
    \"My
    My Calendar Pro Settings > Importer iCal format<\/figcaption><\/figure>\n\n\n\n

    Import to Category<\/strong><\/h3>\n\n\n\n

    If you’re importing an iCal source from a URL, you can assign the events from this URL to a specific category in your calendar. The iCal format doesn’t include any native data that can be used as a category.<\/p>\n\n\n\n

    \n

    Import Events from CSV<\/h3>\n\n\n\n

    A .csv file, or comma separated values file, offers a significantly more flexible way of importing events than the standardized iCal format (.ics). While .ics files are standardized, they’re also quite limited in how they’re structured and what information can be included.<\/p>\n\n\n\n

    The only absolutely required fields are event_title<\/code> and event_begin<\/code>, but you can also automatically generate categories and locations from your CSV import file.<\/p>\n\n\n\n

    Your CSV file must have a header row that includes the field names as listed below, e.g. “event_id,event_title,event_begin”. The header row will be used to map values to My Calendar’s data structures.<\/p>\n\n\n\n

    Supported CSV Fields<\/h3>\n\n\n\n
      \n
    • event_title<\/code> (string): Title<\/li>\n
    • event_begin<\/code> (string): Starting Date<\/li>\n
    • occur_begin<\/code> (string): Starting Date<\/li>\n
    • event_end<\/code> (string): Ending Date<\/li>\n
    • occur_end<\/code> (string): Ending Date<\/li>\n
    • event_time<\/code> (string): Starting Time<\/li>\n
    • event_endtime<\/code> (string): Ending Time<\/li>\n
    • content<\/code> (string): Description<\/li>\n
    • event_desc<\/code> (string): Description<\/li>\n
    • event_short<\/code> (string): Excerpt<\/li>\n
    • event_link<\/code> (string): External event URL<\/li>\n
    • event_link_expires<\/code> (int): Link expiration (0 or 1; 1 means the link will expire after the event.<\/li>\n
    • event_recur<\/code> (string): Recurring frequency period: S – single, D – day, E – weekdays, W – weekly, M – month\/date, U – month\/day, Y – year.<\/li>\n
    • event_repeats<\/code> (string or int): Number of repetitions or date to repeat until. 4 = event repeats 4 times, for a total of 5 occurrences. 2022-05-25 means “repeats until May 25th, 2022”. <\/li>\n
    • event_every<\/code> (int): Recurrence frequency multiplier. event_recur = D and 3 == every 3 days, event_recur = W and 2 == every two weeks.<\/li>\n
    • event_image<\/code> (string): Event Image URL<\/li>\n
    • event_allday<\/code> (int): Event is all-day (0 or 1)<\/li>\n
    • event_author<\/code> (int): Author ID<\/li>\n
    • event_approved<\/code> (int): Publishing status (0: draft, 1: published, 2: trashed)<\/li>\n
    • event_category<\/code> (string or int): Category Name or ID<\/li>\n
    • category_color<\/code> (string): Category Color (hexadecimal triplet with ‘#’)<\/li>\n
    • category_icon<\/code> (string): Category Icon<\/li>\n
    • category_private<\/code> (int): Category Privacy status (1 if private)<\/li>\n
    • event_fifth_week<\/code> (int): Omit week 5 recurrences (1 to omit)<\/li>\n
    • event_holiday<\/code> (int): Cancel on Holidays (1 to cancel)<\/li>\n
    • event_group_id<\/code> (int): Event Group ID<\/li>\n
    • event_span<\/code> (int): Event spans multiple days (0 or 1)<\/li>\n
    • event_hide_end<\/code> (int): Hide end date (0 or 1)<\/li>\n
    • event_status<\/code> (int): Event Status (0: draft, 1: published, 2: trashed) – alias for event_approved<\/li>\n
    • event_flagged<\/code> (int): Event Flagged as Spam (0 or 1)<\/li>\n
    • event_tickets<\/code> (string): Event Tickets Link<\/li>\n
    • event_registration<\/code> (string): Event Registration Info<\/li>\n
    • event_host<\/code> (int): Event Host ID (User ID, or post ID if configured in misc. settings)<\/li>\n
    • event_access<\/code> (string): Event Accessibility Data (a serialized array)<\/li>\n
    • location_preset<\/code> (int): Location ID<\/li>\n
    • event_label<\/code> (string): Location Label<\/li>\n
    • event_street<\/code> (string): Location Street<\/li>\n
    • event_street2<\/code> (string): Location Street (2)<\/li>\n
    • event_city<\/code> (string): Location City<\/li>\n
    • event_state<\/code> (string): Location State<\/li>\n
    • event_postcode<\/code> (string): Location Postcode<\/li>\n
    • event_region<\/code> (string): Location Region<\/li>\n
    • event_country<\/code> (string): Location Country<\/li>\n
    • event_url<\/code> (string): Location URL<\/li>\n
    • event_phone<\/code> (string): Location Phone Number<\/li>\n
    • event_phone2<\/code (string)>: Alternate Location Phone<\/li>\n
    • event_longitude<\/code> (float): Location longitude (<\/li>\n
    • event_latitude<\/code> (float): Location latitude<\/li>\n
    • event_zoom<\/code> (int): Map zoom level<\/li>\n
    • event_location<\/code> (int): Location ID in locations table – assign a location to the event<\/li>\n
    • UID<\/code> (string): Unique event ID. If an event exists with this UID already, it will be updated instead of added.<\/li>\n
    • event_added<\/code> (string): Date this event was added to source calendar<\/li>\n<\/ul>\n\n\n\n

      Notes<\/p>\n\n\n\n

        \n
      • Category name, color, icon, and privacy fields are only applied if the value passed in event_category<\/code> does not already exist. If a category name is supplied that is already present, the category will not be updated to match.<\/li>\n\n\n\n
      • Event Approval status is only managed when an imported event is being updated.<\/li>\n<\/ul>\n<\/div><\/div>\n\n\n\n

        Remote import frequency<\/strong><\/h3>\n\n\n\n

        When importing events by URL, you can set a regular import schedule. This is useful for importing from sources that update periodically. As long as the import source includes a unique ID field, you won’t have to worry about importing duplicate events. <\/p>\n\n\n\n

        The import frequencies are based on your existing cron schedules, so they may vary, but the default frequencies are:<\/p>\n\n\n\n

          \n
        • One time import<\/li>\n\n\n\n
        • Once Weekly<\/li>\n\n\n\n
        • Once Monthly<\/li>\n\n\n\n
        • Once Hourly<\/li>\n\n\n\n
        • Twice Daily<\/li>\n\n\n\n
        • Once Daily<\/li>\n<\/ul>\n\n\n\n

          Scheduled Imports<\/h2>\n\n\n\n

          In the “Remote import frequency” drop down. Selecting Once Weekly\/Monthly\/Hourly\/Daily or Twice Daily. Opens the Scheduled Imports. Here is an example from selecting Once Weekly.<\/p>\n\n\n\n

          \"My
          My Calendar Pro Settings > Importer – Scheduled Imports Once Weekly<\/figcaption><\/figure>\n\n\n\n

          When you schedule an event import, the first automatic import will be scheduled for the future at the end of the current interval. To get the current events, complete the import in the same way you would for a one-time import. If you do not complete the one-time import, the schedule will still be established.<\/p>\n\n\n\n

          Individual scheduled imports can be deleted, but not edited.<\/p>\n","protected":false},"excerpt":{"rendered":"

          Importer is located under My Calendar > My Calendar Pro > Importer. Import Events Settings Restrict event import by time If you have an import file that contains a wide range of events, you can restrict your import to a subset of those events based on date. Import Events from iCal format (.ics) Import to Category […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2,17],"tags":[],"class_list":["post-191","post","type-post","status-publish","format-standard","hentry","category-admin","category-settings"],"_links":{"self":[{"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/posts\/191","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/comments?post=191"}],"version-history":[{"count":10,"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/posts\/191\/revisions"}],"predecessor-version":[{"id":192,"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/posts\/191\/revisions\/192"}],"wp:attachment":[{"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/media?parent=191"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/categories?post=191"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.joedolson.com\/my-calendar-pro\/wp-json\/wp\/v2\/tags?post=191"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}