README

Show upcoming calendar events in the Mail (mailbox) view.

What it does

• Adds a panel in the Mailbox view that lists upcoming events for the next N days.
• Adds a toggle in Settings → Preferences → Mailbox View → Upcoming Events (Mailbox View):
  • Display Upcoming Events (on/off)
  • Days to show ahead

Requirements

• Roundcube 1.5+ (tested against PHP 8+ constructs)
• The official calendar plugin enabled (Kolab calendar or texxasrulez calendar).

Installation

1. Copy the folder calender_inboxview into plugins/ on your Roundcube server.
2. Add calender_inboxview to the $config['plugins'] array in config/config.inc.php.
3. Optionally copy config.inc.php.dist to config.inc.php and adjust settings.
4. In Roundcube, go to Settings → Preferences → Mailbox View and enable Display Upcoming Events.

How it fetches events

By default, the plugin tries to call the Calendar plugin's JSON event list endpoint using the current user session. Different calendar plugin versions expose slightly different action names. This plugin tries a few common ones:

• _action=event_list
• _action=load_events
• _action=list

It also attempts both Unix timestamps and ISO strings for the start/end parameters. If your calendar responds on a different action name, let me know — it's trivial to add another try.

If nothing matches, the panel gracefully shows No upcoming events. You can also switch the provider to "dummy" in config.inc.php to validate the UI without touching calendars.

Skinning

• Basic styles for classic and elastic skins are included. If your custom skin is named differently, the plugin will fall back to the classic stylesheet.

Localization

The localization/ folder contains labels with keys like:

• ci_prefs_section, ci_display_upcoming, ci_days_ahead, ci_panel_title, ci_no_events

Notes

• The panel mounts just under the folder list in most skins. If your layout is exotic, adjust the findMountPoint() selector list in js/calender_inboxview.js.

Screenshot

Versioning

• calender_inboxview now keeps its canonical version in calender_inboxview::PLUGIN_VERSION inside calender_inboxview.php.
• calender_inboxview::info() exposes the plugin metadata array used for self-identification.
• Development builds should use a +dev suffix such as 1.0.0+dev.
• Release builds should use a clean tagged version such as 1.0.0.

For a release bump:

1. Update calender_inboxview::PLUGIN_VERSION in calender_inboxview.php or run sh scripts/bump-version.sh 1.0.0.
2. Update CHANGELOG.md.
3. Create the matching release tag after verification.