PhoneLookup Hack User's Guide

Thank you for using PhoneLookup Hack!


PL-hack icon PL-hack screenshot

This documentation covers PhoneLookup Hack version 2.4
23-DEC-2001


Introduction

The datebook application allows you to look up for a record in the address book (menu Options/Phone Lookup), and to automatically insert the associated data.

For instance, let's select Mr. Neuman's details using the standard Phone Lookup:

Datebook view Lookup view Result

What is inserted isn't configurable : you get the first name, the last name, the phone number and nothing else...

Now look at Mr. Neuman's record in the adress book:

Address view

As you can see, there is a lot of valuable data that could be used by Phone Lookup.

PhoneLookup Hack allows you to define which fields Phone Lookup will return. You can even customize how they will be returned, with line feeds or additional text.

For instance, you may want Phone Lookup to insert the company name, work phone and full address, on multiple lines for legibility (left screenshot), and here's what you get when you do the same lookup as above (right screenshot):                 

Configuration screen

Result

Doesn't it look better? Isn't it more convenient?

Please note that PhoneLookup Hack is shareware. The evaluation period is 30 days long. If you continue to use PhoneLookup Hack after 30 days, you are required to register.

To get the latest version of PhoneLookup Hack, please visit my web page at : http://www.ablivio.com, or download directly the latest plhack.zip at: http://www.ablivio.com/plhack/getit.htm.

[Back to top]


Installing (or removing) PhoneLookup Hack

[Back to top]

First time installation

Step 1
Upload plhack.prc on your Palm device, using the regular HotSync process.
[If X-Master isn't installed yet on your machine, upload X-Master.prc as well. Note: if your machine is low on memory, upload X-Master-light.prc instead.]

HotSync icon

Step 2
Launch X-Master.

The list of all HackMaster extensions available on your machine appears, including "PhoneLookup Hack".
If there is a lot of extensions on your machine, you may have to scroll down the list.

HackMaster icon

PhoneLookup Hack is disabled

Step 3
Check the box beside "PhoneLookup Hack" to activate it.

You're finished!

PhoneLookup Hack is enabled

[Back to top]

How to upgrade an existing PhoneLookup installation

Step 1
Launch X-Master.

The list of all HackMaster extensions available on your machine appears, including "PhoneLookup Hack".
If there is a lot of extensions on your machine, you may have to scroll down the list.

HackMaster icon

PhoneLookup Hack is enabled

Step 2
Uncheck the box beside "PhoneLookup Hack", to disable the hack.

PhoneLookup Hack is disabled

Step 3
Upload plhack.prc file on your Palm device, using the regular HotSync process.

HotSync icon

Step 4
Launch X-Master.

The list of all HackMaster extensions available on your machine appears, including "PhoneLookup Hack".
If there is a lot of extensions on your machine, you may have to scroll down the list.

HackMaster icon

PhoneLookup Hack is disabled

Step 5
Tap on "PhoneLookup Hack" to select it.

Then tap on the "Info" button to display the version information and check that you now have the newer version of the hack (on the screenshot, this is version 2.4).
Tap on "OK".

Step 6
Check the box beside "PhoneLookup Hack" to activate it.

You're finished!

PhoneLookup Hack is enabled

[Back to top]

You want to get rid of PhoneLookup Hack

Well, you're the boss. :-)

[Back to top]


Using PhoneLookup Hack

[Back to top]

Overview

Basically, PhoneLookup Hack allows you to define your own format string to describe how you want the Phone Lookup command to return data from the address book.

To access the format definition form, please proceed as follows :

Step 1
Launch X-Master.

The list of all HackMaster extensions available on your machine appears, including "PhoneLookup Hack".
If there is a lot of extensions on your machine, you may have to scroll down the list. The "PhoneLookup Hack" checkbox must be checked.

HackMaster icon

PhoneLookup Hack is enabled

Step 2
Tap on "PhoneLookup Hack" to select it, then tap on the "Configure" button.

You get to the format definition form.

Configuration screen

Now, you can use any of the markers listed below to compose your own format string. You can also insert additional characters, such as line feeds, if you want the Phone Lookup output to be more legible.

[Back to "Using PhoneLookup Hack"]

[Back to top]

How to define your own format string

Available markers are :

Apart from ^listname and ^listphones, which are special macros defined below, each marker directly matches a field of an address book record.

^listname acts as follows :

^listphone :

[Back to "Using PhoneLookup Hack"]

[Back to top]

Examples

[Back to "Using PhoneLookup Hack"]

[Back to top]


Your comments are welcome!

Feel free to send me your comments, suggestions, criticisms and every other kind of feedback at feedback@ablivio.com. I make a point of replying to all messages I receive.

It will help me to make PhoneLookup Hack better and more useful, by answering more closely your needs.

[Back to top]


What is shareware?

PhoneLookup Hack is shareware. That means that you can download, use and completely free test the program for 30 days. You may also distribute and copy unregistered versions of PhoneLookup Hack to others as long as the files in the original PLHACK.ZIP archive is not tampered and no fee is charged. If you find the program useful and you continue to use it, you are obligated to register.

The whole shareware concept is based on honesty. The registration fee you pay allow me to support and continue to develop PhoneLookup Hack in the future.

When you register PhoneLookup Hack, you will get the most recent registered version of the program, without any shareware nags, or delay screens.

Definitions:

SUPPORT THE SHAREWARE CONCEPT: PAY YOUR SHAREWARES!

[Back to top]


How to register for PhoneLookup Hack?

Registration entitles you to all future corrective updates of PhoneLookup Hack and to special rates (possibly free) for evolutive updates.

When you register, you get a registration code. You merely have to enter it in PhoneLookup Hack, using menu "Info/Register". Then, if you select "Info/About...", you'll be able to check that your copy of PhoneLookup Hack is registered to you.

Note : Once you've entered the registration code, the "Register" menu item is not removed from menu "Info". I did this because removing it would require additional "cosmetic" code, hence a larger app.

Cheaper! Direct registration

The registration fee can be paid directly to me using the following currencies and rates:

US Dollars ($) 9 USD
EURO 10 EUR

Just mail me your registration fee (no checks, nor other currencies than above, thanks !) :

Denis Faivre, 99 avenue Marx Dormoy, 59000 Lille, France.

Note : Don't forget to include:

This information is needed to generate your registration code and send it to you by e-mail.

If you don't remember your user name, just launch the HotSync app on your Palm device. On Pilots and PalmPilots, you'll get a message saying "Welcome, <USER NAME>. Last HotSync...". On Palm IIIs, your user name is displayed on the right of Hotsync app's title bar.

Your address will be kept confidential. It won't be given or sold to anyone.

Faster! Credit card registration (phone, fax, on-line)

Credit card registrations will be processed by PilotGear.

Through PalmGear, PhoneLookup Hack registration fee is $9.95 (USD).

On-line registration: http://store.yahoo.com/pilotgearsw/denisfaivre.html
Phone : 1-800-741-9070 or 1-817-640-6558.
Fax : 1-817-640-6614.

Palm Gear H.Q.
2500 East Randol Mill Road, Suite 117
Arlington, TX 76011
USA.

[Back to top]


License and Legal Information for PhoneLookup Hack

NOTICE: THIS IS A CONTRACT. BY INSTALLING AND USING THIS SOFTWARE, YOU ARE AGREEING TO BE BOUND BY ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT. PLEASE READ CAREFULLY BEFORE PROCEEDING. IF YOU DO NOT AGREE TO THESE TERMS, PROMPTLY DESTROY ALL COPIES OF THE SOFTWARE IN YOUR POSSESSION.

EVALUATION LICENSE

Denis Faivre ("the Author") grants you a non-exclusive license to use PhoneLookup Hack ("the Software") free of charge for a period of 30 days ("the Trial Period") for the purpose of evaluating whether to purchase a license for continued use of the Software.

At the end of the Trial Period, if you do not purchase a license, you must destroy all copies of the Software and Documentation. If you wish to purchase a license, contact the Author at info@ablivio.com or http://www.ablivio.com .

GRANT

On payment of applicable license fees, the Author will grant to you a non-exclusive license to use the Software and Documentation as laid forth below.

SCOPE OF GRANT

You may:

You may not:

DISTRIBUTION

Copies of unregistered versions of the software may be distributed for evaluation purposes only in accordance with the following terms :

Distribution is permitted only for the whole unregistered software package without any modifications. All accompanying files must be included. You are specifically prohibited from charging or requesting donations for any such copies without prior written permission.

WARRANTY DISCLAIMER

THE SOFTWARE IS PROVIDED "AS IS," AND WITHOUT ANY WARRANTY, EXPRESS OR IMPLIED, AS TO NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE.

COPYRIGHT AND TITLE

Title, ownership rights, and intellectual property rights in the Software are owned by the Author and protected by U.S. copyright law and international treaty.

The structure, organization and code of the software are valuable trade secrets of the Author.

Recipient will not disclose, publish, or distribute the Software except as permitted above, and agrees to take reasonable precautions to prevent any unauthorized use, disclosure, publication, or distribution. Proprietary rights notices on the Software shall be preserved on all copies made, and the Software shall not be modified, reverse engineered, or decompiled for any purpose, or translated into another computer language.

GOVERNING LAW

This agreement shall be interpreted, construed and governed in accordance with the french laws.

Copyright (c) 1998-2001 Ablivio - Denis Faivre. All Rights Reserved.

[Back to top]