ban.module

Same filename in other branches
  1. 9 core/modules/ban/ban.module
  2. 10 core/modules/ban/ban.module
  3. 11.x core/modules/ban/ban.module

Allows to ban individual IP addresses.

File

core/modules/ban/ban.module

View source
<?php


/**
 * @file
 * Allows to ban individual IP addresses.
 */
use Drupal\Core\Url;
use Drupal\Core\Routing\RouteMatchInterface;

/**
 * Implements hook_help().
 */
function ban_help($route_name, RouteMatchInterface $route_match) {
    switch ($route_name) {
        case 'help.page.ban':
            $output = '';
            $output .= '<h3>' . t('About') . '</h3>';
            $output .= '<p>' . t('The Ban module allows administrators to ban visits to their site from individual IP addresses. For more information, see the <a href=":url">online documentation for the Ban module</a>.', [
                ':url' => 'https://www.drupal.org/documentation/modules/ban',
            ]) . '</p>';
            $output .= '<h3>' . t('Uses') . '</h3>';
            $output .= '<dl>';
            $output .= '<dt>' . t('Banning IP addresses') . '</dt>';
            $output .= '<dd>' . t('Administrators can enter IP addresses to ban on the <a href=":bans">IP address bans</a> page.', [
                ':bans' => Url::fromRoute('ban.admin_page')->toString(),
            ]) . '</dd>';
            $output .= '</dl>';
            return $output;
        case 'ban.admin_page':
            return '<p>' . t('IP addresses listed here are banned from your site. Banned addresses are completely forbidden from accessing the site and instead see a brief message explaining the situation.') . '</p>';
    }
}

Functions

Title Deprecated Summary
ban_help Implements hook_help().

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.