xref: /dokuwiki/inc/ChangeLog/PageChangeLog.php (revision 1d11f1d3396b6d0e55489e568b4bb7028ff9f172)

<?php

namespace dokuwiki\ChangeLog;

/**
 * Class PageChangeLog; handles changelog of a wiki page
 */
class PageChangeLog extends ChangeLog
{

    /**
     * Returns path to changelog
     *
     * @return string path to file
     */
    protected function getChangelogFilename()
    {
        return metaFN($this->id, '.changes');
    }

    /**
     * Returns path to current page/media
     *
     * @param string|int $rev empty string or revision timestamp
     * @return string path to file
     */
    protected function getFilename($rev = '')
    {
        return wikiFN($this->id, $rev);
    }



    /**
     * Adds an entry to the changelog
     *
     * @param array $info    Revision info structure of a page
     * @param int $timestamp logline date (optional)
     * @return array revision info of added logline
     *
     * @see also addLogEntry() in inc/changelog.php file
     */
    public function addLogEntry(array $info, $timestamp = null)
    {
        global $conf;

        if (isset($timestamp)) unset($this->cache[$this->id][$info['date']]);

        // add changelog lines
        $logline = $this->buildLogLine($info, $timestamp);
        io_saveFile(metaFN($this->id,'.changes'), $logline, $append = true);
        io_saveFile($conf['changelog'], $logline, $append = true); //global changelog cache

        // update cache
        $this->currentRevision = $info['date'];
        $this->cache[$this->id][$this->currentRevision] = $info;
        return $info;
    }

}