graham-campbell/cms-logviewer

This package is not installable via Composer 1.x, please make sure you upgrade to Composer 2+. Read more about our Composer 1.x deprecation policy.
This package is abandoned and no longer maintained. The author suggests using the graham-campbell/logviewer package instead.

CMS LogViewer Is A CMS Core Plugin That Adds A LogViewer Admin Module

v0.2.0-alpha 2014-02-08 22:48 UTC

This package is auto-updated.

Last update: 2019-03-27 18:27:23 UTC


README

Bitdeli Badge Build Status Coverage Status Scrutinizer Quality Score SensioLabsInsight Software License Latest Version

WARNING

This package has been replaced, and is no longer maintained.

What Is CMS LogViewer?

CMS LogViewer is a CMS Core plugin that adds a LogViewer admin module.

System Requirements

  • PHP 5.4.7+ or PHP 5.5+ is required.
  • You will need a CMS Core application like Bootstrap CMS because this package is designed for it.
  • You will need Composer installed to load the dependencies of CMS-LogViewer.

Installation

Please check the system requirements before installing CMS LogViewer.

To get the latest version of CMS LogViewer, simply require "graham-campbell/cms-logviewer": "0.2.*@alpha" in your composer.json file. You'll then need to run composer install or composer update to download it and have the autoloader updated.

You will need to register many service providers before you attempt to load the CMS LogViewer service provider. Open up app/config/app.php and add the following to the providers key.

  • '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'

Once CMS LogViewer is installed, you need to register the service provider. Open up app/config/app.php and add the following to the providers key.

  • 'GrahamCampbell\CMSLogViewer\CMSLogViewerServiceProvider'

Configuration

CMS LogViewer supports optional configuration.

To get started, first publish the package config file:

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

There are two config options:

Log Directories

This option ('log_dirs') defines the paths to the log directories. The default value for this setting is array('app' => storage_path().'/logs').

Logs Per Page

This option ('per_page') defines how many log entries are displayed per page. The default value for this setting is 20.

Usage

There is currently no usage documentation besides the API Documentation for CMS LogViewer.

Note that Bootstrap CMS already ships with CMS LogViewer.

Updating Your Fork

The latest and greatest source can be found on GitHub.

Before submitting a pull request, you should ensure that your fork is up to date.

You may fork CMS LogViewer:

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

The first command is only necessary the first time. If you have issues merging, you will need to get a merge tool such as P4Merge.

You can then update the branch:

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

Once it is set up, run git mergetool. Once all conflicts are fixed, run git rebase --continue, and git push --force origin <branch_name>.

Pull Requests

Please review these guidelines before submitting any pull requests.

  • When submitting bug fixes, check if a maintenance branch exists for an older series, then pull against that older branch if the bug is present in it.
  • Before sending a pull request for a new feature, you should first create an issue with [Proposal] in the title.
  • Please follow the PSR-2 Coding Style and PHP-FIG Naming Conventions.

License

GNU AFFERO GENERAL PUBLIC LICENSE

CMS LogViewer Is A CMS Core Plugin That Adds A LogViewer Admin Module Copyright (C) 2013-2014 Graham Campbell

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.