https://github.com/ho-nl/magento2-Ho_Templatehints

H&O Magento 2 Advanced Template Hints module
https://github.com/ho-nl/magento2-Ho_Templatehints

Last synced: about 1 month ago
JSON representation

H&O Magento 2 Advanced Template Hints module

• Host: GitHub
• URL: https://github.com/ho-nl/magento2-Ho_Templatehints
• Owner: ho-nl
• License: bsd-2-clause
• Created: 2016-06-08T22:26:45.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2023-07-27T07:49:20.000Z (over 1 year ago)
• Last Synced: 2024-05-07T01:32:23.273Z (7 months ago)
• Language: PHP
• Homepage:
• Size: 3.04 MB
• Stars: 268
• Watchers: 27
• Forks: 67
• Open Issues: 22
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-magento2 - Advanced Template Hints - Magento 2 Template Hints Helper. (Open Source Extensions / Development Utilities)
• awesome-magento2 - Advanced Template Hints - Magento 2 Template Hints Helper. (Open Source Extensions / Development Utilities)

README

        
# H&O Magento 2 Advanced Template Hints module

![Overview](docs/total-workings.gif)

Ho_Templatehints extends the default Magento template hints.

- Easily accessible with muscle memory `?ath=1`.

- Shows hints for **Templates**, **AbstractBlocks** (Blocks), **Containers** and **UI Components**.

- No layout interference: Using css outline instead of borders of other HTML elements, so it doesn't f'up the layout.

![Usage $0](docs/usage.gif)

## Installation

```

composer require --dev honl/magento2-templatehints

php bin/magento module:enable Ho_Templatehints

php bin/magento setup:upgrade

```

### Development installation (git enabled)

```

composer require --dev honl/magento2-templatehints "dev-master"

php bin/magento module:enable Ho_Templatehints

php bin/magento setup:upgrade

```

### Configure PHPStorm, allow remote calls

![Setting up PHPStorm](docs/phpstorm-config.png)

## Usage

1. Set your Magento 2 installation to developer mode (when in production mode make sure to add your IP address in Developer Client Restrictions).

2. Add `?ath=1` to your URL to activate.

3. Open up your console in you Chrome/Firefox/Safari/~IE~ devtools.

4. hold ⇧ (shift)

5. Hover over the element you wish to inspect

6. Voila! Hints everywhere!

### Hints for hidden elements

You can't show hints for a hidden element, for that purpose there is `hint($0)`:

```JS

//Select an element in the Elements panel in your devtools, it is now available with $0

hint($0)

```

![Console $0](docs/console.gif)

## Inner Workings

The module adds an additional HTML attribute to the outer most element of a layout element.

## Credits

Inspiration from [Aoe_TemplateHints](https://github.com/AOEpeople/Aoe_TemplateHints) and a lot of love from H&O.

## Developer

This module was developed by the H&O team. Check out more about this module on the H&O website:

H&O Magento 2 Advanced Template hints module