nodebb-plugin-niki-loyalty 1.0.1

package/.gitattributes

@@ -0,0 +1,22 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# Custom for Visual Studio
+*.cs     diff=csharp
+*.sln    merge=union
+*.csproj merge=union
+*.vbproj merge=union
+*.fsproj merge=union
+*.dbproj merge=union
+
+# Standard to msysgit
+*.doc	 diff=astextplain
+*.DOC	 diff=astextplain
+*.docx diff=astextplain
+*.DOCX diff=astextplain
+*.dot  diff=astextplain
+*.DOT  diff=astextplain
+*.pdf  diff=astextplain
+*.PDF	 diff=astextplain
+*.rtf	 diff=astextplain
+*.RTF	 diff=astextplain

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 NodeBB Inc. <sales@nodebb.org>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# Quickstart Plugin for NodeBB
+
+A starter kit for quickly creating NodeBB plugins. Comes with a pre-setup SCSS file, server side JS script with an `static:app.load` hook, and a client-side script. Most plugins need at least one of the above, so this ought to save you some time. For a full list of hooks have a look at our [wiki page](https://github.com/NodeBB/NodeBB/wiki/Hooks), and for more information about creating plugins please visit our [documentation portal](https://docs.nodebb.org/).
+
+Fork this or copy it, and using your favourite text editor find and replace all instances of `nodebb-plugin-quickstart` with `nodebb-plugin-your-plugins-name`. Change the author's name in the LICENSE and package.json files.
+
+## Hello World
+
+Really simple, just edit `public/lib/main.js` and paste in `console.log('hello world');`, and that's it!
+
+## Installation
+
+    npm install nodebb-plugin-quickstart
+
+## Screenshots
+
+Don't forget to add screenshots!

package/commitlint.config.js

@@ -0,0 +1,26 @@
+'use strict';
+
+module.exports = {
+	extends: ['@commitlint/config-angular'],
+	rules: {
+		'header-max-length': [1, 'always', 72],
+		'type-enum': [
+			2,
+			'always',
+			[
+				'breaking',
+				'build',
+				'chore',
+				'ci',
+				'docs',
+				'feat',
+				'fix',
+				'perf',
+				'refactor',
+				'revert',
+				'style',
+				'test',
+			],
+		],
+	},
+};

package/eslint.config.mjs

@@ -0,0 +1,10 @@
+'use strict';
+
+import serverConfig from 'eslint-config-nodebb';
+import publicConfig from 'eslint-config-nodebb/public';
+
+export default [
+	...publicConfig,
+	...serverConfig,
+];
+

package/languages/de/quickstart.json

@@ -0,0 +1,3 @@
+{
+	"info": "Dies ist eine Übersetzungszeichenkette, sie wird in die Sprache des Benutzers übersetzt. Siehe den Ordner 'languages' im Stammverzeichnis dieses Plugins."
+}

package/languages/en-GB/quickstart.json

@@ -0,0 +1,3 @@
+{
+	"info": "This is a translation string, it gets translated to the users language. See the languages folder in the root of this plugin."
+}

package/languages/en-US/quickstart.json

@@ -0,0 +1,3 @@
+{
+	"info": "This is a translation string, it gets translated to the users language. See the languages folder in the root of this plugin."
+}

package/lib/controllers.js

@@ -0,0 +1,20 @@
+'use strict';
+
+const Controllers = module.exports;
+
+Controllers.renderAdminPage = function (req, res/* , next */) {
+	/*
+		Make sure the route matches your path to template exactly.
+
+		If your route was:
+			myforum.com/some/complex/route
+		your template should be:
+			templates/some/complex/route.tpl
+		and you would render it like so:
+			res.render('some/complex/route');
+	*/
+
+	res.render('admin/plugins/quickstart', {
+		title: 'Quick Start',
+	});
+};

package/library.js

@@ -0,0 +1,94 @@
+'use strict';
+
+const db = require.main.require('./src/database');
+const user = require.main.require('./src/user');
+const routeHelpers = require.main.require('./src/controllers/helpers');
+
+const Plugin = {};
+
+// --- AYARLAR ---
+const SETTINGS = {
+    pointsPerHeartbeat: 5,  // Her vuruşta kaç puan?
+    heartbeatInterval: 60,  // Kaç saniyede bir (Client ile uyumlu olmalı)
+    dailyCap: 250           // Günlük maksimum puan (Örn: 50dk aktiflik)
+};
+
+Plugin.init = async function (params) {
+    const router = params.router;
+    const middleware = params.middleware;
+
+    // API: Kalp Atışı (Puan Kazanma)
+    router.post('/api/niki-loyalty/heartbeat', middleware.ensureLoggedIn, async (req, res) => {
+        const uid = req.uid;
+        const today = new Date().toISOString().slice(0, 10).replace(/-/g, ''); // 20251214
+        
+        // 1. Günlük Limiti Kontrol Et
+        const dailyKey = `niki:daily:${uid}:${today}`;
+        const currentDailyScore = await db.getObjectField(dailyKey, 'score') || 0;
+
+        if (parseInt(currentDailyScore) >= SETTINGS.dailyCap) {
+            return res.json({ earned: false, reason: 'daily_cap' });
+        }
+
+        // 2. Puan Ver
+        await user.incrementUserFieldBy(uid, 'niki_points', SETTINGS.pointsPerHeartbeat);
+        await db.incrObjectFieldBy(dailyKey, 'score', SETTINGS.pointsPerHeartbeat);
+
+        // 3. Güncel Bakiyeyi Dön
+        const newBalance = await user.getUserField(uid, 'niki_points');
+        return res.json({ 
+            earned: true, 
+            points: SETTINGS.pointsPerHeartbeat, 
+            total: newBalance,
+            daily: parseInt(currentDailyScore) + SETTINGS.pointsPerHeartbeat
+        });
+    });
+
+    // SAYFA: Cüzdan (/niki-wallet)
+    routeHelpers.setupPageRoute(router, '/niki-wallet', middleware, [], async (req, res) => {
+        const uid = req.uid;
+        if (!uid) return res.redirect('/login');
+
+        const today = new Date().toISOString().slice(0, 10).replace(/-/g, '');
+        
+        // Verileri Çek
+        const [userData, dailyData] = await Promise.all([
+            user.getUserFields(uid, ['username', 'userslug', 'picture', 'niki_points']),
+            db.getObject(`niki:daily:${uid}:${today}`)
+        ]);
+
+        const currentPoints = parseInt(userData.niki_points) || 0;
+        const dailyScore = parseInt(dailyData ? dailyData.score : 0) || 0;
+        
+        // Yüzdelik Hesapla (Bar için)
+        let dailyPercent = (dailyScore / SETTINGS.dailyCap) * 100;
+        if (dailyPercent > 100) dailyPercent = 100;
+
+        res.render('niki-wallet', {
+            title: 'Niki Cüzdan',
+            points: currentPoints,
+            dailyScore: dailyScore,
+            dailyCap: SETTINGS.dailyCap,
+            dailyPercent: dailyPercent,
+            user: userData
+        });
+    });
+};
+
+Plugin.addScripts = async function (scripts) {
+    scripts.push('plugins/nodebb-plugin-niki-loyalty/static/lib/client.js');
+    return scripts;
+};
+
+Plugin.addNavigation = async function (nav) {
+    nav.push({
+        "route": "/niki-wallet",
+        "title": "Niki Cüzdan",
+        "enabled": true,
+        "iconClass": "fa-coffee",
+        "text": "Niki Cüzdan"
+    });
+    return nav;
+};
+
+module.exports = Plugin;

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "nodebb-plugin-niki-loyalty",
+  "version": "1.0.1",
+  "description": "Niki The Cat Coffee Loyalty System - Earn points while studying on IEU Forum.",
+  "main": "library.js",
+  "nbbpm": {
+    "compatibility": "^4.0.0"
+  },
+  "keywords": [
+    "nodebb",
+    "plugin",
+    "loyalty",
+    "gamification",
+    "points",
+    "niki"
+  ],
+  "author": {
+    "name": "IEU Forum Team",
+    "email": "admin@ieu.app"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sucreistaken/nodebb-plugin-niki-loyalty"
+  },
+  "bugs": {
+    "url": "https://github.com/sucreistaken/nodebb-plugin-niki-loyalty/issues"
+  },
+  "dependencies": {}
+}

package/plugin.json

@@ -0,0 +1,20 @@
+{
+    "id": "nodebb-plugin-niki-loyalty",
+    "name": "Niki Loyalty System",
+    "description": "Öğrenciler ders çalışsın, kahve kazansın.",
+    "url": "https://forum.ieu.app",
+    "library": "./library.js",
+    "hooks": [
+        { "hook": "static:app.load", "method": "init" },
+        { "hook": "filter:scripts.get", "method": "addScripts" },
+        { "hook": "filter:navigation.available", "method": "addNavigation" },
+        { "hook": "action:topic.get", "method": "checkTopicVisit" }
+    ],
+    "scripts": [
+        "static/lib/client.js"
+    ],
+    "staticDirs": {
+        "static": "./static"
+    },
+    "templates": "./templates"
+}

package/public/lib/acp-main.js

@@ -0,0 +1,18 @@
+'use strict';
+
+$(document).ready(function () {
+	/*
+		This file shows how admin page client-side javascript can be included via a plugin.
+		If you check `plugin.json`, you'll see that this file is listed under "acpScripts".
+		That array tells NodeBB which files to bundle into the minified javascript
+		that is served to the end user.
+
+		Some events you can elect to listen for:
+
+		$(document).ready(); Fired when the DOM is ready
+		$(window).on('action:ajaxify.end', function(data) { ... }); "data" contains "url"
+	*/
+
+	console.log('nodebb-plugin-quickstart: acp-loaded');
+	// Note how this is shown in the console on the first load of every page in the ACP
+});

package/public/lib/admin.js

@@ -0,0 +1,55 @@
+'use strict';
+
+/*
+	This file is located in the "modules" block of plugin.json
+	It is only loaded when the user navigates to /admin/plugins/quickstart page
+	It is not bundled into the min file that is served on the first load of the page.
+*/
+
+import { save, load } from 'settings';
+import * as uploader from 'uploader';
+
+export function init() {
+	handleSettingsForm();
+	setupUploader();
+};
+
+function handleSettingsForm() {
+	load('quickstart', $('.quickstart-settings'), function () {
+		setupColorInputs();
+	});
+
+	$('#save').on('click', () => {
+		save('quickstart', $('.quickstart-settings')); // pass in a function in the 3rd parameter to override the default success/failure handler
+	});
+}
+
+function setupColorInputs() {
+	var colorInputs = $('[data-settings="colorpicker"]');
+	colorInputs.on('change', updateColors);
+	updateColors();
+}
+
+function updateColors() {
+	$('#preview').css({
+		color: $('#color').val(),
+		'background-color': $('#bgColor').val(),
+	});
+}
+
+function setupUploader() {
+	$('#content input[data-action="upload"]').each(function () {
+		var uploadBtn = $(this);
+		uploadBtn.on('click', function () {
+			uploader.show({
+				route: config.relative_path + '/api/admin/upload/file',
+				params: {
+					folder: 'quickstart',
+				},
+				accept: 'image/*',
+			}, function (image) {
+				$('#' + uploadBtn.attr('data-target')).val(image);
+			});
+		});
+	});
+}

package/public/lib/main.js

@@ -0,0 +1,32 @@
+'use strict';
+
+/**
+ * This file shows how client-side javascript can be included via a plugin.
+ * If you check `plugin.json`, you'll see that this file is listed under "scripts".
+ * That array tells NodeBB which files to bundle into the minified javascript
+ * that is served to the end user.
+ *
+ * There are two (standard) ways to wait for when NodeBB is ready.
+ * This one below executes when NodeBB reports it is ready...
+ */
+
+(async () => {
+	const hooks = await app.require('hooks');
+
+	hooks.on('action:app.load', () => {
+		// called once when nbb has loaded
+	});
+
+	hooks.on('action:ajaxify.end', (/* data */) => {
+		// called everytime user navigates between pages including first load
+	});
+})();
+
+/**
+ * ... and this one reports when the DOM is loaded (but NodeBB might not be fully ready yet).
+ * For most cases, you'll want the one above.
+ */
+
+$(document).ready(function () {
+	// ...
+});

package/public/lib/quickstart.js

@@ -0,0 +1,15 @@
+'use strict';
+
+/*
+	This file is located in the "modules" block of plugin.json
+	It is only loaded when the user navigates to /quickstart page
+	It is not bundled into the min file that is served on the first load of the page.
+*/
+
+define('forum/quickstart', function () {
+	var module = {};
+	module.init = function () {
+		$('#last-p').text('quickstart.js loaded!');
+	};
+	return module;
+});

package/renovate.json

@@ -0,0 +1,5 @@
+{
+  "extends": [
+    "config:recommended"
+  ]
+}

package/scss/quickstart.scss

@@ -0,0 +1 @@
+/* Place any SASS in here */

package/static/lib/client.js

@@ -0,0 +1,82 @@
+'use strict';
+
+$(document).ready(function () {
+    // --- NIKI LOGO URL ---
+    // Buraya Niki'nin transparent PNG logosunu koymalısın.
+    const NIKI_LOGO_URL = 'https://i.imgur.com/kXUe4M6.png'; // Örnek kedi logosu
+
+    // 1. Widget'ı Ekrana Bas (Eğer giriş yapmışsa)
+    if (app.user.uid > 0 && $('#niki-floating-widget').length === 0) {
+        const widgetHtml = `
+            <div id="niki-floating-widget">
+                <div class="niki-widget-content" onclick="ajaxify.go('niki-wallet')">
+                    <img src="${NIKI_LOGO_URL}" class="niki-widget-logo" alt="Niki">
+                    <div class="niki-widget-text">
+                        <span class="niki-lbl">PUANIM</span>
+                        <span class="niki-val" id="niki-live-points">...</span>
+                    </div>
+                </div>
+            </div>
+        `;
+        $('body').append(widgetHtml);
+        
+        // Açılışta puanı çek
+        $.get('/api/user/' + app.user.userslug, function(data) {
+            $('#niki-live-points').text(data.niki_points || 0);
+        });
+    }
+
+    // 2. Aktiflik Takibi (Time-on-Site)
+    let activeSeconds = 0;
+    let isUserActive = false;
+    let idleTimer;
+    
+    // Hareket algılayıcı
+    function resetIdleTimer() {
+        isUserActive = true;
+        clearTimeout(idleTimer);
+        idleTimer = setTimeout(() => { isUserActive = false; }, 30000); // 30sn hareketsizse dur
+    }
+    $(window).on('mousemove scroll keydown click', resetIdleTimer);
+
+    // Her saniye kontrol
+    setInterval(() => {
+        // Sadece Topic sayfalarındaysak say
+        if (ajaxify.data.template.topic && document.visibilityState === 'visible' && isUserActive) {
+            activeSeconds++;
+        }
+        
+        // 60 saniye doldu mu?
+        if (activeSeconds >= 60) {
+            sendHeartbeat();
+            activeSeconds = 0;
+        }
+    }, 1000);
+
+    function sendHeartbeat() {
+        const topicId = ajaxify.data.tid;
+        $.post('/api/niki-loyalty/heartbeat', { tid: topicId, _csrf: config.csrf_token }, function(res) {
+            if (res.earned) {
+                // UI Güncelle
+                $('#niki-live-points').text(res.total);
+                showNikiToast(`+${res.points} Puan! ☕`);
+                
+                // Widget'a ufak bir "bounce" efekti ver
+                $('#niki-floating-widget').addClass('niki-bounce');
+                setTimeout(() => $('#niki-floating-widget').removeClass('niki-bounce'), 500);
+            }
+        });
+    }
+
+    // Özel Bildirim (Toast)
+    function showNikiToast(msg) {
+        $('.niki-toast').remove();
+        const toast = $(`<div class="niki-toast"><i class="fa fa-paw"></i> ${msg}</div>`);
+        $('body').append(toast);
+        setTimeout(() => { toast.addClass('show'); }, 100);
+        setTimeout(() => { 
+            toast.removeClass('show');
+            setTimeout(() => toast.remove(), 300);
+        }, 3000);
+    }
+});

package/static/samplefile.html

@@ -0,0 +1,5 @@
+<h1>Hello!</h1>
+
+<p>This file is served by nodebb at domain.com/assets/plugins/nodebb-plugin-quickstart/static/samplefile.html</p>
+
+Check plugin.json for the "staticDirs" property if you want to change the path.

package/static/style.css

@@ -0,0 +1,206 @@
+/* --- NIKI LOYALTY UI --- */
+
+/* 1. Floating Widget (Sol Alt) */
+#niki-floating-widget {
+    position: fixed;
+    bottom: 25px;
+    left: 25px;
+    z-index: 1050;
+    font-family: 'Poppins', sans-serif; /* Varsa sitenin fontu */
+}
+
+.niki-widget-content {
+    background: rgba(255, 255, 255, 0.9);
+    backdrop-filter: blur(10px);
+    border: 1px solid rgba(78, 52, 46, 0.1);
+    padding: 6px 16px 6px 6px;
+    border-radius: 40px;
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    box-shadow: 0 8px 20px rgba(78, 52, 46, 0.15);
+    cursor: pointer;
+    transition: all 0.3s cubic-bezier(0.175, 0.885, 0.32, 1.275);
+}
+
+.niki-widget-content:hover {
+    transform: translateY(-3px);
+    box-shadow: 0 12px 25px rgba(78, 52, 46, 0.25);
+    background: #fff;
+}
+
+.niki-widget-logo {
+    width: 36px;
+    height: 36px;
+    border-radius: 50%;
+    background: #EFEBE9;
+    padding: 2px;
+    object-fit: cover;
+}
+
+.niki-widget-text {
+    display: flex;
+    flex-direction: column;
+    line-height: 1.1;
+}
+
+.niki-lbl {
+    font-size: 9px;
+    font-weight: 700;
+    color: #8D6E63;
+    letter-spacing: 0.5px;
+}
+
+.niki-val {
+    font-size: 15px;
+    font-weight: 800;
+    color: #4E342E;
+}
+
+/* Animasyon: Bounce */
+.niki-bounce {
+    animation: niki-bounce-anim 0.5s;
+}
+@keyframes niki-bounce-anim {
+    0%, 100% { transform: scale(1); }
+    50% { transform: scale(1.15); }
+}
+
+/* 2. Toast Bildirimi */
+.niki-toast {
+    position: fixed;
+    bottom: 90px;
+    left: 25px;
+    background: #4E342E;
+    color: #fff;
+    padding: 10px 20px;
+    border-radius: 12px;
+    font-size: 13px;
+    font-weight: 600;
+    box-shadow: 0 5px 15px rgba(0,0,0,0.2);
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    z-index: 1060;
+    opacity: 0;
+    transform: translateY(20px) scale(0.9);
+    transition: all 0.3s ease;
+    pointer-events: none;
+}
+
+.niki-toast.show {
+    opacity: 1;
+    transform: translateY(0) scale(1);
+}
+
+/* 3. Cüzdan Sayfası */
+.niki-wallet-wrapper {
+    max-width: 450px;
+    margin: 40px auto;
+    background: #fff;
+    border-radius: 24px;
+    box-shadow: 0 20px 60px rgba(0,0,0,0.08);
+    overflow: hidden;
+    text-align: center;
+    position: relative;
+    border: 1px solid #f0f0f0;
+}
+
+.niki-header-bg {
+    background: #4E342E;
+    height: 120px;
+    width: 100%;
+    position: absolute;
+    top: 0;
+    left: 0;
+    z-index: 0;
+}
+
+.niki-wallet-content {
+    position: relative;
+    z-index: 1;
+    padding: 30px;
+    padding-top: 60px;
+}
+
+.niki-wallet-avatar {
+    width: 110px;
+    height: 110px;
+    border-radius: 50%;
+    border: 5px solid #fff;
+    box-shadow: 0 10px 20px rgba(0,0,0,0.1);
+    margin: 0 auto 20px;
+    background: #fff;
+    display: flex; /* Logo ortalama */
+    align-items: center;
+    justify-content: center;
+}
+
+.niki-wallet-avatar img {
+    width: 100%;
+    height: 100%;
+    border-radius: 50%;
+}
+
+.niki-balance-big {
+    font-size: 42px;
+    font-weight: 900;
+    color: #4E342E;
+    margin-bottom: 5px;
+}
+
+.niki-balance-label {
+    color: #8D6E63;
+    font-size: 14px;
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 1px;
+}
+
+/* Progress Bar */
+.niki-daily-stats {
+    background: #FAFAFA;
+    border-radius: 16px;
+    padding: 20px;
+    margin: 30px 0;
+    border: 1px solid #eee;
+}
+
+.niki-progress-track {
+    background: #E0E0E0;
+    height: 10px;
+    border-radius: 10px;
+    width: 100%;
+    margin: 10px 0;
+    overflow: hidden;
+}
+
+.niki-progress-fill {
+    height: 100%;
+    background: linear-gradient(90deg, #FFAB91, #FF7043);
+    border-radius: 10px;
+    transition: width 1s ease;
+}
+
+/* Buton */
+.niki-btn-action {
+    background: #4E342E;
+    color: white;
+    width: 100%;
+    padding: 16px;
+    border-radius: 14px;
+    font-size: 16px;
+    font-weight: 700;
+    border: none;
+    cursor: pointer;
+    transition: transform 0.2s;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: 10px;
+}
+
+.niki-btn-action:hover {
+    background: #3E2723;
+    transform: translateY(-2px);
+}

package/templates/admin/plugins/quickstart/partials/sorted-list/form.tpl

@@ -0,0 +1,10 @@
+<form>
+    <div class="mb-3">
+        <label class="form-label" for="name">Name</label>
+        <input type="text" id="name" name="name" class="form-control" placeholder="Name" />
+    </div>
+    <div class="mb-3">
+        <label class="form-label" for="description">Description</label>
+        <input type="text" id="description" name="description" class="form-control" placeholder="Description" />
+    </div>
+</form>

package/templates/admin/plugins/quickstart/partials/sorted-list/item.tpl

@@ -0,0 +1,12 @@
+<li data-type="item" class="list-group-item">
+    <div class="d-flex gap-2 justify-content-between align-items-start">
+        <div class="flex-grow-1">
+            <strong>{name}</strong><br />
+            <small>{description}</small>
+        </div>
+        <div class="d-flex gap-1 flex-nowrap">
+            <button type="button" data-type="edit" class="btn btn-sm btn-info">Edit</button>
+            <button type="button" data-type="remove" class="btn btn-sm btn-danger">Delete</button>
+        </div>
+    </div>
+</li>

package/templates/admin/plugins/quickstart.tpl

@@ -0,0 +1,68 @@
+<div class="acp-page-container">
+	<!-- IMPORT admin/partials/settings/header.tpl -->
+
+	<div class="row m-0">
+		<div id="spy-container" class="col-12 col-md-8 px-0 mb-4" tabindex="0">
+			<form role="form" class="quickstart-settings">
+				<div class="mb-4">
+					<h5 class="fw-bold tracking-tight settings-header">General</h5>
+
+					<p class="lead">
+						Adjust these settings. You can then retrieve these settings in code via:
+						<br/><code>await meta.settings.get('quickstart');</code>
+					</p>
+					<div class="mb-3">
+						<label class="form-label" for="setting-1">Setting 1</label>
+						<input type="text" id="setting-1" name="setting-1" title="Setting 1" class="form-control" placeholder="Setting 1">
+					</div>
+					<div class="mb-3">
+						<label class="form-label" for="setting-2">Setting 2</label>
+						<input type="text" id="setting-2" name="setting-2" title="Setting 2" class="form-control" placeholder="Setting 2">
+					</div>
+
+					<div class="form-check form-switch">
+						<input type="checkbox" class="form-check-input" id="setting-3" name="setting-3">
+						<label for="setting-3" class="form-check-label">Setting 3</label>
+					</div>
+				</div>
+
+				<div class="mb-4">
+					<h5 class="fw-bold tracking-tight settings-header">Colors</h5>
+
+					<p class="alert" id="preview">
+						Here is some preview text. Use the inputs below to modify this alert's appearance.
+					</p>
+					<div class="mb-3 d-flex gap-2">
+						<label class="form-label" for="color">Foreground</label>
+						<input data-settings="colorpicker" type="color" id="color" name="color" title="Background Color" class="form-control p-1" placeholder="#ffffff" value="#ffffff" style="width: 64px;"/>
+					</div>
+					<div class="mb-3 d-flex gap-2">
+						<label class="form-label" for="bgColor">Background</label>
+						<input data-settings="colorpicker" type="color" id="bgColor" name="bgColor" title="Background Color" class="form-control p-1" placeholder="#000000" value="#000000" style="width: 64px;" />
+					</div>
+				</div>
+
+				<div class="mb-4">
+					<h5 class="fw-bold tracking-tight settings-header">Sorted List</h5>
+
+					<div class="mb-3" data-type="sorted-list" data-sorted-list="sample-list" data-item-template="admin/plugins/quickstart/partials/sorted-list/item" data-form-template="admin/plugins/quickstart/partials/sorted-list/form">
+						<ul data-type="list" class="list-group mb-2"></ul>
+						<button type="button" data-type="add" class="btn btn-info">Add Item</button>
+					</div>
+				</div>
+
+				<div>
+					<h5 class="fw-bold tracking-tight settings-header">Uploads</h5>
+
+					<label class="form-label" for="uploadedImage">Upload Image</label>
+					<div class="d-flex gap-1">
+						<input id="uploadedImage" name="uploadedImage" type="text" class="form-control" />
+						<input value="Upload" data-action="upload" data-target="uploadedImage" type="button" class="btn btn-light" />
+					</div>
+				</div>
+			</form>
+		</div>
+
+		<!-- IMPORT admin/partials/settings/toc.tpl -->
+	</div>
+</div>

package/templates/niki-wallet.tpl

@@ -0,0 +1,35 @@
+<div class="niki-wallet-wrapper">
+    <div class="niki-header-bg"></div>
+    
+    <div class="niki-wallet-content">
+        <div class="niki-wallet-avatar">
+            <img src="https://i.imgur.com/kXUe4M6.png" alt="Niki">
+        </div>
+
+        <div class="niki-balance-label">Toplam Bakiye</div>
+        <div class="niki-balance-big">{points}</div>
+
+        <div class="niki-daily-stats">
+            <div style="display:flex; justify-content:space-between; font-size:12px; color:#888; font-weight:600;">
+                <span>Günlük Kazanım</span>
+                <span>{dailyScore} / {dailyCap}</span>
+            </div>
+            
+            <div class="niki-progress-track">
+                <div class="niki-progress-fill" style="width: {dailyPercent}%;"></div>
+            </div>
+            
+            <div style="font-size:11px; color:#aaa;">
+                Bugün daha fazla çalışarak limitini doldurabilirsin!
+            </div>
+        </div>
+
+        <button class="niki-btn-action">
+            <i class="fa fa-qrcode"></i> KAHVE AL (QR OLUŞTUR)
+        </button>
+        
+        <p style="font-size:12px; color:#ccc; margin-top:15px;">
+            Niki The Cat Coffee &copy; Loyalty Program
+        </p>
+    </div>
+</div>

package/templates/quickstart.tpl

@@ -0,0 +1,7 @@
+<div class="card card-body text-bg-light">
+	<p>This is a custom page.</p>
+	<p>Your uid is {uid}!</p>
+	<p id="last-p"></p>
+	<hr/>
+	<p>[[quickstart:info]]</p>
+</div>

package/test/.eslintrc

@@ -0,0 +1,9 @@
+{
+	"env": {
+		"mocha": true
+	},
+	"rules": {
+		"no-unused-vars": "off"
+	}
+}
+

package/test/index.js

@@ -0,0 +1,41 @@
+/**
+ * You can run these tests by executing `npx mocha test/plugins-installed.js`
+ * from the NodeBB root folder. The regular test runner will also run these
+ * tests.
+ *
+ * Keep in mind tests do not activate all plugins, so if you are testing
+ * hook listeners, socket.io, or mounted routes, you will need to add your
+ * plugin to `config.json`, e.g.
+ *
+ * {
+ *     "test_plugins": [
+ *         "nodebb-plugin-quickstart"
+ *     ]
+ * }
+ */
+
+'use strict';
+
+/* globals describe, it, before */
+
+const assert = require('assert');
+
+const db = require.main.require('./test/mocks/databasemock');
+
+describe('nodebb-plugin-quickstart', () => {
+	before(() => {
+		// Prepare for tests here
+	});
+
+	it('should pass', (done) => {
+		const actual = 'value';
+		const expected = 'value';
+		assert.strictEqual(actual, expected);
+		done();
+	});
+
+	it('should load config object', async () => {	// Tests can be async functions too
+		const config = await db.getObject('config');
+		assert(config);
+	});
+});