Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/firegento/firegento-debug

Debugging suite for Magento
https://github.com/firegento/firegento-debug
Last synced: about 2 months ago
JSON representation
Debugging suite for Magento
Host: GitHub
URL: https://github.com/firegento/firegento-debug
Owner: firegento
Created: 2011-02-03T17:12:20.000Z (almost 14 years ago)
Default Branch: develop
Last Pushed: 2020-06-28T08:50:12.000Z (over 4 years ago)
Last Synced: 2024-08-04T01:13:53.250Z (5 months ago)
Language: PHP
Homepage:
Size: 836 KB
Stars: 99
Watchers: 28
Forks: 26
Open Issues: 6
Metadata Files:
- Readme: README.md
Awesome Lists containing this project

mageres - Firegento Debug - Provides some debugging functionality for Magento (Extensions / Free)
README

        
[![All Contributors](https://img.shields.io/badge/all_contributors-8-orange.svg?style=flat-square)](#contributors-)

# FireGento_Debug

This extension provides some debbuging functionality for Magento.

## Facts

- version: 1.5.0

- [extension on GitHub](https://github.com/firegento/firegento)

## Description

This extension provides some debugging functionality for Magento.

This includes:

- List all installed modules incl. their dependencies in the Magento backend

- Activate/Deactivate non-core modules via the Magento backend

- Check all installed modules for rewrite conflicts

- Show all triggered events/observers

- Show all log files in the Magento backend in "terminal-like" style

- Show detailed system information in the backend

- Provide logging interfaces for [ChromePhp](http://www.chromephp.com/), [FirePHP](http://www.firephp.org/) and [Firelogger](http://firelogger.binaryage.com/)

## Installation

Install the files using one of the following methods:

### Via modman

- Install [modman](https://github.com/colinmollenhour/modman)

- Use the command from your Magento installation folder: `modman clone https://github.com/firegento/firegento-debug.git`

### Via composer

- Install [composer](http://getcomposer.org/download/)

- Create a composer.json into your project like the following sample:

```json

{

    ...

    "require": {

        "firegento/debug":"*"

    },

    "repositories": [

	    {

            "type": "composer",

            "url": "http://packages.firegento.com"

        }

    ],

    "extra":{

        "magento-root-dir": "./"

    }

}

```

- Then from your composer.json folder: `php composer.phar install` or `composer install`

### Manually

You can copy the files from the 'src' folder of this repository to the same folders of your installation

Once the files are installed:

- Clear the cache, logout from the admin panel and then login again.

 A new Menu item named "**FIREGENTO**" will appear in the admin area

 

## Logging functionality

This module exposes some logging functionality for use in your own extensions.

You can:

- log data to a file that you specify in the configuration

- log data to the browser using either: [ChromePhp](http://www.chromephp.com/), [FirePHP](http://www.firephp.org/) or [Firelogger](http://firelogger.binaryage.com/)

The extension can be configured under FIREGENTO > Configuration

![image](doc/img/configuration.png)

Here you can change the name of the log file which will be written (by default firegento.log) if you select "Force Logging" then the log file will be written to irrespective of the the configuration setting to enable logging "Developer > Log Settings > Enabled".

### Usage

#### Log information to file:

```

$product = Mage::getModel('catalog/product');

Mage::helper('firegento/log')->log($product->debug());

```

This statement will take the output of `$product->debug()` and log it to the configured file.  

There is also a utilty method available `debug()` you can use this method to log large objects such as sales/quote, sales/order or other objects which are instances of Varien_Object internally the debug() method of this object will be called, and the output logged to using `FireGento_Debug_Helper_Log::log()`

```

$object = Mage::getModel('sales/order')->load(XXX);

Mage::helper('firegento/log')->debug($object);

```

#### Log information to the browser

It is also possible to send the output of the logging to the browser and have it displayed by [ChromePhp](http://www.chromephp.com/), [FirePHP](http://www.firephp.org/) or [Firelogger](http://firelogger.binaryage.com/) in order to do this, you must make sure that you have enabled the appropriate option in the configuration, and then you can simply use one of the following statements:

```

$product = Mage::getModel('catalog/product');

// log to chromephp

Mage::helper('firegento/log')->chromephp($product->debug());

// log to firelogger

Mage::helper('firegento/log')->firelogger($product->debug());

// log to firephp

Mage::helper('firegento/log')->firephp($product->debug());

```

You will then see something like these images in the browser extensions:

![debug view 1](doc/img/debug_browser1.png)

![debug view 2](doc/img/debug_browser2.png)

## Admin Functionality

The functionality can be accessed via the "**FIREGENTO**" menu item.

![Firegento menu](doc/img/menu_firegento.png "Firegento menu")

### Diagnostic > Check Modules

Here all the installed modules including their dependencies are listed. 

![image](doc/img/diagnostic_checkmodules.png)

You will see:

- The modules Namespace and name

- the code pool to which it belongs

- the current status

- the path to the extension in the filesystem

- if the path exists or not

- if the config.xml exists

- the version of the extension

- any dependencies defined for the extension

Non system extensions can be activated/decativated by clicking on the link in the Action column.

### Diagnostic > Check Rewrites

A convenient overview of rewritten classes is displayed here.

When a classpath is overwritten by an extension, you will see the name of the class which overrides it, and the name of the active class for that classpath. In the case of a rewrite conflict the status column displays a red "not ok" status. You will see that the Active class differs from the rewrite class.

 

 

![Non conflicted rewrite](doc/img/rewrite_ok.png "Non conflicted rewrite")

In the image above the classpath core/email_template is succesfully overwritten.

![Conflicted rewrite](doc/img/rewrite_conflict.png "Conflicted rewrite")

Here there is a rewrite conflict, and the rewrite which is not active is shown with a red "not ok" status

there is a file called firegento.php which you can install in the root of your magento instance, this allows you to check the status of rewrites without installing the whole Firegento_Debug extension.

### Diagnostic > Check Events

This allows you to see all events in your system and which observers are listening for them. When more than one observer is bound to the event, then they are listed under each other, in the column "Location"

![observers bound to events](doc/img/diagnostic_checkevents.png "observers bound to events")

### Diagnostic > Check System

Here you will see information about the system, which is divided into 5 areas:

- Magento Information

- PHP Information

- MySQL Information

- Server Information

- System Requirements

![System information](doc/img/diagnostic_checksystem.png "System information")

### Diagnostic > phpinfo()

The output of the phpinfo() function is displayed here

### Logs

The log viewer allows you to select a log file to open, you will be able to see in real time in a console like window as entries are written.

![Log file console like viewer](doc/img/logs.png "Log file console like viewer")

## Requirements

- PHP >= 5.3.0

## Compatibility

- Magento >= 1.5

- Versions below are not actively tested but should work without problems

## Support

If you have any issues with this extension, open an issue on [GitHub](https://github.com/firegento/firegento-debug/issues).

## Contribution

Any contribution is highly appreciated. The best way to contribute code is to open a [pull request on GitHub](https://help.github.com/articles/using-pull-requests).

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

  

    
_{Rouven Alexander Rieker}
💻

    
_{Tobias Vogt}
💻

    
_{Andre Flitsch}
💻

    
_{Vincent Pietri}
💻

    
_{Achim Rosenhagen}
💻

    
_{Vinai Kopp}
💻

    
_{Jörg Weller}
💻

  

  

    
_{Kevin Krieger}
📖

  

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

## Developer

- Website: [http://firegento.com](http://firegento.com)

- Twitter: [@firegento](https://twitter.com/firegento)

## Licence

[GNU General Public License, version 3 (GPLv3)](http://opensource.org/licenses/gpl-3.0)

## Copyright

(c) 2013 - 2020 FireGento