tcPhonebook 0.9.3.5
Простая телефонная книга
Плагин файловой системы для Total Commander
© Maximus's Solutions 2010-2012
http://maximus.in.ua


Оглавление
Описание
Установка
Использование
Управление
Настройка
Редактирование/создание контакта
Просмотр контакта
Пользовательские колонки
История версий


Описание
Отображает в виде произвольно задаваемой структуры и позволяет манипулировать контактами телефонной книги непосредственно в панели Total Commander.
Каждая запись может содержать информацию о контактном лице (имя, день рожденья), данные о месте работы (должность, организация, контакты, адрес), личные данные (контакты, адрес), другие данные (контакты, адрес), а также примечание.
Позволяет импортировать/экспортировать контакты в формате vCard (формат файлов для обмена электронными визитными карточками); поддерживается импорт из файлов, которые содержат больше одного контакта. Поддерживает кодировки UTF-8 (импорт/экспорт) и Quoted-printable (только импорт).
Имеет мультиязычный интерфейс (английский, датский, китайский, немецкий, русский, украинский, шведский).
Поддерживаемые ОС: Windows 7 / Vista / XP / 2000


Установка
Автоматическая
  1. Войдите в архив с плагином (Ctrl+PgDn) и Total Commander предложит вам установить его
  2. Следуйте указаниям Total Commander
Ручная
  1. Распакуйте содержимое архива в отдельный каталог
  2. Подключите плагин:
    • {Конфигурация → Настройка... → Плагины → Плагины файловой системы → Настройка}
    • Добавьте tcPhonebook.wfx в список плагинов

Использование
Использовать данный плагин, как и любой WFX-плагин, можно из файловой панели Total Commander выполнив переход в «Сеть / FS-плагины» при помощи соответствующей кнопки на панели кнопок дисков или выбрав соответствующий пункт в окне выбора дисков (Alt+F1, Alt+F2).

→

Управление
Действия
Перечень действий, доступных для управления контактами в файловых панелях Total Commander:

Действие
Способ
Создать контакт Служебный элемент «# Создать контакт»
Создать папку Клавиша F7
Редактировать контакт Комбинация клавиш Alt+Enter
Просмотреть контакт Клавиша Enter или двойной щелчок
Копировать папку или контакт Клавиша F5 (при условии, что в противоположной панели тоже открыт tcPhonebook)
Экспортировать папку или контакт Клавиша F5 (при условии, что в противоположной панели отображается реальная файловая система)
Импортировать папку или контакт Клавиша F5 в реальной файловой системе (при условии, что в противоположной панели открыт tcPhonebook)
Копировать папку или контакт в ту же папку с переименованием Комбинация клавиш Shift+F5
Переименовать папку или контакт Комбинация клавиш Shift+F6
Переместить папку или контакт Клавиша F6
Удалить папку или контакт Клавиша Delete
Вызвать диалог настройки плагина Запуск служебного элемента «# Настройки» в корневом каталоге плагина, комбинация клавиш Alt+Enter на строке с именем плагина (Phonebook) в «Сети / FS-плагинах» или Alt+Enter на элементе [..] в любом каталоге файловой системы плагина

Примечание: В таблице для каждого действия указан один или несколько способов выполнения. Вы можете использовать указанные или любые другие способы, предоставляемые интерфейсом Total Commander.

Служебные элементы и внутренние команды
Служебные элементы файловой системы плагина отображаются в файловых панелях Total Commander, как файлы с именами, начинающимися с символа #. Чтобы выполнить задачу, для которой предназначен служебный элемент, просто запустите его двойным щелчком или клавишей Enter.
Внутренние команды плагина можно использовать в командной строке Total Commander. Чтобы выполнить внутреннюю команду введите её имя и нажмите клавишу Enter.
Далее приведён перечень служебных элементов и соответствующих им внутренних команд:

Служебный элемент
Внутренняя команда
Назначение
# Создать контакт   Открывает диалог «Создание нового контакта»
# Настройка config Открывает основной диалог настроек. Отображается только в корневом каталоге плагина
# Письмо выделенным email Создаёт новое письмо (в почтовой программе по умолчанию) на все адреса, которые содержатся в выделенных контактах. Данное действие может быть выполнено для файлов-контактов, но не для папок

Примечание: По умолчанию в файловой системе плагина отображаются все служебные элементы. Отключить невостребованные элементы можно в основном диалоге настроек.

Настройка
Основной диалог настроек
Вызвать диалог настройки плагина можно, например, при помощи комбинации клавиш Alt+Enter на строке с именем плагина (Phonebook) в «Сети / FS-плагинах» или воспользовавшись служебным элементом «# Настройки» в корневом каталоге плагина. Назначение элементов диалога:

Элемент
Назначение
Отображение
Кнопка «Изменить шрифт» Открывает стандартный системный диалог «Шрифт», где можно выбрать шрифт, который будет использоваться для отображения текста в окнах tcPhonebook
Кнопка «Внешний вид» Открывает диалог для настройки внешнего вида текста и фона для окна «Просмотр контакта»
Кнопка «Последовательность составляющих имени» Открывает диалог, в котором можно изменить последовательность составляющих имени при их отображении в файловых панелях Total Commander и в поле «Полное имя» в окнах «Просмотр контакта» и «Редактирование контакта»
Опция «Отображать расширение .vcf у контактов» Разрешает/запрещает отображение расширения .vcf у файлов-контактов в файловых панелях Total Commander
Опция «Отображать элемент «# Настройки» в корневом каталоге» Разрешает/запрещает отображение служебного элемента «# Настройки» в корневом каталоге плагина
Экспорт / Импорт
Экспорт vCard (Смотрите подробнее о файле формата vCard и назначении его атрибутов)
Опция «Экспортировать vCard в кодировке UTF-8» Разрешает/запрещает экспортировать атрибуты vCard-файла в кодировке UTF-8
Опция «Экспортировать атрибут «N»» Разрешает/запрещает при экспорте контакта включать в результирующий vCard-файл атрибут «N» (структурированное представление имени). Отключение этой опции может понадобиться, если экспортированный файл предназначен, например, для телефона, который некорректно обрабатывает атрибут «N». При отсутствии атрибута «N» имя будет определяться атрибутом «FN» (полное имя в виде единой строки)
Опция «Объединять «Имя» и «Отчество» в одно поле» Если опция установлена, то при экспорте атрибута «N» поля «Имя» и «Отчество» будут объединены в одну строку через пробел и помещены в результирующем файле на место поля «Имя». Включение этой опции может понадобиться, если экспортированный файл предназначен, например, для устройства, которое не отображает поле «Отчество»
Опция «Экспортировать атрибут «LABEL»» Разрешает/запрещает при экспорте контакта включать в результирующий vCard-файл атрибут «LABEL». Отключение этой опции может понадобиться, если экспортированный файл предназначен, например, для программы, которая игнорирует атрибут «ADR» при наличии атрибута «LABEL»
Опция «Формат экспорта дат» Задаёт вид, в каком в результирующий vCard-файл будут внесены даты, например, атрибут «BDAY» (день рожденья). Если выбран базовый формат, то дата будет представлена в виде ГГГГММДД, если расширенный – ГГГГ-ММ-ДД. Используйте эту опцию, если программа, для которой предназначен экспортированный файл работает только с одним из вариантов даты
Импорт vCard (Смотрите подробнее о файле формата vCard и назначении его атрибутов)
Опция «Имя контакта по содержимому vCard-атрибутов» Если опция включена, то имя файла-контакта будет сформировано по содержимому атрибутов («N» или «FN») vCard-файла, иначе имя файла-контакта будет такое же, как и у vCard-файла
Опция «Воспринимать атрибуты без указания кодировки, как UTF-8» Предназначена для обеспечения возможности правильно импортировать атрибуты vCard, если они имеют кодировку UTF-8, но об этом явно не указано строкой «CHARSET=UTF-8». Данная ситуация возможна в результате некорректной формирования vCard-файла другой программой или устройством.
Возможные значения опции:
  • «Никогда». Опция отключена
  • «Если есть хотя бы один атрибут в UTF-8». Атрибут без указания кодировки будет восприниматься как текст UTF-8, если хотя бы в одном атрибуте контакта присутствует явное указание кодировки UTF-8
  • «Всегда». Любой атрибут без указания кодировки будет восприниматься как текст UTF-8
Язык (Language)
Выпадающий список «Язык (Language)» Позволяет выбрать язык интерфейса tcPhonebook
Кнопка «//» Открывает языковой файл, соответствующий выбранному языку, в текстовом редакторе
 
Кнопка «Справка» Открывает данный справочный файл
Кнопка «ОК» Сохраняет настройки и закрывает диалог
Кнопка «Отмена» Отменяет выполненные действия и закрывает диалог

Настройка через файл tcPhonebook.ini
Большинство параметров можно установить при помощи основного диалога настроек, но некоторые настройки можно изменить только редактированием файла tcPhonebook.ini, который содержится в папке установки плагина.
При выгруженном плагине откройте файл tcPhonebook.ini в любом текстовом редакторе, который поддерживает кодировку UTF-8 (например, Блокнот), выполните необходимые изменения и сохраните файл.
Таким способом можно задать следующие дополнительные параметры:

Секция
Ключ
Назначение
Примеры
[Program] Browser Задаёт браузер, в котором будет открываться файл справки при нажатии клавиши F1 или кнопки «Справка» в окнах плагина. Если ключ не задан, то будет использоваться браузер, определённый в ОС по умолчанию.
  1. Использовать Lister (встроенный просмотрщик Total Commander), файл будет открыт в текущей копии Total Commander в режиме показа HTML без перехода по внутренней ссылке (Lister поддерживает внутренние ссылки в командной строке только начиная с Total Commander 8.0):
    Browser=%COMMANDER_PATH%\TOTALCMD.EXE
    BrowserParams=/O /S=L:T5 %0
  2. Использовать браузер Mozilla Firefox, файл будет открыт в новом окне браузера с прокруткой к нужному месту файла в зависимости от места вызова справки (переход по внутренней ссылке):
    Browser=C:\Program Files\Mozilla Firefox\firefox.exe
    BrowserParams=-new-window %1
BrowserParams Задаёт параметры командной строки браузера. Используйте специальные символы %0 (вставляет полное имя файла справки; для браузеров, которые не поддерживают внутренние ссылки в командной строке) или %1 (вставляет полное имя файла справки с внутренней ссылкой для прокрутки к соответствующему разделу справки).
[Display] ShowPostalCodeBeforeRegion Задаёт размещение поля «Почтовый индекс» при просмотре, редактировании и экспорте контакта. Если значение ключа равно 1, поле «Почтовый индекс» будет отображаться перед полем «Регион», иначе – после него. По умолчанию (т.е. если ключ отсутствует) значение считается равным 0.  

Настройка внешнего вида
Диалог «Внешний вид» можно открыть из диалога настроек плагина или из окна просмотра контакта. Диалог предназначен для изменения параметров отображения таких элементов окна просмотра контакта, как «Название группы полей», «Название поля» и «Значение поля» и позволяет для них установить шрифт, размер, начертание, выравнивание, цвет текста и цвет фона. Также здесь можно установить цвет фона неиспользуемой области и сетки списка контактов.
Для изменения параметров выберите из соответствующего выпадающего списка элемент окна просмотра контакта и установите необходимые значения. Для копирования/вставки форматов используйте контекстное меню, которое можно вызвать нажатием правой кнопки мыши на области, в которой находятся параметры форматирования.

Настройка последовательности составляющих имени
Диалог «Последовательность составляющих имени» можно открыть из диалога настроек плагина. Данный диалог предоставляет возможность изменить порядок следования составляющих полного имени (Обращение, Фамилия, Имя, Отчество) при их отображении в файловых панелях Total Commander (колонка «Имя») и в диалогах «Просмотр контакта» и «Редактирование контакта» (поле «Полное имя»).
Для изменения порядка выделите в списке составляющую, позицию которой нужно изменить, и используйте кнопки, расположенные справа от списка, для её перемещения вверх/вниз. Полное имя будет сформировано сложением составляющих с разделением пробелами в одну строку по порядку их следования в списке.

Редактирование/создание контакта. Окна «Редактирование контакта» и «Создание нового контакта».
Данное окно может быть открыто в режиме создания нового контакта при помощи служебного элемента «# Создать контакт», присутствующего в каждой папке файловой системы плагина, – запустите его как обычный файл двойным щелчком или клавишей Enter. Для открытия окна в режиме редактирования контакта воспользуйтесь комбинацией клавиш Alt+Enter или контекстным меню контакта в файловой панели – пункт «Свойства».
Окно редактирования/создания контакта содержит 5 вкладок:
  • «Сводка» – сводная информация о контакте: основные поля собранные на одной вкладке и Примечание
  • «Контактное лицо» – информация о контактном лице: Имя, Фамилия, Отчество, Обращение, День рожденья
  • «Работа» – данные о месте работы: Должность, Организация, Отдел, Кабинет, Контакты (Телефон, Мобильный телефон, Факс, E-почта, Веб-страница), Адрес (Страна, Регион, Населённый пункт, Адрес, Почтовый код)
  • «Личное» – личные данные: Контакты (Телефон, Мобильный телефон, Факс, E-почта, Веб-страница), Адрес (Страна, Регион, Населённый пункт, Адрес, Почтовый код)
  • «Другое» – дополнительные данные: Контакты (Телефон, Мобильный телефон, Факс, E-почта, Веб-страница), Адрес (Страна, Регион, Населённый пункт, Адрес, Почтовый код)
На вкладке «Сводка» в соответствующем выпадающем списке можно выбрать предпочитаемый адрес E-почты из числа всех адресов содержащихся на всех вкладках данного диалога. Такой адрес будет отображаться отдельной строкой в окне «Просмотр контакта» в группе полей «Сводка».
Примечание: При редактировании полей на вкладке «Сводка» их содержимое переносится в соответствующие поля других вкладок и наоборот.
Также в этом окне можно задать произвольное имя файла контакта, которое будет отображаться в файловых панелях Total Commander, или установить опцию «Имя файла как «Полное имя»», которая позволит использовать в качестве имени файла поле «Полное имя».

Специальный редактор полей
Данный редактор предназначен для редактирования полей, которые могут содержать более одного значения (Телефон, Мобильный телефон, Факс, E-почта, Веб-страница). Используйте кнопку «...» справа от таких полей в диалогах «Создание нового контакта» и «Редактирование контакта».
При открытии редактора содержимое поля будет разделено на отдельные значения (разделителями значений внутри поля являются запятые) и отображено в виде списка. В список можно добавлять новые, изменять и удалять уже имеющиеся значения. По завершению редактирования нажмите кнопку «ОК» и все значения, содержащиеся в списке, будут совмещены в одну строку разделённые запятыми и перенесены в поле, для которого был открыт редактор.

Просмотр контакта
Окно просмотра информации о контакте можно вызвать нажав клавишу Enter или выполнив двойной щелчок на файле-контакте в файловой панели Total Commander.
Содержимое полей контакта представлено в виде списка, строки которого разделены на 5 групп – по количеству вкладок в окне «Редактирование контакта». Незаполненные поля в списке не отображаются. Содержимое каждой группы полей может быть скрыто/отображено двойным щелчком или клавишами-стрелками вправо/влево на строке названия группы, а также одиночным щелчком на треугольнике слева от названия группы.
Переход по ссылке (в браузере по умолчанию), которая содержится в поле «Веб-страница», можно выполнить двойным щелчком на названии поля (не на содержимом) или при помощи горячей клавиши F3. Для поля «E-почта» в результате такого действия будет выполнено создание нового письма (в почтовой программе по умолчанию) по адресу, который содержится в поле.
В окне просмотра контакта доступна возможность быстрого редактирования содержимого полей – просто выполните двойной щелчок на содержимом (не на названии) поля, которое необходимо отредактировать, или воспользуйтесь горячей клавишей F2. Чтобы завершить редактирование, нажмите Enter, для отмены нажмите Esc или щёлкните левой кнопкой мыши в другом месте списка. Имейте в виду, что сводные поля (Полное имя, Телефон (все), Мобильный телефон (все), E-почта (все)) недоступны для редактирования. Чтобы удалить поле, удалите весь текст (для поля «День рожденья» уберите отметку перед датой) и нажмите Enter. Важное примечание: Все изменения, выполненные в этом окне, применяются сразу – отмена не предусмотрена.
Кнопка «Редактировать контакт» или горячая клавиша F4 открывает диалог «Редактирование контакта».
Кнопка «Настроить внешний вид» открывает диалог, в котором можно выполнить настройку внешнего вида текста и фона элементов списка в данном окне.

Пользовательские колонки
Плагин поддерживает пользовательские колонки.
Набор пользовательских колонок по умолчанию содержит поля, отображающие основную информацию о контакте: Имя, Все телефоны, Должность, Организация, Населённый пункт (работа).
Изменить текущий набор колонок можно при помощи контекстного меню заголовков табуляторов, пункт «Настроить текущий набор колонок...».
Добавить новый или удалить существующий набор колонок можно при помощи контекстного меню заголовков табуляторов, пункт «Настроить наборы колонок...» или через основной диалог настроек Total Commander, страница «Наборы колонок».
Переключаться между наборами колонок можно используя контекстное меню заголовков табуляторов, выбирая пункт, соответствующий нужному набору.
Примечание: Пользовательские колонки являются частью интерфейса Total Commander. Подробности смотрите в справке Total Commander.

Цветовая схема
Средствами Total Commander вы можете определить цвет для служебных элементов (например, «# Создать контакт») файловой системы плагина:
  • Создайте шаблон поиска:
    • перейдите в корневой каталог файловой системы плагина
    • вызовите диалог поиска Total Commander (например, комбинацией клавиш Alt+F7)
    • на вкладке «Общие параметры» в поле «Искать файлы» введите #* (всего два символа)
    • на вкладке «Шаблоны поиска» сохраните шаблон при помощи кнопки «Сохранить», например, под именем «Phonebook»
  • Определите цвет:
    • откройте главный диалог настроек Total Commander (Главное меню → Конфигурация → Настройка), перейдите на страницу «Цвета» и нажмите кнопку «Определить цвета для типов файлов...»
    • в открывшемся диалоге нажмите кнопку «Добавить»
    • в открывшемся диалоге выберите шаблон «Phonebook», нажмите кнопку «ОК» и выберите подходящий цвет
    • нажмите кнопку «ОК» последовательно во всех диалогах

История версий
[0.9.3.5] [12.06.2012] [0.9.3.4] [25.05.2012] [0.9.3.3] [06.05.2012] [0.9.3.2a] [25.04.2012] [0.9.3.2] [24.04.2012] [0.9.3.0] [17.02.2012] [0.9.2.6] [23.11.2011] [0.9.2.5] [28.10.2011] [0.9.2.0] [09.09.2011] [0.9.1.0] [28.07.2011] [0.9.0.3] [14.07.2011] [0.9.0.2] [13.07.2011] [0.9.0.0] [12.07.2011] [0.8.7.0] [20.04.2011] [0.8.6.5] [16.03.2011] [0.8.5.0] [25.02.2011] [0.8.1.0] [28.01.2011] [0.8.0.0] [27.01.2011] [0.7.5.0] [05.01.2011] [0.7.0.0] [30.12.2010]