xoborg/laravel-blog

为 Laravel 的简单博客包

1.0.2 2018-09-12 10:04 UTC

This package is auto-updated.

Last update: 2024-09-12 23:00:37 UTC


README

Latest Version on Packagist Total Downloads License

安装

您可以通过 composer 安装此包

composer require xoborg/laravel-blog

此包使用 Laravel 的身份验证脚手架,因此如果您尚未设置,只需运行 php artisan make:auth

然后执行 php artisan migrate 以创建 laravel-blog 和 Laravel 表。

接下来,您必须发布配置文件

php artisan vendor:publish --provider="Xoborg\LaravelBlog\LaravelBlogServiceProvider" --tag="config"

最后,您需要发布一个必要的 JavaScript 文件以供后端使用

php artisan vendor:publish --provider="Xoborg\LaravelBlog\LaravelBlogServiceProvider" --tag="public" --force

使用方法

您的博客将安装在 http://your-app.test/blog,但您必须被添加为作者才能发布帖子,为此您可以使用

php artisan laravel-blog:author --add 1 // User ID

然后,如果您已登录到您的应用程序,您将能够访问位于 http://your-app.test/blog/backend 的管理面板。

其他命令

要移除用户作为作者,请运行

php artisan laravel-blog:author --remove 1 // User ID

您还可以查看作者列表

php artisan laravel-blog:author --list

帖子图片

此包使用 Trix 编辑器,该编辑器可以将图片附加到帖子中。这些图片将存储在公共磁盘上,所以不要忘记执行以下命令

php artisan storage:link

自定义视图

如果您想自定义此包的后端或前端视图,请使用以下命令发布视图文件

php artisan vendor:publish --provider="Xoborg\LaravelBlog\LaravelBlogServiceProvider" --tag="views"

RSS 源

Laravel Blog 支持 spatie/laravel-feed 包以生成博客的 RSS 源

使用 feeds-macro 注册显示这些源的路由

// In routes/web.php
Route::feeds();

接下来,您必须发布配置文件

php artisan vendor:publish --provider="Spatie\Feed\FeedServiceProvider" --tag="config"

然后,您需要在此配置文件中指定哪个类和哪个方法将返回应出现在源中的项目

...
'items' => 'Xoborg\LaravelBlog\Models\Post@getFeedItems',
...

如果您希望源读者发现您的源,您应该在 Laravel Blog 视图中发布并添加到 <head> 标签中

 @include('feed::links')

最后,您可以通过更改 config/blog.php 中的设置来设置将在源中显示的项目数量

...
'feed' => [
	/**
	 * The number of items that should appear in the feed
	 */
	'items' => 25
]
...

测试

composer test

安全

如果您发现任何安全相关的问题,请通过电子邮件 developers@xoborg.com 联系我们,而不是使用问题跟踪器。

致谢

有关 Xoborg Technologies 的更多信息,请访问我们的网站 xoborg.com

许可协议

MIT 许可协议 (MIT)。有关更多信息,请参阅 许可文件