hasnainali9 / laravel-blog
为Laravel(6.x和7.x)提供的简单博客包(包含管理面板)。包含所有视图、控制器、路由,并可以将博客添加到任何现有的Laravel应用中。完全可定制的博客(视图、URL以及许多其他选项)。包括图片上传和美观的管理界面来管理您的博客。默认为
Requires
- cviebrock/eloquent-sluggable: ~8.0|~7.0|~6.0|~4.8|~4.7|~4.6|~4.5
- intervention/image: 2.*
- laravel/helpers: ^1.3
- laravelium/feed: ~2.12.0|~3.0.0|3.1.*|v6.0.*|v7.0.*|v8.0.*
Requires (Dev)
This package is auto-updated.
Last update: 2024-09-08 15:30:57 UTC
README
你使用过Wordpress吗?开发者称这个包为类似于Wordpress的Laravel博客。
给我们的包一个星标以支持我们 ⭐ 😍
安装视频 - 不到5分钟
轻量级且全面
具有轻量级Laravel博客包的惊人功能。我强烈推荐它,因为
- 快速安装(<3分钟)
- 非常容易扩展
- 开箱即用功能丰富
- 它的简单性允许与最新的Laravel兼容
- 除了Laravel知识外没有其他概念
- 与Bagisto等其他Laravel平台兼容
突出功能
- 全文搜索 - 在所有博客文章中进行搜索
- 多级分类 - 使用Baum的嵌套集
- 多语言支持
快速简单安装(多语言版本)
1- 使用composer安装
composer require binshops/laravel-blog
对于新的Laravel安装,运行以下命令
composer require laravel/ui
php artisan ui vue --auth
2- 运行以下两个命令来复制配置文件、迁移文件和视图文件
php artisan vendor:publish --provider="BinshopsBlog\BinshopsBlogServiceProvider"
3- 执行迁移以创建表
php artisan migrate;
4- 您必须在您的 \App\User(在laravel 8 \App\Models\User)模型中添加一个方法。正如这个方法的名称所示,它确定哪个用户可以管理文章。将您的逻辑放在那里
/**
* Enter your own logic (e.g. if ($this->id === 1) to
* enable this user to be able to add/edit blog posts
*
* @return bool - true = they can edit / manage blog posts,
* false = they have no access to the blog admin panel
*/
public function canManageBinshopsBlogPosts()
{
// Enter the logic needed for your app.
// Maybe you can just hardcode in a user id that you
// know is always an admin ID?
if ( $this->id === 1
&& $this->email === "your_admin_user@your_site.com"
){
// return true so this user CAN edit/post/delete
// blog posts (and post any HTML/JS)
return true;
}
// otherwise return false, so they have no access
// to the admin panel (but can still view posts)
return false;
}
5- 在 public/
中创建一个名为 blog_images
的目录
6- 以管理员身份登录并设置您的包: /blog_admin/setup
恭喜!您的博客已经准备好使用。(URL在配置文件中可自定义)
管理面板URI: /blog_admin
前端URI: /en/blog
要查看Packagist上的包,请点击此链接
单语言版本
要安装包的单语言版本,请使用版本v8.1x
1- composer require binshops/laravel-blog:v8.1.2
2- php artisan vendor:publish --provider="BinshopsBlog\BinshopsBlogServiceProvider"
3- php artisan vendor:publish --tag=laravel-fulltext
4- php artisan migrate;
您可以在“single-lang”分支中看到单语言版本。
重要说明
- 对于laravel 8.x的默认认证User模型,在
binshopsblog.php
中将用户模型更改为:\App\Models\User::class
功能
- 与最新版本的Laravel兼容(laravel 8.x)
- 向后兼容先前的Laravel版本
- 全文搜索 - 在博客文章中进行搜索
- 多级分类支持
- 通过其
config/binshopsblog.php
配置文件进行完全配置 - 可用的管理面板
- 完全可定制的管理视图和前端视图
- 分页视图
- 上传图片的能力
- 管理文章和分类
- 管理评论和评论批准
- 其他选项包括使用Disqus评论或禁用评论
最近更改
- 9.1.x 多语言支持
- 8.0.x 兼容Laravel 8.x
此包是为谁/什么而设计的
- 为运行Laravel的网站
- 谁想拥有一个网站博客。这个Laravel博客提供了一个易于使用的界面来编写博客文章/分配类别/管理现有文章。
- 只有管理员用户可以编辑/管理博客(这不适用于让网站上所有用户都能管理文章)
- 对于那些喜欢将类似WordPress的Laravel博客添加到Laravel网站中的人
如何自定义博客视图/模板
执行正确的vendor:publish
后,所有默认模板文件都将位于/resources/views/vendor/binshopsblog/,并且很容易编辑以符合您的需求。
自定义管理员视图
如果您需要自定义管理员视图,只需将文件从vendor/binshopsblog/src/Views/binshopsblog_admin
复制到resources/views/vendor/binshopsblog_admin
,然后您可以像其他任何视图文件一样进行修改。
路由
它将自动设置所有必需的路由(包括公开面相和后台管理)。有一些配置选项(例如将/blog/的URL更改为其他内容),可以在binshopsblog.php文件中完成。
配置选项
所有配置选项都有注释,描述了它们的功能。请参阅您/config/目录中的binshopsblog.php
文件。
自定义用户模型
您可以通过配置文件更改默认的用户模型。
事件
您可以通过查看/src/Events
目录来找到所有触发的事件。
将它们(以及事件监听器)添加到您的EventServiceProvider.php
文件中,以便在事件触发时使用这些事件。
内置的CAPTCHA/反垃圾邮件
有一个内置的CAPTCHA(反垃圾邮件评论)系统,这将很容易用您自己的实现来替换。
有一个基本的反垃圾邮件CAPTCHA功能内置。
查看config/binshops.php captcha部分。有一个内置系统(基础!)将阻止大多数自动垃圾邮件尝试。编写您自己的CAPTCHA系统
我故意编写了一个简单的CAPTCHA系统,以便您可以添加自己的CAPTCHA选项。应该很容易添加任何其他CAPTCHA系统。
如果您想编写自己的实现,请创建一个实现\BinshopsBlog\Interfaces\CaptchaInterface的自己的类,然后更新config/binshopsblog.php文件(更改captcha_type选项)。
您需要实现三个方法:public function captcha_field_name() : string
返回一个字符串,例如"captcha"。它用于表单验证。public function view() : string
binshops::partials.add_comment_form视图应该包含什么视图文件?您可以设置为所需的任何内容,然后创建自己的视图文件。默认包含的基本CAPTCHA类将返回"binshops::captcha.basic"。public function rules() : array
返回一个数组作为规则(这些只是标准的Laravel验证规则。这是检查CAPTCHA是否成功的地方。可选:public function runCaptchaBeforeShowingPosts() : null
这不是接口的一部分,不是必需的。默认情况下,它不执行任何操作。但您可以在该方法中添加一些代码,它将在BinshopsReaderController::viewSinglePost方法中运行。
图片上传错误
尝试将其添加到config/app.php
'Image' => Intervention\Image\Facades\Image::class
- 此外,请确保/tmp是可写的。如果您已启用open_basedir,请确保将其值添加:/tmp。
- 确保/public/blog_images(或您在配置中设置的任何目录)可由服务器写入
- 您可能需要设置更高的内存限制,或上传更小的图片文件。这取决于您的服务器。我已经用它上传了巨大的(10mb+)jpg图片而没有问题,一旦服务器正确设置以处理更大的文件上传。
版本历史
- 9.2.x 稳定版本包
- 9.0.x 多语言支持测试版
- 8.0.x 与Laravel 8的兼容性
- 7.3.0 新管理员UI
- 3.0.1 - 替换了所有短标签(<?)为完整的开启标签(<?php)
- 2.0 - 增加了全文搜索(通过配置文件启用,默认禁用)。
- 1.1.1 - 增加了基本验证码
- 1.0.5 - composer.json 的更改。
- 1.0 - 首次发布
- 0.1 - 初次发布