README

警告

此包已被 替换，并且不再维护。

CMS LogViewer 是什么？

CMS LogViewer 是一个 CMS Core 插件，它添加了一个日志查看管理模块。

• CMS LogViewer 由 Graham Campbell 创建并维护。
• CMS LogViewer 在 Mike Mand 的 LogViewer 上进行了大量改进。
• CMS LogViewer 依赖于我的 CMS Core 包。
• CMS LogViewer 使用 Travis CI 和 Coveralls 来检查一切是否正常工作。
• CMS LogViewer 使用 Scrutinizer CI 和 SensioLabsInsight 进行额外的检查。
• CMS LogViewer 使用 Composer 来加载和管理依赖项。
• CMS LogViewer 提供了一个 变更日志、发布 和 API 文档。
• CMS LogViewer 根据 GNU AGPLv3 许可，许可信息可在 此处 找到。

系统要求

• 需要 PHP 5.4.7+ 或 PHP 5.5+。
• 由于此包是为它设计的，您将需要一个 CMS Core 应用程序，例如 Bootstrap CMS。
• 您需要安装 Composer 以加载 CMS-LogViewer 的依赖项。

安装

在安装 CMS LogViewer 之前，请检查系统要求。

要获取 CMS LogViewer 的最新版本，只需在您的 composer.json 文件中添加 "graham-campbell/cms-logviewer": "0.2.*@alpha"。然后，您需要运行 composer install 或 composer update 以下载它并更新自动加载器。

在尝试加载 CMS LogViewer 服务提供者之前，您需要注册许多服务提供者。打开 app/config/app.php 并将以下内容添加到 providers 键。

• 'Lightgear\Asset\AssetServiceProvider'
• 'Cartalyst\Sentry\SentryServiceProvider'
• 'GrahamCampbell\Core\CoreServiceProvider'
• 'GrahamCampbell\Viewer\ViewerServiceProvider'
• 'GrahamCampbell\Queuing\QueuingServiceProvider'
• 'GrahamCampbell\HTMLMin\HTMLMinServiceProvider'
• 'GrahamCampbell\Markdown\MarkdownServiceProvider'
• 'GrahamCampbell\Security\SecurityServiceProvider'
• 'GrahamCampbell\Binput\BinputServiceProvider'
• 'GrahamCampbell\Passwd\PasswdServiceProvider'
• 'GrahamCampbell\Throttle\ThrottleServiceProvider'
• 'GrahamCampbell\Credentials\CredentialsServiceProvider'
• 'GrahamCampbell\Navigation\NavigationServiceProvider'
• 'GrahamCampbell\CMSCore\CMSCoreServiceProvider'

一旦安装了 CMS LogViewer，您需要注册服务提供者。打开 app/config/app.php 并将以下内容添加到 providers 键。

• 'GrahamCampbell\CMSLogViewer\CMSLogViewerServiceProvider'

配置

CMS LogViewer 支持可选配置。

要开始使用，首先发布包配置文件

php artisan config:publish graham-campbell/cms-logviewer

有两个配置选项

日志目录

此选项（'log_dirs'）定义了日志目录的路径。此设置的默认值为 array('app' => storage_path().'/logs')。

每页日志条数

此选项（'per_page'）定义了每页显示多少个日志条目。此设置的默认值为 20。

使用方法

目前除了 CMS LogViewer 的 API 文档 外，没有其他使用文档。

请注意，Bootstrap CMS 已经内置了 CMS LogViewer。

更新您的分支

最新的源代码可以在 GitHub 上找到。

在提交拉取请求之前，您应确保您的分支是最新的。

您可以创建 CMS LogViewer 的分支

git remote add upstream git://github.com/GrahamCampbell/CMS-LogViewer.git

第一个命令只需要第一次运行。如果您在合并时遇到问题，您将需要获取一个合并工具，如 P4Merge。

然后，您可以更新分支

git pull --rebase upstream master
git push --force origin <branch_name>

一旦设置完成，运行 git mergetool。一旦所有冲突都得到解决，运行 git rebase --continue，然后运行 git push --force origin <branch_name>。

拉取请求

在提交任何拉取请求之前，请仔细阅读这些指南。

• 在提交错误修复之前，请检查是否存在针对旧版本的维护分支，如果错误存在于其中，则拉取该旧分支。
• 在提交新特性的拉取请求之前，您应该首先创建一个标题包含 [提案] 的问题。
• 请遵循 PSR-2 编码风格 和 PHP-FIG 命名约定。

许可

GNU AFFERO 通用公共许可证

CMS LogViewer 是一个 CMS 核心插件，它添加了一个 LogViewer 管理模块。版权所有 (C) 2013-2014 Graham Campbell

本程序是自由软件：您可以重新分发它，也可以根据自由软件基金会发布的 GNU Affero 通用公共许可证的条款修改它，无论是许可证的第 3 版，还是（根据您的选择）任何后续版本。

本程序旨在供用户使用，但不提供任何担保；甚至不保证其适销性或适用于特定用途。有关详细信息，请参阅 GNU Affero 通用公共许可证。

您应该已经收到了随本程序一起提供的GNU Affero通用公共许可证副本。如果没有收到，请参阅https://gnu.ac.cn/licenses/。