add docblocks, closes #1652

Closes #1652

Merge request studip/studip!1062

app/views/online/index.php

+<?php
+/**
+ * @var ContactController $controller
+ * @var array $users
+ * @var bool $showGroups
+ * @var int $contact_count
+ * @var int $page
+ * @var int $limit
+ * @var bool $showOnlyBuddies
+ */
+$dimension = Avatar::getDimension(Avatar::SMALL);
+?>
 <div class="online-list">
     <div id="online_contacts">
         <table class="default">
@@ -5,7 +17,7 @@
                 <?= _('Kontakte') ?>
             </caption>
             <colgroup>
-                <col width="<?= reset(Avatar::getDimension(Avatar::SMALL)) ?>px">
+                <col width="<?= reset($dimension) ?>px">
                 <col>
                 <col>
                 <col width="1%">
@@ -80,7 +92,7 @@
                     <? endif; ?>
                 </caption>
                 <colgroup>
-                    <col width="<?= reset(Avatar::getDimension(Avatar::SMALL)) ?>px">
+                    <col width="<?= reset($dimension) ?>px">
                     <col>
                     <col>
                     <col width="1%">

app/views/privacy/index.php

+<?php
+/**
+ * @var PrivacyController $controller
+ * @var array $plugin_data
+ * @var string $section
+ * @var string $user_id
+ */
+?>
 <? if (empty($plugin_data) || empty(reset($plugin_data))): ?>
     <?= MessageBox::info(_('In dieser Kategorie sind keine Daten vorhanden.')) ?>
 <? endif; ?>

app/views/privacy/landing.php

+<?php
+/**
+ * @var PrivacyController $controller
+ * @var array $sections
+ * @var string $user_id
+ */
+?>
 <ul class="boxed-grid">
 <? foreach ($sections as $key => $row): ?>
     <li>

app/views/privacy/print.php

+<?php
+/**
+ * @var string $user_fullname
+ * @var array $plugin_data
+ */
+?>
 <h1><?= sprintf(_('Personenbezogene Daten von %s'), htmlReady($user_fullname)); ?></h1>
 <? foreach ($plugin_data as $label => $tabledata) : ?>
     <? if ($tabledata['table_content']) : ?>

app/views/profile_modules/index.php

+<?php
+/**
+ * @var ProfileModulesController $controller
+ * @var string $username
+ * @var array $list
+ * @var array $config
+ */
+?>
 <form action="<?= $controller->url_for('profilemodules/update', compact('username')) ?>" method="post" class="default plus">
     <?= CSRFProtection::tokenTag() ?>
 

app/views/public_courses/index.php

+<?php
+/**
+ * @var array $seminars
+ */
+?>
 <blockquote>
     <p>
         <?= _('Die folgenden Veranstaltungen können Sie betreten, ohne '

app/views/quickselection/configuration.php

+<?php
+/**
+ * @var QuickselectionController $controller
+ * @var Navigation[] $links
+ * @var array $config
+ */
+?>
 <div id="quickSelectionEdit">
     <form id="configure_quickselection" action="<?= $controller->link_for('quickselection/save') ?>" method="post" class="default" data-dialog>
         <fieldset>

app/views/score/index.php

+<?php
+/**
+ * @var ScoreController $controller
+ * @var int $current_user_score
+ * @var User $current_user
+ * @var array $persons
+ * @var int $offset
+ * @var int $page
+ * @var int $numberOfPersons
+ * @var int $max_per_page
+ */
+?>
 <table class="default">
     <caption>
         <span class="actions" style="font-size: 0.9em;">
             <?= _('Ihre Punkte:') ?>
-            <strong><?= number_format($this->current_user_score, 0, ',', '.') ?></strong>
-            <div class="hidden-small-down">(<?= Score::getTitel($this->current_user_score, $this->current_user->geschlecht) ?>)</div>
+            <strong><?= number_format($current_user_score, 0, ',', '.') ?></strong>
+            <div class="hidden-small-down">(<?= Score::getTitel($current_user_score, $current_user->geschlecht) ?>)</div>
         </span>
         <?= _('Stud.IP-Rangliste')?>
     </caption>

app/views/seminar/details/show_module_pathes.php

-<?
+<?php
+/**
+ * @var MvvCourse[] $mvv_pathes
+ * @var Seminar_DetailsController $controller
+ */
+
 if (count($mvv_pathes)) {
 ?>
 <font size="-1">

app/views/sitemap/index.php

+<?php
+/**
+ * @var Navigation[] $navigation
+ * @var Navigation[] $footer
+ * @var Navigation[] $quicklinks
+ */
+?>
 <h2><?= _('Hauptnavigation') ?></h2>
 <?= $this->render_partial('sitemap/navigation', ['navigation' => $navigation, 'needs_image' => true, 'style' => 'bold'])
 ?>
@@ -6,4 +13,4 @@
 ?>
 <h2><?= _('Fußzeile') ?></h2>
 <?= $this->render_partial('sitemap/navigation', ['navigation' => $footer, 'needs_image' => false, 'style' => 'bold'])
-?>
\ No newline at end of file
+?>

app/views/sitemap/navigation.php

-<?
-# Lifter010: TODO
+<?php
+/**
+ * @var Navigation[] $navigation
+ * @var bool $needs_image
+ * @var string $style
+ */
 ?>
 <ul>
     <? foreach ($navigation as $nav) : ?>

app/views/studiengaenge/abschluesse/index.php

+<?php
+/**
+ * @var Studiengaenge_AbschluesseController $controller
+ * @var Abschluss[] $abschluesse
+ * @var string $abschluss_id
+ */
+?>
 <table class="default collapsable"">
 <thead>
     <tr class="sortable">

app/views/studiengaenge/fachbereiche/index.php

+<?php
+/**
+ * @var Studiengaenge_FachbereicheController $controller
+ * @var Fachbereich[] $fachbereiche
+ * @var string $fachbereich_id
+ */
+?>
 <table class="default collapsable" style="width: 100%;">
     <thead>
         <tr class="sortable">

app/views/studiengaenge/fachbereichestgteile/index.php

+<?php
+/**
+ * @var Studiengaenge_FachbereichestgteileController $controller
+ * @var StudiengangTeil[] $fachbereiche
+ * @var array $stgteil_ids
+ * @var string $details_id
+ */
+?>
 <form method="post">
     <?= CSRFProtection::tokenTag() ?>
     <table class="default collapsable">

app/views/studiengaenge/faecher/index.php

+<?php
+/**
+ * @var Studiengaenge_FaecherController $controller
+ * @var int $count
+ * @var Fach[] $faecher
+ * @var string $details_id
+ * @var StudiengangTeil $stgteile
+ * @var int $page
+ */
+?>
 <form method="post">
     <?= CSRFProtection::tokenTag() ?>
     <table class="default collapsable">
@@ -51,7 +61,8 @@
                         $pagination->set_attribute('perPage', MVVController::$items_per_page);
                         $pagination->set_attribute('num_postings', $count);
                         $pagination->set_attribute('page', $page);
-                        $page_link = reset(explode('?', $controller->action_url('index'))) . '?page_faecher=%s';
+                        $parts = explode('?', $controller->action_url('index'));
+                        $page_link = reset($parts) . '?page_faecher=%s';
                         $pagination->set_attribute('pagelink', $page_link);
                         echo $pagination->render("shared/pagechooser");
                         ?>

app/views/studiengaenge/informationen/degree.php

+<?php
+/**
+ * @var Studiengaenge_InformationenController $controller
+ * @var Degree[] $degree
+ */
+?>
 <table class="default collapsable">
     <colgroup>
         <col width="70%">

app/views/studiengaenge/informationen/index.php

+<?php
+/**
+ * @var Studiengaenge_InformationenController $controller
+ * @var Fach[] $studycourses
+ */
+?>
 <table class="default collapsable">
     <colgroup>
         <col style="width: 70%">

app/views/studiengaenge/informationen/showdegree.php

+<?php
+/**
+ * @var Studiengaenge_InformationenController $controller
+ * @var Fach $studycourse
+ */
+?>
 <td colspan="3">
     <table class="default">
         <colgroup>

app/views/studiengaenge/informationen/showstudycourse.php

+<?php
+/**
+ * @var Studiengaenge_InformationenController $controller
+ * @var Fach $studycourses
+ * @var Degree $degree
+ */
+?>
 <td colspan="3">
     <table class="default">
         <colgroup>

app/views/studiengaenge/kategorien/index.php

+<?php
+/**
+ * @var Studiengaenge_KategorienController $controller
+ * @var AbschlussKategorie[] $kategorien
+ * @var string $kategorie_id
+ */
+?>
 <table class="default collapsable">
     <thead>
         <tr class="sortable">