function filelog_form_system_logging_settings_alter in File Log 2.0.x

Same name and namespace in other branches

1. 8 filelog.module \filelog_form_system_logging_settings_alter()

Implements hook_form_FORM_ID_alter() for system_logging_settings().

File

./filelog.module, line 51

Contains filelog.module.

Code

function filelog_form_system_logging_settings_alter(array &$form) {
  $config = Drupal::configFactory()
    ->getEditable('filelog.settings');
  $form['filelog_enabled'] = [
    '#type' => 'checkbox',
    '#title' => t('Log messages to file'),
    '#default_value' => $config
      ->get('enabled'),
  ];
  $form['filelog'] = [
    '#type' => 'fieldset',
    '#title' => 'Logfile settings',
    '#tree' => TRUE,
    '#states' => [
      'visible' => [
        ':input[name="filelog_enabled"]' => [
          'checked' => TRUE,
        ],
      ],
    ],
  ];
  $location = $config
    ->get('location');
  if (strpos($location, 'public://') === 0) {
    $location = substr($location, strlen('public://'));
  }
  $form['filelog']['location'] = [
    '#type' => 'textfield',
    '#title' => t('Location'),
    '#description' => t('The location where logs are saved. Relative paths are inside the public <code>files/</code> directory, but protected from web access.'),
    '#states' => [
      'required' => [
        ':input[name="filelog_enabled"]' => [
          'checked' => TRUE,
        ],
      ],
    ],
    '#default_value' => $location,
  ];
  $form['filelog']['level'] = [
    '#type' => 'select',
    '#title' => t('Threshold'),
    '#description' => t('Messages below this level are not logged to the file.'),
    '#options' => RfcLogLevel::getLevels(),
    '#default_value' => $config
      ->get('level'),
  ];
  $form['filelog']['channels_type'] = [
    '#type' => 'radios',
    '#title' => t('Log specific channels'),
    '#options' => [
      'include' => t('Log only the specified channels.'),
      'exclude' => t('Log everything except the specified channels.'),
    ],
    '#default_value' => $config
      ->get('channels_type'),
  ];
  $form['filelog']['channels'] = [
    '#type' => 'textarea',
    '#title' => t('Channels'),
    '#description' => t('List the log channels to include or exclude, with one channel per line. Some of the common channels are: @common_channels.', [
      '@common_channels' => implode(', ', [
        'content',
        'cron',
        'php',
        'system',
        'user',
        '...',
      ]),
    ]),
    '#default_value' => implode("\n", $config
      ->get('channels')),
    '#states' => [
      'visible' => [
        ':input[name="filelog[limit_allowed_channels]"]' => [
          'checked' => TRUE,
        ],
      ],
    ],
  ];

  // Link to dblog overview if it exists.
  if (Drupal::moduleHandler()
    ->moduleExists('dblog')) {
    $form['filelog']['channels']['#description'] .= ' ' . t('See the <a href=":log_overview">log overview</a>.', [
      ':log_overview' => Url::fromRoute('dblog.overview')
        ->toString(),
    ]);
  }
  $form['filelog']['rotation'] = [
    '#type' => 'details',
    '#open' => $config
      ->get('rotation.mode') !== 'none',
    '#title' => t('Rotation'),
    '#required' => $config
      ->get('enabled'),
    '#tree' => TRUE,
  ];
  $form['filelog']['rotation']['schedule'] = [
    '#type' => 'select',
    '#title' => t('Schedule'),
    '#options' => [
      'daily' => t('Daily'),
      'weekly' => t('Weekly'),
      'monthly' => t('Monthly'),
      'never' => t('Never'),
    ],
    '#default_value' => $config
      ->get('rotation.schedule'),
    '#description' => t('The rotation will happen on the first cron run after the specified part of the calendar date changes; this is dependent on the server timezone. Use an external cron task for more control.'),
  ];
  $form['filelog']['rotation']['delete'] = [
    '#type' => 'checkbox',
    '#title' => t('Delete logfile instead of moving it.'),
    '#default_value' => $config
      ->get('rotation.delete'),
    '#states' => [
      'invisible' => [
        ':input[name="filelog[rotation][schedule]"]' => [
          'value' => 'never',
        ],
      ],
    ],
  ];
  $form['filelog']['rotation']['destination'] = [
    '#type' => 'textfield',
    '#title' => t('Destination filename'),
    '#default_value' => $config
      ->get('rotation.destination'),
    '#description' => t('Where to save archived files (relative to the log directory). Use <code>[date:custom:...]</code> to include a date. Old files with the same name will be overwritten.'),
    '#states' => [
      'invisible' => [
        [
          ':input[name="filelog[rotation][schedule]"]' => [
            'value' => 'never',
          ],
        ],
        [
          ':input[name="filelog[rotation][delete]"]' => [
            'checked' => TRUE,
          ],
        ],
      ],
    ],
  ];
  $gzip = extension_loaded('zlib');
  $form['filelog']['rotation']['gzip'] = [
    '#type' => 'checkbox',
    '#title' => t('Compress archived files with <code>gzip</code>.'),
    '#default_value' => $config
      ->get('rotation.gzip') && $gzip,
    '#disabled' => !$gzip,
    '#states' => [
      'invisible' => [
        [
          ':input[name="filelog[rotation][schedule]"]' => [
            'value' => 'never',
          ],
        ],
        [
          ':input[name="filelog[rotation][delete]"]' => [
            'checked' => TRUE,
          ],
        ],
      ],
    ],
  ];
  $form['filelog']['format'] = [
    '#type' => 'textarea',
    '#title' => t('Log entry format'),
    '#default_value' => $config
      ->get('format'),
    '#description' => t('Specify the format of the log entry.'),
  ];
  $form['filelog']['help'] = [
    '#type' => 'details',
    '#open' => FALSE,
    '#title' => t('Format variables'),
  ];
  $form['filelog']['help']['variables'] = [
    '#theme' => 'filelog_help',
    '#title' => t('Available placeholders include:'),
    '#label_prefix' => 'log:',
    '#rows' => [
      'channel' => t('The channel of the log message.'),
      'level' => t('The severity of the log message.'),
      'message' => t('The message text, without HTML and with escaped line breaks.'),
      'ip' => t('The IP of the user triggering the message.'),
      'location' => t('The requested URI.'),
      'referrer' => t('The referrer URL, if available.'),
      'user' => [
        'description' => t('The user who triggered the message.'),
        'suffix' => [
          ':uid',
          ':mail',
          ':...',
        ],
      ],
      'created' => [
        'description' => t('The time when the message was created.'),
        'suffix' => [
          ':long',
          ':short',
          ':custom:...',
        ],
      ],
    ],
  ];
  if (Drupal::moduleHandler()
    ->moduleExists('token')) {

    // Show the token help relevant to this pattern type.
    $form['filelog']['help']['tokens'] = [
      '#theme' => 'token_tree_link',
      '#token_types' => [
        'log',
      ],
    ];
  }
  $form['#validate'][] = 'filelog_logging_settings_validate';
  $form['#submit'][] = 'filelog_logging_settings_submit';
}