Skip to content

Commit

Permalink
Update readme with new features.
Browse files Browse the repository at this point in the history
  • Loading branch information
drew7721 authored Oct 11, 2019
1 parent b8e2023 commit 793ecfe
Showing 1 changed file with 33 additions and 14 deletions.
47 changes: 33 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,34 +1,53 @@
# Better Layout Hints
Simple Magento 2 module to show better layout hints.
Magento 2 module to show better layout hints.

## Why?
The default layout hints in M2 are horrible! They don't give enough information
about the block. There is no information about the containers or the
ui elements that are rendered.
The default layout hints in Magento 2 lack much of the needed information.
Because knowledge is key and information is primordial.

This is built to show more information about what is on the page and how it's rendered.
The goal is to provide all the additional information about the layout of the current page.

## Screenshot
![](https://i.imgur.com/EUpbP50.png)
This module provides information about each Container, Block and uiElement on the page. It does this in a
non-intrusive manner.

## Features

- [x] Admin panel control
- [x] Console command line control
- [x] Front-end hide/show function with `Shift + Ctrl + H`
- [x] Non-intrusive display
- [x] Additional layout information at the bottom of the page.

## How to use it?

### Frontend

You can use the `Shift + Ctrl + H` key combination on the frontend to toggle the display of the layout hints.

### Enable/Disable
You can enable the hints from the console or the admin panel.

### Console commands:
**Console:**
```
justinkase:hints:on
justinkase:hints:off
```
So to enable the hints simply run `magento justinkase:hints:on` and you
should probably run a `magento cache:flush` command if your caches are enabled.
*Note: Clear caches after!* `magento cache:flush`

![](https://i.imgur.com/C4l3SMf.png)

### Admin panel
Update the setting from the admin panel.
**Admin panel:**

`Stores > Configuration > JustinKase > Layout Hints`

![](https://i.imgur.com/j4vgKKk.png)

## Screens
Bottom additional information
![](https://i.imgur.com/NhJhmco.png)

Non-intrusive display
![](https://i.imgur.com/BxpJZ1C.png)

## Author
[Alex Ghiban](mailto:drew7721@gmail.com)

0 comments on commit 793ecfe

Please sign in to comment.