277 lines
8.3 KiB
PHP
277 lines
8.3 KiB
PHP
<?php
|
|
|
|
use dokuwiki\Extension\SyntaxPlugin;
|
|
use dokuwiki\plugin\luxtools\Crawler;
|
|
use dokuwiki\plugin\luxtools\Output;
|
|
use dokuwiki\plugin\luxtools\Path;
|
|
|
|
/**
|
|
* luxtools Plugin: Abstract base class for file-listing syntax handlers.
|
|
*
|
|
* Provides shared functionality for directory, files, and images syntax.
|
|
*/
|
|
if (!class_exists('syntax_plugin_luxtools_abstract', false)) {
|
|
abstract class syntax_plugin_luxtools_abstract extends SyntaxPlugin
|
|
{
|
|
/**
|
|
* Returns the syntax keyword (e.g., 'files', 'directory', 'images').
|
|
* Used for pattern matching and plugin registration.
|
|
*
|
|
* @return string
|
|
*/
|
|
abstract protected function getSyntaxKeyword(): string;
|
|
|
|
/**
|
|
* Returns the default parameters for this syntax handler.
|
|
* Will be merged with the base defaults.
|
|
*
|
|
* @return array
|
|
*/
|
|
protected function getDefaultParams(): array
|
|
{
|
|
return [];
|
|
}
|
|
|
|
/**
|
|
* Process the parsed path/pattern. Override to customize path handling.
|
|
*
|
|
* @param string $path The cleaned path from the syntax
|
|
* @return array Data to be passed to render()
|
|
*/
|
|
abstract protected function processPath(string $path): array;
|
|
|
|
/**
|
|
* Perform the actual rendering. Override in each handler.
|
|
*
|
|
* @param string $format Output format (xhtml, odt, etc.)
|
|
* @param \Doku_Renderer $renderer The renderer instance
|
|
* @param array $pathData Path data from processPath()
|
|
* @param array $params Parsed parameters
|
|
* @return bool
|
|
*/
|
|
abstract protected function doRender(string $format, \Doku_Renderer $renderer, array $pathData, array $params): bool;
|
|
|
|
/** @inheritdoc */
|
|
public function getType()
|
|
{
|
|
return 'substition';
|
|
}
|
|
|
|
/** @inheritdoc */
|
|
public function getPType()
|
|
{
|
|
return 'block';
|
|
}
|
|
|
|
/** @inheritdoc */
|
|
public function getSort()
|
|
{
|
|
return 222;
|
|
}
|
|
|
|
/** @inheritdoc */
|
|
public function connectTo($mode)
|
|
{
|
|
$keyword = $this->getSyntaxKeyword();
|
|
$pattern = '\{\{' . $keyword . '>.+?\}\}';
|
|
$this->Lexer->addSpecialPattern($pattern, $mode, 'plugin_luxtools_' . $keyword);
|
|
}
|
|
|
|
/** @inheritdoc */
|
|
public function handle($match, $state, $pos, Doku_Handler $handler)
|
|
{
|
|
global $INPUT;
|
|
|
|
// Do not allow the syntax in discussion plugin comments
|
|
if (!$this->getConf('allow_in_comments') && $INPUT->has('comment')) {
|
|
return false;
|
|
}
|
|
|
|
$keyword = $this->getSyntaxKeyword();
|
|
$match = substr($match, strlen('{{' . $keyword . '>'), -2);
|
|
[$path, $flags] = array_pad(explode('&', $match, 2), 2, '');
|
|
|
|
$params = $this->parseFlags($flags);
|
|
$pathData = $this->processPath($path);
|
|
|
|
return ['pathData' => $pathData, 'params' => $params];
|
|
}
|
|
|
|
/** @inheritdoc */
|
|
public function render($format, Doku_Renderer $renderer, $data)
|
|
{
|
|
if ($data === false) {
|
|
return false;
|
|
}
|
|
|
|
// DokuWiki caches the $data returned by handle(). When the shape changes
|
|
// between plugin versions, old cached instructions can feed unexpected
|
|
// structures (or even null) into render(). Be defensive to avoid fatals.
|
|
if (!is_array($data)) {
|
|
return false;
|
|
}
|
|
|
|
if ($format !== 'xhtml' && $format !== 'odt') {
|
|
return false;
|
|
}
|
|
|
|
// New format: ['pathData' => array, 'params' => array]
|
|
// Back-compat: numeric list or older associative keys.
|
|
$pathData = $data['pathData'] ?? ($data[0] ?? null);
|
|
$params = $data['params'] ?? ($data[1] ?? null);
|
|
|
|
// Some older cached instructions may pass the raw path as string.
|
|
if (is_string($pathData)) {
|
|
$pathData = $this->processPath($pathData);
|
|
}
|
|
|
|
// If params are missing (older cache), fall back to defaults.
|
|
if (!is_array($params)) {
|
|
$params = $this->parseFlags('');
|
|
}
|
|
|
|
// If pathData was inlined (e.g. ['base'=>..,'pattern'=>..,'params'=>..]), extract it.
|
|
if (!is_array($pathData)) {
|
|
$candidate = $data;
|
|
unset($candidate['params']);
|
|
if (isset($candidate['base']) || isset($candidate['pattern']) || isset($candidate['path'])) {
|
|
$pathData = $candidate;
|
|
}
|
|
}
|
|
|
|
if (!is_array($pathData)) {
|
|
return false;
|
|
}
|
|
|
|
// Disable caching if requested
|
|
if (($params['cache'] ?? 0) == 0) {
|
|
$renderer->nocache();
|
|
}
|
|
|
|
return $this->doRender($format, $renderer, $pathData, $params);
|
|
}
|
|
|
|
/**
|
|
* Parse flags string into parameters array.
|
|
*
|
|
* @param string $flags The flags string from the syntax
|
|
* @return array Parsed parameters
|
|
*/
|
|
protected function parseFlags(string $flags): array
|
|
{
|
|
// Base defaults shared by all handlers
|
|
$baseDefaults = [
|
|
'sort' => 'name',
|
|
'order' => 'asc',
|
|
'style' => 'list',
|
|
'tableheader' => 0,
|
|
'foldersfirst' => 0,
|
|
'recursive' => 0,
|
|
'titlefile' => '_title.txt',
|
|
'cache' => 0,
|
|
'randlinks' => 0,
|
|
'showsize' => 0,
|
|
'showdate' => 0,
|
|
'listsep' => ', ',
|
|
'maxheight' => 500,
|
|
];
|
|
|
|
// Merge with handler-specific defaults
|
|
$params = array_merge($baseDefaults, $this->getDefaultParams());
|
|
|
|
// Load default config options and combine with provided flags
|
|
$flags = $this->getConf('defaults') . '&' . $flags;
|
|
$flagList = explode('&', $flags);
|
|
|
|
foreach ($flagList as $flag) {
|
|
if (empty(trim($flag))) {
|
|
continue;
|
|
}
|
|
[$name, $value] = sexplode('=', $flag, 2, '');
|
|
$params[trim($name)] = trim(trim($value), '"'); // quotes can be used to keep whitespace
|
|
}
|
|
|
|
return $params;
|
|
}
|
|
|
|
/**
|
|
* Get path info with error handling.
|
|
*
|
|
* @param string $basePath The base path to resolve
|
|
* @param \Doku_Renderer $renderer The renderer for error output
|
|
* @return array|false Path info array or false on error
|
|
*/
|
|
protected function getPathInfoSafe(string $basePath, \Doku_Renderer $renderer)
|
|
{
|
|
try {
|
|
$pathHelper = new Path($this->getConf('paths'));
|
|
return $pathHelper->getPathInfo($basePath);
|
|
} catch (\Exception $e) {
|
|
$this->renderError($renderer, 'error_outsidejail');
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Create and configure a Crawler instance.
|
|
*
|
|
* @param array $params The parameters array
|
|
* @return Crawler
|
|
*/
|
|
protected function createCrawler(array $params): Crawler
|
|
{
|
|
$crawler = new Crawler($this->getConf('extensions'));
|
|
$crawler->setSortBy($params['sort']);
|
|
$crawler->setSortReverse($params['order'] === 'desc');
|
|
$crawler->setFoldersFirst(($params['foldersfirst'] ?? 0) != 0);
|
|
return $crawler;
|
|
}
|
|
|
|
/**
|
|
* Render an error message.
|
|
*
|
|
* @param \Doku_Renderer $renderer The renderer
|
|
* @param string $langKey The language key for the error message
|
|
*/
|
|
protected function renderError(\Doku_Renderer $renderer, string $langKey): void
|
|
{
|
|
$renderer->cdata('[n/a: ' . $this->getLang($langKey) . ']');
|
|
}
|
|
|
|
/**
|
|
* Render a muted empty-state message (used when a listing has no results).
|
|
*
|
|
* @param \Doku_Renderer $renderer
|
|
* @param string $langKey
|
|
* @return void
|
|
*/
|
|
protected function renderEmptyState(\Doku_Renderer $renderer, string $langKey): void
|
|
{
|
|
$text = (string)$this->getLang($langKey);
|
|
|
|
if ($renderer instanceof \Doku_Renderer_xhtml) {
|
|
$renderer->doc .= '<div class="luxtools-plugin"><div class="luxtools-empty">' . hsc($text) . '</div></div>';
|
|
return;
|
|
}
|
|
|
|
$renderer->cdata($text);
|
|
}
|
|
|
|
/**
|
|
* Separate a path into base directory and pattern.
|
|
*
|
|
* @param string $path The full path with pattern
|
|
* @return array [base, pattern]
|
|
*/
|
|
protected function separatePathAndPattern(string $path): array
|
|
{
|
|
$path = Path::cleanPath($path, false);
|
|
$parts = explode('/', $path);
|
|
$pattern = array_pop($parts);
|
|
$base = implode('/', $parts) . '/';
|
|
return [$base, $pattern];
|
|
}
|
|
}
|
|
|
|
}
|