topWriter/_admin.php

<?php
/**
 * @brief topWriter, a plugin for Dotclear 2
 *
 * @package Dotclear
 * @subpackage Plugin
 *
 * @author Jean-Christian Denis, Pierre Van Glabeke
 *
 * @copyright Jean-Christian Denis
 * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
 */
if (!defined('DC_CONTEXT_ADMIN')) {
    return null;
}

require __DIR__ . '/_widgets.php';

# Dashboard item and user preference
dcCore::app()->addBehavior(
    'adminDashboardItemsV2',
    ['topWriterAdmin', 'adminDashboardItems']
);
dcCore::app()->addBehavior(
    'adminDashboardOptionsFormV2',
    ['topWriterAdmin', 'adminDashboardOptionsForm']
);
dcCore::app()->addBehavior(
    'adminAfterDashboardOptionsUpdate',
    ['topWriterAdmin', 'adminAfterDashboardOptionsUpdate']
);

/**
 * @ingroup DC_PLUGIN_TOPWRITER
 * @brief Display most active users - admin methods.
 * @since 2.6
 */
class topWriterAdmin
{
    public static function adminDashboardItems($__dashboard_items)
    {
        $pref = self::setDefaultPref();

        # top posts
        if ($pref['topWriterPostsItems']) {
            $lines = topWriter::posts($pref['topWriterPostsPeriod'], $pref['topWriterPostsLimit']);
            if (empty($lines)) {
                return null;
            }

            $li = [];
            foreach ($lines as $k => $line) {
                $li[] = sprintf('<li><strong>%s</strong> %s (%s)</li>', $k, $line['author'], $line['count']);
            }

            # Display
            $__dashboard_items[0][] = '<div class="box small" id="topWriterPostsItems">' .
            '<h3>' . html::escapeHTML(__('Top writer: entries')) . '</h3>' .
            '<ul>' . implode('', $li) . '</ul>' .
            '</div>';
        }

        # top comments
        if ($pref['topWriterCommentsItems']) {
            $lines = topWriter::comments($pref['topWriterCommentsPeriod'], $pref['topWriterCommentsLimit']);
            if (empty($lines)) {
                return null;
            }

            $li = [];
            foreach ($lines as $k => $line) {
                $li[] = sprintf('<li><strong>%s</strong> %s (%s)</li>', $k, $line['author'], $line['count']);
            }

            # Display
            $__dashboard_items[0][] = '<div class="box small" id="topWriterCommentsItems">' .
            '<h3>' . html::escapeHTML(__('Top writer: comments')) . '</h3>' .
            '<ul>' . implode('', $li) . '</ul>' .
            '</div>';
        }
    }

    public static function adminDashboardOptionsForm()
    {
        $pref = self::setDefaultPref();

        echo
        '<div class="fieldset">' .
        '<h4>' . __('Top writer: entries') . '</h4>' .
        '<p><label class="classic" for="topWriterPostsItems">' .
        form::checkbox('topWriterPostsItems', 1, $pref['topWriterPostsItems']) . ' ' .
        __('Show') . '</label></p>' .
        '<p><label class="classic" for="topWriterPostsPeriod">' . __('Period:') . ' </label>' .
        form::combo('topWriterPostsPeriod', topWriter::periods(), $pref['topWriterPostsPeriod']) . '</p>' .
        '<p><label class="classic" for="topWriterPostsLimit">' . __('Limit:') . ' </label>' .
        form::number('topWriterPostsLimit', ['min' => 1, 'max' => 20, 'default' => $pref['topWriterPostsLimit']]) . '</p>' .
        '</div>' .

        '<div class="fieldset">' .
        '<h4>' . __('Top writer: comments') . '</h4>' .
        '<p><label class="classic" for="topWriterCommentsItems">' .
        form::checkbox('topWriterCommentsItems', 1, $pref['topWriterCommentsItems']) . ' ' .
        __('Show') . '</label></p>' .
        '<p><label class="classic" for="topWriterCommentsPeriod">' . __('Period:') . ' </label>' .
        form::combo('topWriterCommentsPeriod', topWriter::periods(), $pref['topWriterCommentsPeriod']) . '</p>' .
        '<p><label class="classic" for="topWriterCommentsLimit">' . __('Limit:') . ' </label>' .
        form::number('topWriterCommentsLimit', ['min' => 1, 'max' => 20, 'default' => $pref['topWriterCommentsLimit']]) . '</p>' .
        '</div>';
    }

    public static function adminAfterDashboardOptionsUpdate($user_id)
    {
        dcCore::app()->auth->user_prefs->dashboard->put(
            'topWriterPostsItems',
            !empty($_POST['topWriterPostsItems']),
            'boolean'
        );
        dcCore::app()->auth->user_prefs->dashboard->put(
            'topWriterPostsPeriod',
            (string) $_POST['topWriterPostsPeriod'],
            'string'
        );
        dcCore::app()->auth->user_prefs->dashboard->put(
            'topWriterPostsLimit',
            (int) $_POST['topWriterPostsLimit'],
            'integer'
        );

        dcCore::app()->auth->user_prefs->dashboard->put(
            'topWriterCommentsItems',
            !empty($_POST['topWriterCommentsItems']),
            'boolean'
        );
        dcCore::app()->auth->user_prefs->dashboard->put(
            'topWriterCommentsPeriod',
            (string) $_POST['topWriterCommentsPeriod'],
            'string'
        );
        dcCore::app()->auth->user_prefs->dashboard->put(
            'topWriterCommentsLimit',
            (int) $_POST['topWriterCommentsLimit'],
            'integer'
        );
    }

    private static function setDefaultPref()
    {
        if (!dcCore::app()->auth->user_prefs->dashboard->prefExists('topWriterPostsItems')) {
            dcCore::app()->auth->user_prefs->dashboard->put(
                'topWriterPostsItems',
                false,
                'boolean'
            );
        }
        if (!dcCore::app()->auth->user_prefs->dashboard->prefExists('topWriterPostsPeriod')) {
            dcCore::app()->auth->user_prefs->dashboard->put(
                'topWriterPostsPeriod',
                'month',
                'string'
            );
        }
        if (!dcCore::app()->auth->user_prefs->dashboard->prefExists('topWriterPostsLimit')) {
            dcCore::app()->auth->user_prefs->dashboard->put(
                'topWriterPostsLimit',
                10,
                'integer'
            );
        }
        if (!dcCore::app()->auth->user_prefs->dashboard->prefExists('topWriterCommentsItems')) {
            dcCore::app()->auth->user_prefs->dashboard->put(
                'topWriterCommentsItems',
                false,
                'boolean'
            );
        }
        if (!dcCore::app()->auth->user_prefs->dashboard->prefExists('topWriterCommentsPeriod')) {
            dcCore::app()->auth->user_prefs->dashboard->put(
                'topWriterCommentsPeriod',
                'month',
                'string'
            );
        }
        if (!dcCore::app()->auth->user_prefs->dashboard->prefExists('topWriterCommentsLimit')) {
            dcCore::app()->auth->user_prefs->dashboard->put(
                'topWriterCommentsLimit',
                10,
                'integer'
            );
        }

        return [
            'topWriterPostsItems'     => dcCore::app()->auth->user_prefs->dashboard->get('topWriterPostsItems'),
            'topWriterPostsPeriod'    => dcCore::app()->auth->user_prefs->dashboard->get('topWriterPostsPeriod'),
            'topWriterPostsLimit'     => dcCore::app()->auth->user_prefs->dashboard->get('topWriterPostsLimit') ?? 10,
            'topWriterCommentsItems'  => dcCore::app()->auth->user_prefs->dashboard->get('topWriterCommentsItems'),
            'topWriterCommentsPeriod' => dcCore::app()->auth->user_prefs->dashboard->get('topWriterCommentsPeriod'),
            'topWriterCommentsLimit'  => dcCore::app()->auth->user_prefs->dashboard->get('topWriterCommentsLimit') ?? 10,
        ];
    }
}