readme.txt

== Установка/Обновление ==

<strong><span style="color: #ff0000;">Внимание!</span></strong> <span style="color: #800000;">Это <a href="https://wp-kama.ru/id_3767/must-use-plugins-ili-obyazatelnyie-plaginyi-v-wordpress.html" target="_blank">MU-плагин для WordPress</a> - поэтому его установка не обычна.</span>

<h3 style="text-align: center;">Установка:</h3>

1. Создайте каталог (если нету) <code>mu-plugins</code> чтобы вышло <code>/wp-content/mu-plugins/</code>
2. Скачайте архив этого плагина, распакуйте архив на своем ПК и по FTP залейте туда файл `otshelnik-fm-kint.php` и папку `/ot-fm-kint-resource/`
Получится такая структура:
 ```
    /wp-content/mu-plugins/ot-fm-kint-resource/
    /wp-content/mu-plugins/otshelnik-fm-kint.php
 ```
3. Настройки в файле otshelnik-fm-kint.php. Если будете использовать функции kint - раскомментируйте 33 строку. Если только мои - пропускаем этот шаг.  
4. Всё. Работаем и дебажим  

<h3 style="text-align: center;">Обновление:</h3>

MU плагины не обновляются средствами вордпресс движка - т.к. они начинают работу раньше этих функций обновлений. 
Поэтому за обновлениями следите или на <a href="https://github.com/Otshelnik-Fm/otshelnik-fm-kint" target="_blank">гите</a> или в на странице CodeSeller



== Как работать ==
= Я добавил 5-ть своих функций: =

<code>vd($var, 1);</code> - (мой var_dump) - удобный дебаг вместо print_r() или var_dump(). 
2-й аргумент - необязательный параметр. Если нужно вывести в фиксированном окне слева сверху. 
Полезно для "узких" мест вывода. Бесполезно для циклов. Фиксированный блок можно скрывать (спойлер на details теге)
    
<code>vdd($var);</code> - аналог vd, но с die; на конце. Когда нужно остановить дальнейшую работу  
  
<code>vda($var, 1);</code> - (var_dump admin) - вывод на экран для админа  
2-й аргумент - необязательный параметр. Если нужно вывести в фиксированном окне слева сверху. 
Полезно для "узких" мест вывода. Бесполезно для циклов. Фиксированный блок можно скрывать (спойлер на details теге)

<code>vdl($var);</code> - (var_dump log) - пишем в логи сервера. Когда выводить на экран нам нельзя (или это дебаг ajax запроса например).   
 
<code>vdx($var);</code> - (var_dump XHR) - для дебага ajax (смотри приходящие данные POST в вкладке XHR браузера) Наглядно: https://yadi.sk/i/CPGuKgwmSQTEKg
   
= а вот основные, на мой взгляд, от Kint: =

<small>доступно, если выполнили пункт 3 "Настроек"</small>

<code>d($var);</code> - распечатает переменную    
<code>ddd($var);</code> - распечатает ее и остановит выполнение. Эквивалент `d();die;`    
<code>!d($var);</code> - сразу отобразит объект/переменную в раскрытом виде    
<code>d(1);</code> - сделает трассировку стека вызовов    
<code>s($var);</code> - выведет переменную в печатном виде    
<code>sd($var);</code> - выведет переменную в печатном виде и остановит. Эквивалент `s();die;`    

p.s. Подробно описано на странице библиотеки <a href="https://github.com/kint-php/kint" target="_blank">Kint</a>



== Changelog ==
= 2018-11-07 =
v2.0.0      
* добавлена функция vdx() - полезный помощник для простого дебага ajax в инструментах браузера "сеть"
Часто функция vdl() отнимала время - надо переключаться после запроса в логи сервера - получать их и высматривать там данные, а тут все происходит быстро
В панели разработчика браузера в post ответе (сеть - фильтр по XHR) приходят данные и их тип

* Kint обновлен до версии 3.0, но по дефолту теперь отключен. За полтора года я им воспользовался пару раз. Поэтому вначале он отключен.

* Функции vd() и vda() принимают второй аргумент. Передайте туда 1 чтобы отобразить результат в фиксированном окне слева сверху. 
Полезно для "узких" мест вывода. Бесполезно для циклов. Фиксированный блок можно скрывать (спойлер на details теге)


= 2017-03-15 =
v1.0.0
* Release



== Прочее ==

* Поддержка осуществляется в рамках текущего функционала дополнения
* При возникновении проблемы, создайте соотвествующую тему на форуме поддержки товара
* Если вам нужна доработка под ваши нужды - вы можете обратиться ко мне в <a href="https://codeseller.ru/author/otshelnik-fm/?tab=chat" target="_blank">ЛС</a> с техзаданием на платную доработку.

Все мои работы опубликованы <a href="https://otshelnik-fm.ru/?p=2562" target="_blank">на моём сайте</a> и в каталоге магазина <a href="https://codeseller.ru/author/otshelnik-fm/?tab=publics&subtab=type-products" target="_blank">CodeSeller.ru</a>