View source
<?php
namespace Drupal\yamlform\Plugin\YamlFormElement;
use Drupal\Core\Form\FormStateInterface;
use Drupal\yamlform\Element\YamlFormLikert as YamlFormLikertElement;
use Drupal\yamlform\Entity\YamlFormOptions;
use Drupal\yamlform\Utility\YamlFormElementHelper;
use Drupal\yamlform\Utility\YamlFormOptionsHelper;
use Drupal\yamlform\YamlFormElementBase;
use Drupal\yamlform\YamlFormInterface;
class YamlFormLikert extends YamlFormElementBase {
public function getDefaultProperties() {
return [
'title' => '',
'description' => '',
'default_value' => [],
'title_display' => '',
'description_display' => '',
'required' => FALSE,
'format' => $this
->getDefaultFormat(),
'questions' => [],
'questions_randomize' => FALSE,
'answers' => [],
'na_answer' => FALSE,
'na_answer_value' => '',
'na_answer_text' => $this
->t('N/A'),
] + $this
->getDefaultBaseProperties();
}
public function getTranslatableProperties() {
return array_merge(parent::getTranslatableProperties(), [
'questions',
'answers',
'na_answer_text',
]);
}
public function initialize(array &$element) {
parent::initialize($element);
if (isset($element['#answers'])) {
$element['#answers'] = YamlFormOptions::getElementOptions($element, '#answers');
}
YamlFormLikertElement::processYamlFormLikertAnswers($element);
}
public function formatHtml(array &$element, $value, array $answers = []) {
$format = $this
->getFormat($element);
switch ($format) {
case 'raw':
$items = [];
foreach ($element['#questions'] as $question_key => $question_label) {
$answer_value = isset($value[$question_key]) ? $value[$question_key] : NULL;
$items[$question_key] = [
'#markup' => "<b>{$question_key}:</b> {$answer_value}",
];
}
return [
'#theme' => 'item_list',
'#items' => $items,
];
case 'table':
$header = [];
$header['likert_question'] = [
'data' => '',
'align' => 'left',
'width' => '40%',
];
foreach ($element['#answers'] as $answer_value => $answer_text) {
$header[$answer_value] = [
'data' => $answer_text,
'align' => 'center',
];
}
$width = number_format(60 / count($element['#answers']), 2, '.', '') . '%';
$rows = [];
foreach ($element['#questions'] as $question_key => $question_label) {
$question_value = isset($value[$question_key]) ? $value[$question_key] : NULL;
$row = [];
$row['likert_question'] = [
'data' => $question_label,
'align' => 'left',
'width' => '40%',
];
foreach ($element['#answers'] as $answer_value => $answer_text) {
$row[$answer_value] = [
'data' => $question_value == $answer_value ? [
'#markup' => '✗',
] : '',
'align' => 'center',
'width' => $width,
];
}
$rows[$question_key] = $row;
}
return [
'#type' => 'table',
'#header' => $header,
'#rows' => $rows,
'#attributes' => [
'class' => [
'yamlform-likert-table',
],
],
'#attached' => [
'library' => [
'yamlform/yamlform.element.likert',
],
],
];
default:
case 'value':
case 'list':
$items = [];
foreach ($element['#questions'] as $question_key => $question_label) {
$answer_value = isset($value[$question_key]) ? $value[$question_key] : NULL;
$answer_text = $answer_value ? YamlFormOptionsHelper::getOptionText($answer_value, $element['#answers']) : $this
->t('[blank]');
$items[$question_key] = [
'#markup' => "<b>{$question_label}:</b> {$answer_text}",
];
}
return [
'#theme' => 'item_list',
'#items' => $items,
];
}
}
public function formatText(array &$element, $value, array $answers = []) {
if ($value === '' || $value === NULL || is_array($value) && empty($value)) {
return '';
}
$format = $this
->getFormat($element);
switch ($format) {
case 'raw':
$list = [];
foreach ($element['#questions'] as $question_key => $question_label) {
$answer_value = isset($value[$question_key]) ? $value[$question_key] : NULL;
$list[] = "{$question_key}: {$answer_value}";
}
return implode("\n", $list);
default:
case 'value':
case 'table':
case 'list':
$list = [];
foreach ($element['#questions'] as $question_key => $question_label) {
$answer_value = isset($value[$question_key]) ? $value[$question_key] : NULL;
$answer_text = YamlFormOptionsHelper::getOptionText($answer_value, $element['#answers']);
$list[] = "{$question_label}: {$answer_text}";
}
return implode("\n", $list);
}
}
public function getExportDefaultOptions() {
return [
'likert_answers_format' => 'label',
];
}
public function buildExportOptionsForm(array &$form, FormStateInterface $form_state, array $export_options) {
$form['likert'] = [
'#type' => 'details',
'#title' => $this
->t('Likert questions and answers'),
'#open' => TRUE,
'#weight' => -10,
];
$form['likert']['likert_answers_format'] = [
'#type' => 'radios',
'#title' => $this
->t('Answers format'),
'#options' => [
'label' => $this
->t('Answer labels, the human-readable value (label)'),
'key' => $this
->t('Answer keys, the raw value stored in the database (key)'),
],
'#default_value' => $export_options['likert_answers_format'],
];
}
public function buildExportHeader(array $element, array $options) {
$header = [];
foreach ($element['#questions'] as $key => $label) {
$header[] = $options['header_format'] == 'key' ? $key : $label;
}
return $this
->prefixExportHeader($header, $element, $options);
}
public function buildExportRecord(array $element, $value, array $export_options) {
$record = [];
foreach ($element['#questions'] as $question_key => $question_label) {
$answer_value = isset($value[$question_key]) ? $value[$question_key] : NULL;
if ($export_options['likert_answers_format'] == 'key') {
$record[] = $answer_value;
}
else {
$record[] = YamlFormOptionsHelper::getOptionText($answer_value, $element['#answers']);
}
}
return $record;
}
public function getDefaultFormat() {
return 'list';
}
public function getFormats() {
return parent::getFormats() + [
'list' => $this
->t('List'),
'table' => $this
->t('Table'),
];
}
public function getTableColumn(array $element) {
$key = $element['#yamlform_key'];
$title = $element['#title'] ?: $key;
$is_title_displayed = YamlFormElementHelper::isTitleDisplayed($element);
$columns = parent::getTableColumn($element);
$columns['element__' . $key]['sort'] = FALSE;
foreach ($element['#questions'] as $question_key => $question_label) {
$columns['element__' . $key . '__' . $question_key] = [
'title' => ($is_title_displayed ? $title . ': ' : '') . $question_label,
'sort' => TRUE,
'default' => FALSE,
'key' => $key,
'element' => $element,
'delta' => $question_key,
'question_key' => $question_key,
'plugin' => $this,
];
}
return $columns;
}
public function formatTableColumn(array $element, $value, array $options = []) {
if (isset($options['question_key'])) {
$question_key = $options['question_key'];
$question_value = isset($value[$question_key]) ? $value[$question_key] : '';
return YamlFormOptionsHelper::getOptionText($question_value, $element['#answers']);
}
else {
return $this
->formatHtml($element, $value);
}
}
public function getTestValue(array $element, YamlFormInterface $yamlform) {
$value = [];
foreach ($element['#questions'] as $key => $question) {
$keys = array_keys($element['#answers']);
$value[$key] = $keys[array_rand($keys)];
}
return [
$value,
];
}
protected function getElementSelectorInputsOptions(array $element) {
$selectors = $element['#questions'];
foreach ($selectors as &$text) {
$text .= ' [' . $this
->t('Radios') . ']';
}
return $selectors;
}
public function form(array $form, FormStateInterface $form_state) {
$form = parent::form($form, $form_state);
$form['likert'] = [
'#type' => 'fieldset',
'#title' => $this
->t('Likert settings'),
];
$form['likert']['questions'] = [
'#type' => 'yamlform_options',
'#title' => $this
->t('Questions'),
'#label' => $this
->t('question'),
'#labels' => $this
->t('questions'),
'#required' => TRUE,
];
$form['likert']['questions_randomize'] = [
'#type' => 'checkbox',
'#title' => $this
->t('Randomize questions'),
'#description' => $this
->t('Randomizes the order of the questions when they are displayed in the form.'),
'#return_value' => TRUE,
];
$form['likert']['answers'] = [
'#type' => 'yamlform_element_options',
'#title' => $this
->t('Answers'),
'#likert' => TRUE,
'#required' => TRUE,
];
$form['likert']['na_answer'] = [
'#type' => 'checkbox',
'#title' => $this
->t('Allow N/A answer'),
'#description' => $this
->t('Allowing N/A is ideal for situations where you wish to make a likert element required, but still want to allow users to opt out of certain questions.'),
'#return_value' => TRUE,
];
$form['likert']['na_answer_value'] = [
'#type' => 'textfield',
'#title' => $this
->t('N/A answer value'),
'#description' => $this
->t('Value stored in the database. Leave blank to store an empty string in the database.'),
'#states' => [
'visible' => [
':input[name="properties[na_answer]"]' => [
'checked' => TRUE,
],
],
],
];
$form['likert']['na_answer_text'] = [
'#type' => 'textfield',
'#title' => $this
->t('N/A answer text'),
'#description' => $this
->t('Text display display on form.'),
'#states' => [
'visible' => [
':input[name="properties[na_answer]"]' => [
'checked' => TRUE,
],
],
'required' => [
':input[name="properties[na_answer]"]' => [
'checked' => TRUE,
],
],
],
];
return $form;
}
}