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


Зміст
Опис
Встановлення
Використання
Керування
Налаштування
Редагування/створення контакту
Перегляд контакту
База даних
Користувацькі колонки
Історія версій


Опис
Відображає у вигляді довільної структури і дозволяє маніпулювати контактами телефонної книги безпосередньо в панелі Total Commander.
Кожен запис може містити інформацію про контактну особу (ім'я, день народження), дані про місце роботи (посада, організація, контакти, адреса), особисті дані (контакти, адреса), інші дані (контакти, адреса), а також примітку.
Дозволяє імпортувати/експортувати контакти у форматі vCard (формат файлів для обміну електронними візитними картками) в кодуваннях ANSI, 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:

Дія
Спосіб
Створити контакт Запуск службового елемента Створити контакт або виконання внутрішньої команди create
Створити папку Клавіша F7
Редагувати контакт Комбінація клавіш Alt+Enter
Переглянути контакт Клавіша Enter або подвійний клік
Копіювати папку або контакт Клавіша F5 (за умови, що в протилежній панелі також відкрито tcPhonebook)
Експортувати папку або контакт Клавіша F5 (за умови, що в протилежній панелі відображається реальна файлова система)
Експортувати всі контакти одним файлом Запуск службового елемента Експортувати все одним файлом у кореневому каталозі плаґіна, виконання внутрішньої команди export all або копіювання даного елемента до реальної файлової системи
Імпортувати папку або контакт Клавіша F5 в реальній файловій системі (за умови, що в протилежній панелі відкрито tcPhonebook)
Копіювати папку або контакт до тієї ж папки з перейменуванням Комбінація клавіш Shift+F5
Перейменувати папку або контакт Комбінація клавіш Shift+F6
Перемістити папку або контакт Клавіша F6
Видалити папку або контакт Клавіша Delete
Відкрити діалог налаштування плаґіна Запуск службового елемента Налаштування у кореневому каталозі плаґіна, виконання внутрішньої команди config, комбінація клавіш Alt+Enter на рядку з ім'ям плаґіна (Phonebook) в «Мережі / FS-плагінах» або Alt+Enter на елементі [..] в будь-якому каталозі файлової системи плаґіна

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

Службові елементи та внутрішні команди
Службові елементи файлової системи плаґіна відображаються в файлових панелях Total Commander, як файли з іменами, що починаються з символу #. Щоб виконати задачу, для якої призначено службовий елемент, просто запустіть його подвійним кліком або клавішею Enter.
Внутрішні команди плаґіна можна використовувати в командному рядку Total Commander. Щоб виконати внутрішню команду введіть її ім'я та натисніть клавішу Enter.
Нижче приведено перелік службових елементів та відповідних їм внутрішніх команд:

Службовий елемент
Внутрішня команда
Призначення
Налаштування config Відкриває основний діалог налаштувань
Створити контакт create Відкриває діалог «Створення нового контакту». Відображається тільки у кореневому каталозі плаґіна
Лист виділеним email Створює нового листа (в поштовій програмі за замовчуванням) на всі адреси, які містяться у виділених контактах. Дана дія може бути виконана для файлів-контактів, але не для папок
Експортувати все одним файлом export all Експортує всі контакти одним файлом у форматі vCard з попереднім запитом імені файлу та розташування у стандартному системному діалозі. Копіювання даного службового елемента до реальної файлової системи виконає ту ж саму дію, але за допомогою діалогу Total Commander.

Примітка: За замовчуванням у файловій системі плаґіна відображаються всі службові елементи. Вимкнути непотрібні елементи можна в основному діалозі налаштувань.

Налаштування
Основний діалог налаштувань
Викликати діалог налаштування плаґіна можна, наприклад, за допомогою комбінації клавіш 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-файлу, а при значенні «vCard-атрибути початкового файлу» ім'я файлу-контакту буде сформовано за вмістом атрибутів («N» або «FN») 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 або кнопки «Довідка» у вікнах плаґіна. Якщо ключ не задано, то буде використовуватися інтернет-оглядач, визначений в ОС за замовчуванням.
  • Використовувати Lister (вбудований переглядач Total Commander), файл буде відкрито у поточній копії Total Commander в режимі показу HTML без переходу за внутрішнім посиланням (Lister підтримує внутрішні посилання у командному рядку тільки починаючи з Total Commander 8.0):
    Browser=%COMMANDER_PATH%\TOTALCMD.EXE
    BrowserParams=/O /S=L:T5 %0
  • Використовувати оглядач Mozilla Firefox, файл буде відкрито в новому вікні оглядача з прокручуванням до потрібного місця файлу в залежності від місця виклику довідки (перехід за внутрішнім посиланням):
    Browser=C:\Program Files\Mozilla Firefox\firefox.exe
    BrowserParams=-new-window %1
BrowserParams
Задає параметри командного рядка оглядача. Використовуйте спеціальні символи %0 (вставляє повне ім'я файлу довідки; для оглядачів, які не підтримують внутрішні посилання в командному рядку) або %1 (вставляє повне ім'я файлу довідки з внутрішнім посиланням для прокручування до відповідного розділу довідки).
[Display] ShowPostalCodeBeforeRegion
Задає розташування поля «Поштовий індекс» при перегляді, редагуванні та експорті контакту. Якщо значення ключа дорівнює 1, поле «Поштовий індекс» буде відображатися перед полем «Регіон», інакше – після нього. За замовчуванням (тобто якщо ключ відсутній) значення вважається рівним 0.
 
ServiceItemSign
Задає рядок-ознаку, з якого будуть починатися імена службових елементів файлової системи плаґіна.
Важлива примітка: Майте на увазі, що якщо даний рядок був змінений, то раніше створені папки та контакти, що містять на початку імені заданий рядок, будуть помилково вважатися службовими елементами. Будьте уважними!
Примітка: Символ підкреслення _ заборонений для використання і буде замінюватися символом #.
Приклади відображення службового елемента Налаштування в залежності від значення ключа:
  • Ключ відсутній. Буде використовуватися рядок за замовчуванням:
    # Налаштування
  • Пустий ключ (ServiceItemSign=). Ім'я елемента буде починатися з пробілу:
     Налаштування
  • Довільний рядок (ServiceItemSign=!!!). Ім'я елемента буде починатися зі вказаного рядка:
    !!! Налаштування

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

Налаштування формату повного імені
Діалог «Формат повного імені» можна відкрити з діалогу налаштувань плаґіна. Даний діалог надає можливість задати порядок розташування складових повного імені (Звернення, Ім'я, По-батькові, Прізвище, Суфікс, Нік) при їх відображенні у файлових панелях Total Commander (колонка «Ім'я») та в діалогах «Перегляд контакту» і «Редагування контакту» (поле «Повне ім'я»). Також в рядку формату можна вказувати додаткові символи або слова: наприклад, кому перед суфіксом або «aka» перед ніком.
Для вставки складових імені повинні використовуватися спеціальні символи: %P (Звернення), %F (Ім'я), %M (По-батькові), %L (Прізвище), %S (Суфікс), %N (Нік). Також в рядку можна використовувати квадратні дужки – підрядок, взятий у квадратні дужки, не буде відображатися, якщо всі складові, які відповідають спеціальним символам, що містяться в дужках, пусті.
Приклад
У властивостях контакту складові імені заповнені таким чином: Звернення Пан, Ім'я Петро, По-батькові Петрович, Прізвище Петренко, Суфікс к. м. н., Нік Петрик.
В налаштуваннях задано наступний формат повного імені: %P[ %F][ %M][ %L][, %S][ aka %N].
Тоді повне ім'я буде відображатися як Пан Петро Петрович Петренко, к. м. н. aka Петрик.
Якщо ж не заповнено складову «Суфікс», то повне ім'я буде відображатися як Пан Петро Петрович Петренко aka Петрик.

Редагування/створення контакту. Вікна «Редагування контакту» і «Створення нового контакту».
Дане вікно може бути відкрите в режимі створення нового контакту за допомогою службового елемента Створити контакт, присутнього в кожній папці файлової системи плаґіна, – запустіть його як звичайний файл подвійним кліком або клавішею Enter. Також відкрити це вікно для створення нового контакту можна виконавши з командного рядка Total Commander внутрішню команду create.
Для відкриття вікна в режимі редагування контакту скористайтесь комбінацією клавіш Alt+Enter або контекстним меню контакту в файловій панелі – пункт «Властивості».
Вікно редагування/створення контакту містить наступні вкладки:
На вкладці «Основні дані» у відповідному випадаючому списку можна вибрати бажану адресу E-пошти з усіх адрес, що містяться на всіх вкладках даного діалогу. Така адреса буде відображатися окремим рядком у вікні «Перегляд контакту» в групі полів «Основні дані».
Примітка: При редагуванні полів на вкладці «Основні дані» їх вміст переноситься до відповідних полів інших вкладок і навпаки.
Примітка: Поле «Примітка» може містити декілька рядків, але при експорті переведення рядків будуть замінені пробілами.
Також у цьому вікні можна задати довільне ім'я файлу контакту, яке буде відображатися у файлових панелях Total Commander, або встановити опцію «Ім'я файлу як «Повне ім'я»», яка дозволить використовувати у якості імені файлу поле «Повне ім'я».

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

Перегляд контакту
Вікно перегляду інформації про контакт можна викликати натиснувши клавішу Enter або виконавши подвійний клік на файлі-контакті у файловій панелі Total Commander.
Вміст полів контакту представлений у вигляді списку, рядки якого розділені на групи відповідно до вкладок у вікні «Редагування контакту». Незаповнені поля у списку не відображаються. Вміст кожної групи полів може бути прихований/відображений подвійним кліком або клавішами-стрілками вправо/вліво на рядку назви групи або одиночним кліком на трикутнику ліворуч від назви групи.
Для деяких полів можна виконувати специфічні дії відповідно до їх типу. Дію можна виконати подвійним кліком на назві поля (не на значенні) або за допомогою гарячої клавіші F3. Підтримуються наступні дії:
У вікні перегляду контакту доступна можливість швидкого редагування вмісту полів – просто виконайте подвійний клік на значенні поля (не на назві), яке потрібно редагувати, або скористайтесь гарячою клавішею F2. Щоб закінчити редагування, натисніть Enter, для скасування натисніть Esc або клікніть лівою кнопкою миші в іншому місці списку. Майте на увазі, що збірні поля (Повне ім'я, Телефон (всі), Мобільний телефон (всі), E-пошта (всі)) недоступні для редагування. Щоб видалити поле, видаліть увесь текст (для поля «День народження» зніміть позначку перед датою) і натисніть Enter. Важлива примітка: Всі зміни, виконані у цьому вікні, застосовуються відразу – скасування не передбачено.
Кнопка «Редагувати контакт» або гаряча клавіша F4 відкриває діалог «Редагування контакту».
Кнопка «Налаштувати зовнішній вигляд» відкриває діалог, у якому можна виконати налаштування зовнішнього вигляду тексту та фону елементів списку в даному вікні.

База даних
Файлова система плаґіна (файли-контакти і папки) зберігаються у файлі tcPhonebook.db (база даних SQLite в кодуванні UTF-8).
При кожному оновленні плаґіна до наступної версії, при першому його запуску, буде виконано резервне копіювання файлу бази даних. Файли резервних копій розташовуються поряд з файлом робочої бази даних, їх імена мають розширення dbbak і містять інформацію про версію бази даних та час копіювання.

Користувацькі колонки
Плаґін підтримує користувацькі колонки.
Набір користувацьких колонок за замовчуванням містить поля, які відображають основну інформацію про контакт: Ім'я, Всі телефони, Посада, Організація, Населений пункт (робота).
Змінити поточний набір колонок можна за допомогою контекстного меню заголовків табуляторів, пункт «Налаштувати поточний набір колонок...».
Додати новий або видалити існуючий набір колонок можна за допомогою контекстного меню заголовків табуляторів, пункт «Налаштувати набори колонок...» або через основний діалог налаштувань Total Commander, сторінка «Набори колонок».
Переключатися між наборами колонок можна використовуючи контекстне меню заголовків табуляторів, вибираючи пункт, відповідний потрібному набору.
Примітка: Користувацькі колонки – це частина інтерфейсу Total Commander. Докладніше дивіться у довідці Total Commander.

Колірна схема
Засобами Total Commander ви можете визначити колір для службових елементів (наприклад, Створити контакт) файлової системи плаґіна:

Історія версій
[0.9.4.0] [25.09.2012] [0.9.3.6] [06.07.2012] [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]