Skip to content

Commit

Permalink
MDL-74500 profilefield_checkbox: override show/empty class methods.
Browse files Browse the repository at this point in the history
  • Loading branch information
paulholden committed Feb 7, 2024
1 parent 0ac237d commit 597a8ac
Show file tree
Hide file tree
Showing 2 changed files with 147 additions and 0 deletions.
25 changes: 25 additions & 0 deletions user/profile/field/checkbox/field.class.php
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,31 @@ public function edit_field_add($mform) {
}
}

/**
* Override parent {@see profile_field_base::is_empty} check
*
* We can't check the "data" property, because if not set by the user then it's populated by "defaultdata" of the field,
* which can also be 0 (false) therefore ensuring the parent class check could never return true for this comparison
*
* @return bool
*/
public function is_empty() {
return ($this->userid && !$this->field->hasuserdata);
}

/**
* Override parent {@see profile_field_base::show_field_content} check
*
* We only need to determine whether the field is visible, because we also want to show the "defaultdata" of the field,
* even if the user hasn't explicitly filled it in
*
* @param context|null $context
* @return bool
*/
public function show_field_content(?context $context = null): bool {
return $this->is_visible($context);
}

/**
* Display the data for this field
*
Expand Down
122 changes: 122 additions & 0 deletions user/profile/field/checkbox/tests/profile_field_checkbox_test.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,122 @@
<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.

namespace profilefield_checkbox;

use advanced_testcase;
use profile_field_checkbox;

/**
* Unit tests for the field class
*
* @package profilefield_checkbox
* @covers \profile_field_checkbox
* @copyright 2024 Paul Holden <[email protected]>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class profile_field_checkbox_test extends advanced_testcase {

/**
* Load required test libraries
*/
public static function setUpBeforeClass(): void {
global $CFG;
require_once("{$CFG->dirroot}/user/profile/lib.php");
}

/**
* Data provider for {@see test_is_empty}
*
* @return array[]
*/
public static function is_empty_provider(): array {
return [
'No value' => [
[],
true,
],
'Value equals 0' => [
['profile_field_check' => 0],
false,
],
'Value equals 1' => [
['profile_field_check' => 1],
false,
],
];
}

/**
* Test field empty state
*
* @param array $userrecord
* @param bool $expected
*
* @dataProvider is_empty_provider
*/
public function test_is_empty(array $userrecord, bool $expected): void {
$this->resetAfterTest();

$this->getDataGenerator()->create_custom_profile_field([
'datatype' => 'checkbox',
'name' => 'My check',
'shortname' => 'check',
]);

$user = $this->getDataGenerator()->create_user($userrecord);

/** @var profile_field_checkbox[] $fields */
$fields = profile_get_user_fields_with_data($user->id);
$fieldinstance = reset($fields);

$this->assertEquals($expected, $fieldinstance->is_empty());
}

/**
* Test whether to show field content
*/
public function test_show_field_content(): void {
$this->resetAfterTest();

$this->getDataGenerator()->create_custom_profile_field([
'datatype' => 'checkbox',
'name' => 'My check',
'shortname' => 'check',
'visible' => PROFILE_VISIBLE_PRIVATE,
]);

// User can view their own value.
$userwith = $this->getDataGenerator()->create_user(['profile_field_check' => 1]);
$this->setUser($userwith);

/** @var profile_field_checkbox[] $fields */
$fields = profile_get_user_fields_with_data($userwith->id);
$fieldinstance = reset($fields);

$this->assertTrue($fieldinstance->show_field_content());

// Another user cannot view the value.
$userview = $this->getDataGenerator()->create_user();
$this->setUser($userview);

$this->assertFalse($fieldinstance->show_field_content());

// Another user with appropriate access can view the value.
$this->setAdminUser();
$this->assertTrue($fieldinstance->show_field_content());

}
}

0 comments on commit 597a8ac

Please sign in to comment.