godscodes/laravel-blog

为Laravel(6.x和7.x)提供的简单博客包(包含管理面板)。包括所有视图、控制器、路由,并可以将博客添加到任何现有的Laravel应用程序中。完全可定制的博客(视图、URL以及许多其他选项)。包括图片上传和美观的管理界面来管理您的博客。默认为

1.0.2 2024-02-06 06:11 UTC

This package is auto-updated.

Last update: 2024-09-06 07:53:21 UTC


README

你是否使用过Wordpress?开发者称这个包为类似于Wordpress的Laravel博客。

轻量级且全面

轻量级Laravel博客包拥有令人难以置信的功能。我强烈推荐它,因为它

  • 快速安装(<3分钟)
  • 非常容易扩展
  • 内置了出色的功能
  • 它的简洁性允许轻松地与最新的Laravel兼容
  • 除了Laravel知识外,没有其他概念
  • 与Bagisto等其他Laravel平台兼容

卓越功能

  • 全文搜索 - 在所有博客文章中进行搜索
  • 多级分类 - 使用Baum进行嵌套集
  • 多语言支持

快速且容易安装(多语言版本)

1- 通过composer安装

composer require godscodes/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 godscodes/laravel-blog:v1.0.0

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博客提供了一个易于使用的界面来编写博客文章/分配分类/管理现有帖子
  • 所有用户都可以编辑/管理博客的地方(这适用于您网站上每个用户都能管理帖子的情况)
  • 喜欢为Laravel网站添加Wordpress类似博客的人

如何自定义博客视图/模板

完成正确的 vendor:publish 后,所有默认模板文件都会在 /resources/views/vendor/binshopsblog/ 中找到,并且很容易编辑以适应您的需求。

自定义管理视图

如果您需要自定义管理视图,只需将文件从 vendor/godscodes/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 - 添加基本 CAPTCHA
  • 1.0.5 - composer.json 变更。
  • 1.0 - 首次发布
  • 0.1 - 初次发布

参考

https://github.com/binshops/laravel-blog