mirror/moodle-auth_outage
1
0
Fork 0
mirror of https://github.com/catalyst/moodle-auth_outage.git synced 2026-05-17 05:48:43 +02:00
Code Issues Packages Projects Releases Wiki Activity

Fixed code inspections, missing phpdocs and code standards.

Browse Source
This commit is contained in:
Daniel Thee Roperto
2016-09-15 14:01:45 +10:00
parent 6041d945e1
commit 7ca44c74ab
17 changed files with 143 additions and 65 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
classes/event/outage_created.php
View File

@@ -16,6 +16,8 @@
namespace auth_outage\event;
use core\event\base;
defined('MOODLE_INTERNAL') || die();
/**
@@ -26,7 +28,7 @@ defined('MOODLE_INTERNAL') || die();
* @copyright Catalyst IT
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class outage_created extends \core\event\base {
class outage_created extends base {
/**
* Init method.
*/
@@ -37,11 +39,20 @@ class outage_created extends \core\event\base {
$this->context = \context_system::instance();
}
/**
* Returns non-localised event description with id's for admin use only.
*
* @return string
*/
public function get_description() {
return "The user with the id '{$this->userid}' created a new outage title '{$this->other['title']}' "
. " with id '{$this->other['id']}'.";
}
/**
* Returns relevant URL, override in subclasses.
* @return \moodle_url
*/
public function get_url() {
return new \moodle_url('/auth/outage/list.php#auth_outage_id_' . $this->other['id']);
}

13
classes/event/outage_deleted.php
View File

@@ -16,6 +16,8 @@
namespace auth_outage\event;
use core\event\base;
defined('MOODLE_INTERNAL') || die();
/**
@@ -26,7 +28,7 @@ defined('MOODLE_INTERNAL') || die();
* @copyright Catalyst IT
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class outage_deleted extends \core\event\base {
class outage_deleted extends base {
/**
* Init method.
*/
@@ -37,11 +39,20 @@ class outage_deleted extends \core\event\base {
$this->context = \context_system::instance();
}
/**
* Returns non-localised event description with id's for admin use only.
*
* @return string
*/
public function get_description() {
return "The user with the id '{$this->userid}' deleted the outage titled '{$this->other['title']}' "
. "with id '{$this->other['id']}'.";
}
/**
* Returns relevant URL, override in subclasses.
* @return \moodle_url
*/
public function get_url() {
return new \moodle_url('/auth/outage/list.php#auth_outage_id_' . $this->other['id']);
}

14
classes/event/outage_updated.php
View File

@@ -16,6 +16,8 @@
namespace auth_outage\event;
use core\event\base;
defined('MOODLE_INTERNAL') || die();
/**
@@ -26,7 +28,7 @@ defined('MOODLE_INTERNAL') || die();
* @copyright Catalyst IT
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class outage_updated extends \core\event\base {
class outage_updated extends base {
/**
* Init method.
*/
@@ -37,12 +39,20 @@ class outage_updated extends \core\event\base {
$this->context = \context_system::instance();
}
/**
* Returns non-localised event description with id's for admin use only.
*
* @return string
*/
public function get_description() {
return "The user with the id '{$this->userid}' updated the outage title '{$this->other['title']}' "
. "with id '{$this->other['id']}'.";
}
/**
* Returns relevant URL, override in subclasses.
* @return \moodle_url
*/
public function get_url() {
return new \moodle_url('/auth/outage/list.php');
}

3
classes/forms/outage/delete.php
View File

@@ -56,5 +56,4 @@ class delete extends \moodleform {
return $errors;
}
}
}

2
classes/forms/outage/edit.php
View File

@@ -16,7 +16,7 @@
namespace auth_outage\forms\outage;
use \auth_outage\models\outage;
use auth_outage\models\outage;
if (!defined('MOODLE_INTERNAL')) {
die('Direct access to this script is forbidden.'); // It must be included from a Moodle page.

27
classes/models/outage.php
View File

@@ -14,19 +14,18 @@
// You should have received a copy of the GNU General Public License
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
namespace auth_outage\models;
use auth_outage\outagelib;
/**
* An Outage object with all information about one specific outage.
* Outage class with all information about one specific outage.
*
* @package auth_outage
* @author Daniel Thee Roperto <daniel.roperto@catalyst-au.net>
* @copyright Catalyst IT
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
namespace auth_outage\models;
use auth_outage\outagelib;
class outage {
/**
* @var int Outage ID (auto generated by the DB).
@@ -143,14 +142,6 @@ class outage {
return $this->replace_placeholders($this->title);
}
/**
* Get the description with properly replaced placeholders such as {{start}} and {{stop}}.
* @return string Description.
*/
public function get_description() {
return $this->replace_placeholders($this->description);
}
/**
* Returns the input string with all placeholders replaced.
* @param $str string Input string.
@@ -180,6 +171,14 @@ class outage {
return $this->stoptime - $this->starttime;
}
/**
* Get the description with properly replaced placeholders such as {{start}} and {{stop}}.
* @return string Description.
*/
public function get_description() {
return $this->replace_placeholders($this->description);
}
/**
* Gets the warning duration from the outage (from warning time to start time).
* @return int Warning duration in seconds.

55
classes/outagedb.php
View File

@@ -22,7 +22,12 @@ if (!defined('MOODLE_INTERNAL')) {
require_once($CFG->dirroot . '/calendar/lib.php');
use auth_outage\event\outage_created;
use auth_outage\event\outage_deleted;
use auth_outage\event\outage_updated;
use auth_outage\models\outage;
use calendar_event;
use InvalidArgumentException;
/**
* The DB Context to manipulate Outages.
@@ -65,10 +70,10 @@ class outagedb {
global $DB;
if (!is_int($id)) {
throw new \InvalidArgumentException('$id must be an int.');
throw new InvalidArgumentException('$id must be an int.');
}
if ($id <= 0) {
throw new \InvalidArgumentException('$id must be positive.');
throw new InvalidArgumentException('$id must be positive.');
}
$outage = $DB->get_record('auth_outage', ['id' => $id]);
@@ -100,7 +105,7 @@ class outagedb {
$outage->createdby = $USER->id;
// Then create it, log it and adjust its id.
$outage->id = $DB->insert_record('auth_outage', $outage, true);
\auth_outage\event\outage_created::create(
outage_created::create(
['objectid' => $outage->id, 'other' => (array)$outage]
)->trigger();
// Create calendar entry.
@@ -110,7 +115,7 @@ class outagedb {
unset($outage->createdby);
$DB->update_record('auth_outage', $outage);
// Log it.
\auth_outage\event\outage_updated::create(
outage_updated::create(
['objectid' => $outage->id, 'other' => (array)$outage]
)->trigger();
// Update calendar entry.
@@ -124,22 +129,22 @@ class outagedb {
/**
* Deletes an outage from the database.
*
* @param $id outage Outage ID to delete
* @param int $id Outage ID to delete
* @throws InvalidArgumentException If ID is not valid.
*/
public static function delete($id) {
global $DB;
if (!is_int($id)) {
throw new \InvalidArgumentException('$id must be an int.');
throw new InvalidArgumentException('$id must be an int.');
}
if ($id <= 0) {
throw new \InvalidArgumentException('$id must be positive.');
throw new InvalidArgumentException('$id must be positive.');
}
// Log it.
$previous = $DB->get_record('auth_outage', ['id' => $id], '*', MUST_EXIST);
$event = \auth_outage\event\outage_deleted::create(['objectid' => $id, 'other' => (array)$previous]);
$event = outage_deleted::create(['objectid' => $id, 'other' => (array)$previous]);
$event->add_record_snapshot('auth_outage', $previous);
$event->trigger();
@@ -163,7 +168,7 @@ class outagedb {
$time = time();
}
if (!is_int($time)) {
throw new \InvalidArgumentException('$time must be null or an int.');
throw new InvalidArgumentException('$time must be null or an int.');
}
$data = $DB->get_records_select(
@@ -178,7 +183,7 @@ class outagedb {
// Not using $DB->get_record_select instead because there is no 'limit' parameter.
// Allowing multiple records still raises an internal error.
return (count($data) == 0) ? null : new \auth_outage\models\outage(array_shift($data));
return (count($data) == 0) ? null : new outage(array_shift($data));
}
/**
@@ -193,7 +198,7 @@ class outagedb {
$time = time();
}
if (!is_int($time)) {
throw new \InvalidArgumentException('$time must be null or an int.');
throw new InvalidArgumentException('$time must be null or an int.');
}
$outages = [];
@@ -224,7 +229,7 @@ class outagedb {
$time = time();
}
if (!is_int($time)) {
throw new \InvalidArgumentException('$time must be null or an int.');
throw new InvalidArgumentException('$time must be null or an int.');
}
$outages = [];
@@ -243,10 +248,18 @@ class outagedb {
return $outages;
}
/**
* Create an event on the calendar for this outage.
* @param outage $outage Outage to be added to the calendar.
*/
private static function calendar_create(outage $outage) {
\calendar_event::create(self::calendar_data($outage));
calendar_event::create(self::calendar_data($outage));
}
/**
* Updates an event on the calendar based on this outage.
* @param outage $outage Outage to be updated in the calendar.
*/
private static function calendar_update(outage $outage) {
$event = self::calendar_load($outage->id);
@@ -258,6 +271,10 @@ class outagedb {
}
}
/**
* Removes an event from the calendar related to this outage.
* @param int $outageid Id of outage to be deleted from the calendar.
*/
private static function calendar_delete($outageid) {
$event = self::calendar_load($outageid);
@@ -269,6 +286,11 @@ class outagedb {
}
}
/**
* Generates an array with the calendar event data based on an outage object.
* @param outage $outage Outage to use as reference for the calendar event.
* @return array Calendar event data.
*/
private static function calendar_data(outage $outage) {
return [
'name' => $outage->get_title(),
@@ -285,6 +307,11 @@ class outagedb {
];
}
/**
* Finds the calendar event for an specific outage.
* @param int $outageid The outage id to find in the calendar.
* @return calendar_event|null The calendar event or null if not found.
*/
private static function calendar_load($outageid) {
global $DB;
@@ -296,6 +323,6 @@ class outagedb {
IGNORE_MISSING
);
return ($event === false) ? null : \calendar_event::load($event->id);
return ($event === false) ? null : calendar_event::load($event->id);
}
}

7
classes/outagelib.php
View File

@@ -16,6 +16,8 @@
namespace auth_outage;
use auth_outage_renderer;
if (!defined('MOODLE_INTERNAL')) {
die('Direct access to this script is forbidden.'); // It must be included from a Moodle page.
}
@@ -33,8 +35,7 @@ class outagelib {
/**
* Initializes admin pages for outage.
*
* @return \renderer_base
* @return auth_outage_renderer The outage renderer for the page.
*/
public static function pagesetup() {
global $PAGE;
@@ -45,7 +46,7 @@ class outagelib {
/**
* Returns the outage renderer.
* @return \renderer_base
* @return auth_outage_renderer The outage renderer.
*/
public static function get_renderer() {
global $PAGE;

24
classes/tables/manage.php
View File

@@ -16,6 +16,9 @@
namespace auth_outage\tables;
use auth_outage\models\outage;
use flexible_table;
require_once($CFG->libdir . '/tablelib.php');
/**
@@ -26,9 +29,13 @@ require_once($CFG->libdir . '/tablelib.php');
* @copyright Catalyst IT
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class manage extends \flexible_table {
class manage extends flexible_table {
private static $autoid = 0;
/**
* Constructor
* @param string|null $id to be used by the table, autogenerated if null.
*/
public function __construct($id = null) {
global $PAGE;
@@ -51,6 +58,11 @@ class manage extends \flexible_table {
$this->setup();
}
/**
* Sets the data of the table.
* @param array $outages An array with outage objects.
* @param bool $editdelete If it should display the edit and delete button.
*/
public function set_data(array $outages, $editdelete) {
if (!is_bool($editdelete)) {
throw new \InvalidArgumentException('$editdelete must be a bool.');
@@ -76,7 +88,13 @@ class manage extends \flexible_table {
}
}
private function set_data_buttons($outage, $editdelete) {
/**
* Create the action buttons HTML code for a specific outage.
* @param outage $outage The outage to generate the buttons.
* @param bool $editdelete If it should display the edit and delete button.
* @return string The HTML code of the action buttons.
*/
private function set_data_buttons(outage $outage, $editdelete) {
global $OUTPUT;
$buttons = '';
@@ -135,4 +153,4 @@ class manage extends \flexible_table {
return $buttons;
}
}
}