{"id":812,"date":"2024-05-17T15:06:01","date_gmt":"2024-05-17T19:06:01","guid":{"rendered":"https:\/\/sites.bu.edu\/marcom-team\/?page_id=812"},"modified":"2025-09-03T17:25:04","modified_gmt":"2025-09-03T21:25:04","slug":"calendar","status":"publish","type":"page","link":"https:\/\/sites.bu.edu\/marcom-team\/departments\/interactive-design\/role-specific-info\/info-for-developers\/calendar\/","title":{"rendered":"Working with BU Calendar"},"content":{"rendered":"

BU has a custom phpbin<\/code> Calendar App that is the source for all the BU Calendar pages.<\/span><\/p>\n

The calendar app data is fed into<\/em> WordPress sites via the calendar #id<\/code> [in the URL, at the end of the string] and custom coded within each site.
\nThis is usually some custom html, or custom WordPress templates.<\/span><\/p>\n

<\/p>\n

Example<\/h4>\n

University Bands Calendar<\/a>,<\/span>
\n<\/span>Located at: http:\/\/www.bu.edu\/bands\/calendar\/<\/span><\/p>\n

Is powered by this data:<\/span>
\n<\/span>http:\/\/www.bu.edu\/phpbin\/calendar\/app\/calendar.php?id=47<\/span><\/a><\/p>\n

[Using the page template in the responsive framework 2x:<\/span>
\n<\/span>https:\/\/github.com\/bu-ist\/responsive-framework\/blob\/master\/inc\/calendar.php<\/span><\/a>]<\/p>\n

<\/div>\n

 <\/p>\n

Common Tasks & Issues<\/strong><\/h2>\n

When developing in a sandbox it is helpful to have data to match production. But, by default, sandbox sites are pointed to a development version of the calendar that is usually out of sync with the main University calendar.<\/span><\/p>\n

Making Calendar Data Viewable in Sandbox<\/strong><\/h2>\n

Requesting Permission to Add Events To A Calendar<\/strong><\/h4>\n

Each individual calendar has its own Access permissions. If you are looking at a calendar in the development environment and do not see the New Events, Topics, Options, and Sharing in the menu bar then you do not have access to add events.<\/span><\/p>\n

Request Access<\/strong><\/h4>\n
    \n
  1. Post the calendar URL in the #Interactive-Design Slack channel and ask if anyone in ID has admin access that can add you as an admin.<\/span><\/li>\n
  2. If there are no general admins for that calendar, Slack Steve @srudolfi or Adam @adamzp\u00a0 in Slack ( Global Access Owners ) and request they add you to the calendar as an admin.<\/span><\/li>\n<\/ol>\n

    Ask #WebTeam slack channel<\/strong><\/h4>\n

    Ask the #WebTeam channel in slack to copy the data over from Prod to your sandbox environment, usually this will request will be completed by Adam P. They will export the prod database and import that database into your sandbox development environment.<\/span><\/p>\n

     <\/p>\n

    Update Sandbox BU Calendar Plugin Constants<\/strong><\/h2>\n

    <\/span><\/p>\n

    Caution: This method will point all calendar links in your sandbox to production. <\/strong><\/span>Do not edit the production calendar unless that is your intention.<\/strong><\/span><\/h4>\n

    <\/div><\/span><\/p>\n

    In Your Sandbox:<\/strong><\/h4>\n

    In the php file located at: wp-content\/mu-plugins\/bu-calendar\/bu-calendar.php<\/code>, a<\/strong><\/span>dd this line to the top of the file<\/strong>:<\/span><\/p>\n\n\n\n
    1<\/span><\/td>\ndefine( ‘DEV_BU_CALENDAR_RPC_URI’, ‘<\/span>http:\/\/www.bu.edu\/phpbin\/calendar\/rpc<\/span><\/a>‘ );<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    In the php file located at: wp-content\/mu-plugins\/bu-calendar\/calendar.php<\/code>, c<\/span>omment out the existing endpoints and replace with new<\/em><\/strong> endpoints with the new constant:<\/span><\/p>\n\n\n\n
    1<\/span><\/p>\n

    2<\/span><\/p>\n

    3<\/span><\/p>\n

    4<\/span><\/p>\n

    5<\/span><\/p>\n

    6<\/span><\/p>\n

    7<\/span><\/p>\n

    8<\/span><\/p>\n

    9<\/span><\/p>\n

    10<\/span><\/p>\n

    11<\/span><\/td>\n

    		\/\/\u00a0 const CALENDARS_ENDPOINT = BU_CALENDAR_RPC_URI\u00a0 . ‘\/calendars.php?cid=’;<\/span><\/p>\n

    \/\/\u00a0 const EVENTS_ENDPOINT = BU_CALENDAR_RPC_URI\u00a0 . ‘\/events.php?cid=’;<\/span><\/p>\n

    \/\/\u00a0 const EVENT_ENDPOINT = BU_CALENDAR_RPC_URI\u00a0 . ‘\/event.php?cid=’;<\/span><\/p>\n

    \/\/\u00a0 const FIELDS_ENDPOINT = BU_CALENDAR_RPC_URI\u00a0 . ‘\/fields.php?cid=’;<\/span><\/p>\n

    \/\/\u00a0 const TOPICS_ENDPOINT = BU_CALENDAR_RPC_URI\u00a0 . ‘\/topics.php?cid=’;<\/span><\/p>\n

    \u00a0<\/span><\/p>\n

    \u00a0\u00a0\u00a0\u00a0const CALENDARS_ENDPOINT = DEV_BU_CALENDAR_RPC_URI\u00a0 . ‘\/calendars.php?cid=’;<\/span><\/p>\n

    \u00a0\u00a0\u00a0\u00a0const EVENTS_ENDPOINT<\/span> = DEV_BU_CALENDAR_RPC_URI\u00a0 . ‘\/events.php?cid=’;<\/span><\/p>\n

    \u00a0\u00a0\u00a0\u00a0const EVENT_ENDPOINT <\/span> = DEV_BU_CALENDAR_RPC_URI\u00a0 . ‘\/event.php?cid=’;<\/span><\/p>\n

    \u00a0\u00a0\u00a0\u00a0const FIELDS_ENDPOINT<\/span> = DEV_BU_CALENDAR_RPC_URI\u00a0 . ‘\/fields.php?cid=’;<\/span><\/p>\n

    \u00a0\u00a0\u00a0\u00a0const TOPICS_ENDPOINT<\/span> = DEV_BU_CALENDAR_RPC_URI\u00a0 . ‘\/topics.php?cid=’;<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    After the file’s been uploaded to the desired sandbox, wait about 30 minutes for the transients to clear and the calendar to refresh. In some cases it may take as long as 45 minutes.<\/span><\/p>\n

     <\/p>\n

    Adding BU Calendar ID<\/strong><\/h2>\n

    <\/span><\/p>\n

    If you don\u2019t know the Calendar ID<\/strong>, go to the site you want the ID from, select settings > Site Options from the dashboard. Then, click the link for changing existing options as depicted above and search for the calendar ID. ( Or go into the database and search on the options table for the option_name<\/code>: bu_calendar_id<\/code> ).<\/div><\/span><\/p>\n

    For a calendar to show, there needs to be a BU Calendar ID in the site options. <\/span>Sometimes on a fresh site or on a sandbox site there will often be no calendar ID defined.<\/span><\/p>\n

    To add a new calendar ID go to Settings<\/strong> > Site Options<\/strong> in the dashboard of your sandbox site.<\/span><\/p>\n

    Add the option name bu_calendar_id<\/code> and the option value will be the integer of the calendar you want to show. The main [University-wide] BU Calendar id is 17<\/strong>. Using this ID can be helpful during development testing, when you just need an example of calendar events in general and it doesn\u2019t need to be specific to the site.<\/span><\/p>\n

    Caching<\/strong><\/h4>\n

    The cache on the average devl<\/code> calendar takes about 30\u201345 minutes to clear. If you, or a designer, needs to make changes, or add events: be patient, and check back in 30 minutes.<\/span><\/p>\n

    <\/h4>\n

    Calendar URLs<\/strong><\/h2>\n

    All Available Calendars Within The App [Listing]<\/strong><\/span><\/h3>\n

    Located at: http:\/\/www.bu.edu\/phpbin\/calendar\/app\/calendars.php<\/span><\/a><\/p>\n

    Official BU Calendar Plugin Documentation<\/strong><\/span><\/h3>\n

    Located at: http:\/\/developer.bu.edu\/webteam\/applications\/calendar\/<\/span><\/a><\/p>\n

    Main University Calendar<\/strong><\/h3>\n

    Located at: http:\/\/www.bu.edu\/calendar\/<\/span><\/a><\/p>\n

    Development Calendar<\/strong><\/h3>\n

    Located at: http:\/\/www-devl.bu.edu\/nisdev\/php5\/calendar\/app\/calendar.php?id=1386<\/a><\/span><\/p>\n

    Production Calendar<\/strong><\/h3>\n

    http:\/\/www.bu.edu\/phpbin\/calendar\/app\/calendar.php?id=1386<\/span><\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

    BU has a custom phpbin Calendar App that is the source for all the BU Calendar pages. The calendar app data is fed into WordPress sites via the calendar #id [in the URL, at the end of the string] and custom coded within each site. This is usually some custom html, or custom WordPress templates. […]<\/p>\n","protected":false},"author":12906,"featured_media":0,"parent":230,"menu_order":6,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/pages\/812"}],"collection":[{"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/users\/12906"}],"replies":[{"embeddable":true,"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/comments?post=812"}],"version-history":[{"count":5,"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/pages\/812\/revisions"}],"predecessor-version":[{"id":2595,"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/pages\/812\/revisions\/2595"}],"up":[{"embeddable":true,"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/pages\/230"}],"wp:attachment":[{"href":"https:\/\/sites.bu.edu\/marcom-team\/wp-json\/wp\/v2\/media?parent=812"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}