tcPhonebook 0.9.3.4
Simple phone book
File system plugin for Total Commander
© Maximus's Solutions 2010-2012
http://maximus.in.ua
mxmus@rambler.ru support@maximus.in.ua
Contents
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 multilingual interface (Chinese, Danish, English, German, Russian, Swedish, Ukrainian).
Supported OS: Windows 7 / Vista / XP / 2000
Installation
Automatic
- Enter in the archive with the plugin (Ctrl+PgDn) and Total Commander will ask you to install it
- Follow the instructions of Total Commander
Manual
- Unpack the contents of the archive to a separate directory
- Install plugin:
- {Configuration → Options... → Plugins → File system plugins → Configure}
- Add tcPhonebook.wfx to the list of plugins
Using
You can use this 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).
 |
→ |
 |
Control
Actions
The list of actions available for manage contacts in the file windows of Total Commander:
| 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 |
| 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 or contact |
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 any directory of the plugin file system |
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.
Service elements and internal commands
Service elements of plugin filesystem displayed in the Total Commander file windows, as files with names beginning with symbol #. To perform the task for which the service element is intended, just run it by double clicking or by pressing Enter.
Internal commands of plugin you can use in the Total Commander command line. To perform an internal command, input its name and press Enter.
The following is a list of service elements and their corresponding internal commands:
| Service element |
Internal command |
Appointment |
| # Create contact |
|
Opens dialog «Create new contact». Displayed only in the plugin root directory |
| # Configuration |
config |
Opens main configuration dialog |
| # E-mail to selected |
email |
Creates a new e-mail letter (in the default mail program) to all address, which is contained in the selected contacts. This action can be performed for files-contacts, but not for folders |
Note: By default, all service elements are displayed in the plugin filesystem. Disable unclaimed elements you can in the main
configuration dialog.
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 |
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 / Import |
Export ( See more details about vCard format file and appointment of its properties) |
| Option «Export vCard in UTF-8 encoding» |
Enables/disables to export vCard-file properties in UTF-8 encoding |
| Option «Export «N» property» |
Enables/disables to include in the resulting vCard-file property «N» (structured representation of the name) 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». The name will be defined by property «FN» (formatted name string), if property «N» is not included in the file |
| Option «Combine «First name» and «Middle name» into one field» |
If option enabled, then when exporting the property «N» the fields «First name» and «Middle name» will be combined into one string separated by space and put in the resulting file at the place of field «Name». Enabling this option may be needed if the exported file is intended, for example, for a device that does not display the field «Middle name» |
| Option «Export «LABEL» property» |
Enables/disables to include 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 «Date export format» |
Specifies the form in which dates will be included in the resulting vCard-file, for example, «BDAY» property (birthday). If you choose the basic format, the date will be presented in the form YYYYMMDD, if extended – YYYY-MM-DD. Use this option, if program, for which exported file is intended, works with one type of date only |
Import ( See more details about vCard format file and appointment of its properties) |
| 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 |
| Option «Assume property text to be UTF-8 if encoding is not specified» |
It is intended to make it possible to import the vCard attributes correctly if they are encoded in the UTF-8, but this is not explicitly specified by string «CHARSET=UTF-8». This situation is possible as a result of incorrect forming vCard-file by another program or device.
Possible option values:
- «Never». Option disabled
- «If at least one property in UTF-8 is present». Property without specifying the encoding will be assumed as a text in UTF-8, if at least one property of the contact has an explicit specifying of the encoding UTF-8
- «Always». Any property without specifying the encoding will be assumed as a text in UTF-8
|
Language |
| Dropdown list «Language» |
Allows you to select tcPhonebook interface language |
| Button «//» |
Opens language file corresponding to the selected language in a text editor |
| |
| 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. |
- 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 support internal links in the command line only from Total Commander 8.0):
Browser=%COMMANDER_PATH%\TOTALCMD.EXE
BrowserParams=/O /S=L:T5 %0
- 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).
|
| [Display] |
ShowPostalCodeBeforeRegion |
Specifies placement of the field «Postal code» when viewing, editing and exporting contacts. If the key value is equal to 1, field «Postal code» will be displayed before the field «Region», otherwise – after. By default (ie if the key is missing), the value is equal to 0. |
|
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. Also here you can set the background color of unused area and color of grid of contact list.
To change settings, select from the appropriate dropdown listbox element of viewing contact window and set the values you need. To copy/paste formats use the context menu that can be called by right clicking on the area, which contains the formatting options.
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 or pressing 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, Locality, Address, Postal code)
- Personal – personal data: Contacts (Phone, Mobile phone, Fax, E-mail, Web page), Address (Country, Region, Locality, Address, Postal code)
- Other – additional data: Contacts (Phone, Mobile phone, Fax, E-mail, Web page), Address (Country, Region, Locality, 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.
Also in this window you can specify an arbitrary file name of contact, that will be displayed in the Total Commander file windows, or you can check option «File name as «Full name»», which will allow to use the field «Full name» as the file name of contact.
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 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 on the name (not the contents) of the field or with hotkey F3. 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 on the contents (not the name) of field you want to edit, or use hotkey F2. 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 «Edit contact» or hotkey
F4 opens dialog «
Edit contact».
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, Locality (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.3.3] [06 May 2012]
- Changed: There will be some changes made to the database of contacts when you first start the plugin. Previous versions of the plugin will not work with the modified database.
- Fixed: Import: Processing of some vCard-properties («PHOTO», «SOUND» and others) unused by plugin – now they mistakenly not counted as part of other properties.
- Added: Import: Option «Assume property text to be UTF-8 if encoding is not specified».
- Fixed: Configuration, Display: Common font and size of text wrongly influenced also by elements of the view contact window.
- Fixed: E-mail to selected: Added handling of new format strings that are obtained from the file windows with LB_GETTEXT (format changed starting with Total Commander 8.0 beta 24).
- Fixed: Editing: «E-mail (preferred)» address wrongly changed, if performed removing or adding any address in the list before the selected address.
[0.9.3.2a] [25 Apr 2012]
- Fixed: Open help, Internet Explorer: An error occurred, if there were spaces in the path.
[0.9.3.2] [24 Apr 2012]
- Changed: Reorganized the configuration dialog.
- Added: Configuration, Export: Option «Date export format»: Basic (YYYYMMDD) and Extended (YYYY-MM-DD).
- Added: Configuration file: Key [Display], ShowPostalCodeBeforeRegion: If the key value is equal to 1, that field «Postal code» will be displayed before the field «Region».
- Added: Editing: Save/restore last active tab. When creating a new contact is always the first tab is opened.
- Added: Internal command «email» works with the file under cursor if no selection.
- Changed: Service element «# E-mail to selected» appears in the file system, only if the folder contains at least one file-contact.
- Added: Export: Property PRODID with value "-//Maximus's Solutions//NONSGML tcPhonebook//EN".
- Changed: Export: Field «Office» exports as additional (third) field of the property ORG instead of appending to the second field «Department».
- Added: Import: If the PRODID property with value "-//Maximus's Solutions//..." is present in the vCard-file then third field of the ORG property is seen as a field «Office».
- Fixed: Export: In the ADR property has been mixed up the fields «Region» and «Postal code».
- Fixed: Results of contact fields changing are not shown in custom columns, if only one contact was present in the current folder.
- Fixed: Editing: Option «File name as «Full name»» did not work when creating contact, only when editing.
- Changed: Editing: Allowed to use all of the characters in the fields name components except '|' and ';'.
- Changed: Import: If the name of the contact is formed on the content of vCard-properties, characters that are prohibited for use in file names are replaced with the underscore character.
[0.9.3.0] [17 Feb 2012]
- Added: The file name of contact is no longer dependent on the full name. Available for inplace renaming in the file window and in dialog «Edit contact».
- Added: Customize appearance: Ability to set grid and background color of the fields list of viewing contact window.
- Added: Customize appearance: Interface elements to set the color: The panels are replaced by buttons.
- Fixed: Customize appearance: Were not localized format context menu.
- Added: Service element «# E-mail to selected» creates a new email to the addresses contained in the selected contacts. Internal command «email».
- Added: Internal command «config» opens main configuration dialog.
- Added: Viewing: Hotkey F4, button «Edit contact»: Open dialog «Edit contact».
- Added: Viewing: Hotkey F2: Edit current field.
- Added: Viewing: Hotkey F3: Go to the website / Create a new mail to the address, contained in the current field.
- Added: Configuration, Export: Option «Combine «First name» and «Middle name» into one field».
- Fixed: Error when starts the plugin with absent language files.
- Added: Message about the absence of the help file when you try to open it.
- Changed: Field name «City» changed to «Locality».
[0.9.2.6] [23 Nov 2011]
- Added: Viewing: Single-clicking on the triangle to the left of the field group name expands/collapses the group.
- Added: Viewing: The arrow keys right/left on the row of the field group name expands/collapses the group.
- Added: Viewing: Quick editing of field «E-mail (preferred)» by double-clicking on field contents (address selection from the drop down list).
- Added: Viewing: Create a letter by double-clicking on the content or name of field «E-mail (all)».
- Changed: Viewing: Quick editing of all fields calls by double-clicking on the field content; following a link (fields «Web page») and creating a letter (fields «E-mail») – on the field name.
[0.9.2.5] [28 Oct 2011]
- Added: Service elements «# Configuration» in the plugin root directory.
- Added: Editing: Ability to specify more than one E-mail address in one field (Button «...»).
- Added: Preferred (PREF) Е-mail: Editing (Summary), Viewing (Summary), Custom column.
- Changed: Export: Keyword PREF will be indicated only if in properties of the contact selected preferred E-mail address.
- Added: Editing: Tab «Contact person»: Button «Swap fields «First name» and «Last name»».
- Changed: Editing: Field names are displayed in bold.
- Added: Buttons and key F1 in dialogs to open help file.
- Fixed: Import: Encoding Quoted-printable: Fixed loss of normal (not in this encoding) spaces.
- Fixed: Import: Unknown vCard-properties (for example «CLASS», «AGENT», etc.) were added to the contents of the previous properties.
- Fixed: Viewing: Follow a link does not work, if the string does not begin with "http://" or "www".
- Fixed: When you call the configuration dialog with Alt+Enter on element [..] not removed the underscore in the main menu items.
[0.9.2.0] [09 Sep 2011]
- Added: Import: Support for vCard-files with multiple contacts. Additional replacement dialog.
- Added: Dialog for configuring format of text and background in preview window. Format copy and paste are available through the context menu.
- Added: Viewing: Editing fields by double-clicking.
- Added: Viewing: Going to the website and create a new mail by double-clicking on the value of the corresponding field (field editing is available by double-clicking on the name field).
- Added: Custom columns Total Commander: All phones, Phone (all), Mobile phone (all), Fax (all), E-mail (all), Webpage (all).
- Changed: In the default columns view column «Phone (work)» replaced by column «All phones».
- Added: Calling the configuration dialog with the key combination Alt+Enter on element [..] in the root directory of the plugin.
- Added: Import: In the absence of vCard-property «N» and the presence of vCard-property «FN», the field «Name» is filled with the contents of vCard-property «FN».
- Added: Import: In the absence of vCard-properties «N» and «FN» field «Name» is filled with the name of the imported file.
- Added: Configuration dialog, Export: Option «Export «N» (vCard-property)».
- Fixed: Import: Was created the field «Birthday», even if the imported contact does not contain vCard-properties «BDAY».
- Fixed: Export: When disabled option «Show .vcf extension with contacts», was made overwriting files without prompting.
- Changed: Disabled system sounds when pressing Esc and Enter keys in the fields for text input.
[0.9.1.0] [28 Jun 2011]
- Added: Possibility resize the windows «Information about contact», «Create new contact»/«Edit contact».
- Added: Viewing: Tooltip above the text, which is not fully visible.
- Added: Viewing: Definition of the rows height by text height.
- Added: Import: Available option «Make contact name by vCard-properties content».
- Added: Viewing/File windows: Available option «Sequence of name components».
- Added: Change the modification time after editing a contact.
- Fixed: Import: Fixed another bug when decoding Quoted-printable.
[0.9.0.3] [14 Jun 2011]
- Fixed: Import: Some fixes with Quoted-printable decoding.
[0.9.0.2] [13 Jun 2011]
- Fixed: Import: Decoding UTF-8 and Quoted-printable (Chinese alphabet symbols now imported correctly).
- Changed: Editing/Viewing/Export: Field «Postal code» is moved to the position after the field «City».
- Changed: Localization English: Field «Post» renamed to «Job title».
[0.9.0.0] [12 Jun 2011]
- Changed: Contact fields are divided into groups on a different principle (Contact person, Work, Personal, Other).
- Added: New fields for the components of name (First Name, Last Name, Middle Name, Title).
- Added: New field «Birthday» in the group «Contact person».
- Added: Editing/Viewing: Fields group «Other» (additional contacts and address).
- Added: Editing: Tab «Summary»: added fields «Phone», «Mobile phone», «E-mail» (work and personal).
- Added: Viewing: Fields group «Summary»: fields «Phone», «Mobile phone», «E-mail» combines the work, personal and additional contacts.
- Added: Import: Support encoding Quoted-printable.
- Added: Support Unicode in file names (plugin interface is now fully Unicode).
- Fixed: Changing the contact fields through the dialog «Change attributes» worked incorrect.
- Fixed: Increased buffer size for converting text to encoding UTF-8 (some characters were truncated if in the string were present 3 or 4-byte characters UTF-8).
- Fixed: Import: Unnecessary replacement request when disabled displaying of extension.
- Changed: In the messages element names are displayed in the format «Phonebook:\name\of\element».
[0.8.7.0] [20 Apr 2011]
- Added: Configuration dialog: Font selection for plugin windows (window «View contact» does not apply – will be a separate setting).
- Added: Configuration dialog: Option «Export vCard in UTF-8 encoding».
- Added: Import: Multistring vCard-properties.
- Changed: Import: Parse vCard-file stops when it finds the string «VCARD:END».
- Fixed: View contact: Wrong scrolling when list has collapsed groups and has no scrollbar.
- Fixed: Export: When extension displaying was disabled an error occurred with contact viewing by F3.
- Fixed: Import: Optimized vCard-file reading algorithm. Properties with known types now are not lost.
[0.8.6.5] [16 Mar 2011]
- Added: Language files in UTF-8 encoding.
- Added: Configuration dialog: Option «Show extension .vcf with contacts».
- Added: Configuration dialog: Option «Export LABEL (vCard property)».
- Added: Configuration dialog: Language list is displayed as strings with names in English and native language.
- Fixed: Solved the problem with the incorrect input of Chinese characters in Chinese Windows.
- Fixed: Import: Now, if work address is absent in imported contact, it will not be filled with home address.
- Added: Localization: Chinese.
[0.8.5.0] [25 Feb 2011]
- Changed: Viewing information about contact as a list of fields.
- Added: Viewing: Empty fields are not displayed.
- Added: Viewing: Possibility to collapse/expand field groups (with state saving).
- Fixed: Import: Significantly improved algorithm of reading vCard format files.
- Added: Import: Import fields with UTF-8 charset.
- Added: Export/import: Processing field «Department».
- Added: Export/import: Processing field «Note».
- Fixed: Export: Empty fields are now not exported.
- Changed: Export: Export to a vCard format file version 2.1.
- Added: Localization: Danish, Swedish.
[0.8.1.0] [28 Jan 2011]
- Added: Localization of custom columns names.
[0.8.0.0] [27 Jan 2011]
- Added: Import/export contacts in vCard format.
- Added: Displaying .vcf extension with contacts in Total Commander file window.
[0.7.5.0] [05 Jan 2011]
- Added: When «run» contact by double-click or Enter contact information displayed in view easy to read as.
- Fixed: Restored search efficiency.
- Changed: Field «Post» added to the custom columns by default instead of field «E-Mail».
[0.7.0.0] [30 Dec 2010]
- Added: First public release.