release 2023.10.11

2023-10-11 21:02:43 +02:00 · 2023-10-11 21:02:43 +02:00 · 208963952c
commit 208963952c
parent aa05e6e1b5
27 changed files with 291 additions and 342 deletions
--- a/README.md
+++ b/README.md
@ -32,10 +32,6 @@ you should also add widgets.

 ## LINKS

-* License : [GNU GPL v2](https://www.gnu.org/licenses/old-licenses/lgpl-2.0.html)
-* Source & contribution : [Gitea Page](https://git.dotclear.watch/JcDenis/enhancePostContent) or [GitHub Page](https://github.com/JcDenis/enhancePostContent)
-* Packages & details: [Gitea Page](https://git.dotclear.watch/JcDenis/enhancePostContent/releases) or [Dotaddict Page](https://plugins.dotaddict.org/dc2/details/enhancePostContent)
-
 * [License](https://git.dotclear.watch/JcDenis/enhancePostContent/src/branch/master/LICENSE)
 * [Packages & details](https://git.dotclear.watch/JcDenis/enhancePostContent/releases) (or on [Dotaddict](https://plugins.dotaddict.org/dc2/details/enhancePostContent))
 * [Sources & contributions](https://git.dotclear.watch/JcDenis/enhancePostContent) (or on [GitHub](https://github.com/JcDenis/enhancePostContent))
--- a/_define.php
+++ b/_define.php
@ -1,35 +1,30 @@
 <?php
 /**
- * @brief enhancePostContent, a plugin for Dotclear 2
+ * @file
+ * @brief       The plugin enhancePostContent definition
+ * @ingroup     enhancePostContent
 *
- * @package Dotclear
- * @subpackage Plugin
+ * @defgroup    enhancePostContent Plugin enhancePostContent.
 *
- * @author Jean-Christian Denis and Contributors
+ * Add features to words in post content.
 *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
 */
-
-use Dotclear\App;
-
 $this->registerModule(
    'Enhance post content',
    'Add features to words in post content',
    'Jean-Christian Denis and Contributors',
-    '2023.08.14',
+    '2023.10.11',
    [
-        'requires' => [
-            ['php', '8.1'],
-            ['core', '2.28'],
-        ],
-        'permissions' => App::auth()->makePermissions([
-            App::auth()::PERMISSION_CONTENT_ADMIN,
-        ]),
-        'settings' => [
+        'type'        => 'plugin',
+        'requires'    => [['core', '2.28']],
+        'permissions' => 'My',
+        'settings'    => [
+            'self' => '',
            'blog' => '#params.epc_params',
        ],
-        'type'       => 'plugin',
        'support'    => 'https://git.dotclear.watch/JcDenis/' . basename(__DIR__) . '/issues',
        'details'    => 'https://git.dotclear.watch/JcDenis/' . basename(__DIR__) . '/src/branch/master/README.md',
        'repository' => 'https://git.dotclear.watch/JcDenis/' . basename(__DIR__) . '/raw/branch/master/dcstore.xml',
--- a/_init.php
+++ b/_init.php
@ -1,20 +0,0 @@
-<?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
-if (!defined('DC_RC_PATH')) {
-    return null;
-}
-
-class initEnhancePostContent
-{
-    public const TABLE_NAME = 'epc';
-}
--- a/dcstore.xml
+++ b/dcstore.xml
@ -2,10 +2,10 @@
 <modules xmlns:da="http://dotaddict.org/da/">
  <module id="enhancePostContent">
    <name>Enhance post content</name>
-    <version>2023.10.08</version>
+    <version>2023.10.11</version>
    <author>Jean-Christian Denis and Contributors</author>
    <desc>Add features to words in post content</desc>
-    <file>https://git.dotclear.watch/JcDenis/enhancePostContent/releases/download/v2023.10.08/plugin-enhancePostContent.zip</file>
+    <file>https://git.dotclear.watch/JcDenis/enhancePostContent/releases/download/v2023.10.11/plugin-enhancePostContent.zip</file>
    <da:dcmin>2.28</da:dcmin>
    <da:details>https://git.dotclear.watch/JcDenis/enhancePostContent/src/branch/master/README.md</da:details>
    <da:support>https://git.dotclear.watch/JcDenis/enhancePostContent/issues</da:support>
--- a/src/Backend.php
+++ b/src/Backend.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent;
@ -30,6 +20,14 @@ use Dotclear\Helper\Html\Form\{
    Text
 };

+/**
+ * @brief   enhancePostContent backend class.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class Backend extends Process
 {
    public static function init(): bool
--- a/src/BackendList.php
+++ b/src/BackendList.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent;
@ -23,8 +13,14 @@ use Dotclear\Helper\Date;
 use Dotclear\Helper\Html\Form\Checkbox;
 use Dotclear\Helper\Html\Html;

+
 /**
- * Backend filters values list.
+ * @brief   enhancePostContent filters list class.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
 */
 class BackendList extends Listing
 {
@ -43,7 +39,7 @@ class BackendList extends Listing
            return;
        }

-        $pager           = new Pager($filter->value('page'), $this->rs_count, $filter->value('nb'), 10);
+        $pager           = new Pager($filter->value('page'), (int) $this->rs_count, $filter->value('nb'), 10);
        $pager->base_url = $url;

        $epc_id = [];
@ -71,7 +67,7 @@ class BackendList extends Listing
        echo $pager->getLinks() . $blocks[0];

        while ($this->rs->fetch()) {
-            $this->line(isset($epc_id[$this->rs->epc_id]));
+            $this->line(isset($epc_id[$this->rs->f('epc_id')]));
        }

        echo $blocks[1] . $blocks[2] . $pager->getLinks();
@ -85,15 +81,15 @@ class BackendList extends Listing
    private function line(bool $checked): void
    {
        $cols = [
-            'check' => '<td class="nowrap">' . (new Checkbox(['epc_id[]'], $checked))->value($this->rs->epc_id)->render() . '</td>',
-            'key'   => '<td class="nowrap">' . Html::escapeHTML($this->rs->epc_key) . '</td>',
-            'value' => '<td class="maximal">' . Html::escapeHTML($this->rs->epc_value) . '</td>',
-            'date'  => '<td class="nowrap count">' . Date::dt2str(__('%Y-%m-%d %H:%M'), $this->rs->epc_upddt) . '</td>',
+            'check' => '<td class="nowrap">' . (new Checkbox(['epc_id[]'], $checked))->value($this->rs->f('epc_id'))->render() . '</td>',
+            'key'   => '<td class="nowrap">' . Html::escapeHTML($this->rs->f('epc_key')) . '</td>',
+            'value' => '<td class="maximal">' . Html::escapeHTML($this->rs->f('epc_value')) . '</td>',
+            'date'  => '<td class="nowrap count">' . Date::dt2str(__('%Y-%m-%d %H:%M'), $this->rs->f('epc_upddt')) . '</td>',
        ];

        echo
-        '<tr class="line" id="p' . $this->rs->epc_id . '">' .
+        '<tr class="line" id="p' . $this->rs->f('epc_id') . '">' .
        implode($cols) .
        '</tr>';
    }
-}
+}
--- a/src/Epc.php
+++ b/src/Epc.php
@ -31,15 +31,60 @@ __('search results page');
 __('atom feeds');
 __('RSS feeds');

+/**
+ * @brief   enhancePostContent main class.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class Epc
 {
-    /** @var    string  The temporary pattern to tag words to replace */
+    /**
+     * Plugin table name.
+     *
+     * @var     string  TABLE_NAME
+     */
+    public const TABLE_NAME = 'epc';
+
+    /**
+     * Distributed filters.
+     *
+     * @var     array<int,string>   DEFAULT_FILTERS
+     */
+    public const DEFAULT_FILTERS = [
+        Filter\EpcFilterTag::class,
+        Filter\EpcFilterSearch::class,
+        Filter\EpcFilterAcronym::class,
+        Filter\EpcFilterAbbreviation::class,
+        Filter\EpcFilterDefinition::class,
+        Filter\EpcFilterCitation::class,
+        Filter\EpcFilterLink::class,
+        Filter\EpcFilterReplace::class,
+        Filter\EpcFilterUpdate::class,
+        Filter\EpcFilterTwitter::class,
+    ];
+
+    /**
+     * The temporary pattern to tag words to replace.
+     *
+     * @var     string  FLAGGER
+     */
    public const FLAGGER = 'ççççç%sççççç';

-    /** @var    EpcFilters  $filters    THe filters stack */
+    /**
+     * The filters stack.
+     *
+     * @var     EpcFilters  $filters
+     */
    private static EpcFilters $filters;

-    /** @var    array<string,int>   $limits     The replacment limit per filtre */
+    /**
+     * The replacment limit per filtre.
+     *
+     * @var     array<string,int>   $limits
+     */
    private static array $limits = [];

    /**
@ -76,7 +121,7 @@ class Epc
    /**
     * Get list of allowed templates name->[tag,callback] to list on epc widgets.
     *
-     * @return  array    The templates name->[id,cb] values
+     * @return  array   The templates name->[id,cb] values
     */
    public static function widgetAllowedTemplateValue(): array
    {
@ -402,7 +447,7 @@ class Epc

        $content = '';
        while (App::frontend()->ctx->__get('posts')?->fetch()) {
-            $content .= dApp::frontend()->ctx->__get('posts')->f('post_content');
+            $content .= App::frontend()->ctx->__get('posts')->f('post_content');
        }

        return $content;
@ -422,9 +467,9 @@ class Epc
        }

        $content = '';
-        while (App::frontend()->ctx->__get('posts')?->fetch()) {
+        while (App::frontend()->ctx->__get('posts')->fetch()) {
            $comments = App::blog()->getComments(['post_id' => App::frontend()->ctx->__get('posts')->f('post_id')]);
-            while ($comments?->fetch()) {
+            while ($comments->fetch()) {
                $content .= $comments->__call('getContent', []);
            }
        }
--- a/src/EpcFilter.php
+++ b/src/EpcFilter.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent;
@ -20,9 +10,14 @@ use Dotclear\Plugin\widgets\WidgetsElement;
 use Exception;

 /**
- * Filter abstract class.
+ * @brief   enhancePostContent abstract filter class.
+ * @ingroup enhancePostContent
 *
 * All filter must extends this class.
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
 */
 abstract class EpcFilter
 {
@ -44,10 +39,10 @@ abstract class EpcFilter
    /** @var    bool    $has_list   Filter has list of records (property) */
    public readonly bool $has_list;

-    /** @var    array  $ignore     The filter disabled html tags (property) */
+    /** @var    array<int,string>   $ignore     The filter disabled html tags (property) */
    public readonly array $ignore;

-    /** @var    array  $class  The css class that apply to filter (property) */
+    /** @var    array<int,string>  $class  The css class that apply to filter (property) */
    public readonly array $class;

    /** @var    string  $replace    The filter replacement bloc in content (property) */
@ -65,16 +60,16 @@ abstract class EpcFilter
    /** @var    bool    $plural     The replacement limit per filter (settings) */
    public readonly int $limit;

-    /** @var    array  $style   The style applied to filter class (settings) */
+    /** @var    array<int,string>   $style   The style applied to filter class (settings) */
    public readonly array $style;

-    /** @var    array  $notag   The filter disabled html tags (settings) */
+    /** @var    array<int,string>   $notag   The filter disabled html tags (settings) */
    public readonly array $notag;

-    /** @var    array  $template    The extra template value to scan (settings) */
+    /** @var    array<int,string>   $template    The extra template value to scan (settings) */
    public readonly array $template;

-    /** @var    array  $page    The extra frontend pages to scan (settings) */
+    /** @var    array<int,string>   $page   The extra frontend pages to scan (settings) */
    public readonly array $page;

    /**
--- a/src/EpcFilters.php
+++ b/src/EpcFilters.php
@ -1,23 +1,18 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent;

 /**
- * Filters stack.
+ * @brief   enhancePostContent filters stack.
+ * @ingroup enhancePostContent
 *
 * Use Epc::getFilters() to get loaded stack
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
 */
 class EpcFilters
 {
--- a/src/EpcRecord.php
+++ b/src/EpcRecord.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent;
@ -22,7 +12,12 @@ use Dotclear\Database\{
 use Exception;

 /**
- * Filter records.
+ * @brief   enhancePostContent filters records.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
 */
 class EpcRecord
 {
@ -48,7 +43,7 @@ class EpcRecord
            'E.epc_filter, E.epc_key, E.epc_value ';
        }

-        $strReq .= 'FROM ' . App::con()->prefix() . My::TABLE_NAME . ' E ';
+        $strReq .= 'FROM ' . App::con()->prefix() . Epc::TABLE_NAME . ' E ';

        if (!empty($params['from'])) {
            $strReq .= $params['from'] . ' ';
@ -121,7 +116,7 @@ class EpcRecord
     */
    public static function addRecord(Cursor $cur): int
    {
-        App::con()->writeLock(App::con()->prefix() . My::TABLE_NAME);
+        App::con()->writeLock(App::con()->prefix() . Epc::TABLE_NAME);

        try {
            $cur->setField('epc_id', self::getNextId());
@ -199,7 +194,7 @@ class EpcRecord
        App::behavior()->callBehavior('enhancePostContentbeforeDelRecord', $id);

        App::con()->execute(
-            'DELETE FROM ' . App::con()->prefix() . My::TABLE_NAME . ' ' .
+            'DELETE FROM ' . App::con()->prefix() . Epc::TABLE_NAME . ' ' .
            'WHERE epc_id = ' . $id . ' ' .
            "AND blog_id = '" . App::con()->escapeStr(App::blog()->id()) . "' "
        );
@ -215,7 +210,7 @@ class EpcRecord
    private static function getNextId(): int
    {
        return (int) App::con()->select(
-            'SELECT MAX(epc_id) FROM ' . App::con()->prefix() . My::TABLE_NAME . ' '
+            'SELECT MAX(epc_id) FROM ' . App::con()->prefix() . Epc::TABLE_NAME . ' '
        )->f(0) + 1;
    }

@ -226,7 +221,7 @@ class EpcRecord
     */
    public static function openCursor(): Cursor
    {
-        return App::con()->openCursor(App::con()->prefix() . My::TABLE_NAME);
+        return App::con()->openCursor(App::con()->prefix() . Epc::TABLE_NAME);
    }

    /**
--- a/src/Filter/EpcFilterAbbreviation.php
+++ b/src/Filter/EpcFilterAbbreviation.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent\Filter;
@ -19,6 +9,14 @@ use Dotclear\Plugin\enhancePostContent\Epc;
 use Dotclear\Plugin\enhancePostContent\EpcFilter;
 use Dotclear\Plugin\widgets\WidgetsElement;

+/**
+ * @brief   enhancePostContent abbreviation filter.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class EpcFilterAbbreviation extends EpcFilter
 {
    protected string $id = 'abbreviation';
--- a/src/Filter/EpcFilterAcronym.php
+++ b/src/Filter/EpcFilterAcronym.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent\Filter;
@ -19,6 +9,14 @@ use Dotclear\Plugin\enhancePostContent\Epc;
 use Dotclear\Plugin\enhancePostContent\EpcFilter;
 use Dotclear\Plugin\widgets\WidgetsElement;

+/**
+ * @brief   enhancePostContent acronym filter.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class EpcFilterAcronym extends EpcFilter
 {
    protected string $id = 'acronym';
--- a/src/Filter/EpcFilterCitation.php
+++ b/src/Filter/EpcFilterCitation.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent\Filter;
@ -19,6 +9,14 @@ use Dotclear\Plugin\enhancePostContent\Epc;
 use Dotclear\Plugin\enhancePostContent\EpcFilter;
 use Dotclear\Plugin\widgets\WidgetsElement;

+/**
+ * @brief   enhancePostContent citaion filter.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class EpcFilterCitation extends EpcFilter
 {
    protected string $id = 'citation';
--- a/src/Filter/EpcFilterDefinition.php
+++ b/src/Filter/EpcFilterDefinition.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent\Filter;
@ -19,6 +9,14 @@ use Dotclear\Plugin\enhancePostContent\Epc;
 use Dotclear\Plugin\enhancePostContent\EpcFilter;
 use Dotclear\Plugin\widgets\WidgetsElement;

+/**
+ * @brief   enhancePostContent definition filter.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class EpcFilterDefinition extends EpcFilter
 {
    protected string $id = 'definition';
--- a/src/Filter/EpcFilterLink.php
+++ b/src/Filter/EpcFilterLink.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent\Filter;
@ -19,6 +9,14 @@ use Dotclear\Plugin\enhancePostContent\Epc;
 use Dotclear\Plugin\enhancePostContent\EpcFilter;
 use Dotclear\Plugin\widgets\WidgetsElement;

+/**
+ * @brief   enhancePostContent link filter.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class EpcFilterLink extends EpcFilter
 {
    protected string $id = 'link';
--- a/src/Filter/EpcFilterReplace.php
+++ b/src/Filter/EpcFilterReplace.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent\Filter;
@ -17,6 +7,14 @@ namespace Dotclear\Plugin\enhancePostContent\Filter;
 use Dotclear\Plugin\enhancePostContent\Epc;
 use Dotclear\Plugin\enhancePostContent\EpcFilter;

+/**
+ * @brief   enhancePostContent replacement filter.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class EpcFilterReplace extends EpcFilter
 {
    protected string $id = 'replace';
--- a/src/Filter/EpcFilterSearch.php
+++ b/src/Filter/EpcFilterSearch.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent\Filter;
@ -18,6 +8,14 @@ use Dotclear\App;
 use Dotclear\Plugin\enhancePostContent\Epc;
 use Dotclear\Plugin\enhancePostContent\EpcFilter;

+/**
+ * @brief   enhancePostContent search filter.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class EpcFilterSearch extends EpcFilter
 {
    protected string $id = 'search';
--- a/src/Filter/EpcFilterTag.php
+++ b/src/Filter/EpcFilterTag.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent\Filter;
@ -20,6 +10,14 @@ use Dotclear\Plugin\enhancePostContent\Epc;
 use Dotclear\Plugin\enhancePostContent\EpcFilter;
 use Dotclear\Plugin\widgets\WidgetsElement;

+/**
+ * @brief   enhancePostContent tag filter.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class EpcFilterTag extends EpcFilter
 {
    protected string $id = 'tag';
--- a/src/Filter/EpcFilterTwitter.php
+++ b/src/Filter/EpcFilterTwitter.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent\Filter;
@ -17,6 +7,14 @@ namespace Dotclear\Plugin\enhancePostContent\Filter;
 use Dotclear\Plugin\enhancePostContent\Epc;
 use Dotclear\Plugin\enhancePostContent\EpcFilter;

+/**
+ * @brief   enhancePostContent twitter filter.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class EpcFilterTwitter extends EpcFilter
 {
    protected string $id = 'twitter';
--- a/src/Filter/EpcFilterUpdate.php
+++ b/src/Filter/EpcFilterUpdate.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent\Filter;
@ -17,6 +7,14 @@ namespace Dotclear\Plugin\enhancePostContent\Filter;
 use Dotclear\Plugin\enhancePostContent\Epc;
 use Dotclear\Plugin\enhancePostContent\EpcFilter;

+/**
+ * @brief   enhancePostContent update filter.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class EpcFilterUpdate extends EpcFilter
 {
    protected string $id = 'update';
--- a/src/Frontend.php
+++ b/src/Frontend.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent;
@ -17,6 +7,14 @@ namespace Dotclear\Plugin\enhancePostContent;
 use Dotclear\App;
 use Dotclear\Core\Process;

+/**
+ * @brief   enhancePostContent frontend class.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class Frontend extends Process
 {
    public static function init(): bool
--- a/src/Install.php
+++ b/src/Install.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent;
@ -19,6 +9,14 @@ use Dotclear\Core\Process;
 use Dotclear\Database\Structure;
 use Exception;

+/**
+ * @brief   enhancePostContent installation class.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class Install extends Process
 {
    public static function init(): bool
@ -35,7 +33,7 @@ class Install extends Process
        try {
            // Database
            $s = new Structure(App::con(), App::con()->prefix());
-            $s->__get(My::TABLE_NAME)
+            $s->__get(Epc::TABLE_NAME)
                ->field('epc_id', 'bigint', 0, false)
                ->field('blog_id', 'varchar', 32, false)
                ->field('epc_type', 'varchar', 32, false, "'epc'")
@ -124,10 +122,10 @@ class Install extends Process
                $curlist = @unserialize($record->f('setting_value'));
                if (is_array($curlist)) {
                    foreach ($curlist as $k => $v) {
-                        $cur = App::con()->openCursor(App::con()->prefix() . My::TABLE_NAME);
-                        App::con()->writeLock(App::con()->prefix() . My::TABLE_NAME);
+                        $cur = App::con()->openCursor(App::con()->prefix() . Epc::TABLE_NAME);
+                        App::con()->writeLock(App::con()->prefix() . Epc::TABLE_NAME);

-                        $cur->setField('epc_id', (int) App::con()->select('SELECT MAX(epc_id) FROM ' . App::con()->prefix() . My::TABLE_NAME . ' ')->f(0) + 1);
+                        $cur->setField('epc_id', (int) App::con()->select('SELECT MAX(epc_id) FROM ' . App::con()->prefix() . Epc::TABLE_NAME . ' ')->f(0) + 1);
                        $cur->setField('blog_id', $record->f('blog_id'));
                        $cur->setField('epc_filter', strtolower($m[1]));
                        $cur->setField('epc_key', $k);
@ -150,9 +148,9 @@ class Install extends Process
    private static function upTo20211006(): void
    {
        # Move old filter name to filter id
-        $record = App::con()->select('SELECT epc_id, epc_filter FROM ' . App::con()->prefix() . My::TABLE_NAME);
+        $record = App::con()->select('SELECT epc_id, epc_filter FROM ' . App::con()->prefix() . Epc::TABLE_NAME);
        while ($record->fetch()) {
-            $cur = App::con()->openCursor(App::con()->prefix() . My::TABLE_NAME);
+            $cur = App::con()->openCursor(App::con()->prefix() . Epc::TABLE_NAME);

            $cur->setField('epc_filter', strtolower($record->f('epc_filter')));

--- a/src/Manage.php
+++ b/src/Manage.php
@ -42,6 +42,14 @@ use Dotclear\Helper\Html\Html;
 use Dotclear\Helper\Network\Http;
 use Exception;

+/**
+ * @brief   enhancePostContent manage class.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class Manage extends Process
 {
    public static function init(): bool
--- a/src/My.php
+++ b/src/My.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent;
@ -18,32 +8,23 @@ use Dotclear\App;
 use Dotclear\Module\MyPlugin;

 /**
- * This module definitions.
+ * @brief   enhancePostContent My helper.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
 */
 class My extends MyPlugin
 {
-    /** @var    string  Plugin table name */
-    public const TABLE_NAME = 'epc';
-
-    /** @var    array   Distributed filters */
-    public const DEFAULT_FILTERS = [
-        Filter\EpcFilterTag::class,
-        Filter\EpcFilterSearch::class,
-        Filter\EpcFilterAcronym::class,
-        Filter\EpcFilterAbbreviation::class,
-        Filter\EpcFilterDefinition::class,
-        Filter\EpcFilterCitation::class,
-        Filter\EpcFilterLink::class,
-        Filter\EpcFilterReplace::class,
-        Filter\EpcFilterUpdate::class,
-        Filter\EpcFilterTwitter::class,
-    ];
-
    public static function checkCustomContext(int $context): ?bool
    {
-        return !in_array($context, [My::BACKEND, My::MANAGE, My::MENU]) ? null :
-            App::auth()->check(App::auth()->makePermissions([
-                App::auth()::PERMISSION_CONTENT_ADMIN,
-            ]), App::blog()->id());
-    }
-}
+        return match ($context) {
+            // Limit main backend featrues to content admin
+            self::BACKEND, self::MANAGE, self::MENU => 
+                App::auth()->check(App::auth()->makePermissions([
+                    App::auth()::PERMISSION_CONTENT_ADMIN,
+                ]), App::blog()->id()),
+
+            default => null,
+  
--- a/src/Prepend.php
+++ b/src/Prepend.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent;
@ -18,6 +8,14 @@ use Dotclear\App;
 use Dotclear\Core\Process;
 use Dotclear\Helper\Html\Html;

+/**
+ * @brief   enhancePostContent prepend class.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class Prepend extends Process
 {
    public static function init(): bool
@ -33,7 +31,7 @@ class Prepend extends Process

        // register epc filters
        app::behavior()->addBehavior('enhancePostContentFilters', function (EpcFilters $stack): void {
-            foreach (My::DEFAULT_FILTERS as $class) {
+            foreach (Epc::DEFAULT_FILTERS as $class) {
                $stack->add(new $class());
            }
        });
--- a/src/Uninstall.php
+++ b/src/Uninstall.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent;
@ -17,6 +7,14 @@ namespace Dotclear\Plugin\enhancePostContent;
 use Dotclear\Core\Process;
 use Dotclear\Plugin\Uninstaller\Uninstaller;

+/**
+ * @brief   enhancePostContent uninstall class.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
+ */
 class Uninstall extends Process
 {
    public static function init(): bool
@ -39,7 +37,7 @@ class Uninstall extends Process
            ->addUserAction(
                'tables',
                'delete',
-                My::TABLE_NAME
+                Epc::TABLE_NAME
            )
            ->addUserAction(
                'plugins',
@ -59,7 +57,7 @@ class Uninstall extends Process
            ->addDirectAction(
                'tables',
                'delete',
-                My::TABLE_NAME
+                Epc::TABLE_NAME
            )
            ->addDirectAction(
                'plugins',
--- a/src/Widgets.php
+++ b/src/Widgets.php
@ -1,15 +1,5 @@
 <?php
-/**
- * @brief enhancePostContent, a plugin for Dotclear 2
- *
- * @package Dotclear
- * @subpackage Plugin
- *
- * @author Jean-Christian Denis and Contributors
- *
- * @copyright Jean-Christian Denis
- * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
- */
+
 declare(strict_types=1);

 namespace Dotclear\Plugin\enhancePostContent;
@ -21,9 +11,12 @@ use Dotclear\Plugin\widgets\WidgetsStack;
 use Dotclear\Plugin\widgets\WidgetsElement;

 /**
- * @ingroup DC_PLUGIN_ENHANCEPOSTCONTENT
- * @brief Filter posts content - widgets methods.
- * @since 2.6
+ * @brief   enhancePostContent widgets class.
+ * @ingroup enhancePostContent
+ *
+ * @author      Jean-Christian Denis
+ * @copyright   Jean-Christian Denis
+ * @copyright   GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
 */
 class Widgets
 {