tcPhonebook 0.9.2.6
Simple phone book
File system plugin for Total Commander
© Maximus's Solutions 2010-2011
http://maximus.in.ua


Contents
Description
Installation
Using
Control
Configuration
Contact editing/creating
Contact viewing
Custom columns
Version history


Description
Displays as user-defined structure and allows to manipulate the phone book contacts directly in the file window of Total Commander.
Each record can contains information about the contact person (name, birthday), data on place of work (post, organization, contacts, address), personal data (contacts, address), other data (contacts, address), and note.
Allows you to import/export contacts in vCard format (file format standard for electronic business cards); supports import of files, which contain more than one contact. Supports UTF-8 encoding (import/export) and Quoted-printable encodings (import only).
Has a multilingual interface (Chinese, Danish, English, German, Russian, Swedish, Ukrainian).
Supported OS: Windows 2000 / XP / Vista / 7


Installation
Automatic
  1. Enter in the archive with the plugin (Ctrl+PgDn) and Total Commander will ask you to install it
  2. Follow the instructions of Total Commander
Manual
  1. Unpack the contents of the archive to a separate directory
  2. Install plugin:
    • {Configuration → Options... → Plugins → File system plugins → Configure}
    • Add tcPhonebook.wfx to the list of plugins
You can use the plugin, like any WFX-plugin, from file window in Total Commander after switching to the «Network Neighborhood» with the appropriate button on the drive bar, or by selecting the appropriate item in the drive selection list (Alt+F1, Alt+F2).


Using
Control

Action
Method
Create contact Service element «# Create contact»
Create folder Key F7
Edit contact Key combination Alt+Enter
View contact Key Enter or double click the left mouse button
Copy folder or contact Key F5 (assuming that in the opposite file window also tcPhonebook is opened)
Export folder or contact Key F5 (assuming that in the opposite file window real filesystem displaying)
Import folder or contact Key F5 in the real filesystem (assuming that in the opposite file window tcPhonebook is opened)
Copy folder in the same folder with rename Key combination Shift+F5
Rename folder Key combination Shift+F6
Move folder or contact Key F6
Delete folder or contact Key Delete
Open plugin configuration dialog Starting the service element «# Configuration» in the plugin root directory, key combination Alt+Enter on item with plugin name (Phonebook) in «Network Neighborhood» or Alt+Enter on element [..] in the root directory of the plugin.

Note: In the table for each action specified one or several ways to perform it. You can use this or any other method that provides an interface of Total Commander.
Important note: It is not recommended to change the contact name when copying/moving. Such action will only lead to a change in name, which appears in the file window. At the first edit of contact field (by Alt+Enter) name will be replaced by the name automatically generated.

Configuration
Main configuration dialog
You can open plugin configuration dialog, for sample, with key combination Alt+Enter on item with plugin name (Phonebook) in «Network Neighborhood» or by using the service element «# Configuration» in the plugin root directory. Appointment of dialog elements:

Element
Appointment
Language
Dropdown list «Language» Allows you to select tcPhonebook interface language
Button «//» Opens language file corresponding to the selected language in a text editor
Display
Button «Change font» Opens standard system dialog «Font», where you can select the font to be used for displaying text in windows of tcPhonebook
Button «Appearance» Opens dialog for configuring appearance of text and background for window «View contact»
Button «Sequence of name components» Opens dialog which allows you to change the sequence of the name components in which they appear in the Total Commander file windows and in the field «Full name» in windows «View contact» and «Edit contact»
Option «Show .vcf extension with contacts» Enables/disables displaying of file extensions .vcf with contacts in file windows of Total Commander
Option «Show service element «# Configuration» in root directory» Enables/disables displaying of the service element «# Configuration» in the root directory of plugin
Export
Option «Export vCard in UTF-8 encoding» Enables/disables to export vCard-file properties in UTF-8 encoding
Option «Export «LABEL» (vCard property)» Enables/disables to create in the resulting vCard-file property «LABEL» when you exports contact. Disabling of this option may be needed if the exported file, for example, is for a program which for a program that ignores property «ADR» in the presence of property «LABEL»
Option «Export «N» (vCard property)» Enables/disables to create in the resulting vCard-file property «N» when you exports contact. Disabling of this option may be needed if the exported file, for example, is for a phone that not correctly handle property «N»
Import
Option «Make contact name by vCard-properties content» If this option is enabled, the file-contact name will be generated by content of vCard-file properties («N» or «FN»), otherwise file-contact name will be the same as that of the vCard-File
 
Button «Help» Opens this help file
Button «OK» Saves configuration and closes dialog
Button «Cancel» Discards any changes and closes dialog

Configuration using file tcPhonebook.ini
Most parameters can be set using the main configuration dialog, but some settings can be changed only editing the file tcPhonebook.ini, which is contained in the plugin installation folder.
When plugin is unloaded, open the file tcPhonebook.ini with any text editor that supports UTF-8 encoding (such as Notepad), make the necessary changes and save the file.
This way you can specify the following additional parameters:

Section
Key
Appointment
Examples
[Program] Browser Sets the browser, which will open the help file by pressing key F1 or button «Help» in the plugin windows. If this key is not specified, will be used browser defined in OS by default.
  1. Use Total Commander internal file Lister, file will be opened in the current copy of Total Commander with HTML mode and without following internal link (Lister does not support internal links in the command line):
    Browser=%COMMANDER_PATH%\TOTALCMD.EXE
    BrowserParams=/O /S=L:T5 %0
  2. Use browser Mozilla Firefox, file will be opened in a new window of browser and scrolled to the right place in the file, depending help calling context (following internal link):
    Browser=C:\Program Files\Mozilla Firefox\firefox.exe
    BrowserParams=-new-window %1
BrowserParams Specifies browser command-line. Use the special characters %0 (inserts full name of the help file; for browsers that do not support internal links in the command line) or %1 (inserts full name of the help file with internal link to scroll to the appropriate help section).

Customize appearance
Dialog «Appearance» can be opened from plugin configuration dialog or from viewing contact window. The dialog is intended to change the display of such items of viewing contact window, as «Fields group name», «Field name» and «Field name» and allows them to set font, size, style, alignment, text color and background color.
To change settings, select from the appropriate dropdown listbox element of viewing contact window and set the values you need.

Configuration of sequence of name components
Dialog «Sequence of name components» can be opened from plugin configuration dialog. This dialog provides ability to reorder components of the full name (Title, First name, Middle name, Last name) when they are displayed in the Total Commander file windows (column «Name») and in the dialogs «View contact» and «Edit contact» (field «Full name»).
To change the order, select from the list component, the position you want to change, and use the buttons to the right of the list to move it up/down. The full name will be formed by adding components separated by spaces to the string in order they appear in the list.

Contact editing/creating. Windows «Edit contact» and «Create new contact».
This window can be opened in creation mode with service element «# Create contact», which is present in each folder of plugin file system, – run it like a usual file by double clicking the left mouse button or press Enter. To open window in edit mode, use the key combination Alt+Enter or the context menu of a contact in the file window – item «Properties».
Window for editing/creating contact contains 5 tabs:
  • Summary – summary information about the contact: the main fields collected on the same tab and Note
  • Contact person – information about the contact person: First Name, Last Name, Middle Name, Title, Birthday
  • Work – data on place of work: Job title, Organization, Department, Office, Contacts (Phone, Mobile phone, Fax, E-mail, Web page), Address (Country, Region, City, Address, Postal code)
  • Personal – personal data: Contacts (Phone, Mobile phone, Fax, E-mail, Web page), Address (Country, Region, City, Address, Postal code)
  • Other – additional data: Contacts (Phone, Mobile phone, Fax, E-mail, Web page), Address (Country, Region, City, Address, Postal code)
On the «Summary» tab in the corresponding drop-down list, you can select preferred address E-mail, from among all addresses contained on all tabs of this dialog. This address will appear as separate line in the window «View contact» in field group «Summary».
Note: When editing fields on the «Summary» tab their content is transferred into the corresponding fields of other tabs, and vice versa.

Special field editor
This editor allows you to edit fields that may contain more than one value. At the moment these are all the fields «E-mail». Use the button «...» which is located right near the fields in the dialogs «Create new contact» and «Edit contact».

When you open an editor field contents will be divided into single values ​​(comma is separator of values inside the field) and displayed in a list. To the list you can add new, edit and delete existing values. Upon completion of editing, click «OK» and all the values ​​contained in the list will be combined into one string separated by commas and moved to field for which was opened editor.

Contact viewing. Window «View contact».
Window for viewing contact details can be opened by pressing Enter or by double-clicking the left mouse button on file-contact in the Total Commander file window.
Content of contact fields presented in a list, whose rows are divided into five groups – by the number of tabs in window «Edit contact». Empty fields are not displayed in the list. The contents of each fields group can be hidden/displayed by double-clicking or using arrow keys right/left on the group name row and also by single-clicking on triangle to the left of group name.
Follow a link (in the default browser), which is contained in the field "Web page", you can by double-clicking the left mouse button on the name (not the contents) of the field. For the field «E-mail» as a result of such action will be created a new e-mail letter (in the default mail program) to address, which is contained in the field.
In view contact window is available quick editing of field content – just do double-clicking the left mouse button on the contents (not the name) of field you want to edit. To finish editing, press Enter, to cancel, press Esc or click the left mouse button elsewhere in the list. Keep in mind that the summary fields (Full name, Phone (all), Mobile phone (all), E-mail (all)) are not available for editing. To delete field, remove all text (for «Birthday» disable checkbox near the date) and press Enter. Important note: Any changes made in this window are applied immediately – cancel is not provided.
Button «Customize appearance» opens dialog where you can customize the appearance of text and background elements of the list in this window.

Custom columns
The plugin supports custom columns.
A set of custom columns by default contains the fields that display the basic contact information: Name, All phones, Post, Organization, City (work).
Change the current set of columns can be using the context menu of tabstop header, item «Configure this custom columns view...».
Add new or delete an existing columns view may be using the context menu of tabstop header, item «Configure custom columns...» or with the main Total Commander configuration dialog on page «Custom columns».
To switch between columns views can be using the context menu of tabstop header by selecting an item corresponding to the required view.
Note: Custom columns are part of the Total Commander interface. Details are provided in help for Total Commander.

Color scheme
Using Total Commander interface you can specify a color for the service elements (e.g., «# Create contact») of plugin file system:
  • Create the search template:
    • go to the root of the plugin file system
    • call the Total Commander Find dialog (eg, key combination Alt+F7)
    • on «General» tab in «Search for» field input #* (only two characters)
    • on «Load/Save» tab save template by pressing button «Save», for example, with name «Phonebook»
  • Specify color:
    • open main Total Commander configuration dialog (Main menu → Configuration → Options...), go to the page «Color» and press button «Define colors by file type...»
    • in the dialog that opens, press the «Add» button
    • in the dialog that opens, select the template «Phonebook», press «OK» button and select the appropriate color
    • press «OK» button consistently in all dialogs

Version history
[0.9.2.6] [23 Nov 2011] [0.9.2.5] [28 Oct 2011] [0.9.2.0] [09 Sep 2011] [0.9.1.0] [28 Jun 2011] [0.9.0.3] [14 Jun 2011] [0.9.0.2] [13 Jun 2011] [0.9.0.0] [12 Jun 2011] [0.8.7.0] [20 Apr 2011] [0.8.6.5] [16 Mar 2011] [0.8.5.0] [25 Feb 2011] [0.8.1.0] [28 Jan 2011] [0.8.0.0] [27 Jan 2011] [0.7.5.0] [05 Jan 2011] [0.7.0.0] [30 Dec 2010]