* @copyright 2025 Johann Duscher
*/
use dokuwiki\Extension\AdminPlugin;
// Protect against direct call
if (!defined('DOKU_INC')) die();
/**
* Class admin_plugin_deletepageguard
*
* Provides an admin interface for validating Delete Page Guard patterns
* and offering configuration guidance to administrators.
*/
class admin_plugin_deletepageguard extends AdminPlugin {
/**
* Return sort order for position in admin menu
* @return int
*/
public function getMenuSort() {
return 200;
}
/**
* Return the text to display in the admin menu
* @return string
*/
public function getMenuText($language) {
return $this->getLang('menu');
}
/**
* Return true if access to this admin plugin is allowed
* @return bool
*/
public function forAdminOnly() {
return true;
}
/**
* Handle user request
* @return void
*/
public function handle() {
// Nothing to handle - validation is done in html() method
}
/**
* Render HTML output
* @return void
*/
public function html() {
echo '' . $this->getLang('admin_title') . '
';
echo '';
// Determine which patterns to show - use POST data if available, otherwise config
$patterns = $_POST['test_patterns'] ?? $this->getConf('patterns');
// Show validation results if form was submitted
if (isset($_POST['validate_patterns'])) {
echo '
' . $this->getLang('validation_results_title') . '
';
$this->showPatternValidation($patterns);
} else {
// Show current config patterns on initial load
$this->showPatternValidation($patterns);
}
// Add validation form
echo '
' . $this->getLang('test_patterns_title') . '
';
echo '
';
echo '
' . $this->getLang('no_patterns') . '
';
return;
}
$lines = preg_split('/\R+/', $patterns, -1, PREG_SPLIT_NO_EMPTY);
$hasErrors = false;
$validCount = 0;
echo '';
echo '
' . $this->getLang('validation_results') . '
';
echo '
';
foreach ($lines as $i => $line) {
$pattern = trim($line);
if ($pattern === '') continue;
$lineNum = $i + 1;
$status = $this->validateSinglePattern($pattern);
if ($status === true) {
echo '- ✓ ';
echo 'Line ' . $lineNum . ':
' . hsc($pattern) . ' ';
$validCount++;
} else {
echo '- ✗ ';
echo 'Line ' . $lineNum . ':
' . hsc($pattern) . '
';
echo ' ' . hsc($status) . ' ';
$hasErrors = true;
}
}
echo '
';
if (!$hasErrors && $validCount > 0) {
echo '
' . sprintf($this->getLang('all_patterns_valid'), $validCount) . '
';
} elseif ($hasErrors) {
echo '
' . $this->getLang('some_patterns_invalid') . '
';
}
echo '