393 lines
14 KiB
Plaintext
393 lines
14 KiB
Plaintext
<?php
|
|
|
|
/**
|
|
* @file
|
|
* Defines simple text field types.
|
|
*/
|
|
|
|
use Drupal\Core\Entity\EntityInterface;
|
|
|
|
/**
|
|
* Implements hook_library_info().
|
|
*/
|
|
function text_library_info() {
|
|
$libraries['drupal.text'] = array(
|
|
'title' => 'Text',
|
|
'version' => VERSION,
|
|
'js' => array(
|
|
drupal_get_path('module', 'text') . '/text.js' => array(),
|
|
),
|
|
'dependencies' => array(
|
|
array('system', 'jquery'),
|
|
array('system', 'jquery.once'),
|
|
array('system', 'drupal'),
|
|
),
|
|
);
|
|
|
|
return $libraries;
|
|
}
|
|
|
|
/**
|
|
* Implements hook_help().
|
|
*/
|
|
function text_help($path, $arg) {
|
|
switch ($path) {
|
|
case 'admin/help#text':
|
|
$output = '';
|
|
$output .= '<h3>' . t('About') . '</h3>';
|
|
$output .= '<p>' . t("The Text module defines various text field types for the Field module. A text field may contain plain text only, or optionally, may use Drupal's <a href='@filter-help'>text filters</a> to securely manage HTML output. Text input fields may be either a single line (text field), multiple lines (text area), or for greater input control, a select box, checkbox, or radio buttons. If desired, the field can be validated, so that it is limited to a set of allowed values. See the <a href='@field-help'>Field module help page</a> for more information about fields.", array('@field-help' => url('admin/help/field'), '@filter-help' => url('admin/help/filter'))) . '</p>';
|
|
return $output;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Implements hook_field_info().
|
|
*
|
|
* Field settings:
|
|
* - max_length: The maximum length for a varchar field.
|
|
* Instance settings:
|
|
* - text_processing: Whether text input filters should be used.
|
|
* - display_summary: Whether the summary field should be displayed. When
|
|
* empty and not displayed the summary will take its value from the trimmed
|
|
* value of the main text field.
|
|
*/
|
|
function text_field_info() {
|
|
return array(
|
|
'text' => array(
|
|
'label' => t('Text'),
|
|
'description' => t('This field stores varchar text in the database.'),
|
|
'settings' => array('max_length' => 255),
|
|
'instance_settings' => array('text_processing' => 0),
|
|
'default_widget' => 'text_textfield',
|
|
'default_formatter' => 'text_default',
|
|
'field item class' => '\Drupal\text\Type\TextItem',
|
|
),
|
|
'text_long' => array(
|
|
'label' => t('Long text'),
|
|
'description' => t('This field stores long text in the database.'),
|
|
'instance_settings' => array('text_processing' => 0),
|
|
'default_widget' => 'text_textarea',
|
|
'default_formatter' => 'text_default',
|
|
'field item class' => '\Drupal\text\Type\TextItem',
|
|
),
|
|
'text_with_summary' => array(
|
|
'label' => t('Long text and summary'),
|
|
'description' => t('This field stores long text in the database along with optional summary text.'),
|
|
'instance_settings' => array('text_processing' => 1, 'display_summary' => 0),
|
|
'default_widget' => 'text_textarea_with_summary',
|
|
'default_formatter' => 'text_default',
|
|
'field item class' => '\Drupal\text\Type\TextSummaryItem',
|
|
),
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Implements hook_field_settings_form().
|
|
*/
|
|
function text_field_settings_form($field, $instance, $has_data) {
|
|
$settings = $field['settings'];
|
|
|
|
$form = array();
|
|
|
|
if ($field['type'] == 'text') {
|
|
$form['max_length'] = array(
|
|
'#type' => 'number',
|
|
'#title' => t('Maximum length'),
|
|
'#default_value' => $settings['max_length'],
|
|
'#required' => TRUE,
|
|
'#description' => t('The maximum length of the field in characters.'),
|
|
'#min' => 1,
|
|
// @todo: If $has_data, add a validate handler that only allows
|
|
// max_length to increase.
|
|
'#disabled' => $has_data,
|
|
);
|
|
}
|
|
|
|
return $form;
|
|
}
|
|
|
|
/**
|
|
* Implements hook_field_instance_settings_form().
|
|
*/
|
|
function text_field_instance_settings_form($field, $instance) {
|
|
$settings = $instance['settings'];
|
|
|
|
$form['text_processing'] = array(
|
|
'#type' => 'radios',
|
|
'#title' => t('Text processing'),
|
|
'#default_value' => $settings['text_processing'],
|
|
'#options' => array(
|
|
t('Plain text'),
|
|
t('Filtered text (user selects text format)'),
|
|
),
|
|
);
|
|
if ($field['type'] == 'text_with_summary') {
|
|
$form['display_summary'] = array(
|
|
'#type' => 'checkbox',
|
|
'#title' => t('Summary input'),
|
|
'#default_value' => $settings['display_summary'],
|
|
'#description' => t('This allows authors to input an explicit summary, to be displayed instead of the automatically trimmed text when using the "Summary or trimmed" display type.'),
|
|
);
|
|
}
|
|
|
|
return $form;
|
|
}
|
|
|
|
/**
|
|
* Implements hook_field_validate().
|
|
*
|
|
* Possible error codes:
|
|
* - text_value_max_length: The value exceeds the maximum length.
|
|
* - text_summary_max_length: The summary exceeds the maximum length.
|
|
*/
|
|
function text_field_validate(EntityInterface $entity = NULL, $field, $instance, $langcode, $items, &$errors) {
|
|
foreach ($items as $delta => $item) {
|
|
// @todo Length is counted separately for summary and value, so the maximum
|
|
// length can be exceeded very easily.
|
|
foreach (array('value', 'summary') as $column) {
|
|
if (!empty($item[$column])) {
|
|
if (!empty($field['settings']['max_length']) && drupal_strlen($item[$column]) > $field['settings']['max_length']) {
|
|
switch ($column) {
|
|
case 'value':
|
|
$message = t('%name: the text may not be longer than %max characters.', array('%name' => $instance['label'], '%max' => $field['settings']['max_length']));
|
|
break;
|
|
|
|
case 'summary':
|
|
$message = t('%name: the summary may not be longer than %max characters.', array('%name' => $instance['label'], '%max' => $field['settings']['max_length']));
|
|
break;
|
|
}
|
|
$errors[$field['field_name']][$langcode][$delta][] = array(
|
|
'error' => "text_{$column}_length",
|
|
'message' => $message,
|
|
);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Implements hook_field_load().
|
|
*
|
|
* Where possible, the function generates the sanitized version of each field
|
|
* early so that it is cached in the field cache. This avoids the need to look
|
|
* up the field in the filter cache separately.
|
|
*/
|
|
function text_field_load($entity_type, $entities, $field, $instances, $langcode, &$items) {
|
|
foreach ($entities as $id => $entity) {
|
|
foreach ($items[$id] as $delta => $item) {
|
|
// Only process items with a cacheable format, the rest will be handled
|
|
// by formatters if needed.
|
|
if (empty($instances[$id]['settings']['text_processing']) || filter_format_allowcache($item['format'])) {
|
|
$items[$id][$delta]['safe_value'] = isset($item['value']) ? text_sanitize($instances[$id]['settings']['text_processing'], $langcode, $item, 'value') : '';
|
|
if ($field['type'] == 'text_with_summary') {
|
|
$items[$id][$delta]['safe_summary'] = isset($item['summary']) ? text_sanitize($instances[$id]['settings']['text_processing'], $langcode, $item, 'summary') : '';
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Implements hook_field_is_empty().
|
|
*/
|
|
function text_field_is_empty($item, $field) {
|
|
if (!isset($item['value']) || $item['value'] === '') {
|
|
return !isset($item['summary']) || $item['summary'] === '';
|
|
}
|
|
return FALSE;
|
|
}
|
|
|
|
/**
|
|
* Sanitizes the 'value' or 'summary' data of a text value.
|
|
*
|
|
* Depending on whether the field instance uses text processing, data is run
|
|
* through check_plain() or check_markup().
|
|
*
|
|
* @param bool $text_processing
|
|
* Whether to process the text via check_markup().
|
|
* @param string $langcode
|
|
* The language associated with $item.
|
|
* @param array $item
|
|
* The field value to sanitize.
|
|
* @param string $column
|
|
* The column to sanitize (either 'value' or 'summary').
|
|
*
|
|
* @return string
|
|
* The sanitized string.
|
|
*/
|
|
function text_sanitize($text_processing, $langcode, $item, $column) {
|
|
// If the value uses a cacheable text format, text_field_load() precomputes
|
|
// the sanitized string.
|
|
if (isset($item["safe_$column"])) {
|
|
return $item["safe_$column"];
|
|
}
|
|
if ($text_processing) {
|
|
return check_markup($item[$column], $item['format'], $langcode);
|
|
}
|
|
// Escape all HTML and retain newlines.
|
|
// @see \Drupal\text\Plugin\field\formatter\TextPlainFormatter
|
|
return nl2br(check_plain($item[$column]));
|
|
}
|
|
|
|
/**
|
|
* Generates a trimmed, formatted version of a text field value.
|
|
*
|
|
* If the end of the summary is not indicated using the <!--break--> delimiter
|
|
* then we generate the summary automatically, trying to end it at a sensible
|
|
* place such as the end of a paragraph, a line break, or the end of a sentence
|
|
* (in that order of preference).
|
|
*
|
|
* @param $text
|
|
* The content for which a summary will be generated.
|
|
* @param $format
|
|
* The format of the content. If the PHP filter is present and $text contains
|
|
* PHP code, we do not split it up to prevent parse errors. If the line break
|
|
* filter is present then we treat newlines embedded in $text as line breaks.
|
|
* If the htmlcorrector filter is present, it will be run on the generated
|
|
* summary (if different from the incoming $text).
|
|
* @param $size
|
|
* The desired character length of the summary. If omitted, the default value
|
|
* will be used. Ignored if the special delimiter is present in $text.
|
|
*
|
|
* @return
|
|
* The generated summary.
|
|
*/
|
|
function text_summary($text, $format = NULL, $size = NULL) {
|
|
|
|
if (!isset($size)) {
|
|
$size = config('text.settings')->get('default_summary_length');
|
|
}
|
|
|
|
// Find where the delimiter is in the body
|
|
$delimiter = strpos($text, '<!--break-->');
|
|
|
|
// If the size is zero, and there is no delimiter, the entire body is the summary.
|
|
if ($size == 0 && $delimiter === FALSE) {
|
|
return $text;
|
|
}
|
|
|
|
// If a valid delimiter has been specified, use it to chop off the summary.
|
|
if ($delimiter !== FALSE) {
|
|
return substr($text, 0, $delimiter);
|
|
}
|
|
|
|
// Retrieve the filters of the specified text format, if any.
|
|
if (isset($format)) {
|
|
$filters = filter_list_format($format);
|
|
// If the specified format does not exist, return nothing. $text is already
|
|
// filtered text, but the remainder of this function will not be able to
|
|
// ensure a sane and secure summary.
|
|
if (!$filters) {
|
|
return '';
|
|
}
|
|
}
|
|
|
|
// We check for the presence of the PHP evaluator filter in the current
|
|
// format. If the body contains PHP code, we do not split it up to prevent
|
|
// parse errors.
|
|
if (isset($format) && $filters->has('php_code') && $filters->get('php_code')->status && strpos($text, '<?') !== FALSE) {
|
|
return $text;
|
|
}
|
|
|
|
// If we have a short body, the entire body is the summary.
|
|
if (drupal_strlen($text) <= $size) {
|
|
return $text;
|
|
}
|
|
|
|
// If the delimiter has not been specified, try to split at paragraph or
|
|
// sentence boundaries.
|
|
|
|
// The summary may not be longer than maximum length specified. Initial slice.
|
|
$summary = truncate_utf8($text, $size);
|
|
|
|
// Store the actual length of the UTF8 string -- which might not be the same
|
|
// as $size.
|
|
$max_rpos = strlen($summary);
|
|
|
|
// How much to cut off the end of the summary so that it doesn't end in the
|
|
// middle of a paragraph, sentence, or word.
|
|
// Initialize it to maximum in order to find the minimum.
|
|
$min_rpos = $max_rpos;
|
|
|
|
// Store the reverse of the summary. We use strpos on the reversed needle and
|
|
// haystack for speed and convenience.
|
|
$reversed = strrev($summary);
|
|
|
|
// Build an array of arrays of break points grouped by preference.
|
|
$break_points = array();
|
|
|
|
// A paragraph near the end of sliced summary is most preferable.
|
|
$break_points[] = array('</p>' => 0);
|
|
|
|
// If no complete paragraph then treat line breaks as paragraphs.
|
|
$line_breaks = array('<br />' => 6, '<br>' => 4);
|
|
// Newline only indicates a line break if line break converter
|
|
// filter is present.
|
|
if (isset($format) && $filters->has('filter_autop') && $filters->get('filter_autop')->status) {
|
|
$line_breaks["\n"] = 1;
|
|
}
|
|
$break_points[] = $line_breaks;
|
|
|
|
// If the first paragraph is too long, split at the end of a sentence.
|
|
$break_points[] = array('. ' => 1, '! ' => 1, '? ' => 1, '。' => 0, '؟ ' => 1);
|
|
|
|
// Iterate over the groups of break points until a break point is found.
|
|
foreach ($break_points as $points) {
|
|
// Look for each break point, starting at the end of the summary.
|
|
foreach ($points as $point => $offset) {
|
|
// The summary is already reversed, but the break point isn't.
|
|
$rpos = strpos($reversed, strrev($point));
|
|
if ($rpos !== FALSE) {
|
|
$min_rpos = min($rpos + $offset, $min_rpos);
|
|
}
|
|
}
|
|
|
|
// If a break point was found in this group, slice and stop searching.
|
|
if ($min_rpos !== $max_rpos) {
|
|
// Don't slice with length 0. Length must be <0 to slice from RHS.
|
|
$summary = ($min_rpos === 0) ? $summary : substr($summary, 0, 0 - $min_rpos);
|
|
break;
|
|
}
|
|
}
|
|
|
|
// If the htmlcorrector filter is present, apply it to the generated summary.
|
|
if (isset($format) && $filters->has('filter_htmlcorrector') && $filters->get('filter_htmlcorrector')->status) {
|
|
$summary = _filter_htmlcorrector($summary);
|
|
}
|
|
|
|
return $summary;
|
|
}
|
|
|
|
/**
|
|
* Implements hook_field_prepare_translation().
|
|
*/
|
|
function text_field_prepare_translation(EntityInterface $entity, $field, $instance, $langcode, &$items, EntityInterface $source_entity, $source_langcode) {
|
|
// If the translating user is not permitted to use the assigned text format,
|
|
// we must not expose the source values.
|
|
$field_name = $field['field_name'];
|
|
if (!empty($source_entity->{$field_name}[$source_langcode])) {
|
|
$formats = filter_formats();
|
|
foreach ($source_entity->{$field_name}[$source_langcode] as $delta => $item) {
|
|
$format_id = $item['format'];
|
|
if (!empty($format_id) && !filter_access($formats[$format_id])) {
|
|
unset($items[$delta]);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Implements hook_filter_format_update().
|
|
*/
|
|
function text_filter_format_update($format) {
|
|
field_cache_clear();
|
|
}
|
|
|
|
/**
|
|
* Implements hook_filter_format_disable().
|
|
*/
|
|
function text_filter_format_disable($format) {
|
|
field_cache_clear();
|
|
}
|