Готовый пример плагина с пояснениями

;
; Version description file for plugin @@ Next Generation CMS
;

ID: random_news
Name: Случайная выборка новостей
Version: 0.02
Acts: index
File: random_news.php
Config: config.php
Type: plugin
Description: В случайном порядке показывает новости
Author: Anonimys
Author_URI: http://ngcms.ru/
Title: Случайные новости
Information: Случайно показывает новости
Preinstall: no

<?php
if (!defined('NGCMS')) die('HAL');

// Загрузка языкового файла
LoadPluginLang('random_news', 'config', '', '', ':');

add_act('index', 'random_news');

function random_news()
{
    global $template, $mysql, $tpl, $config;

    // Получаем параметры из конфига
    $num = intval(extra_get_param('random_news', 'number'));
    $cacheTime = intval(extra_get_param('random_news', 'cache_time'));

    // Генерация имени кеш-файла
    $cacheFileName = md5('random_news' . $config['theme'] . $config['default_lang'] . $num) . '.txt';

    // Попытка получения данных из кеша
    if ($cacheTime > 0) {
        $cacheData = cacheRetrieveFile($cacheFileName, $cacheTime, 'random_news');
        if ($cacheData !== false) {
            $template['vars']['random_news'] = $cacheData;
            return;
        }
    }

    if (($num < 1) || ($num > 50)) {
        $num = 10; // Значение по умолчанию
    }

    $tpath = locatePluginTemplates(array('random_news', 'entries'), 'random_news');
    $v = '';

    foreach ($mysql->select("SELECT * FROM " . prefix . "_news ORDER BY RAND() LIMIT " . $num) as $row) {
        $tvars['vars'] = array(
            'link'  => newsGenerateLink($row),
            'views' => $row['views'],
            'title' => $row['title']
        );

        $tpl->template('entries', $tpath['entries']);
        $tpl->vars('entries', $tvars);
        $v .= $tpl->show('entries');
    }

    $tvars['vars'] = array('entries' => $v);
    $tpl->template('random_news', $tpath['random_news']);
    $tpl->vars('random_news', $tvars);
    $output = $tpl->show('random_news');

    // Сохранение в кеш
    if ($cacheTime > 0) {
        cacheStoreFile($cacheFileName, $output, 'random_news');
    }

    $template['vars']['random_news'] = $output;
}

<?php
if (!defined('NGCMS')) die('HAL');

// Загрузка текущего конфига
pluginsLoadConfig();
// Загрузка языкового файла
LoadPluginLang('random_news', 'config', '', '', ':');

$cfg = array();
$cfgX = array();

array_push($cfgX, array(
    'name'  => 'number',
    'title' => $lang['random_news:number_title'],
    'descr' => $lang['random_news:number_descr'],
    'type'  => 'input',
    'value' => intval(extra_get_param('random_news', 'number'))
));

array_push($cfgX, array(
    'name'  => 'cache_time',
    'title' => $lang['random_news:cache_time_title'],
    'descr' => $lang['random_news:cache_time_descr'],
    'type'  => 'input',
    'value' => intval(extra_get_param('random_news', 'cache_time'))
));

array_push($cfg, array(
    'mode'    => 'group',
    'title'   => $lang['random_news:group_title'],
    'entries' => $cfgX
));

if ($_REQUEST['action'] == 'commit') {
    commit_plugin_config_changes('random_news', $cfg);
    print_commit_complete('random_news');
} else {
    generate_config_page('random_news', $cfg);
}

<div class="random-news">
    {entries}
</div>

<div class="news-item">
    <a href="{link}">{title}</a>
    <span class="views">Просмотров: {views}</span>
</div>