carlson / nova-simple-content

为使用 Nova 的 Laravel 应用程序提供的简单页面和博客文章内容包

v1.0.0 2021-10-16 19:32 UTC

This package is not auto-updated.

Last update: 2024-09-16 08:02:59 UTC


README

目的

这是一个用于管理简单内容的简单包。如果您只需要简化 Nova 资源设置(例如博客文章和页面)的样板代码,并完全控制视图,则此包适用于您。如果您需要复杂的分层分类和深入控制帖子或页面模型,则此包可能不适合。

要求

  1. >= Laravel 8
  2. >= Laravel Nova 3

特性

  1. Nova 资源页面用于帖子
  2. 独立配置帖子
  3. 基于资源更新和删除的事件驱动缓存
  4. 无偏见视图模板 – 写自己的!
  5. 可配置页面和帖子路由前缀(例如 /blog, /content)
  6. 100% 测试覆盖率

安装

  1. composer require carlson/nova-simple-content
  2. 要复制视图以进行编辑: php artisan vendor:publish --tag=nova-simple-content-views
  3. 要复制配置以自定义缓存和路由: php artisan vendor:publish --tag=nova-simple-content-config
  4. 要设置所需的表: php artisan migrate

配置

以下值可以在 nova-simple-content.php 配置文件中进行配置

  1. cache_posts:为帖子开启或关闭缓存。默认为 true
  2. cache_pages:为页面开启或关闭缓存。默认为 true
  3. post_list_url:帖子列表的路由。默认为 '/blog'
  4. post_detail_slug_prefix:帖子路由前缀,例如 /blog/test-slug 中的 '/blog'。默认为 '/blog'
  5. page_slug_prefix:所有页面的路由前缀,例如 /content/test-slug 中的 '/content'。默认为 '/content'

缓存

默认情况下,页面和帖子的缓存都已开启,但可以独立配置。要禁用帖子或页面缓存,请在 nova-simple-content.php 配置文件中编辑相应的值。

开发

欢迎贡献!包含一个 docker-compose.yml 文件,其中包含正确版本的 PHP 和所需的依赖项,以及用于测试的数据库和缓存容器。

安装

  1. 克隆此存储库。
  2. 请确保您的计算机上已安装 Docker。
  3. 从存储库根目录运行 docker-compose up -d

测试

所有 PHP 或 JavaScript 的提交都必须有相应的测试。要运行测试套件,请进入运行的应用程序容器(docker exec -it nova_simple_content_app /bin/bash),然后运行 composer test