How To Customize Collections

  Contents

You can add/rename/hide collections by using an external setup file. The setup file can also be used to hide the image viewer functionality.  

One setup file applies to a given database and should have the same name as the database (example: for database "demo.mdb" the setup file should be named "demo.dat" file).  

Below is an example of contents of a setup file, which can help you understand the format rules.  

Format rules  

1) Lines beginning with ';' or blank lines are ignored by APO  

2) Lines beginning with '<original collection name>=' are used to rename or suppress collections: '<original collection name>=<new name of collection>' will rename the original collection while '<original collection name>=<blank>' will suppress it (see the example below)  

3) Lines beginning with 'x' or 'X' followed by a two digit number are used to add new collections. The format is: 'x<nn>=<name of collection to be added>.  To each added collection a default icon will be assigned, unless APO finds an icon file for the collection in the APO installation directory ('x01.ico for the first added collection, 'x02.ico' for the second one and so on). For example, if APO finds file x03.ico it will use it as icon for the collection added with line 'x03=<...>. NOTE: icon format should be 16x16 or 32x32 pixel according to your preference about the toolbar size (small or large respectively)  

4) Lines containing 'para_image_viewer=false' are used to hide the image viewer functionality

WARNING: if you rename or suppress collections for which any items are present in the database, these will not be automatically renamed or deleted. However, you can do a bulk collection rename or bulk collection delete for these items by using functions "bulk rename of field 'collection' and 'delete all filtered records' in the 'all collections' table (see table context menu by clicking with the right mouse button on an grid row).  

Example of contents of setup (.dat) file  

;---------------collections renamed--------------

Journal=Diario
Myself=Me stesso
Personal chrono=Cronologia personale
Favorites=Preferiti

;-------------collections hidden--------------

persons=
contacts=
World chrono=
Books=
Media=
Internet URLs=
Encyclopedia=
Glossary=
File links=
Wisdom=
Improvement=
Profession=
Misc=
Apx=
Money=

;-------------collections added-------------

x01=Familiari
x02=Amici
x03=Colleghi
x04=Altre persone
x05=Lavoro
x06=Abitazione
x07=Tempo libero
x08=Politica
x09=Economia

;---------- miscellaneous parameters-------------
para_image_viewer=false