feature: Add calendar layout and occurrence handling functionality

- Introduced `calendar-layout.php` to manage month grid generation, occurrence intersection checks, and segment assignments for events.
- Added `occurrences.php` for normalizing, validating, and displaying event occurrences, including migration from legacy formats.
- Implemented functions for parsing dates, validating occurrence ranges, and formatting occurrences for display.
- Established hooks for synchronizing event occurrence data upon saving posts and validating ACF repeater fields.
This commit is contained in:
Keith Solomon
2026-07-06 10:26:36 -05:00
parent 6ba917bf9b
commit 42ff7754cb
16 changed files with 2205 additions and 344 deletions
+168 -32
View File
@@ -13,6 +13,8 @@
.aa-events-calendar-header {
align-items: center;
display: flex;
flex-wrap: wrap;
gap: 0.625rem;
justify-content: space-between;
margin-bottom: 0.625rem;
}
@@ -26,46 +28,129 @@
padding: 0.5rem 1rem;
text-decoration: none;
&:hover { background: #eee; }
}
.aa-events-calendar {
border-collapse: collapse;
table-layout: fixed;
width: 100%;
.aa-events-calendar-today-btn:hover,
.aa-events-calendar-today-btn:focus-visible {
background: #eee;
}
th, td {
border: 1px solid #aaa;
padding: 0.625rem;
text-align: left;
vertical-align: top;
}
.aa-events-calendar-grid {
border-left: 1px solid #aaa;
border-top: 1px solid #aaa;
max-width: 100%;
min-width: 0;
}
th {
background-color: #f5f5f5;
text-align: center;
}
.aa-events-calendar-weekdays {
display: grid;
grid-template-columns: repeat(7, minmax(0, 1fr));
}
td { height: 9.375rem; }
.aa-events-calendar-weekday {
background: #f5f5f5;
border-bottom: 1px solid #aaa;
border-right: 1px solid #aaa;
font-weight: bold;
min-width: 0;
overflow: hidden;
padding: 0.625rem 0.25rem;
text-align: center;
}
.day-number {
font-weight: bold;
margin-bottom: 0.3125rem;
}
.aa-events-calendar-weekday abbr {
text-decoration: none;
}
.today-cell {
background: #ffe9b3;
border: 2px solid #f7b500;
font-weight: bold;
}
.aa-events-calendar-week {
display: grid;
grid-template-columns: repeat(7, minmax(0, 1fr));
min-height: calc(7.5rem + (var(--aa-event-lanes, 1) * 1.75rem));
position: relative;
}
.events-list {
list-style: none;
margin: 0;
padding: 0;
.aa-events-calendar-day {
border-bottom: 1px solid #aaa;
border-right: 1px solid #aaa;
min-width: 0;
padding: 0.5rem;
}
li { margin-bottom: 0.3125rem; }
}
.aa-events-calendar-day .day-number {
display: block;
font-weight: bold;
margin-bottom: 0.3125rem;
}
.aa-events-calendar-day.is-outside-month {
background: #f7f7f7;
color: #666;
}
.aa-events-calendar-day.today-cell {
background: #fff3cf;
box-shadow: inset 0 0 0 2px #b57900;
font-weight: bold;
}
.aa-events-calendar-event {
align-items: center;
background: #245b87;
border-radius: 0.25rem;
box-sizing: border-box;
color: #fff;
display: flex;
gap: 0.25rem;
height: 1.5rem;
left: calc(((100% / 7) * var(--aa-event-column)) + 0.2rem);
line-height: 1.5rem;
min-width: 0;
overflow: hidden;
padding: 0 0.375rem;
position: absolute;
text-decoration: none;
top: calc(2.25rem + (var(--aa-event-lane) * 1.75rem));
white-space: nowrap;
width: calc(((100% / 7) * var(--aa-event-span)) - 0.4rem);
z-index: 1;
}
.aa-events-calendar-event > span:not(.aa-events-calendar-continuation) {
min-width: 0;
overflow: hidden;
text-overflow: ellipsis;
}
.aa-events-calendar-event.is-continuing-before {
border-bottom-left-radius: 0;
border-top-left-radius: 0;
}
.aa-events-calendar-event.is-continuing-after {
border-bottom-right-radius: 0;
border-top-right-radius: 0;
}
.aa-events-calendar-continuation {
flex: 0 0 auto;
font-weight: bold;
line-height: 1;
}
.aa-events-calendar-event:hover {
background: #163d5d;
text-decoration: underline;
}
.aa-events-calendar-event:focus-visible {
background: #163d5d;
outline: 3px solid #111;
outline-offset: 2px;
z-index: 2;
}
.aa-events-calendar-agenda {
display: none;
}
.aa-event-item .aa-event-details {
@@ -89,7 +174,58 @@
}
@media (max-width: 640px) {
.aa-events-wrap .aa-events-grid { grid-template-columns: 1fr; }
.aa-events-wrap .aa-events-grid { grid-template-columns: 1fr; }
.aa-events-calendar-desktop { display: none; }
.aa-events-calendar-agenda { display: block; }
.aa-events-calendar-agenda-list {
list-style: none;
margin: 0;
padding: 0;
}
.aa-events-agenda-item + .aa-events-agenda-item { margin-top: 0.75rem; }
.aa-events-agenda-item > a {
border: 1px solid #aaa;
border-left: 0.25rem solid #245b87;
border-radius: 0.25rem;
display: block;
min-width: 0;
overflow-wrap: anywhere;
padding: 0.75rem;
text-decoration: underline;
}
.aa-events-agenda-item > a:hover { background: #f5f5f5; }
.aa-events-agenda-item > a:focus-visible {
outline: 3px solid currentColor;
outline-offset: 2px;
}
.aa-events-agenda-title,
.aa-events-agenda-item time {
display: block;
overflow-wrap: anywhere;
}
.aa-events-agenda-title { font-weight: bold; }
.aa-events-agenda-item .screen-reader-text {
border: 0;
clip: rect(1px, 1px, 1px, 1px);
clip-path: inset(50%);
height: 1px;
margin: -1px;
overflow: hidden;
padding: 0;
position: absolute;
width: 1px;
word-wrap: normal !important;
}
}
.aa-events-wrap .entry-header:has(.entry-thumbnail),
+69
View File
@@ -0,0 +1,69 @@
(function($) {
'use strict';
// Guard against a jQuery UI datepicker crash in the block editor meta box area.
// In some contexts, _findPos receives a node with no positioned parent and throws.
if ($.datepicker && $.datepicker._findPos) {
var originalFindPos = $.datepicker._findPos;
$.datepicker._findPos = function(obj) {
try {
if (!obj || !obj.ownerDocument || !obj.ownerDocument.documentElement) {
return [0, 0];
}
return originalFindPos.call(this, obj);
} catch (e) {
return [0, 0];
}
};
}
// After repeater rows are appended, remove accidental focus from date inputs
// so datepicker doesn't try to open against a transient/hidden element.
if (window.acf && window.acf.addAction) {
window.acf.addAction('append', function($el) {
var $dateInputs = $el.find('.acf-date-picker input.hasDatepicker');
if ($dateInputs.length) {
setTimeout(function() {
$dateInputs.first().trigger('blur');
}, 0);
}
});
}
function syncAllDayRows($scope) {
var $repeaters = $scope.find('.acf-field[data-name="event_dates"]')
.addBack('.acf-field[data-name="event_dates"]')
.add($scope.closest('.acf-field[data-name="event_dates"]'));
$repeaters.find('.acf-row').each(function() {
var $row = $(this);
var checked = $row.find('.acf-field[data-name="all_day"] input[type="checkbox"]').first().is(':checked');
var $timeFields = $row.find('.acf-field[data-name="start_time"], .acf-field[data-name="end_time"]');
$row.toggleClass('aa-events-is-all-day', checked);
$timeFields.toggle(!checked).attr('aria-hidden', checked ? 'true' : 'false');
$timeFields.find('input').prop('disabled', checked);
});
}
$(document).on('change', '.acf-field[data-name="event_dates"] .acf-field[data-name="all_day"] input[type="checkbox"]', function() {
var $checkbox = $(this);
var $row = $checkbox.closest('.acf-row');
if ($checkbox.is(':checked')) {
$row.find('.acf-field[data-name="start_time"] input, .acf-field[data-name="end_time"] input').val('');
}
syncAllDayRows($row.closest('.acf-field[data-name="event_dates"]'));
});
$(function() {
syncAllDayRows($(document));
});
if (window.acf && window.acf.addAction) {
window.acf.addAction('ready', function($el) {
syncAllDayRows($el || $(document));
});
window.acf.addAction('append', function($el) {
syncAllDayRows($el);
});
}
})(jQuery);