Welcome, this wiki is for documentation of adx.
You can find here information how adx works, tips and tricks, etc.
Table of contents:
adx (addressbook.xml) is a simple but massively web enabled address book in your web browser (no server components needed).
Supported web accounts: Skype, LinkedIn, Facebook, Xing, ebay, Flickr, Picasa, YouTube, MySpace, Twitter, Soup, ICQ, AIM, YIM, MSNIM, Jabber, Picasa, Google, Spin.de, last.fm, SourceForge, DeviantArt, identi.ca, bebo, studiVZ, qype.com, brightkite.com, hi5.com, quarterlife.com, amiestreet.com, hellotxt, etc. See [Accounts] for full list
How it works: addressbook.xml + XSLT = HTML in your web browser
To add contacts just edit addressbook.xml in a text editor of your choice
- Online importer for Open Contacts (a freeware address book tool for Windows)
- Opent Contacts has itself various import possibilities which can be used as intermediate step before importing to adx. Supported import formats are Outlook, vCard, Mozilla, Eudora, CSV, LDIF and more.
- You can create your own XSLT transformator to import any XML based format to adx (e.g. based on the XSLT file from Open Contacts to adx)
Otherwise add your contacts manually to [addressbook.xml] with a text editor of your choice.
Native vCard export via adx:
How to use the vCard files:
Android phones can import easily vCard contacts (Android >= 2.1). Go to contacts in your phone and press 'menu' where you can find an import functionality from your SDCard (e.g. in 'options').
Thunderbird (version 16 as of now) has several issues on importing vCard data. The Thunderbird extension MoreFunctionsForAddressBook imports vCards much better.
Evolution Email solution can also import vCard files.
A QR code is a two-dimensional barcode which can contain vCard data. Following example contains a full contact:
A QR code can be optical read out e.g. by any device with a camera and an app (Recommendation for Android: Barcode Scanner)
adx uses a open source QR code generator library to generate the QR code completely offline. So, your contact data is not leaving your web browsor and therefore not uploaded to any server.
You can also create a XSLT document to export the contacts to the format of your choice.
Browser need a workaround if you want to use adx locally:
Iin following you see two How Tos which should be similar on any other OS.
--allow-file-access-from-files. You can check this in Chrome by entering URL
chrome://version(see screenshot below).
Following was tested with Ubuntu 11.10 under Gnome 3. Add needed command line parameter in file /usr/share/applications/chromium-browser.desktop:
"sudo gedit /usr/share/applications/chromium-browser.desktop"
"Exec=/usr/bin/chromium-browser --allow-file-access-from-files %U"
If it's still not working you can doublecheck with URL
chrome://version if the parameter
--allow-file-access-from-files is listed:
Workaround for Chrome should be similar.
Attention: This option is applied to all chromium instances started inside Gnome desktop. If you have security concerns you should start chromium directly from terminal with command line parameter
You can register adx as browser search engine. Add a url template like following consisting of your addressbook.xml (works online and offline).
"%s" will be replaced by your search term.
You need to replace the path to your addressbook.xml (works online and offline).
In Chrome this can be added very easy in Preferences -> Manage Search Engines.
Firefox integration can be done via a bookmark with above url pattern. Important is to apply a keyword for the bookmark (e.g. "adx") in order to call it from the url bar:
Once added as bookmark (here with keyword "adx") you can search from the address bar:
There are two types of settings:
For details see below.
Cookies or similar technology is not used at all.
Search for "User settings" in adx2html_phonelist.xsl. There's a list with settings you can adjust:
URL parameters cover most settings you can directly adjust on your adx web site. Example in order to show contact details by default: http://elektronengehirn.net/addressbook/addressbook.xml?showdetails=1
This is handy in order to bookmark adx with your needed settings:
Example with all URL parameters: http://elektronengehirn.net/addressbook/addressbook.xml?showdetails=1&showheader=1&showexport=1&tagfilter=Musician&searchfilter=Raph&frequencyhigh=1&frequencymedium=1&frequencylow=1&fontsize=1.1em