ILIAS  trunk Revision v11.0_alpha-2638-g80c1d007f79
class.ilCalendarMonthGUI.php
Go to the documentation of this file.
1 <?php
2 
19 declare(strict_types=1);
20 
28 {
29  protected int $bkid; // booking user
30  protected int $num_appointments = 1;
31  protected array $schedule_filters = array();
32 
35  protected string $timezone = 'UTC';
36 
37  public function __construct(ilDate $seed_date)
38  {
40  $this->bkid = $this->initBookingUserFromQuery();
41  }
42 
43  public function setBkId(int $bkid = 0): void
44  {
45  $this->bkid = $bkid;
46  }
47 
48  public function initialize(int $a_calendar_presentation_type): void
49  {
50  parent::initialize($a_calendar_presentation_type);
51  $this->tabs_gui->setSubTabActive('app_month');
52  $this->user_settings = ilCalendarUserSettings::_getInstanceByUserId($this->user->getId());
53  $this->app_colors = new ilCalendarAppointmentColors($this->user->getId());
54  if ($this->user->getTimeZone()) {
55  $this->timezone = $this->user->getTimeZone();
56  }
57  }
58 
59  public function executeCommand(): void
60  {
61  $this->ctrl->saveParameter($this, 'seed');
62 
63  $next_class = $this->ctrl->getNextClass();
64  switch ($next_class) {
65  case "ilcalendarappointmentpresentationgui":
66  $this->ctrl->setReturn($this, "");
67  $gui = ilCalendarAppointmentPresentationGUI::_getInstance($this->seed, (array) $this->getCurrentApp());
68  $this->ctrl->forwardCommand($gui);
69  break;
70  case 'ilcalendarappointmentgui':
71  $this->ctrl->setReturn($this, '');
72  $this->tabs_gui->setSubTabActive((string) ilSession::get('cal_last_tab'));
73  // initial date for new calendar appointments
74  $idate = new ilDate($this->initInitialDateFromQuery(), IL_CAL_DATE);
75  $app = new ilCalendarAppointmentGUI($this->seed, $idate, $this->initAppointmentIdFromQuery());
76  $this->ctrl->forwardCommand($app);
77  break;
78 
79  default:
80  $time = microtime(true);
81  $cmd = $this->ctrl->getCmd("show");
82  $this->$cmd();
83  $this->main_tpl->setContent($this->tpl->get());
84  break;
85  }
86  }
87 
91  public function addScheduleFilter(ilCalendarScheduleFilter $a_filter): void
92  {
93  $this->schedule_filters[] = $a_filter;
94  }
95 
96  public function show(): void
97  {
98  $this->tpl = new ilTemplate('tpl.month_view.html', true, true, 'components/ILIAS/Calendar');
99 
101 
102  $navigation = new ilCalendarHeaderNavigationGUI($this, $this->seed, ilDateTime::MONTH);
103  $this->tpl->setVariable('NAVIGATION', $navigation->getHTML());
104 
105  for ($i = $this->user_settings->getWeekStart(); $i < (7 + $this->user_settings->getWeekStart()); $i++) {
106  $this->tpl->setCurrentBlock('month_header_col');
107  $this->tpl->setVariable('TXT_WEEKDAY', ilCalendarUtil::_numericDayToString($i, true));
108  $this->tpl->parseCurrentBlock();
109  }
110 
111  if ($this->bkid) {
113  $disable_empty = true;
114  $no_add = true;
115  } else {
116  if ($this->user->getId() == ANONYMOUS_USER_ID) {
117  $user_id = $this->user->getId();
118  $disable_empty = false;
119  $no_add = true;
120  } else {
121  $user_id = $this->user->getId();
122  $disable_empty = false;
123  $no_add = false;
124  }
125  }
126 
127  $is_portfolio_embedded = false;
129  $no_add = true;
130  $is_portfolio_embedded = true;
131  }
132  $scheduler = new ilCalendarSchedule($this->seed, ilCalendarSchedule::TYPE_MONTH, $user_id);
133  $scheduler->addSubitemCalendars(true);
134  if (sizeof($this->schedule_filters)) {
135  foreach ($this->schedule_filters as $filter) {
136  $scheduler->addFilter($filter);
137  }
138  }
139  $scheduler->calculate();
140 
141  $settings = ilCalendarSettings::_getInstance();
142 
143  $counter = 0;
145  (int) $this->seed->get(IL_CAL_FKT_DATE, 'm'),
146  (int) $this->seed->get(IL_CAL_FKT_DATE, 'Y'),
147  $this->user_settings->getWeekStart()
148  )->get() as $date) {
149  $counter++;
150  $has_events = (bool) $this->showEvents($scheduler, $date);
151 
152  if (!$this->view_with_appointments && $has_events) {
153  $this->view_with_appointments = true;
154  }
155 
156  if (!$no_add) {
157  $this->ctrl->clearParametersByClass('ilcalendarappointmentgui');
158  $this->ctrl->setParameterByClass('ilcalendarappointmentgui', 'idate', $date->get(IL_CAL_DATE));
159  $this->ctrl->setParameterByClass('ilcalendarappointmentgui', 'seed', $this->seed->get(IL_CAL_DATE));
160  $current_hour = (new ilDateTime(time(), IL_CAL_UNIX))->get(IL_CAL_FKT_DATE, 'G', $this->user->getTimeZone());
161  $this->ctrl->setParameterByClass("ilcalendarappointmentgui", "hour", $current_hour);
162  $new_app_url = $this->ctrl->getLinkTargetByClass('ilcalendarappointmentgui', 'add');
163 
164  $this->tpl->setCurrentBlock("new_app");
165  $this->tpl->setVariable(
166  'NEW_GLYPH',
167  $this->ui_renderer->render($this->ui_factory->symbol()->glyph()->add($new_app_url))
168  );
169  $this->tpl->parseCurrentBlock();
170 
171  // }
172  }
173 
174  $day = (int) $date->get(IL_CAL_FKT_DATE, 'j');
175  $month = (int) $date->get(IL_CAL_FKT_DATE, 'n');
176 
177  if ($day == 1) {
178  $month_day = '1 ' . ilCalendarUtil::_numericMonthToString($month, false);
179  } else {
180  $month_day = $day;
181  }
182 
183  if (!$is_portfolio_embedded &&
184  (!$disable_empty || $has_events)) {
185  $this->tpl->setCurrentBlock('month_day_link');
186  $this->ctrl->clearParametersByClass('ilcalendardaygui');
187  $this->ctrl->setParameterByClass('ilcalendardaygui', 'seed', $date->get(IL_CAL_DATE));
188  $this->tpl->setVariable('OPEN_DAY_VIEW', $this->ctrl->getLinkTargetByClass('ilcalendardaygui', ''));
189  $this->ctrl->clearParametersByClass('ilcalendardaygui');
190  } else {
191  $this->tpl->setCurrentBlock('month_day_no_link');
192  }
193 
194  $this->tpl->setVariable('MONTH_DAY', $month_day);
195 
196  $this->tpl->parseCurrentBlock();
197 
198  $this->tpl->setCurrentBlock('month_col');
199 
200  if (ilCalendarUtil::_isToday($date)) {
201  $this->tpl->setVariable('TD_CLASS', 'caltoday');
202  } elseif (ilDateTime::_equals($date, $this->seed, IL_CAL_MONTH)) {
203  $this->tpl->setVariable('TD_CLASS', 'calstd');
204  } elseif (ilDateTime::_before($date, $this->seed, IL_CAL_MONTH)) {
205  $this->tpl->setVariable('TD_CLASS', 'calprev');
206  } else {
207  $this->tpl->setVariable('TD_CLASS', 'calnext');
208  }
209  $this->tpl->parseCurrentBlock();
210  if ($counter && !($counter % 7)) {
211  $this->tpl->setCurrentBlock('month_row');
212  $this->tpl->parseCurrentBlock();
213  }
214  }
215  }
216 
217  public function getHTML(): string
218  {
219  $this->show();
220  return $this->tpl->get();
221  }
222 
223  protected function showEvents(ilCalendarSchedule $scheduler, ilDate $date): int
224  {
225  $count = 0;
226  $time = '';
227  foreach ($scheduler->getByDay($date, $this->timezone) as $item) {
228  $this->ctrl->clearParametersByClass('ilcalendarappointmentgui');
229  $this->ctrl->setParameterByClass('ilcalendarappointmentgui', 'app_id', $item['event']->getEntryId());
230 
231  $event_tpl = new ilTemplate('tpl.month_event_view.html', true, true, 'components/ILIAS/Calendar');
232 
233  if (!$item['event']->isFullDay()) {
234  switch ($this->user_settings->getTimeFormat()) {
236  $time = $item['event']->getStart()->get(IL_CAL_FKT_DATE, 'H:i', $this->timezone);
237  break;
238 
240  $time = $item['event']->getStart()->get(IL_CAL_FKT_DATE, 'h:ia', $this->timezone);
241  break;
242  }
243  }
244 
245  //plugins can change the modal title.
246  $shy = $this->getAppointmentShyButton($item['event'], (string) $item['dstart'], "");
247  $event_html = ($time != "") ? $time . " " . $shy : $shy;
248  $event_tpl->setCurrentBlock('il_event');
249 
250  //Start configuring the default template
251  $event_tpl->setVariable(
252  'EVENT_EDIT_LINK',
253  $this->ctrl->getLinkTargetByClass('ilcalendarappointmentgui', 'edit')
254  );
255  $event_tpl->setVariable('EVENT_NUM', $item['event']->getEntryId());
256  $event_tpl->setVariable('EVENT_CONTENT', $event_html);
257  $color = $this->app_colors->getColorByAppointment($item['event']->getEntryId());
258  $event_tpl->setVariable('EVENT_BGCOLOR', $color);
259  $event_tpl->setVariable('EVENT_ADD_STYLES', $item['event']->getPresentationStyle());
260  $event_tpl->setVariable('EVENT_FONTCOLOR', ilCalendarUtil::calculateFontColor($color));
261 
262  //plugins can override the previous template variables. The plugin slot parses the current block because
263  //it needs to call the template get method to use the resulting HTML in the replaceContent method.
264  if ($event_html_by_plugin = $this->getContentByPlugins(
265  $item['event'],
266  $item['dstart'],
267  $event_html,
268  $event_tpl
269  )) {
270  $event_body_html = $event_html_by_plugin;
271  } else {
272  $event_tpl->parseCurrentBlock();
273  $event_body_html = $event_tpl->get();
274  }
275 
276  $this->tpl->setCurrentBlock("event_nfd");
277  $this->tpl->setVariable("EVENT_CONTENT", $event_body_html);
278  $this->tpl->parseCurrentBlock();
279 
280  $this->num_appointments++;
281  $count++;
282  }
283  return $count;
284  }
285 }
static _getInstance(ilDate $seed, array $a_app)
get singleton instance
static get(string $a_var)
static _buildMonthDayList(int $a_month, int $a_year, int $weekstart)
Build a month day list.
const ANONYMOUS_USER_ID
Definition: constants.php:27
static _numericMonthToString(int $a_month, bool $a_long=true, ?ilLanguage $lng=null)
numeric month to string
getByDay(ilDate $a_start, string $a_timezone)
showEvents(ilCalendarSchedule $scheduler, ilDate $date)
static _before(ilDateTime $start, ilDateTime $end, string $a_compare_field='', string $a_tz='')
compare two dates and check start is before end This method does not consider tz offsets.
getContentByPlugins(ilCalendarEntry $a_cal_entry, int $a_start_date, string $a_content, ilTemplate $a_tpl)
const IL_CAL_MONTH
addScheduleFilter(ilCalendarScheduleFilter $a_filter)
Add schedule filter.
const IL_CAL_UNIX
static _getInstanceByUserId(int $a_user_id)
static _numericDayToString(int $a_day, bool $a_long=true, ?ilLanguage $lng=null)
Calendar schedule filter interface.
__construct(ilDate $seed_date)
initialize(int $a_calendar_presentation_type)
const IL_CAL_FKT_DATE
static initDragDrop(?ilGlobalTemplateInterface $a_main_tpl=null)
Init YUI Drag and Drop used in Modules/Survey, Services/Calendar, Services/COPage, Services/Form (Jan 2022)
ilCalendarUserSettings $user_settings
static _getInstance($a_usr_id=0)
get singleton instance
const IL_CAL_DATE
ilCalendarAppointmentColors $app_colors
Administrate calendar appointments.
__construct(Container $dic, ilPlugin $plugin)
static calculateFontColor(string $a_html_color_code)
Calculate best font color from html hex color code.
static _equals(ilDateTime $start, ilDateTime $end, string $a_compare_field='', string $a_tz='')
Check if two date are equal.
getAppointmentShyButton(ilCalendarEntry $a_calendar_entry, string $a_dstart, string $a_title_forced="")
static _isToday(ilDateTime $date)
Represents a list of calendar appointments (including recurring events) for a specific user in a give...