﻿XML content plugin for Total Commander 6.50+
Author: Bashmanov Sergey
email: sergey.bashmanov@gmail.com

Описание.
---------
Плагин предназначен для работы с файлами xml с произвольной структурой.
Набор полей прописывается в файле конфигурации "anyXML.xml" в папке с плагином.
Так как основная цель разработки плагина, работа с xml файлами для обмена данными результатов землеустроительных работ в Украине (UkrainianCadastralExchangeFile), то этот файл конфигурации предустановлен по умолчанию.
В папке "examples" можно найти этот файл конфигурации с комментариями и, возможно в будущем, другие как примеры.

Плагин основан на исходных кодах плагина WDX_FB2 от bookmist (roshst@yandex.ru) http://bookmist.ucoz.ru

Для работы плагина требуется уставленный MSXML. Во всех современных версиях Windows этот компонент уставлен по умолчанию.
В некоторых случаях некорректной работы плагина переустановка MSXML может решить проблему.

!!!ЕСЛИ В СТРУКТУРЕ ПРОСМАТРИВАЕМОГО ФАЙЛА ИЛИ ФАЙЛА КОНФИГУРАЦИИ ЕСТЬ ОШИБКИ, ТО ПЛАГИН МОЖЕТ ПОКАЗЫВАТЬ НЕВЕРНУЮ ИНФОРМАЦИЮ ИЛИ ПОКАЗЫВАТЬ ПУСТЫЕ ПОЛЯ!!!

Установка.
----------
Описание установки для Total Commander 6.50+.
Плагин можно установить автоматически, если ваша версия Total Commander поддерживает эту функцию.
Для этого нужно просто нажать Enter на архиве (wdx_anyXML_*.zip) с плагином - будет показано окно, с предложением установить плагин. Просто несколько раз нажмите кнопку OK.
Если ваша версия Total Commander не поддерживает автоматическую установку плагинов, то плагин можно установить вручную.
Распакуйте архив, куда вам будет удобно. Например, в папку "c:\Program Files\totalcmd\plugins\wdx\In4Info\".
В меню Total Commander выберите "Конфигурация -> Настройка -> Плагины -> Информационные плагины(.WDX) -> Настроить -> Добавить".
Выбирайте файл - "c:\Program Files\totalcmd\plugins\wdx\In4Info\In4Info.wdx" -> "OK -> OK -> OK".
В английском переводе "Configuration -> Options... -> Plugins -> Content Plugins(.WDX) -> Configure -> Add".
Структура меню и названия зависят от выбранного языка и версии локализации Total Commander и могут отличаться.


Настройка.
----------
Основное назначение плагина работа с пользовательскими наборами колонок.
Для создания набора колонок выберите в меню Total Commander "Конфигурация -> Настройка -> Наборы колонок".
Нажмите кнопку "Новый" и введите имя набора колонок.
В английском переводе "Configuration -> Options... -> Custom columns -> New".
Структура меню и названия зависят от выбранного языка и версии локализации Total Commander и могут отличаться.
Нажмите кнопку "Добавить колонки" и с помощью кнопки "+" добавляйте в текущую колонку необходимые вам столбцы из плагина "anyxml".
В каждый столбец можно вывести несколько полей информации, а также любой произвольный текст.
Для каждого столбца вы можете ввести свое название, выставить ширину и задать выравнивание по левому или правому краю.
Для того чтобы видеть длинные строки поставьте галочку возле строки "Горизонтальная полоса прокрутки" внизу окна.
После добавления всех необходимых столбцов нажмите OK -> OK.

Можно быстро переключатся между стандартными и пользовательскими наборами колонок, для этого щелкните правой кнопкой мыши на заголовке любого столбца и выберите необходимый вам набор колонок.

Также в Total Commander можно использовать значения возвращаемые плагином для:
1. Поиска файлов по значению одного или нескольких дескрипторов с использованием логических связок условий поиска.
   Закладка "Плагины" в окне "Поиск файлов";
2. Показа информации во всплывающих подсказках при наведении курсора на файл.
   "Конфигурация -> Настройка -> Экран -> Подсказки/комментарии в стиле Win32(если доступно) -> +".
   Для этого предварительно надо задать шаблон для поиска обменных файлов и сохранить его.
   Закладка "Загрузить/Сохранить" в окне "Поиск файлов";
3. Группового переименования файлов.
   "Файлы -> Групповое переименование..."
   Удобно использовать для переименования файлов по кадастровому номеру или ФИО владельца;
4. Цветовой расцветки имен файлов.
Эти и некоторые другие возможности описаны в справке Total Commander.


Disclaimer
----------
Данный плагин абсолютно бесплатен (Freeware)и предоставляется "как есть"(AS IS).
Вы можете использовать его как вам угодно, однако помните, что вы делаете это на свой страх и риск.
Автор не несет никакой ответственности за возможный моральный или материальный ущерб, вызванный при использовании плагина, любую упущенную выгоду в результате или процессе использования.


Известные проблемы и ограничения.
---------------------------------
По умолчанию плагин поддерживает только тип файлов xml, если требуется добавить другие типы файлов основанные на xml, то их расширение требуется добавить вручную в файл конфигурации Total Commander.
  Пример: 10_detect="ext="XML" | EXT="KML" "
Указание на множественные элементы с помощью звездочки в файле конфигурации не работает с тегами <template> и <special>.
Не тестировалось изменение xml файлов через изменение атрибутов в Total Commander.
Не тестировалась работа тега <div>,</div> - разделитель, вставляется после каждого повторения <template>, кроме последнего.
Плагин не поддерживает файлы в zip архивах и такая функция не планируется в ближайшее время.


History.
--------
v 0.2.0 (2014-08-06)
Первая публичная версия.
Основной файл конфигурации для xml файлов обмена результатами работ в землеустройстве (UkrainianCadastralExchangeFile).

v 0.3.1 (2016-01-26)
Исправлена ошибка с пустыми значениями в некоторых случаях.
Изменены special теги, и добавлены новые.
Изменена структура файла конфигурации (добавлен корневой элемент <wdx_anyXML>).
Добавлены новые поля в файл конфигурации для UkrainianCadastralExchangeFile.

v 0.3.2 (2019-11-29)
Дополнения и исправления в файле конфигурации anyXML.xml для UkrainianCadastralExchangeFile
- добавлены дополнительные два поля для множественных элементов, было 3, стало 5.
- добавлено поле "Громадянство"
- добавлены поля про аренду:
    "Назва орендаря"
    "ЄДРПОУ орендаря"
    "Адреса орендаря"
    "Площа оренди"
    "Термін оренди"
    "Орендна плата"
    "Реестраційній номер договора оренди"
    "Дата реестрації договора оренди"
- Исправлен показ значений для нескольких угодий
    "Кадастровий номер угіддя"
    "Код угіддя"
    "Площа угіддя"

v 0.3.3 (2021-03-01)
Дополнения и исправления в файле конфигурации anyXML.xml для UkrainianCadastralExchangeFile
- добавлено поле "Локальна система координат"
