add docblocks, closes #1653

Closes #1653

Merge request studip/studip!1064

app/views/admin/courses/export_csv.php

+<?php
+/**
+ * @var Admin_CoursesController $controller
+ * @var array $fields
+ * @var array $selection
+ */
+?>
 <form action="<?= $controller->link_for('admin/courses/export_csv') ?>" method="get" class="default">
     <fieldset>
     <? foreach ($fields as $index => $name) : ?>

app/views/admin/courses/get_subcourses.php

+<?php
+/**
+ * @var array $courses
+ * @var array $view_filter
+ * @var array $actions
+ * @var string $selected_action
+ * @var string $parent
+ */
+?>
 <?php foreach ($courses as $semid => $values) : ?>
     <?= $this->render_partial('admin/courses/_course', compact('semid', 'values', 'view_filter', 'actions', 'selected_action', 'parent', 'courses')) ?>
 <?php endforeach;

app/views/admin/courses/index.php

+<?php
+/**
+ * @var Admin_CoursesController $controller
+ * @var int $count_courses
+ */
+?>
 <? if (empty($insts)): ?>
     <?= MessageBox::info(sprintf(_('Sie wurden noch keinen Einrichtungen zugeordnet. Bitte wenden Sie sich an einen der zuständigen %sAdministratoren%s.'), '<a href="' . URLHelper::getLink('dispatch.php/siteinfo/show') . '">', '</a>')) ?>
 <? elseif (!empty($courses)): ?>

app/views/admin/courses/lock.php

+<?php
+/**
+ * @var array $values
+ * @var SimpleCollection $all_lock_rules
+ * @var Course $course
+ */
+?>
 <? $current_lock_rule = $all_lock_rules->findOneBy('lock_id', $values['lock_rule']); ?>
 <? if (!$GLOBALS['perm']->have_perm('root') && ($current_lock_rule['permission'] == 'admin' || $current_lock_rule['permission'] == 'root')) : ?>
     <?= htmlReady($current_lock_rule['name'])?>

app/views/admin/courses/lock_preselect.php

+<?php
+/**
+ * @var array $values
+ * @var SimpleCollection $all_lock_rules
+ */
+?>
 <label><?= _('Für alle Veranstaltungen') ?>
     <select name="lock_sem_all" style="max-width: 200px">
         <? for ($i = 0; $i < count($all_lock_rules); $i++) : ?>
@@ -9,4 +15,4 @@
     </select>
 </label>
 
-<?= \Studip\Button::createAccept(_('Zuweisen'), 'all'); ?>
\ No newline at end of file
+<?= \Studip\Button::createAccept(_('Zuweisen'), 'all'); ?>

app/views/admin/courses/notice-action.php

+<?php
+/**
+ * @var array $action
+ * @var Course $course
+ * @var string $action
+ */
+?>
 <?php
     $notice = $course->config->COURSE_ADMIN_NOTICE;
     $method = $notice ? 'createHasNotice' : 'createHasNoNotice';

app/views/admin/courses/notice.php

+<?php
+/**
+ * @var Admin_CoursesController $controller
+ * @var Course $course
+ * @var string $notice
+ */
+?>
 <form action="<?= $controller->notice($course) ?>" method="post" data-dialog class="default">
     <fieldset>
         <legend>

app/views/admin/courses/sidebar.php

+<?php
+/**
+ * @var array $userSelectedElements
+ * @var DatafieldEntryModel[] $datafields
+ */
+?>
 <form class="default" method="post"
     action="<?= URLHelper::getLink('dispatch.php/admin/courses/sidebar'); ?>" >
     <input type="hidden" name="updateConfig" value="1">

app/views/admin/courses/visibility.php

+<?php
+/**
+ * @var Course $course
+ */
+?>
 <? if ($GLOBALS['perm']->have_perm("admin") || !LockRules::Check($course->id, "seminar_visibility")) : ?>
     <label>
         <input type="hidden" name="all_sem[]" value="<?= htmlReady($course->id) ?>">

app/views/admin/cronjobs/logs/display.php

+<?php
+/**
+ * @var CronjobLog $log
+ */
+?>
 <dl class="cronlog">
     <dt><?= _('Cronjob') ?></dt>
     <dd><?= htmlReady($log->schedule->title) ?></dd>

app/views/admin/cronjobs/logs/index.php

-<? use Studip\Button, Studip\LinkButton; ?>
+<?php
+/**
+ * @var Admin_Cronjobs_LogsController $controller
+ * @var Pagination $pagination
+ * @var int $total
+ * @var array $filter
+ * @var CronjobSchedule[] $schedules
+ * @var CronjobTask[] $tasks
+ * @var CronjobLog[] $logs
+ */
+use Studip\Button, Studip\LinkButton;
+?>
 
 <form action="<?= $controller->filter() ?>" method="post" class="cronjob-filters default">
     <fieldset>

app/views/admin/cronjobs/schedules/display.php

+<?php
+/**
+ * @var CronjobSchedule $schedule
+ * @var Admin_Cronjobs_SchedulesController $controller
+ */
+?>
 <dl class="cronjob">
     <dt><?= _('Titel') ?></dt>
     <dd><?= htmlReady($schedule->title) ?></dd>

app/views/admin/cronjobs/schedules/edit.php

-<? use Studip\Button, Studip\LinkButton; ?>
-
 <?php
-    $days_of_week = [
-        1 => _('Montag'),
-        2 => _('Dienstag'),
-        3 => _('Mittwoch'),
-        4 => _('Donnerstag'),
-        5 => _('Freitag'),
-        6 => _('Samstag'),
-        7 => _('Sonntag'),
-    ];
+/**
+ * @var CronjobSchedule $schedule
+ * @var Admin_Cronjobs_SchedulesController $controller
+ * @var int $page
+ * @var CronjobTask[] $tasks
+ */
+
+use Studip\Button, Studip\LinkButton;
+
+$days_of_week = [
+    1 => _('Montag'),
+    2 => _('Dienstag'),
+    3 => _('Mittwoch'),
+    4 => _('Donnerstag'),
+    5 => _('Freitag'),
+    6 => _('Samstag'),
+    7 => _('Sonntag'),
+];
 ?>
-
 <form action="<?= $controller->edit($schedule, $page) ?>" method="post" class="cronjobs-edit default">
     <?= CSRFProtection::tokenTag() ?>
 
@@ -238,4 +244,4 @@
         <?= Button::createAccept(_('Speichern'), 'store') ?>
         <?= LinkButton::createCancel('Abbrechen', $controller->indexURL($page)) ?>
     </footer>
-</form>
\ No newline at end of file
+</form>

app/views/admin/cronjobs/schedules/index.php

-<? use Studip\Button, Studip\LinkButton; ?>
+<?php
+/**
+ * @var CronjobTask[] $tasks
+ * @var CronjobSchedule[] $schedules
+ * @var Admin_Cronjobs_SchedulesController $controller
+ * @var Pagination $pagination
+ * @var int $total
+ * @var array $filter
+ */
+
+use Studip\Button, Studip\LinkButton;
+?>
 
 <form action="<?= $controller->filter() ?>" method="post" class="default cronjob-filters">
     <fieldset>
@@ -160,4 +171,4 @@
         </tr>
         </tfoot>
     </table>
-</form>
\ No newline at end of file
+</form>

app/views/admin/cronjobs/schedules/parameters.php

 <?php
-    $selected   = !$schedule->isNew() && $schedule->task_id === $task->task_id;
-    $parameters = $schedule->parameters;
+/**
+ * @var CronjobSchedule $schedule
+ * @var CronjobTask $task
+ * @var Admin_Cronjobs_SchedulesController $controller
+ */
+
+$selected   = !$schedule->isNew() && $schedule->task_id === $task->task_id;
+$parameters = $schedule->parameters;
 ?>
 
 <h3><?= _('Parameter') ?></h3>

app/views/admin/cronjobs/schedules/periodic-schedule.php

 <?php
+/**
+ * @var string $minute
+ * @var string $hour
+ * @var string $day
+ * @var string $month
+ * @var string $day_of_week
+ */
+?>
+<?php
 $cronify = function ($n) {
     if ($n === null) {
         return '*';

app/views/admin/cronjobs/tasks/execute.php

+<?php
+/**
+ * @var Admin_Cronjobs_TasksController $controller
+ * @var CronjobTask $task
+ */
+?>
 <h2><?= sprintf(_('Cronjob-Aufgabe "%s" ausführen'), htmlReady($task->name)) ?></h2>
 <? if (isset($result)): ?>
     <pre><code><?= htmlReady($result ?: _('- Keine Ausgabe -')) ?></code></pre>
@@ -11,4 +17,4 @@
             <?= Studip\Button::createAccept(_('Ausführen'), 'submit') ?>
         </div>
     </form>
-<? endif; ?>
\ No newline at end of file
+<? endif; ?>

app/views/admin/cronjobs/tasks/index.php

-<? use Studip\Button; ?>
+<?php
+/**
+ * @var Admin_Cronjobs_TasksController $controller
+ * @var Pagination $pagination
+ * @var CronjobTask[] $tasks
+ */
+
+use Studip\Button;
+?>
 
 <form action="<?= $controller->bulk($pagination->getCurrentPage()) ?>" method="post" class="default">
     <?= CSRFProtection::tokenTag() ?>

app/views/admin/datafields/config.php

+<?php
+/**
+ * @var Admin_DatafieldsController $controller
+ * @var DataField $struct
+ */
+?>
 <form action="<?= $controller->url_for('admin/datafields/config/' . $struct->id) ?>" method="post" class="default">
     <?= CSRFProtection::tokenTag() ?>
 

app/views/admin/datafields/edit.php

-<?
+<?php
 # Lifter010: TODO
+/**
+ * @var Admin_DatafieldsController $controller
+ * @var DataField $item
+ * @var string $datafield_id
+ * @var DataFieldEntry $datafield_entry
+ * @var array $institutes
+ */
+
 use Studip\Button, Studip\LinkButton;
 ?>