nhymxu / tramkho-blog-engine

Dead simple blog engine

blog

Dead simple blog engine

tramkho-blog-engine's Issues

opengraph meta data

Current

<meta name="description" content="">
<meta property="og:type" content="website">
<meta property="og:title" content="">
<meta property="og:url" content="">
<meta property="og:site_name" content="Dz notes">
<meta property="og:description" content="">

Need filled data to this

[admin] authen when running on subfolder

Basic auth currently only work if not running on subfolder
Eg: http://localhost/admin

If running on subfolder, auth not run
Eg: http://localhost/tramkho/admin

Should handle this case using $app->getBasePath();

add `X-Response-Time` header

Sample code:

<?php
declare(strict_types = 1);

namespace Middlewares;

use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Server\MiddlewareInterface;
use Psr\Http\Server\RequestHandlerInterface;

class ResponseTime implements MiddlewareInterface
{
    const HEADER = 'X-Response-Time';

    /**
     * Process a server request and return a response.
     */
    public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
    {
        $server = $request->getServerParams();
        $startTime = $server['REQUEST_TIME_FLOAT'] ?? microtime(true);
        $response = $handler->handle($request);

        return $response->withHeader(self::HEADER, sprintf('%2.3fms', (microtime(true) - $startTime) * 1000));
    }
}

Need add as first middleware

[admin] filter button

Need filter dropdown on blog list

Project page

List all project

Have some detail

• Title
• Screenshot
• Description
• Link

Maybe create simple table on database

Init project

Very simple blog engine.

• Data store on SQLite
• Caching render to html file, some part on redis
• Language maybe Python/PHP
• Need tool convert from WordPress
• Validation using rakit/validation
• Dependency Injection using php-di/php-di
• Add hashtag to footer of post
• Tag page - list all post via tag
• Maybe default hide insideme tag from index
• Re-validate post content
• Split database to 2 file: tech blog and insideme blog
• Tag list page: show all tag have on system ( maybe count number of post for each tag )
• Better config
• Analytics: GA, self-tracked

allow check template file exists or not

I want to check template file exists or not.
If not, fallback to archive.twig

upgrade to League\CommonMark v2.0

Currently, this engine using CommonMark v1.6.

Need upgrade to v2.0 with some breaking change:

https://commonmark.thephpleague.com/2.0/upgrading/
https://commonmark.thephpleague.com/2.0/changelog/

update slimphp 4.6.0

Release info: slimphp/Slim#3023

Add config file to quick enable debug function

Currently, when I want to debug, I need add multi line to this .env.php file

define('NX_DEBUG', true);

$settings['error']['display_error_details'] = true;
$settings['error']['log_errors'] = true;
$settings['error']['log_error_details'] = true;

$settings['logger']['level'] = \Monolog\Logger::DEBUG;

$settings['twig']['options']['debug'] = true;
$settings['twig']['options']['cache_enabled'] = false;

I want create seperate file, put all of settings to this file.
When I need debug, just import this file.

Maybe can put on docs/ folder with name env.debug.php

and modify .env.php like this

<?php

require __DIR__ . '/docs/env.debug.php';

[admin] markdown editor

check https://mdxeditor.dev/ and consider replace or not

remove PHP 7 support

allow choose theme using config file

I want change theme, just using config file. Not need edit direct to twig config bootstrap file

Disable FLoC tracking

FLoC is Google's Federated Learning of Cohorts. New way Google tracking user.
I want prevent this using https://github.com/nhymxu/php-floc-disable middleware

[cli] clear twig cache

need command to clear twig cache

add `published_at` column to posts table

I need to know first time post published.

add rss feed

I want rss feed for my blog

SQL builder class

Need SQL builder for easier, better write models

allow config to get post tag on post list or not

Currently, homepage and tag list page only get simple post detail.
I want get tag for each post. But not fixed (base on each theme).

So I want add config $settings['homepage']['get_post_tag'] = false; to know when I need to get tags for each post.

[admin] better new post screen

When create new post, need remove Trash option
And default status is Draft

post list config number of post

I want config number of post per pagination

choose layout render post

Each post have layout properties on metadata. When render post, choose template to render based on this properties

[FEAT]: youtube embed

Description

I need embed youtube video to post.

So I think syntax maybe:

[youtube_embed](https://www.youtube.com/watch?v={video_id_here})

If markdown parser match youtube_embed keyword and check link is youtube video
=> create youtube embed frame over clickable-link

Additional Information

We need customize how markdown lib parsing document.

caching htmt output to static file

Because blog post not change frequently, so I want caching this to static html file on cache folder.

Apache or Nginx can direct access this cache file over php process + database query.

It's good for frontend

So I need

• Middleware write output content to file
• Document for nginx config

remove highlightjs from layout

Hightlightjs just need loaded on single post.
Move from layout to post template

[admin] image upload management

Need manage upload file

• List
• Upload new file
• Delete file
• Rename file

[admin] dashboard overview

• Draw using
  • https://github.com/leeoniya/uPlot
  • chart.js
• Total posts
• Post published
• Post draft
• Circle post status

tag list order by tag name

Currently tag list order by total post have tag.
Should be order by tag name

[admin] verify database file is read-only or can write

When I forgot change owner for database.sqlite from upload user to www-data.
Everything still fine before I saved post => read-only database error.

Need validate this and display warning on admin page

compress html output

Need compress html output for better serving

disable minify html output when debug

When NX_DEBUG flag == true, disable miniy html output

add sentry to tracking exception

[admin] create new post button

Missing button

Need button point to http://blog.com/admin/post/new

[FEAT]: Replace admin template with Tabler

Description

Tailwind is take time, just using other template like Tabler
https://tabler.io/

It's faster time to build.

Additional Information

No response

basepath error on nginx root folder

BasePath on http://domain.com will return /.
Should return empty string to work well

Sitemap generate

:bug: sitemap generate error

Expected: http://domain.com/post-slug
Actual: http://domain.compost-slug

Comment system

• Show comment list on post detail
• Visitor can post comment
  • Verify login using google account

:bug: error when update published time

tramkho-blog-engine/src/Domain/Blog/AdminRepository.php

Lines 107 to 118 in 4efd266

	public function updatePostPublishTime(int $post_id, string $publish_time)
	{
	$sql = "UPDATE post
	SET published_at = :publish_time
	WHERE id = :post_id AND published_at = ''";
	$stmt = $this->connection->prepare($sql);
	$stmt->execute([
	'post_id' => $post_id,
	'published_at' => $publish_time
	]);
	}

On this function, wrong param name make publish post action always error.

Just changed from 'published_at' => $publish_time to 'publish_time' => $publish_time

Preload anonymous font

Replace @css import with html preload

<link rel="preconnect" href="https://fonts.gstatic.com">
<link href="https://fonts.googleapis.com/css2?family=Anonymous+Pro&display=swap" rel="stylesheet">

and

font-family: 'Anonymous Pro', monospace;

add health-check route

Need health check url for validate.

Maybe:

/status
/health
/ping

Response can be pong only or json with many value want to check

[admin] new post screen can't add tag

Because not pass tag list to twig

[admin] post management

• Authen using middleware https://github.com/tuupola/slim-basic-auth
• Text edit using markdown format
• Post management
• Post filter by status
• New post
• Edit post
• Delete post

[admin] allow edit post time on edit post screen

Description

• created_at
• updated_at
• published_at

Have checkbox, if enable checkbox -> allow edit

Additional Information

No response

[admin] Tag management

re-build sitemap when publish post

Currently, sitemap only re-build when run CLI command.
I want this auto re-build when published new post

[admin] comment management