xoborg / laravel-blog
为 Laravel 的简单博客包
Requires
- php: ^7.1
- illuminate/auth: 5.6.*|5.7.*
- illuminate/console: 5.6.*|5.7.*
- illuminate/database: 5.6.*|5.7.*
- illuminate/http: 5.6.*|5.7.*
- illuminate/routing: 5.6.*|5.7.*
- illuminate/support: 5.6.*|5.7.*
- illuminate/validation: 5.6.*|5.7.*
- spatie/laravel-feed: ^2.1
Requires (Dev)
- mockery/mockery: ^1.1
- orchestra/testbench: ~3.6.0|~3.7.0
- phpunit/phpunit: ^7.0
This package is auto-updated.
Last update: 2024-09-12 23:00:37 UTC
README
安装
您可以通过 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)。有关更多信息,请参阅 许可文件。