View source
<?php
namespace Drupal\webform\Plugin\WebformElement;
use Drupal\Core\Form\FormStateInterface;
use Drupal\webform\Element\WebformLikert as WebformLikertElement;
use Drupal\webform\Entity\WebformOptions;
use Drupal\webform\Utility\WebformAccessibilityHelper;
use Drupal\webform\Utility\WebformElementHelper;
use Drupal\webform\Utility\WebformOptionsHelper;
use Drupal\webform\Plugin\WebformElementBase;
use Drupal\webform\WebformInterface;
use Drupal\webform\WebformSubmissionInterface;
class WebformLikert extends WebformElementBase {
protected function defineDefaultProperties() {
return [
'title' => '',
'default_value' => [],
'help' => '',
'help_title' => '',
'description' => '',
'more' => '',
'more_title' => '',
'title_display' => '',
'description_display' => '',
'help_display' => '',
'disabled' => FALSE,
'required' => FALSE,
'required_error' => '',
'format' => $this
->getItemDefaultFormat(),
'format_html' => '',
'format_text' => '',
'format_attributes' => [],
'sticky' => TRUE,
'questions' => [],
'questions_description_display' => 'description',
'questions_randomize' => FALSE,
'answers' => [],
'answers_description_display' => 'description',
'na_answer' => FALSE,
'na_answer_value' => '',
'na_answer_text' => $this
->t('N/A'),
'wrapper_attributes' => [],
'label_attributes' => [],
] + $this
->defineDefaultBaseProperties();
}
protected function defineTranslatableProperties() {
return array_merge(parent::defineTranslatableProperties(), [
'questions',
'answers',
'na_answer_text',
]);
}
public function initialize(array &$element) {
parent::initialize($element);
if (isset($element['#answers'])) {
$element['#answers'] = WebformOptions::getElementOptions($element, '#answers');
}
WebformLikertElement::processWebformLikertAnswers($element);
}
protected function formatHtmlItem(array $element, WebformSubmissionInterface $webform_submission, array $options = []) {
$value = $this
->getValue($element, $webform_submission, $options);
$format = $this
->getItemFormat($element);
switch ($format) {
case 'raw':
$items = [];
foreach ($element['#questions'] as $question_key => $question_text) {
$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' => WebformAccessibilityHelper::buildVisuallyHidden(t('Questions')),
'align' => 'left',
'width' => '40%',
];
foreach ($element['#answers'] as $answer_value => $answer_text) {
list($answer_title) = WebformOptionsHelper::splitOption($answer_text);
$header[$answer_value] = [
'data' => $answer_title,
'align' => 'center',
];
}
$width = number_format(60 / count($element['#answers']), 2, '.', '') . '%';
$rows = [];
foreach ($element['#questions'] as $question_key => $question_text) {
list($question_title) = WebformOptionsHelper::splitOption($question_text);
$question_value = isset($value[$question_key]) ? $value[$question_key] : NULL;
$row = [];
$row['likert_question'] = [
'data' => $question_title,
'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,
'#sticky' => $this
->getElementProperty($element, 'sticky'),
'#attributes' => [
'class' => [
'webform-likert-table',
],
],
'#attached' => [
'library' => [
'webform/webform.element.likert',
],
],
];
default:
case 'value':
case 'list':
$items = [];
foreach ($element['#questions'] as $question_key => $question_text) {
list($question_title) = WebformOptionsHelper::splitOption($question_text);
$answer_value = isset($value[$question_key]) ? $value[$question_key] : NULL;
$answer_text = $answer_value !== NULL ? WebformOptionsHelper::getOptionText($answer_value, $element['#answers'], TRUE) : $this
->t('[blank]');
$items[$question_key] = [
'question' => [
'#markup' => $question_title,
'#prefix' => '<b>',
'#suffix' => ':</b> ',
],
'answer' => [
'#markup' => $answer_text,
],
];
}
return [
'#theme' => 'item_list',
'#items' => $items,
];
}
}
protected function formatTextItem(array $element, WebformSubmissionInterface $webform_submission, array $options = []) {
$value = $this
->getValue($element, $webform_submission, $options);
$format = $this
->getItemFormat($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(PHP_EOL, $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 = WebformOptionsHelper::getOptionText($answer_value, $element['#answers'], TRUE);
$list[] = "{$question_label}: {$answer_text}";
}
return implode(PHP_EOL, $list);
}
}
public function getExportDefaultOptions() {
return [
'likert_answers_format' => 'label',
];
}
public function buildExportOptionsForm(array &$form, FormStateInterface $form_state, array $export_options) {
parent::buildExportOptionsForm($form, $form_state, $export_options);
if (isset($form['likert'])) {
return;
}
$form['likert'] = [
'#type' => 'details',
'#title' => $this
->t('Likert questions and answers options'),
'#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, WebformSubmissionInterface $webform_submission, array $export_options) {
$value = $this
->getValue($element, $webform_submission);
$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[] = WebformOptionsHelper::getOptionText($answer_value, $element['#answers'], TRUE);
}
}
return $record;
}
public function getItemDefaultFormat() {
return 'list';
}
public function getItemFormats() {
return parent::getItemFormats() + [
'list' => $this
->t('List'),
'table' => $this
->t('Table'),
];
}
public function getTableColumn(array $element) {
$key = $element['#webform_key'];
$title = $element['#title'] ?: $key;
$is_title_displayed = WebformElementHelper::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, WebformSubmissionInterface $webform_submission, array $options = []) {
if (isset($options['question_key'])) {
$value = $this
->getValue($element, $webform_submission);
$question_key = $options['question_key'];
$question_value = isset($value[$question_key]) ? $value[$question_key] : '';
return WebformOptionsHelper::getOptionText($question_value, $element['#answers'], TRUE);
}
else {
return $this
->formatHtml($element, $webform_submission);
}
}
public function preview() {
return parent::preview() + [
'#questions' => [
'q1' => $this
->t('Please answer question 1?'),
'q2' => $this
->t('How about now answering question 2?'),
'q3' => $this
->t('Finally, here is question 3?'),
],
'#answers' => [
'1' => '1',
'2' => '2',
'3' => '3',
],
];
}
public function getTestValues(array $element, WebformInterface $webform, array $options = []) {
$value = [];
foreach ($element['#questions'] as $key => $question) {
$keys = array_keys($element['#answers']);
$value[$key] = $options['random'] ? $keys[array_rand($keys)] : reset($keys);
}
return [
$value,
];
}
protected function getElementSelectorInputsOptions(array $element) {
$selectors = $element['#questions'];
foreach ($selectors as &$text) {
$text .= ' [' . $this
->t('Radios') . ']';
}
return $selectors;
}
public function getElementSelectorSourceValues(array $element) {
$selector_options = $this
->getElementSelectorOptions($element);
$selectors = reset($selector_options);
$source_values = [];
foreach (array_keys($selectors) as $selector) {
$source_values[$selector] = $element['#answers'];
}
return $source_values;
}
public function form(array $form, FormStateInterface $form_state) {
$form = parent::form($form, $form_state);
$form['validation']['required_container']['required_error']['#description'] = $this
->t('If set, this message will be used when a required likert question is empty, instead of the default "X field is required." message. To include the question title in the required message, please include the @name placeholder in the required message.');
$form['likert'] = [
'#type' => 'fieldset',
'#title' => $this
->t('Likert settings'),
];
$form['likert']['questions'] = [
'#type' => 'webform_options',
'#title' => $this
->t('Questions'),
'#label' => $this
->t('question'),
'#labels' => $this
->t('questions'),
'#options_value_maxlength' => 128,
'#options_description' => TRUE,
'#required' => TRUE,
];
$form['likert']['questions_description_display'] = [
'#title' => $this
->t('Questions description display'),
'#type' => 'select',
'#options' => [
'description' => $this
->t('Description'),
'help' => $this
->t('Help text'),
],
];
$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 webform.'),
'#return_value' => TRUE,
];
$form['likert']['answers'] = [
'#type' => 'webform_element_options',
'#title' => $this
->t('Answers'),
'#options_description' => TRUE,
'#likert' => TRUE,
'#required' => TRUE,
];
$form['likert']['answers_description_display'] = [
'#title' => $this
->t('Answers description display'),
'#type' => 'select',
'#options' => [
'description' => $this
->t('Description'),
'help' => $this
->t('Help text'),
],
];
$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 displayed on the webform.'),
'#attributes' => [
'data-webform-states-no-clear' => TRUE,
],
'#states' => [
'visible' => [
':input[name="properties[na_answer]"]' => [
'checked' => TRUE,
],
],
'required' => [
':input[name="properties[na_answer]"]' => [
'checked' => TRUE,
],
],
],
];
$form['likert']['sticky'] = [
'#type' => 'checkbox',
'#title' => $this
->t('Enable Drupal style "sticky" table headers (Javascript)'),
'#description' => $this
->t('If checked, the answers will float at the top of the page as the user scrolls-thru the questions.'),
'#return_value' => TRUE,
];
return $form;
}
}