xref: /template/strap/action/qualitymutation.php (revision 4cadd4f8c541149bdda95f080e38a6d4e3a640ca)

<?php

use ComboStrap\CacheLog;
use ComboStrap\CacheManager;
use ComboStrap\Event;
use ComboStrap\ExceptionCombo;
use ComboStrap\FileSystems;
use ComboStrap\LogUtility;
use ComboStrap\LowQualityCalculatedIndicator;
use ComboStrap\LowQualityPageOverwrite;
use ComboStrap\MetadataDokuWikiStore;
use ComboStrap\Page;
use ComboStrap\PagePath;
use ComboStrap\Site;


require_once(__DIR__ . '/../ComboStrap/PluginUtility.php');

/**
 * Delete the backlinks when there is a quality mutation
 */
class action_plugin_combo_qualitymutation extends DokuWiki_Action_Plugin
{


    public const QUALITY_MUTATION_EVENT_NAME = 'quality_mutation';
    const CANONICAL = "low_quality";
    const DESC = "desc";


    public function register(Doku_Event_Handler $controller)
    {


        /**
         * create the async event
         */
        $controller->register_hook(MetadataDokuWikiStore::PAGE_METADATA_MUTATION_EVENT, 'AFTER', $this, 'create_quality_mutation', array());

        /**
         * process the Async event
         */
        $controller->register_hook(self::QUALITY_MUTATION_EVENT_NAME, 'AFTER', $this, 'handle_quality_mutation');


    }


    public function handle_quality_mutation(Doku_Event $event, $param)
    {


        $data = $event->data;
        $path = $data[PagePath::getPersistentName()];
        $page = Page::createPageFromQualifiedPath($path);

        if (!$page->getCanBeOfLowQuality()) {
            return;
        }

        /**
         * Delete the html document cache to rewrite the links
         *
         */
        foreach ($page->getBacklinks() as $backlink) {
            $htmlDocument = $backlink->getHtmlDocument();
            $desc = $data[self::DESC];
            CacheLog::deleteCacheIfExistsAndLog(
                $htmlDocument,
                self::QUALITY_MUTATION_EVENT_NAME,
                "The {$backlink->getDokuwikiId()} of {$path} had its HTML cache deleted ($desc)."
            );
        }
    }


    /**
     */
    function create_quality_mutation(Doku_Event $event, $params): void
    {

        if (!Site::isLowQualityProtectionEnable()) {
            return;
        }

        /**
         * If this is not a mutation on references we return.
         */
        $data = $event->data;
        $variableName = $data["name"];
        if (!(in_array($variableName, [LowQualityCalculatedIndicator::getPersistentName(), LowQualityPageOverwrite::getPersistentName()]))) {
            return;
        }

        $newValue = $data[MetadataDokuWikiStore::NEW_VALUE_ATTRIBUTE];
        $path = $data[PagePath::getPersistentName()];
        Event::createEvent(
            self::QUALITY_MUTATION_EVENT_NAME,
            [
                PagePath::getPersistentName() => $path,
                self::DESC => "The variable ($variableName) has the new value ($newValue)"
            ]
        );


    }

}